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

G3 profile
├── identity fields   (decomposed: name, role, ...)
├── sections          (named, ordered prompt blocks)
└── onboarding        (first-run guidance)

**აგენტი** არის ის ერთეული, რომელსაც AiHummer აყენებს საუბრის წინ. თითოეულ აგენტს აქვს პერსონა, საკუთარი მოდელი, სტრუქტურირებული პრომპტი და უნარების ნაკრები, და მისი ყოველი ცვლილება ვერსიფიცირებულია. აგენტებს მართავთ ვებ ადმინ UI-დან და ადმინ API-ის გავლით `/v1/admin/agents/*`-ის ქვეშ. ეს გვერდი ფარავს იმას, რისგან შედგება აგენტი, როგორ აიწყობა სტრუქტურირებული "G3" პრომპტი და როგორ შეუძლია აგენტს უსაფრთხოდ დაარედაქტიროს საკუთარი პროფილი. ## აგენტების რეესტრი რეესტრი არის აგენტების სრული CRUD კატალოგი. თითოეული აგენტისთვის თქვენ განსაზღვრავთ იდენტობას, პერსონას, მოდელს, რომელზეც ის მუშაობს, და უნარებს, რომელთა გამოყენებაც მას შეუძლია. რადგან gateway მრავალმოიჯარეა (multitenant), აგენტები ცხოვრობენ სამუშაო სივრცის (workspace) შიგნით და იზოლირებულნი არიან ისე, როგორც ნებისმიერი სხვა მოიჯარის მონაცემები. - **პერსონა** — აგენტის ხმა და ქცევა, რომელიც გადატანილია სისტემური პრომპტის სტაბილურ, ქეშისთვის ხელსაყრელ ფენაში. - **თითო აგენტზე მოდელი** — თითოეულ აგენტს შეუძლია მიამაგროს საკუთარი მოდელი და პროვაიდერი, ასე რომ იაფი აგენტი და ფლაგმანური აგენტი შეიძლება თანაარსებობდნენ ერთსა და იმავე სამუშაო სივრცეში. - **უნარები** — თითო აგენტზე და გაზიარებული უნარები ასახავენ "უნარების" ბლოკს პრომპტში; ისინი აღწერენ შესაძლებლობებს, არა წონებს. > [!NOTE] > თითო აგენტზე მოდელი დამოუკიდებელია მარშრუტიზაციისგან. მოდელის დონის > მარშრუტიზაცია (მარტივი / სტანდარტული / რთული) ირჩევს მოდელის კლასს ერთი > სვლისთვის, ხოლო თითო აგენტზე მოდელი არის აგენტის საკუთარი ნაგულისხმევი. იხ. > [მარშრუტიზაცია](/ka/v1.0/concepts/routing). ## ვერსიები, უკან დაბრუნება და კლონირება აგენტში ყოველი მნიშვნელოვანი ცვლილება ფიქსირდება როგორც **ვერსია**. ეს ხდის აგენტის კონფიგურაციას აუდიტირებადს და შექცევადს: შეგიძლიათ გადახედოთ რა შეიცვალა, **დაბრუნდეთ უკან** ადრინდელ ვერსიაზე, ან **დააკლონოთ** აგენტი ახლისთვის საწყის წერტილად. ვერსიისა და პროფილის რესურსები ცხოვრობენ `/v1/admin/agents/*`-ის ქვეშ (profile, sections, skills, versions). > [!TIP] > დააკლონეთ მუშა აგენტი ვიდრე დიდ პერსონის ან პრომპტის გადაწერას შეუდგებით. თუ > ახალი მიმართულება არ გამოვა, ორიგინალი ჯერ კიდევ ერთი უკან დაბრუნების მანძილზეა. ## სტრუქტურირებული "G3" პრომპტი ერთიანი თავისუფალი ტექსტის სისტემური პრომპტის ნაცვლად, AiHummer იყენებს **სტრუქტურირებულ აგენტის პროფილს** (შიდად "G3"). იდენტობა **იშლება ველებად**, ნაცვლად იმისა, რომ პროზაში დაიფაროს, ხოლო პრომპტის დანარჩენი ნაწილი აიწყობა დასახელებული **სექციებისგან** პლუს **ონბორდინგის** ბლოკისგან. ორკესტრატორი ასახავს მათ ფენოვან სისტემურ პრომპტში, ინახავს სტაბილურ ნაწილებს (იდენტობა, პერსონა, სექციები) ქეშირებად პრეფიქსში და ცვალებად მონაცემებს ბოლოს ამატებს. სტრუქტურა ხდის პროფილს ადვილ რედაქტირებადს ველ-ველად, ადვილ შესადარებლად ვერსიებს შორის და პროგნოზირებადს ასახვისთვის — არ არსებობს დაფარული პრომპტ-ნახარში. ```text 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` | ვერსიების ისტორია, უკან დაბრუნება და კლონირება | ## სად შემდეგ - გაიგეთ, როგორ ასრულებენ აგენტები სვლას და ქმნიან დამხმარეებს [ორკესტრაცია და ქვე-აგენტებში](/ka/v1.0/concepts/orchestration-subagents). - ნახეთ, როგორ აღწევს შემომავალი შეტყობინება კონკრეტულ აგენტამდე [მარშრუტიზაციაში](/ka/v1.0/concepts/routing). - მიეცით თქვენს აგენტებს გრძელვადიანი მეხსიერება [მეხსიერებით (Einstein)](/ka/v1.0/concepts/memory-einstein).