Agentai ir asmenybės — AiHummer Dokumentai

Vienas agentas yra vienetas, kurį AiHummer pateikia prieš pokalbį. Kiekvienas agentas turi savo asmenybę, savo modelį, struktūruotą užklausą ir įgūdžių rinkinį, o kiekvienas jo pakeitimas yra versijuojamas. Agentais valdomi per žiniatinklio administratoriaus sąsają ir per administratoriaus API pagal /v1/admin/agents/*.

Šis puslapis apžvelgia, iš ko sudarytas agentas, kaip surenkamas struktūruotas „G3“ užklausa ir kaip agentas gali saugiai redaguoti savo profilį.

Agentų registras

Registras yra pilnas CRUD agentų katalogas. Kiekvienam agentui jūs nustatote tapatybę, asmenybę, modelį, kuriame jis veikia, ir įgūdžius, kuriuos jis gali naudoti. Kadangi vartai yra daugnuominiai, agentai gyvena darbo erdvėje ir yra izoliuoti kaip bet kurie kiti nuomininkų duomenys.

Asmenybė — agento balsas ir elgesys, perduoti į tvartą, sistemos užklausos sluoksnis, palankus talpyklai.
Agento modelis — kiekvienas agentas gali prisegti savo modelį ir tiekėją, taigi pigus agentas ir pagrindinis agentas gali egzistuoti toje pačioje darbo vietoje.
Įgūdžiai — per-agent ir bendros įgūdžių funkcijos paverčia „Įgūdžių“ bloką į komanda; jie aprašo galimybes, o ne svorius.

[!NOTE] Agentų pagal modelį sistema nepriklauso nuo maršrutizavimo. Modelio lygio maršrutizavimas (paprastas / standartinis / sudėtingas) pasirenka modelio klasę tam tikram ėjimui, o kiekvienas agentas modelis yra pats agento numatytasis. Žr. Maršrutizavimas.

Versijos, atšaukimas ir klonavimas

Kiekvienas reikšmingas pokytis agentui fiksuojamas kaip versija. Tai leidžia agento konfigūraciją tikrinti ir atšaukti: galite peržiūrėti, kas pasikeitė, atidėti atgal į ankstesnę versiją, arba klonas agentą naudoti kaip pradinį tašką naujam. Versijos ir profilio ištekliai gyvena po /v1/admin/agents/* (profilis, skyriai, įgūdžiai, versijos).

[!TIP] Klonuokite veikiantį agentą prieš didelį asmenybės ar užklausos pertvarkymą. Jei naujas jei kryptis nepasiteisina, originalas vis tiek yra vos vieno atšaukimo atstumu.

Struktūruota „G3“ užklausa

Vietoje vieno laisvo teksto sistemos užrašo, AiHummer naudoja strukturizuotas agento profilis (viduje „G3“). Tapatybė yra suskaidyta į laukus verčiau nei palaidotas prozoje, o likusi užuominos dalis sukurta iš pavadintų skyriai pliusas vienas įvedimas į darbą blokuoti. Orkestras paverčia juos sluoksniuotu sistemos raginimu, laikydamas stabilias dalis (tapatybę, asmenybę, skyrius) talpinamame prefikse ir pridėdamas kintamus duomenis paskutiniais.

Struktūra leidžia lengvai redaguoti profilį laukas po lauko, lengvai palyginti versijas ir numatomai atvaizduoti – nėra jokio paslėpto raginimų mišinio.

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

Pačios redagavimas už patvirtinimo vartų

Agentui gali būti leista redaguoti savo profilį naudojant savarankiško redagavimo įrankius – pavyzdžiui, patobulinti skyrių arba atnaujinti jo prisijungimo procesą. Tai sąmoningai saugoma:

Savarankiški redagavimai pereina per patvirtinimo vartai: siūlomas pakeitimas įrašomas ir privalo būti patvirtintas žmogaus prieš įsigaliojant. Atmestas pakeitimas niekada panaudotas.
Pakeitimas įrašomas kaip naujas versija, taigi savarankišką redagavimą galima patikrinti ir atstatomas kaip bet koks rankinis redagavimas.

[!WARNING] Savarankiškas redagavimas yra galingas. Laikykite jį už patvirtinimo slenksčio, kad agentas negalėtų tyliai perrašyti savo tapatybę. Peržiūrėkite siūlomus savireguliavimo pakeitimus tokiu pačiu būdu, kaip jūs peržiūrėti bet kokį privilegijuotą pakeitimą.

El. pašto slaptažodžiai eina į seifą

Jei agento konfigūracija apima pašto kredencialus (dėl mail įrankis), slaptažodis yra užrašytas į užšifruotas kredencialų saugykla, nėra saugoma profilyje ar pateikiama užklausoje. Paslaptys niekada nepatenka į modelio kontekstą.

Vykdymo politika: kontekstas, sesijos ir vaikiniai agentai

Nuo 1.3 versijos agentas turi vykdymo politiką — lauką runtime_policy administravimo API (/v1/admin/agents kuriant ir atnaujinant). Tai griežtai tikrinamas JSON objektas su "version": 1: tuščias {} grąžina numatytąsias reikšmes, lauko praleidimas atnaujinant išsaugo ankstesnę politiką, o nežinomi laukai ir reikšmės už leistinų ribų atmetami. Politika nesuteikia įrankių ir neplečia teisių — ji nustato tik biudžetus ir terminus. Agento klonas ir ėjimo perdavimas jam ją paveldi.

context — istorijos biudžetas: max_tokens, reserve_tokens ir history_share nustato, kiek istorijos patenka į užklausą; max_history_messages riboja žinučių langą, bootstrap_max_chars — profilio bloko dydį. Kai kontekstas nurodytas aiškiai, senos žinutės dalimis suglaudinamos į santrauką prieš sudarant dabartinę užklausą.
- pruning — pasenusių įrankių rezultatų valymas: pagal terminą (ttl_seconds), saugant paskutinius atsakymus (keep_last_assistants), švelnus apkarpymas (soft_trim_ratio, head_chars, tail_chars) ir visiškas pakeitimas placeholder tekstu viršijus hard_clear_ratio. Naudotojo tekstas, vaizdai ir pilna istorija duomenų bazėje neliečiami.
- memory_flush — prieš glaudinimą agentas be įrankių užrašo trumpą pastabą apie tikslus, sprendimus ir nebaigtus darbus (soft_threshold_tokens); paskutinės trys to paties pokalbio pastabos įmaišomos į kontekstą kaip nepatikrinta nuoroda.
session — pokalbio gyvavimo ciklas: idle_reset_minutes po pauzės pradeda naują kontekstą (neapdorota istorija išsaugoma), index_prune_after_days ir index_max_entries pašalina senus pokalbius iš numatytojo sąrašo jų neištrindami. scope = per-peer (vienas pokalbis patvirtintam naudotojui visuose kanaluose) arba per-channel-peer (atskiras pokalbis kiekvienam kanalui).
children — vaikiniai agentai: max_depth (iki 4), max_concurrent (iki 8 vienam paleidimo medžiui), max_per_parent (iki 5), timeout_seconds (iki 48 valandų, bet ne ilgiau nei tėvas) ir archive_after_minutes — kada užbaigti paleidimai dingsta iš numatytojo sąrašo. Reikšmės šiam agentui perrašo globalius AIHUMMER_SUBAGENT_MAX_DEPTH ir AIHUMMER_SUBAGENT_TIMEOUT_SEC.
max_iterations (1–256) — funkcijų iškvietimo ciklo žingsnių riba patikrintiems scenarijams su daugeliu delegavimų.
app — tik AiHummer programėlei: reasoning_effort, service_tier ir trumpo atsakymo režimas direct_completion (auto arba always su max_tokens iki 4096 ir timeout_ms iki 60 000).
interaction — aiškūs leidimai dirbti su sesijomis: user_ids, session_agent_ids, spawn_agent_ids, matomumas session_visibility (self, agent arba granted), session_send, įrankių draudimai vaikiniams iškvietimams (child_tool_deny, child_leaf_tool_deny) ir elevated_telegram_user_ids — user_ids poaibis, kuriam leidžiama prašyti aiškiai pakelto code_exec vykdymo (patvirtinimai neapeinami). Pakaitos simbolių ir leidimų visam nuomininkui nėra.

Administratoriaus API

Agentai ir jų struktūruoti profiliai tvarkomi per administratoriaus API, kuris yra OIDC apsaugotas ir audituojamas:

Ištekliai	Tikslas
`/v1/admin/agents`	Agentų sąrašo sudarymas, kūrimas, atnaujinimas, šalinimas (CRUD)
`/v1/admin/agents/.../profile`	Struktūrizuotas G3 profilis (tapatybės laukeliai)
`/v1/admin/agents/.../sections`	Pavadintos užklausų sekcijos
`/v1/admin/agents/.../skills`	Agento įgūdžiai
`/v1/admin/agents/.../versions`	Versijų istorija, grąžinimas ir klonavimas

Kur toliau

Suprasti, kaip agentai vykdo ėjimą ir sukuria pagalbininkus Orkestracija ir subagentai.
Pažiūrėkite, kaip gaunamas pranešimas pasiekia konkretų agentą Maršrutizavimas.
Suteikite savo agentams ilgalaikę atmintį su Atmintis (Einšteinas).