Agendid ja persoonad — AiHummer Dokumendid

Ü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.

Käituspoliitika: kontekst, seansid ja lapsagendid

Alates versioonist 1.3 on agendil käituspoliitika — väli runtime_policy haldus-API-s (/v1/admin/agents loomisel ja uuendamisel). See on rangelt valideeritav JSON-objekt väärtusega "version": 1: tühi {} taastab vaikeväärtused, välja ärajätmine uuendamisel säilitab eelmise poliitika ning tundmatud väljad ja lubatud piiridest väljas väärtused lükatakse tagasi. Poliitika ei anna tööriistu ega laienda õigusi — see määrab ainult eelarved ja tähtajad. Agendi kloon ja talle käigu üleandmine pärivad selle.

context — ajaloo eelarve: max_tokens, reserve_tokens ja history_share määravad, kui palju ajalugu päringusse jõuab; max_history_messages piirab sõnumiakent, bootstrap_max_chars profiiliploki suurust. Kui kontekst on selgesõnaliselt määratud, tihendatakse vanemad sõnumid enne praeguse päringu koostamist osade kaupa kokkuvõtteks.
- pruning — aegunud tööriistatulemuste puhastamine: vanuse järgi (ttl_seconds), viimaseid vastuseid kaitstes (keep_last_assistants), pehme kärpimine (soft_trim_ratio, head_chars, tail_chars) ja täielik asendus placeholder-tekstiga, kui hard_clear_ratio on ületatud. Kasutaja teksti, pilte ja andmebaasi täisajalugu ei puudutata.
- memory_flush — enne tihendamist kirjutab tööriistadeta agent lühikese märkuse eesmärkide, otsuste ja pooleliolevate asjade kohta (soft_threshold_tokens); sama vestluse kolm viimast märkust lisatakse konteksti kontrollimata viitena.
session — vestluse elutsükkel: idle_reset_minutes alustab pärast pausi uut konteksti (toorajalugu säilib), index_prune_after_days ja index_max_entries eemaldavad vanad vestlused vaikeloendist neid kustutamata. scope = per-peer (üks vestlus kinnitatud kasutaja kohta kõigis kanalites) või per-channel-peer (eraldi vestlus kanali kohta).
children — lapsagendid: max_depth (kuni 4), max_concurrent (kuni 8 käivituspuu kohta), max_per_parent (kuni 5), timeout_seconds (kuni 48 tundi, kuid mitte kauem kui vanem) ja archive_after_minutes — millal lõpetatud käivitused vaikeloendist kaovad. Väärtused kirjutavad selle agendi jaoks üle globaalsed AIHUMMER_SUBAGENT_MAX_DEPTH ja AIHUMMER_SUBAGENT_TIMEOUT_SEC.
max_iterations (1–256) — funktsioonikutsete tsükli sammude piir kontrollitud stsenaariumidele paljude delegeerimistega.
app — ainult AiHummeri rakendusele: reasoning_effort, service_tier ja lühivastuse režiim direct_completion (auto või always koos max_tokens kuni 4096 ja timeout_ms kuni 60 000).
interaction — selgesõnalised seansiõigused: user_ids, session_agent_ids, spawn_agent_ids, nähtavus session_visibility (self, agent või granted), session_send, lapskutsete tööriistakeelud (child_tool_deny, child_leaf_tool_deny) ja elevated_telegram_user_ids — user_ids alamhulk, kellel on lubatud taotleda selgesõnaliselt kõrgendatud code_exec-käivitust (kinnitustest mööda ei minda). Metamärke ega kogu rentniku hõlmavaid õigusi ei ole.

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

Mõista, kuidas agendid teevad käigu ja loovad abilised Orkestreerimine ja alaagendid.
Vaadake, kuidas saabuv sõnum jõuab kindla agendini Marsruutimine.
Anna oma agentidele pikaajaline mälu koos Mälu (Einstein).