AiHummer
Dansk
Log indKonto
v1.2.x
{ }Swagger

Agenter og personaer

v1.2.x · opdateret 2026-06-26

En agent er enheden, som AiHummer sætter foran en samtale. Hver agent har en persona, sin egen model, en struktureret prompt og et sæt færdigheder, og hver ændring til den versionsstyres. Agenter administreres fra web-admin-UI’et og gennem admin-API’en under /v1/admin/agents/*.

Denne side dækker, hvad en agent består af, hvordan den strukturerede “G3”-prompt sammensættes, og hvordan en agent sikkert kan redigere sin egen profil.

Agentregistret

Registeret er et fuldt CRUD-katalog over agenter. For hver agent definerer du en identitet, en persona, den model, den kører på, og de færdigheder, den kan bruge. Fordi gatewayen er multitenant, lever agenter inden for et arbejdsområde og er isoleret som enhver anden lejerdata.

  • Persona — agentens stemme og adfærd, gengivet i en stald, cache-venligt lag af systemprompten.
  • Per-agent model — hver agent kan fastgøre sin egen model og udbyder, så en En billig agent og en flagskibsagent kan sameksistere i det samme arbejdsområde.
  • Færdigheder — per-agent og delte færdigheder gengiver en “Færdigheder”-blok i prompt; de beskriver kapaciteter, ikke vægte.

[!NOTE] En per-agent model er uafhængig af routing. Model-lag routing (simpel / standard / kompleks) vælger en modelklasse for en tur, mens den pr. agent modellen er agentens egen standard. Se Routing.

Versioner, tilbageførsel og klon

Hver meningsfuld ændring af en agent registreres som en version. Dette gør agentkonfigurationen reviderbar og omvendelig: du kan gennemse, hvad der blev ændret, rulle tilbage til en tidligere version, eller klon en agent til at bruge det som udgangspunkt for en ny. Version- og profileressourcer findes under /v1/admin/agents/* (profil, sektioner, færdigheder, versioner).

[!TIP] Klon en fungerende agent før en stor persona- eller prompt-omskrivning. Hvis den nye hvis retningen ikke lykkes, er originalen stadig en tilbageførsel væk.

Den strukturerede “G3” prompt

I stedet for et enkelt frit tekstsystemprompt bruger AiHummer en struktureret agentprofil (internt “G3”). Identiteten er opdelt i felter snarere end begravet i prosa, og resten af prompten er bygget op af navngivne sektioner plus en introduktion blok. Orkestratoren gengiver disse i den lagdelte systemprompt, idet de stabile dele (identitet, persona, sektioner) holdes i et cachebart præfiks og de flygtige data tilføjes til sidst.

Strukturen gør det nemt at redigere en profil felt for felt, nemt at sammenligne mellem versioner og forudsigelig at gengive — der er ingen skjult prompt-suppe.

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

Selvredigering bag en godkendelsesport

En agent kan få lov til at redigere sin egen profil at bruge selvredigeringsværktøjer — for eksempel til at forfine en sektion eller opdatere dens onboarding. Dette er bevidst beskyttet:

  • Selvredigeringer går gennem godkendelsesport: en foreslået ændring registreres og skal godkendes af et menneske, før det træder i kraft. En afvist ændring er aldrig anvendt.
  • Ændringen registreres som en ny version, så en selvredigering er lige så reviderbar og lige så reversibel som enhver manuel redigering.

[!WARNING] Selvredigering er kraftfuld. Hold det bag godkendelsesporten, så en agent ikke kan stille omskrive sin egen identitet. Gennemgå foreslåede selvediteringer på samme måde, som du gennemgå enhver privilegeret ændring.

Mailadgangskoder går til hvelvet

Hvis en agents konfiguration inkluderer maillegitimationsoplysninger (for mail værktøj), adgangskoden bliver skrevet til krypteret legitimationsopbevaring, ikke gemt i profilen eller indsat i prompten. Hemmeligheder kommer aldrig ind i modelkonteksten.

Admin-API

Agenter og deres strukturerede profiler administreres under admin-API’en, som er OIDC-beskyttet og revideret:

Ressource Formål
/v1/admin/agents Liste, opret, opdater, slet agenter (CRUD)
/v1/admin/agents/.../profile Den strukturerede G3-profil (identitetsfelter)
/v1/admin/agents/.../sections Navngivne promptsektioner
/v1/admin/agents/.../skills Færdigheder pr. agent
/v1/admin/agents/.../versions Versionshistorik, tilbagetrækning og klon

Hvor til næste