Agentit ja henkilöhahmot

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

Yksi **agentti** on yksikkö, jonka AiHummer asettaa keskustelun eteen. Jokaisella agentilla on persoona, oma malli, strukturoitu kehotus ja joukko taitoja, ja kaikki siihen tehtävät muutokset versioidaan. Agenteja hallitaan verkkohallintaliittymän kautta ja hallinta-API:n kautta osoitteessa `/v1/admin/agents/*`. Tämä sivu käsittelee, mistä agentti koostuu, miten rakenteellinen "G3"-kehotus kootaan ja miten agentti voi turvallisesti muokata omaa profiiliaan. ## Agenttirekisteri Rekisteri on täydellinen CRUD-katalogi agenteista. Jokaiselle agentille määritellään identiteetti, persoonallisuus, malli, jolla se toimii, ja taidot, joita se voi käyttää. Koska portti on monivuokralaisratkaisu, agentit sijaitsevat työtilassa ja ne on eristetty kuten kaikki muutkin vuokralaisaineistot. - **Persoona** — agentin ääni ja käytös, muunnettuna talliksi, välimuistille ystävällinen kerros järjestelmän kehotteessa. - **Agenttikohtainen malli** — jokainen agentti voi kiinnittää oman mallinsa ja tarjoajansa, joten Halpa agentti ja lippulaiva-agentti voivat olla samassa työtilassa. - **Taidot** — agenttikohtaiset ja jaetut taidot muuttavat "Taidot"-lohkon muotoon kehotus; ne kuvaavat kykyjä, eivät painoja. > [!NOTE] > Yksittäinen agenttimalli on riippumaton reitityksestä. Mallitasoinen reititys (yksinkertainen / > standardi / monimutkainen) valitsee malliluokan kierrokselle, kun taas yksittäinen agentti > malli on agentin oma oletus. Katso > [Reititys](/fi/v1.0/concepts/routing). ## Versiot, palautus ja kloonaus Jokainen merkityksellinen muutos agenttiin tallennetaan muodossa **versio**. Tämä tekee agentin määrityksestä tarkastettavan ja palautettavan: voit tarkastella, mitä on muuttunut, **peruuta** aiempaan versioon, tai **klooni** agentti käyttää sitä uuden luomisen lähtökohtana. Versio- ja profiiliresurssit sijaitsevat alla `/v1/admin/agents/*` (profiili, osiot, taidot, versiot). > [!TIP] > Kloonaa toimiva agentti ennen suurta persoona- tai kehotteen uudelleenkirjoitusta. Jos uusi > jos suunta ei pidäkään paikkaansa, alkuperäinen on silti yhden palautuksen päässä. ## Rakenteellinen "G3"-kehote Yhden vapaatekstijärjestelmän kehotteen sijasta, AiHummer käyttää **jäsennelty agenttiprofiili** (sisäisesti "G3"). Henkilöllisyys on **pilkkoutunut kenttiin** sen sijaan että se olisi haudattu proosaan, ja loput kehotteesta on rakennettu nimetyistä **osiot** plus yksi **perehdyttäminen** lohko. Orkestroija muuntaa nämä kerrokselliseksi järjestelmäkehotteeksi, pitäen vakaat osat (identiteetti, persoona, osiot) välimuistiin tallennettavassa etuliitteessä ja lisäämällä muuttuvat tiedot viimeiseksi. Rakenne tekee profiilin muokkaamisesta kenttä kerrallaan helppoa, version välisten erojen tarkastelusta yksinkertaista ja renderöinnistä ennustettavaa — piilotettua keittokirjamaisia kehotteita ei ole. ```text G3 profile ├── identity fields (decomposed: name, role, ...) ├── sections (named, ordered prompt blocks) └── onboarding (first-run guidance) ``` ## Itsensä muokkaaminen hyväksyntäportin takana Asiakasta voidaan sallia **muokata omaa profiiliaan** käyttämällä itsekorjaustyökaluja — esimerkiksi osion hienosäätämiseksi tai sen perehdytyksen päivittämiseksi. Tämä on tarkoituksella suojattu: - Itse tehdyt muokkaukset käyvät läpi **hyväksyntäportti**: ehdotettu muutos kirjataan ja on hyväksyttävä ihmiseltä ennen kuin se tulee voimaan. Hylätty muutos ei koskaan sovellettiin. - Muutos tallennetaan uutena **versio**, joten itse muokkaus on yhtä tarkastettavissa ja peruutettavissa kuten mikä tahansa manuaalinen muokkaus. > [!WARNING] > Itseeditointi on voimakasta. Pidä se hyväksyntäportin takana, jotta agentti ei voi > uudelleenkirjoittaa hiljaisesti omaa identiteettiään. Tarkastele ehdotettuja itse-editsauksia samalla tavalla kuin sinä > tarkistaa kaikki etuoikeutetut muutokset. ### Sähköpostin salasanat menevät holviin Jos agentin asetuksiin sisältyy sähköpostitunnuksia (`mail`-työkalua varten), salasana kirjoitetaan **salattu tunnistetietovarasto**, ei tallenneta profiiliin eikä lisätä kehotteeseen. Salaisuudet eivät koskaan päädy mallin kontekstiin. ## Ylläpitäjän API Agentteja ja heidän rakenteellisia profiilejaan hallinnoidaan admin-API:n kautta, joka on OIDC-suojattu ja tarkastettu: | Resurssi | Tarkoitus | |---|---| | `/v1/admin/agents` | Listaa, luo, päivitä, poista agentteja (CRUD) | | `/v1/admin/agents/.../profile` | Rakenteellinen G3-profiili (identiteettikentät) | | `/v1/admin/agents/.../sections` | Nimetyt kehotteen osiot | | `/v1/admin/agents/.../skills` | Agenttikohtaiset taidot | | `/v1/admin/agents/.../versions` | Versiohistoria, palautus ja kloonaus | ## Minne seuraavaksi - Ymmärrä, miten agentit suorittavat vuoron ja luovat avustajia [Orkestrointi ja aliedustajat](/fi/v1.0/concepts/orchestration-subagents). - Katso, kuinka saapuva viesti saavuttaa tietyn agentin kohteessa [Reititys](/fi/v1.0/concepts/routing). - Anna agenteillesi pitkäkestoinen muisti [Muisti (Einstein)](/fi/v1.0/concepts/memory-einstein).