AiHummer
Latviešu
PierakstītiesKonts
v1.0.x
{ }Swagger

Aģenti un personības

v1.0.x · atjaunināts 2026-06-26

Neviens aģents ir vienība, ko AiHummer liek sarunas priekšā. Katram aģentam ir personība, savs modelis, strukturēts uzvedne un prasmju kopums, un katras izmaiņas tiek versijuotas. Aģenti tiek pārvaldīti no tīmekļa administrēšanas lietotāja interfeisa un caur administrēšanas API zem /v1/admin/agents/*.

Šī lapa apraksta, no kā sastāv aģents, kā tiek izveidota strukturētā ‘G3’ uzvedne un kā aģents var droši rediģēt savu profilu.

Aģentu reģistrs

Reģistrs ir pilns CRUD aģentu katalogs. Katram aģentam jūs definējat identitāti, personību, modeli, uz kura tas darbojas, un prasmes, ko tas var izmantot. Tā kā vārteja ir daudznomnieku, aģenti dzīvo darbvietā un ir izolēti tāpat kā jebkuri citi nomnieka dati.

  • Persona — aģenta balss un uzvedība, pārtulkota stabilā, sistēmas uzvednes kešatmiņai draudzīgā slānis.
  • Katram aģentam modelis — katrs aģents var piespraust savu modeli un nodrošinātāju, tāpēc a Lēts aģents un galvenais aģents var līdzpastāvēt tajā pašā darba vidē.
  • Prasmes — katra aģenta un kopīgās prasmes pārvērš “Prasmju” bloku par uzvedne; tās apraksta spējas, nevis svarus.

[!NOTE] Aģenta modeļa līmenis ir neatkarīgs no maršrutēšanas. Modeļa slāņa maršrutēšana (vienkārša / standarta / sarežģīts) izvēlas modeļa klasi vienam gājienam, kamēr katrs aģents modelis ir paša aģenta noklusējums. Skatīt Maršrutēšana.

Versijas, atcelšana un klons

Katras nozīmīgas izmaiņas aģentā tiek fiksētas kā versija. Tas padara aģenta konfigurāciju pārskatāmu un atgriezenisku: jūs varat pārskatīt, kas ir mainījies, atcelt izmaiņas uz iepriekšēju versiju, vai klons aģents to izmantot to kā sākumpunktu jaunam. Versijas un profila resursi dzīvo zem /v1/admin/agents/* (profils, sadaļas, prasmes, versijas).

[!TIP] Klonējiet darba aģentu pirms lielas personas vai uzaicinājuma pārrakstīšanas. Ja jaunais ja virziens neizdodas, oriģināls joprojām ir tikai vienas atsaukšanas attālumā.

Strukturētais “G3” uzvednes teksts

Vietā viena brīvteksta sistēmas uzvednes, AiHummer izmanto strukturēts aģenta profils (iekšēji “G3”). Identitāte ir sadalīts laukos nevis aprakti prozā, un pārējā uzvedne ir veidota no nosauktajiem sadaļas plus un ievadapmācība bloks. Orķestrators pārvērš tos slāņotajā sistēmas uzvednē, saglabājot stabilās daļas (identitāte, personība, sadaļas) kešojamā prefiksā un beigās pievienojot mainīgos datus.

Struktūra padara profilu viegli rediģējamu laukā pa laukam, viegli salīdzināmu starp versijām un paredzamu renderēšanai — nav nekādas slēptās uzvednes zupas.

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

Pašrediģēšana aiz apstiprināšanas barjeras

Aģentam var būt atļauts rediģēt savu profilu izmantojot pašrediģēšanas rīkus — piemēram, lai uzlabotu sadaļu vai atjauninātu tās ievadapmācību. Tas ir apzināti aizsargāts:

  • Pašrediģējumi tiek izieti cauri apstiprināšanas vārti: ierosinātā izmaiņa tiek ierakstīta un jābūt apstiprinātam cilvēka, pirms tas stājas spēkā. Noraidīta izmaiņa nekad piemērots.
  • Izmaiņas tiek fiksētas kā jaunas versija, tāpēc pašrediģēšana ir tikpat pārbaudāma un atgriezenisks kā jebkura manuāla rediģēšana.

[!WARNING] Pašrediģēšana ir spēcīga. Glabājiet to aiz apstiprināšanas barjeras, lai aģents nevarētu klusībā pārraksta savu identitāti. Pārskati ieteiktās pašrediģēšanas tāpat kā tu pārskatīt jebkādas privilēģētās izmaiņas.

Pasta paroles tiek glabātas seifā

Ja aģenta konfigurācijā ir iekļauti pasta akreditācijas dati (lai mail rīks), parole tiek ierakstīta uz šifrēta akreditācijas glabātuve, netiek glabāti profilā vai attēloti uzvednē. Noslēpumi nekad neiet modela kontekstā.

Administratora API

Aģenti un viņu strukturētie profili tiek pārvaldīti caur admin API, kas ir OIDC aizsargāts un uzraudzīts:

Resursi Mērķis
/v1/admin/agents Sarakstīt, izveidot, atjaunināt, dzēst aģentus (CRUD)
/v1/admin/agents/.../profile Strukturētais G3 profils (identitātes lauki)
/v1/admin/agents/.../sections Nosauktās uzvednes sadaļas
/v1/admin/agents/.../skills Katram aģentam prasmes
/v1/admin/agents/.../versions Versijas vēsture, atcelšana un klonēšana

Kur uz nākamo