AiHummer
Հայերեն
Մուտք
v1.0.x
{ }Swagger

Գործակալներ և անձնավորություններ

v1.0.x · թարմացվել է 2026-06-26

Գործակալը այն միավորն է, որը AiHummer-ը դնում է զրույցի դիմաց: Յուրաքանչյուր գործակալ ունի անձնավորություն, սեփական մոդել, կառուցվածքային հուշում և հմտությունների հավաքածու, և նրա հանդեպ կատարված ամեն փոփոխություն տարբերակվում է: Գործակալները կառավարվում են վեբ ադմին UI-ից և ադմին API-ի միջոցով /v1/admin/agents/* հասցեի ներքո:

Այս էջը նկարագրում է, թե ինչից է կազմված գործակալը, ինչպես է հավաքվում կառուցվածքային «G3» հուշումը և ինչպես կարող է գործակալն ապահով խմբագրել իր սեփական պրոֆիլը:

Գործակալների ռեգիստրը

Ռեգիստրը գործակալների ամբողջական CRUD կատալոգ է: Յուրաքանչյուր գործակալի համար դուք սահմանում եք ինքնություն, անձնավորություն, այն մոդելը, որի վրա այն աշխատում է, և այն հմտությունները, որ կարող է օգտագործել: Քանի որ gateway-ը բազմավարձակալ է, գործակալները ապրում են աշխատանքային տարածքի ներսում և մեկուսացված են ինչպես ցանկացած այլ վարձակալի տվյալ:

  • Անձնավորություն — գործակալի ձայնն ու վարքագիծը, որը վերածվում է կայուն, քեշավորման համար հարմար շերտի՝ համակարգային հուշման մեջ:
  • Յուրաքանչյուր գործակալի մոդել — յուրաքանչյուր գործակալ կարող է ամրացնել իր սեփական մոդելն ու մատակարարին, այնպես որ էժան գործակալը և դրոշակակիր գործակալը կարող են համատեղ գոյակցել նույն աշխատանքային տարածքում:
  • Հմտություններ — յուրաքանչյուր գործակալի և համատեղ հմտությունները հուշման մեջ վերածում են «Հմտություններ» բլոկի. դրանք նկարագրում են հնարավորությունները, ոչ թե կշիռները:

[!NOTE] Յուրաքանչյուր գործակալի մոդելը անկախ է երթուղավորումից: Մոդելի մակարդակի երթուղավորումը (պարզ / ստանդարտ / բարդ) ընտրում է մոդելի դաս մեկ քայլի համար, մինչդեռ յուրաքանչյուր գործակալի մոդելը գործակալի սեփական լռելյայն մոդելն է: Տես Երթուղավորում:

Տարբերակներ, հետադարձ և կլոնավորում

Գործակալի ամեն իմաստալից փոփոխություն գրանցվում է որպես տարբերակ: Սա դարձնում է գործակալի կազմաձևումը աուդիտի ենթակա և շրջելի. դուք կարող եք վերանայել, թե ինչ է փոխվել, հետ գլորել ավելի վաղ տարբերակի, կամ կլոնավորել գործակալը՝ այն օգտագործելու որպես նորի ելակետ: Տարբերակի և պրոֆիլի ռեսուրսները ապրում են /v1/admin/agents/* հասցեի ներքո (profile, sections, skills, versions):

[!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 Տարբերակների պատմություն, հետադարձ և կլոնավորում

Ո՞ւր հաջորդիվ