AiHummer
Română
AutentificareCont personal
v1.0.x
{ }Swagger

Agenți și persoane

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

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

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

Registrul agenților

Registrul este un catalog complet CRUD al agenților. Pentru fiecare agent definiți o identitate, o persoană, modelul pe care rulează și abilitățile pe care le poate folosi. Deoarece gateway-ul este multichiriaș, agenții trăiesc în interiorul unui spațiu de lucru și sunt izolați ca orice alte date ale chiriașului.

  • Persoană — vocea și comportamentul agentului, transpuse într-o grajdă, strat prietenos cu cache-ul al promptului sistemului.
  • Model per agent — fiecare agent își poate fixa propriul model și furnizor, deci un un agent ieftin și un agent de referință pot coexista în același spațiu de lucru.
  • Competențe — abilitățile per-agent și partajate transformă un bloc „Abilități” în prompt; ei descriu capacități, nu greutăți.

[!NOTE] Un model pe agent este independent de rutare. Rutarea la nivel de model (simplă / standard / complex) alege o clasă de model pentru un tur, în timp ce per-agent modelul este implicitul agentului. Vezi Rutare.

Versiuni, revenire și clonare

Fiecare schimbare semnificativă adusă unui agent este capturată ca versiune. Acest lucru face ca configurarea agentului să fie audibilă și reversibilă: poți revizui ce s-a schimbat, anula la o versiune anterioară, sau clonă un agent pentru a-l folosi ca punct de plecare pentru unul nou. Resursele de versiune și profil se află sub /v1/admin/agents/* (profil, secțiuni, abilități, versiuni).

[!TIP] Clonează un agent funcțional înainte de o rescriere majoră a persoanei sau a promptului. Dacă noul dacă direcția nu funcționează, originalul este încă la un pas de rollback.

Promptul structurat „G3”

În locul unui singur prompt de sistem cu text liber, AiHummer folosește un profil de agent structurat (intern intern „G3”). Identitatea este descompus în câmpuri mai degrabă decât îngropat în proză, iar restul sugestiei este construit din elemente numite secțiuni plus un an integrare bloc. Orchestratorul le redă în promptul sistemului stratificat, păstrând părțile stabile (identitate, persoană, secțiuni) într-un prefix memorabil și adăugând datele volatile la final.

Structura face ca un profil să fie ușor de editat câmp cu câmp, ușor de comparat între versiuni și predictibil de afișat — nu există nicio amestecătură ascunsă de prompturi.

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

Auto-corectare în spatele unui filtru de aprobare

Un agent poate fi autorizat să editează propriul profil folosind instrumente de auto-editare — de exemplu pentru a rafina o secțiune sau a actualiza procesul său de integrare. Acest lucru este protejat în mod deliberat:

  • Auto-corectările trec prin poartă 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.
  • Schimbarea este capturată ca una nouă versiune, așadar o auto-revizuire este la fel de verificabilă și reversibil ca orice editare manuală.

[!WARNING] Auto-corectarea este puternică. Ține-o în spatele porții de aprobare astfel încât un agent să nu poată rescrie în tăcere propria identitate. Examinează propunerile de auto-corectare în același mod în care revizuiește orice modificare privilegiată.

Parolele de e-mail merg în seif

Dacă configurația unui agent include acreditive de e-mail (pentru mail instrument), parola este scrisă în seif de acreditări criptate, nu sunt stocate în profil sau incluse în prompt. Secretele nu intră niciodată în contextul modelului.

API de administrare

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

Resursă Scop
/v1/admin/agents Listează, creează, actualizează, șterge agenți (CRUD)
/v1/admin/agents/.../profile Profilul G3 structurat (câmpuri de identitate)
/v1/admin/agents/.../sections Secțiuni de prompt denumite
/v1/admin/agents/.../skills Abilități per agent
/v1/admin/agents/.../versions Istoric versiuni, revenire și clonare

Unde următor?