Agentlar va personalar

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

**Agent** — bu AiHummer suhbat oldiga qoʻyadigan asosiy birlik. Har bir agentning oʻz personasi, oʻz modeli, tarkibiy prompti va koʻnikmalar toʻplami boʻladi va unga kiritilgan har bir oʻzgarish versiyalanadi. Agentlar veb-admin UI orqali hamda `/v1/admin/agents/*` ostidagi admin API orqali boshqariladi. Bu sahifa agent nimalardan tashkil topganini, tarkibiy "G3" prompti qanday yigʻilishini va agent oʻz profilini qanday qilib xavfsiz tahrir qila olishini koʻrib chiqadi. ## Agentlar reestri Reestr — bu agentlarning toʻliq CRUD katalogi. Har bir agent uchun siz uning identifikatsiyasini, personasini, ishlaydigan modelini va foydalana oladigan koʻnikmalarini belgilaysiz. Gateway koʻp-ijarali (multitenant) boʻlgani uchun agentlar ish maydoni (workspace) ichida yashaydi va boshqa har qanday ijarachi maʼlumotlari kabi izolyatsiya qilinadi. - **Persona** — agentning ovozi va xulqi, tizim promptining barqaror, kesh uchun qulay qatlamiga aylantiriladi. - **Har bir agent uchun model** — har bir agent oʻz modeli va provayderini qotirib qoʻyishi mumkin, shu bois arzon agent va flagman agent bitta ish maydonida birga yashashi mumkin. - **Koʻnikmalar** — har bir agentga xos va umumiy koʻnikmalar promptga "Skills" blokini chiqaradi; ular qobiliyatlarni tavsiflaydi, vaznlarni emas. > [!NOTE] > Har bir agent uchun model marshrutlashdan mustaqil. Model-darajasi > marshrutlashi (oddiy / standart / murakkab) bitta nubat (turn) uchun model > sinfini tanlaydi, har bir agent uchun model esa agentning oʻz standartidir. > [Marshrutlash](/uz/v1.0/concepts/routing) sahifasiga qarang. ## Versiyalar, orqaga qaytarish va klonlash Agentga kiritilgan har bir muhim oʻzgarish **versiya** sifatida qayd etiladi. Bu agent konfiguratsiyasini auditga yaroqli va orqaga qaytariladigan qiladi: nima oʻzgarganini koʻrib chiqishingiz, oldingi versiyaga **orqaga qaytarishingiz**, yoki agentni **klonlab**, uni yangi agent uchun boshlangʻich nuqta sifatida ishlatishingiz mumkin. Versiya va profil resurslari `/v1/admin/agents/*` ostida joylashgan (profil, boʻlimlar, koʻnikmalar, versiyalar). > [!TIP] > Katta persona yoki prompt qayta yozishdan oldin ishlayotgan agentni klonlang. > Agar yangi yoʻnalish oqlanmasa, asl nusxa hamon bitta orqaga qaytarish > masofasida boʻladi. ## Tarkibiy "G3" prompti Bitta erkin matnli tizim prompti oʻrniga AiHummer **tarkibiy agent profilidan** (ichki nomi "G3") foydalanadi. Identifikatsiya nasr ichida koʻmilgan emas, balki **maydonlarga ajratilgan**, promptning qolgan qismi esa nomlangan **boʻlimlar**dan hamda **onboarding** blokidan quriladi. Orkestrator bularni qatlamli tizim promptiga aylantirib, barqaror qismlarni (identifikatsiya, persona, boʻlimlar) keshlanadigan prefiksda saqlaydi va oʻzgaruvchan maʼlumotni oxirida qoʻshadi. Bu tuzilma profilni maydon-maydon tahrir qilishni osonlashtiradi, versiyalar oʻrtasida farqlashni osonlashtiradi va aylantirishni bashorat qilinadigan qiladi — hech qanday yashirin prompt sho'rvasi yoʻq. ```text G3 profile ├── identity fields (decomposed: name, role, ...) ├── sections (named, ordered prompt blocks) └── onboarding (first-run guidance) ``` ## Tasdiqlash darvozasi ortida oʻzini-tahrirlash Agentga oʻzini-tahrirlash vositalari yordamida **oʻz profilini tahrir qilish**ga ruxsat berilishi mumkin — masalan, biror boʻlimni takomillashtirish yoki oʻz onboardingini yangilash uchun. Bu ataylab himoyalangan: - Oʻzini-tahrirlashlar **tasdiqlash darvozasi**dan oʻtadi: taklif etilgan oʻzgarish qayd etiladi va kuchga kirishidan oldin inson tomonidan tasdiqlanishi shart. Rad etilgan oʻzgarish hech qachon qoʻllanmaydi. - Oʻzgarish yangi **versiya** sifatida qayd etiladi, shu bois oʻzini-tahrirlash har qanday qoʻlda tahrir kabi auditga yaroqli va orqaga qaytariladigandir. > [!WARNING] > Oʻzini-tahrirlash kuchli vositadir. Uni tasdiqlash darvozasi ortida saqlang, > shunda agent oʻz identifikatsiyasini sukut bilan qayta yoza olmaydi. Taklif > etilgan oʻzini-tahrirlashlarni har qanday imtiyozli oʻzgarishni koʻrib > chiqqaningiz kabi koʻrib chiqing. ### Pochta parollari xazinaga (vault) tushadi Agar agent konfiguratsiyasi pochta hisob maʼlumotlarini oʻz ichiga olsa (`mail` vositasi uchun), parol **shifrlangan hisob maʼlumotlari xazinasiga** yoziladi, profilda saqlanmaydi yoki promptga chiqarilmaydi. Sirlar hech qachon model kontekstiga kirmaydi. ## Admin API Agentlar va ularning tarkibiy profillari admin API ostida boshqariladi, u OIDC bilan himoyalangan va auditga olinadi: | Resurs | Maqsadi | |---|---| | `/v1/admin/agents` | Agentlarni roʻyxatlash, yaratish, yangilash, oʻchirish (CRUD) | | `/v1/admin/agents/.../profile` | Tarkibiy G3 profili (identifikatsiya maydonlari) | | `/v1/admin/agents/.../sections` | Nomlangan prompt boʻlimlari | | `/v1/admin/agents/.../skills` | Har bir agentga xos koʻnikmalar | | `/v1/admin/agents/.../versions` | Versiyalar tarixi, orqaga qaytarish va klonlash | ## Keyin qayerga - Agentlar nubatni qanday bajarishi va yordamchilarni qanday paydo qilishini [Orkestratsiya va sub-agentlar](/uz/v1.0/concepts/orchestration-subagents) sahifasida tushuning. - Kirayotgan xabar muayyan agentga qanday yetib borishini [Marshrutlash](/uz/v1.0/concepts/routing) sahifasida koʻring. - Agentlaringizga uzoq muddatli xotira bering: [Xotira (Einstein)](/uz/v1.0/concepts/memory-einstein).