AiHummer
Қазақша
Кіру
v1.0.x
{ }Swagger

Агенттер және персоналар

v1.0.x · жаңартылды 2026-06-26

Агент — AiHummer сөйлесудің алдына қоятын бірлік. Әр агентте персона, өз моделі, құрылымды промпт және дағдылар жиынтығы бар, әрі оған енгізілген әрбір өзгеріс нұсқаланады. Агенттер веб-админ UI-ден және /v1/admin/agents/* астындағы админ API арқылы басқарылады.

Бұл бет агенттің неден тұратынын, құрылымды «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

Агенттер мен олардың құрылымды профильдері OIDC-қорғалған әрі аудиттелетін админ API астында басқарылады:

Ресурс Мақсаты
/v1/admin/agents Агенттерді тізімдеу, құру, жаңарту, жою (CRUD)
/v1/admin/agents/.../profile Құрылымды G3 профилі (сәйкестік өрістері)
/v1/admin/agents/.../sections Аталған промпт бөлімдері
/v1/admin/agents/.../skills Әр агентке арналған дағдылар
/v1/admin/agents/.../versions Нұсқалар тарихы, қайтару және клондау

Әрі қарай қайда

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