AiHummer
Eesti▾
SisselogimineKonto
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Tuumikkontseptsioonid/Agendid ja persoonad

Agendid ja persoonad

v1.0.x · uuendatud 2026-06-26

Üks agent on üksus, mille AiHummer asetab vestluse ette. Igal agendil on iseloom, oma mudel, struktureeritud käsk ja oskuste kogum, ning iga selle muutmine salvestatakse versioonina. Agente hallatakse veebipõhise haldusliidese kaudu ja halduse API kaudu all /v1/admin/agents/*.

See leht käsitleb, millest agent koosneb, kuidas koostatakse struktureeritud ‘G3’ viis, ja kuidas agent saab turvaliselt oma profiili redigeerida.

Agendi register

Registratuur on täielik CRUD-kataloog agentidest. Iga agendi puhul määratlete identiteedi, iseloomu, mudeli, millel see töötab, ja oskused, mida ta saab kasutada. Kuna lüüs on mitmeüüriline, elavad agendid tööruumis ja on isoleeritud nagu iga teine üürnikudata.

  • Isik — agendi hääl ja käitumine, muudetud talliks, süsteemiprompti vahemäljesõbralik kiht.
  • Agendi kohta mudel — iga agent saab kinnitada oma mudeli ja teenusepakkuja, nii et odav agent ja lipulaeva agent võivad eksisteerida samas tööruumis.
  • Oskused — agendi-spetsiifilised ja jagatud oskused muudavad „Oskused” ploki sõnum; nad kirjeldavad võimekusi, mitte kaalusid.

[!NOTE] Agendi-põhine mudel on marsruutimisest sõltumatu. Mudeli kihina marsruutimine (lihtne / standardne / keeruline) valib vooru jaoks mudeliklassi, samal ajal kui iga agent mudel on agendi enda vaikeväärtus. Vaata Marsruutimine.

Versioonid, tagasikerimine ja kloonimine

Iga mõtestatud muutus agendile salvestatakse kui versioon. See muudab agendi konfiguratsiooni auditeeritavaks ja pööratavaks: saate üle vaadata, mis muutus, tagasi kerima varasemale versioonile või kloon agendi kasutamiseks selle lähtepunktina uue jaoks. Versiooni ja profiili ressursid asuvad all /v1/admin/agents/* (profiil, jaotised, oskused, versioonid).

[!TIP] Klooni töötav agent enne suuremat isiku- või käsuümberkirjutust. Kui uus kui suund ei tasu end ära, on originaal ikkagi ühe tagasikerimise kaugusel.

Struktureeritud „G3“ käsk

Ühe vaba teksti süsteemkäskluse asemel kasutab AiHummer struktureeritud agendi profiil (sisemiselt “G3”). Identiteet on lagunenud väljaosadeks pigem kui prose alla mattes, ja ülejäänud üleskutse on loodud nimedest jaotised pluss üks töölevõtmine plokk. Orkestreerija teisendab need kihilisse süsteemi käsu, hoides stabiilsed osad (identiteet, isiksus, jaotised) vahetatavas eellaaditavas eesliites ja lisades muutuvad andmed viimasena.

Struktuur muudab profiili lihtsaks muuta välja kaupa, lihtsaks versioonide vahel võrrelda ja ennustatavaks kuvada — varjatud käsuerida ei ole.

G3 profile
├── identity fields   (decomposed: name, role, ...)
├── sections          (named, ordered prompt blocks)
└── onboarding        (first-run guidance)

Enese redigeerimine heakskiiduluku taga

Agetile võib olla lubatud muuda oma profiili iseendatoimetamise tööriistade kasutamine — näiteks mõne osa täpsustamiseks või selle pealevõtmise uuendamiseks. See on tahtlikult kaitstud:

  • Enesetarkandused läbivad heakskiidu värav: ettepanekuline muudatus on registreeritud ja peab jõustumiseks olema inimese poolt heaks kiidetud. Tagasi lükatud muudatus ei ole kunagi rakendatud.
  • Muutus salvestatakse uutena versioon, nii et enese redigeerimine on sama auditeeritav ja pööratav nagu iga käsitsi tehtud muudatus.

[!WARNING] Enese-redigeerimine on võimas. Hoidke seda heakskiidulaua taga, et agent seda ei saaks vaikselt oma identiteeti ümber kirjutama. Vaata ettepanekuid enda muutustest sama moodi läbi nagu sina ülevaatama kõiki privileege puudutavaid muudatusi.

Meiliparoolid lähevad kappidesse

Kui agendi konfiguratsioon sisaldab meilikontosid (järgmiseks mail tool), parool on kirjutatud krüpteeritud mandaadivaramu, ei salvestata profiili ega kuvatakse käsus. Saladused ei sisene kunagi mudeli konteksti.

Admin API

Agendid ja nende struktureeritud profiilid on hallatav administraatori API kaudu, mis on OIDC-ga kaitstud ja auditeeritud:

Ressurss Eesmärk
/v1/admin/agents Agentide loendamine, loomine, värskendamine, kustutamine (CRUD)
/v1/admin/agents/.../profile Struktureeritud G3 profiil (identiteediväljad)
/v1/admin/agents/.../sections Nimetatud lähteteksti sektsioonid
/v1/admin/agents/.../skills Agendi kohta oskused
/v1/admin/agents/.../versions Versiooniajalugu, tagasipöördumine ja kloonimine

Kuhu järgmine