AiHummer
ქართული
შესვლაპირადი კაბინეტი
v1.0.x
{ }Swagger

აგენტები და პირები

v1.0.x · განახლდა 2026-06-26

ერთი აგენტი ეს ერთეულია, რომელსაც 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 ვერსიების ისტორია, უკან დაბრუნება და კლონირება

სად შემდეგ?