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

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

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

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

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

Персона — голас і паводзіны агента, адлюстраваныя ў стабільны, спрыяльны для кэшавання слой сістэмнага промпта.
Мадэль на кожнага агента — кожны агент можа замацаваць уласную мадэль і правайдара, так што танны агент і флагманскі агент могуць суіснаваць у адной працоўнай прасторы.
Навыкі — навыкі агента і агульныя навыкі ствараюць блок “Навыкі” ў промпце; яны апісваюць здольнасці, а не вагі.

[!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`	Гісторыя версій, адкат і кланаванне

Куды далей

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