Agenter och personas

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

En **agent** är enheten som AiHummer sätter framför en konversation. Varje agent har en persona, sin egen modell, en strukturerad prompt och en uppsättning färdigheter, och varje ändring av den versionshanteras. Agenter hanteras från webbadministrationsgränssnittet och genom administrations-API:et under `/v1/admin/agents/*`. Denna sida behandlar vad en agent består av, hur den strukturerade "G3"-prompten sätts ihop, och hur en agent säkert kan redigera sin egen profil. ## Agentregistret Registret är en fullständig CRUD-katalog över agenter. För varje agent definierar du en identitet, en persona, modellen den körs på och de färdigheter den kan använda. Eftersom gatewayen är multitenant, lever agenterna inom ett arbetsområde och är isolerade som vilken annan tenant-data som helst. - **Persona** — agentens röst och beteende, återgivna i en stall, cache-vänligt lager av systemprompten. - **Per-agentmodell** — varje agent kan spika sin egen modell och leverantör, så en En billig agent och en flaggskeppsagent kan samexistera i samma arbetsyta. - **Färdigheter** — per-agent och delade färdigheter renderar en "Färdigheter"-block till prompt; de beskriver kapaciteter, inte vikter. > [!NOTE] > En per-agent modell är oberoende av routing. Modell-nivå routing (enkel / > standard / komplex) väljer en modellklass för en tur, medan per-agent > modellen är agentens egen standard. Se > [Routing](/sv/v1.0/concepts/routing). ## Versioner, återställning och kloning Varje meningsfull förändring av en agent fångas som en **version**. Detta gör agentkonfigurationen granskbar och omvändbar: du kan se vad som har ändrats, **återställa** till en tidigare version, eller **klon** en agent att använda det som utgångspunkt för en ny. Versions- och profileresurser finns under `/v1/admin/agents/*` (profil, sektioner, färdigheter, versioner). > [!TIP] > Klon en fungerande agent innan en stor personlighets- eller promptomskrivning. Om den nya > om riktningen inte fungerar, är originalet fortfarande ett återställningssteg bort. ## Den strukturerade "G3"-uppmaningen Istället för en enda fritextsystemuppmaning använder AiHummer en **strukturerad agentprofil** (internt "G3"). Identiteten är **uppdelad i fält** snarare än begravd i prosa, och resten av uppmaningen är byggd från namngivna **avsnitt** plus en **introduktion** block. Orkestratorn renderar dessa i det lagerlade systempromptet, och behåller de stabila delarna (identitet, persona, sektioner) i ett cachbart prefix och lägger till flyktig data sist. Strukturen gör att en profil är lätt att redigera fält för fält, lätt att jämföra mellan versioner och förutsägbar att återge — det finns ingen dold prompt-soppa. ```text G3 profile ├── identity fields (decomposed: name, role, ...) ├── sections (named, ordered prompt blocks) └── onboarding (first-run guidance) ``` ## Självredigering bakom en godkännandespärr En agent kan tillåtas att **redigera sin egen profil** använda självredigeringsverktyg — till exempel för att förbättra en sektion eller uppdatera dess introduktion. Detta är medvetet skyddat: - Självredigeringar går igenom **godkännandekontroll**: en föreslagen ändring registreras och måste godkännas av en människa innan det träder i kraft. En avvisad ändring är aldrig tillämpad. - Förändringen registreras som en ny **version**, så en självredigering är lika granskbar och omvändbar som vilken manuell redigering som helst. > [!WARNING] > Självredigering är kraftfullt. Håll det bakom godkännandegrinden så att en agent inte kan > tyst omskriver sin egen identitet. Granska föreslagna självediteringar på samma sätt som du > granska alla privilegierade ändringar. ### E-postlösenord går till valvet Om en agents konfiguration inkluderar e-postuppgifter (för `mail` verktyg), lösenordet skrivs till **krypterad behörighetsvalv**, inte lagrat i profilen eller renderat i prompten. Hemligheter kommer aldrig in i modellens kontext. ## Admin-API Agenter och deras strukturerade profiler hanteras under admin-API:t, som är OIDC-skyddat och granskats: | Resurs | Syfte | |---|---| | `/v1/admin/agents` | Lista, skapa, uppdatera, ta bort agenter (CRUD) | | `/v1/admin/agents/.../profile` | Den strukturerade G3-profilen (identitetsfält) | | `/v1/admin/agents/.../sections` | Namngivna uppmaningsavsnitt | | `/v1/admin/agents/.../skills` | Färdigheter per agent | | `/v1/admin/agents/.../versions` | Versionshistorik, återställning och kloning | ## Vart härnäst - Förstå hur agenter kör en tur och skapar hjälpare i [Orkestrering och underagenter](/sv/v1.0/concepts/orchestration-subagents). - Se hur ett inkommande meddelande når en specifik agent i [Routing](/sv/v1.0/concepts/routing). - Ge dina agenter långtidsminne med [Minne (Einstein)](/sv/v1.0/concepts/memory-einstein).