Агенты і персоны — AiHummer Дакументацыя

Адзін агент гэта адзінка, якую AiHummer ставіць перад размовай. Кожны агент мае сваю асобу, уласную мадэль, структураваны падказак і набор навыкаў, а кожная змена ў яе версіруецца. Агентамі кіруюць з вэб-інтэрфейсу адміністратара і праз адміністрацыйны API па /v1/admin/agents/*.

Гэтая старонка апісвае, з чаго складаецца агент, як збіраецца структураваны запыт “G3” і як агент можа бяспечна рэдагаваць свой уласны профіль.

Рэгістр агентаў

Рэгістр з’яўляецца поўным CRUD-каталогам агентаў. Для кожнага агента вызначаецца яго ідэнтычнасць, персона, мадэль, на якой ён працуе, і навыкі, якія можа выкарыстоўваць. Паколькі шлюз падтрымлівае колькасць карыстальнікаў, агенты знаходзяцца ў рабочай прасторы і ізаляваныя, як і любыя іншыя дадзеныя арандатара.

Асоба — голас і паводзіны агента, перанесеныя на стабільную, кэш-аптымізаваны пласт сістэмнага падказкі
Мадэль на агента — кожны агент можа замацаваць у сябе ўласную мадэль і пастаўшчыка, так што a Дэшывы агент і галоўны агент могуць суіснаваць у адным працоўным асяроддзі.
Навыкі — навыкі, якія характэрныя для канкрэтнага агента або агульныя, ператвараюць блок «Навыкі» ў падказка; яны апісваюць магчымасці, а не вагу.

[!NOTE] Мадэль на агента незалежная ад маршрутызацыі. Маршрутызацыя ўзроўню мадэлі (простая / стандартны / складанны) выбірае клас мадэлі для ходу, у той час як кожны агент мадэль з’яўляецца стандартнай па змаўчанні для агента. Глядзі Маршрутызацыя.

Версіі, адкат і клон

Кожная значная змена агента зафіксавана як версіяГэта робіць канфігурацыю агента правяраемай і адкатвальнай: вы можаце праглядзець, што змянілася, адкат да ранейшай версіі, або клон агент выкарыстоўвае яго як адпраўную кропку для новага. Рэсурсы версій і профіляў знаходзяцца пад /v1/admin/agents/* (профіль, раздзелы, навыкі, версіі)

[!TIP] Кланіруйце працоўнага агента перад вялікай асобай або перапісваннем падказкі. Калі новы калі кірунак не спраўдзіцца, арыгінал усё яшчэ ў адным адкатным кроку.

Структураваны запыт “G3”

Замест аднаго сістэмнага запыту ў выглядзе свабоднага тэксту, AiHummer выкарыстоўвае структураваны профіль агента (унутрана “G3”). Ідэнтычнасць разлажаны на палі але не пахавана ў прозе, а астатняя частка падказкі пабудавана на імёнах сакцыі плюс адзін ўвядзенне ў пасаду блок. Аркестратар пераўтварае іх у шматслаёвую сістэмную падказку, захоўваючы стабільныя часткі (ідэнтычнасць, персону, раздзелы) у кэшуючымя прэфіксе і дадаючы нестабільныя даныя ў канцы.

Структура робіць прафіль лёгка рэдагуемым па палях, лёгка параўноўваць версіі і прадказальна адлюстроўвацца — няма схаванага набору падказак.

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

Самарэдагаванне за варотамі зацвярджэння

Агенту можа быць дазволена рэдагаваць уласны профіль выкарыстанне інструментаў самарэдагавання — напрыклад, каб удасканаліць раздзел або абнавіць яго ўводзіны. Гэта наўмысна абаронена:

Самарэдагаванні праходзяць праз брамка зацвярджэння: прапанаваная змена зафіксаваная і павінен быць зацверджаны чалавекам перад уступленнем у сілу. Адхіленая змена ніколі не прымянілі.
Змена зафіксавана як новая версія, таму самарэдагаванне таксама падлягае аўдыту і аднаўляльны як любое ручное рэдагаванне.

[!WARNING] Самарэдагаванне магутнае. Трымайце яго за межамі дзвярэй зацвярджэння, каб агент не мог ціха перапісвае ўласную ідэнтычнасць. Разгледзьце прапанаваныя самарэдагаванні гэтак жа, як і вы праверыць любыя прывілеяваныя змены

Паролі ад пошты ідуць у сховішча

Калі канфігурацыя агента ўключае паштовыя ўліковыя дадзеныя (для mail інструмент), пароль запісваецца ў зашыфраваны сейф з уліковымі дадзенымі, не захоўваецца ў профілі і не ўключаецца ў падказку. Сакрэты ніколі не трапляюць у кантэкст мадэлі.

API адміністратара

Агенты і іх структурыраваныя профілі кіруюцца праз адміністрацыйны API, які абаронены OIDC і падлягае аўдыту:

Рэсурс	Мэта
`/v1/admin/agents`	Спіс, стварэнне, абнаўленне, выдаленне агентаў (CRUD)
`/v1/admin/agents/.../profile`	Структураваны профіль G3 (палі ідэнтычнасці)
`/v1/admin/agents/.../sections`	Названыя раздзелы падказкі
`/v1/admin/agents/.../skills`	Навыкі кожнага агента
`/v1/admin/agents/.../versions`	Гісторыя версій, адкат і кланаванне

Куды далей

Зразумейце, як агенты праводзяць ход і выклікаюць памагатых Аркестрацыя і суб-агенты.
Паглядзіце, як уваходнае паведамленне даходзіць да канкрэтнага агента ў Маршрутызацыя.
Дайце сваім агентам доўгатэрміновую памяць з Памяць (Эйнштэйн).