Agenți și persona — AiHummer Documentație

Un agent este unitatea pe care AiHummer o pune în fața unei conversații. Fiecare agent are o persona, propriul său model, un prompt structurat și un set de competențe, iar fiecare modificare adusă lui este versionată. Agenții sunt gestionați din interfața web de administrare și prin API-ul de administrare sub /v1/admin/agents/*.

Această pagină acoperă din ce este alcătuit un agent, cum este asamblat promptul structurat „G3” și cum poate un agent să-și editeze în siguranță propriul profil.

Registrul de agenți

Registrul este un catalog CRUD complet de agenți. Pentru fiecare agent definești o identitate, o persona, modelul pe care rulează și competențele pe care le poate folosi. Deoarece gateway-ul este multitenant, agenții trăiesc în interiorul unui workspace și sunt izolați la fel ca orice alte date ale unui tenant.

Persona — vocea și comportamentul agentului, redate într-un strat stabil și prietenos cu cache-ul al promptului de sistem.
Model per agent — fiecare agent își poate fixa propriul model și furnizor, astfel încât un agent ieftin și un agent flagship pot coexista în același workspace.
Competențe — competențele per agent și cele partajate redau un bloc „Competențe” în prompt; ele descriu capabilități, nu ponderi.

[!NOTE] Un model per agent este independent de rutare. Rutarea pe tier-uri de model (simplu / standard / complex) alege o clasă de model pentru un tur, în timp ce modelul per agent este valoarea implicită proprie a agentului. Vezi Rutare.

Versiuni, rollback și clonare

Fiecare modificare semnificativă adusă unui agent este capturată ca o versiune. Acest lucru face ca configurația agentului să fie auditabilă și reversibilă: poți examina ce s-a schimbat, poți face rollback la o versiune anterioară sau poți clona un agent pentru a-l folosi ca punct de plecare pentru unul nou. Resursele de versiune și profil trăiesc sub /v1/admin/agents/* (profil, secțiuni, competențe, versiuni).

[!TIP] Clonează un agent funcțional înainte de o rescriere amplă a persona-ei sau a promptului. Dacă noua direcție nu dă roade, originalul este încă la un singur rollback distanță.

Promptul structurat „G3”

În loc de un singur prompt de sistem în text liber, AiHummer folosește un profil de agent structurat (intern „G3”). Identitatea este descompusă în câmpuri mai degrabă decât îngropată în proză, iar restul promptului este construit din secțiuni denumite plus un bloc de onboarding. Orchestratorul le redă în promptul de sistem stratificat, păstrând părțile stabile (identitate, persona, secțiuni) într-un prefix care poate fi pus în cache și adăugând datele volatile la final.

Structura face un profil ușor de editat câmp cu câmp, ușor de comparat între versiuni și previzibil de redat — nu există nicio supă de prompt ascunsă.

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

Auto-editare în spatele unei porți de aprobare

Unui agent i se poate permite să-și editeze propriul profil folosind instrumente de auto-editare — de exemplu pentru a rafina o secțiune sau a-și actualiza onboarding-ul. Acest lucru este deliberat păzit:

Auto-editările trec prin poarta de aprobare: o modificare propusă este înregistrată și trebuie aprobată de un om înainte de a intra în vigoare. O modificare respinsă nu este niciodată aplicată.
Modificarea este capturată ca o nouă versiune, astfel încât o auto-editare este la fel de auditabilă și reversibilă ca orice editare manuală.

[!WARNING] Auto-editarea este puternică. Păstreaz-o în spatele porții de aprobare, astfel încât un agent să nu-și poată rescrie în tăcere propria identitate. Examinează auto-editările propuse în același mod în care examinezi orice modificare privilegiată.

Parolele de e-mail merg în vault

Dacă configurația unui agent include credențiale de e-mail (pentru instrumentul mail), parola este scrisă în vault-ul criptat de credențiale, nu stocată în profil sau redată în prompt. Secretele nu intră niciodată în contextul modelului.

API de administrare

Agenții și profilurile lor structurate sunt gestionate sub API-ul de administrare, care este protejat prin OIDC și auditat:

Resource	Purpose
`/v1/admin/agents`	Listează, creează, actualizează, șterge agenți (CRUD)
`/v1/admin/agents/.../profile`	Profilul structurat G3 (câmpuri de identitate)
`/v1/admin/agents/.../sections`	Secțiuni denumite de prompt
`/v1/admin/agents/.../skills`	Competențe per agent
`/v1/admin/agents/.../versions`	Istoric de versiuni, rollback și clonare

Unde mergi mai departe

Înțelege cum rulează un agent un tur și cum generează ajutoare în Orchestrare și sub-agenți.
Vezi cum ajunge un mesaj primit la un agent specific în Rutare.
Oferă agenților tăi memorie pe termen lung cu Memorie (Einstein).