Агенттер мен тұлғалар — AiHummer Құжаттама

Бір агент AiHummer әңгіменің алдында қоятын бөлім болып табылады. Әр агентте өзінің жеке тұлғасы, жеке моделі, құрылымдық сұрауышы және дағдылар жинағы бар, және оған жасалған әрбір өзгеріс нұсқаланған. Агенттер веб әкімші UI арқылы және әкімші 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`	Нұсқалар тарихы, кері қайтару және клондау

Келесі қайда

Агенттер қалай кезекті жүргізетінін және көмекшілерді қалай шығаратындығын түсініңіз Оркестрлеу және қосалқы агенттер.
Көріңіз, қалай кіріп жатқан хабар белгілі бір агентке жетеді Маршрутизация.
Агенттеріңізге ұзақ мерзімді есте сақтау қабілетін беріңіз Естелік (Эйнштейн).