Bilim / RAG

AIHUMMER_QDRANT_URL=http://localhost:6333
AIHUMMER_EMBEDDER_URL=http://localhost:8081

**Bilim** bu AiHummer javoblarni modelning o'quv ma'lumotlari o'rniga sizning hujjatlaringizga qanday asoslaydi. Siz mazmunni qabul qilasiz, agent esa tegishli parchalarni oladi `search_knowledge` asbob, va javoblar qaytadi **manbalarni keltirib**. Qiyinroq savollar uchun, `deep_research` asbob ko‘p bosqichli tekshiruvni amalga oshiradi va manbali hisobot tayyorlaydi. Bilim boshqariladi `/v1/admin/knowledge/*` va `/v1/admin/knowledge/connectors/*`. ## Kontentni qabul qilish Siz ichishingiz mumkin **hujjatlar, PDF fayllar va URL manzillar** bilim bazasiga. Qabul qilingan kontent indekslanadi, shunda u javob berish vaqtida olinishi va uning manbasiga qaytarilishi mumkin bo‘ladi. > [!TIP] > Hujjatning kanonik versiyasini bir marta qabul qiling va agentlarga uni iqtibos qilishlariga ruxsat bering, buning o‘rniga > uzun parchalarni so‘rovga yopishtirishdan ko‘ra. Iqtibos keltirish orqali olinishi javoblarni saqlaydi > tekshirib bo‘ladigan va sizning kontekstingiz kichik. ## Asosli javoblar va vositalar Ikki vosita bilim bazasini agentga ochib beradi: | Asbob | Nimani qiladi | |---|---| | `search_knowledge` | Tegishli parchalarni oladi va javobni manbalar bilan asoslaydi. | | `deep_research` | Bilim bazasi bo‘ylab bir necha bosqichli tadqiqot jarayonini boshqaradi va iqtibos keltirilgan hisobot tayyorlaydi. | Ikkalasi ham burilishda keladi **asbob natijalari**, hech qachon sun'iy ko'rsatmalar sifatida emas — AiHummerda hamma joyda qo'llaniladigan bir xil prompt-inyeksiya intizomi. Javoblar o'zida **iqtiboslar** shunda o‘quvchi da’voni uning manbasiga qayta izlab topishi mumkin. > [!NOTE] > `deep_research` haqiqiy ko‘p bosqichli savollar uchun — bu ko‘proq vaqt talab qiladi va > bitta dan ko‘p token `search_knowledge` qo'ng'iroq. Bitta qaytarish paytida unga yeting > etarli emas. ## Bilim ulagichlari Qo'lda kiritishdan tashqari, bilimlar tashqi manbalardan, ulanishlarni boshqarish ostida tortib olinishi mumkin `/v1/admin/knowledge/connectors/*`. Yetti ulanish mavjud; har birining ma'lumotlari shifrlangan maxfiylik omborida saqlanadi va fon rejalashtiruvchisi sinxronizatsiyalarni bajaradi: | Ulanma | Nimani tortadi | |---|---| | **Google Drive** (`gdrive`) | Xizmat hisob qaydnomasi (credential JSON) orqali Google Drive fayllari. | | **Microsoft Graph** (`msgraph`) | Microsoft Graph ilovasi orqali SharePoint / OneDrive hujjatlari. | | **Tasavvur** (`notion`) | Ichki integratsiya tokeni orqali Notion sahifalari. | | **Slack** (`slack`) | Web API token orqali Slack kanali xabarlar tarixi (barcha kanallar yoki sozlangan ro'yxat). | | **S3** (`s3`) | S3-ga mos keladigan bucketdan (AWS S3, S3 rejimida GCS, MinIO va boshqalar) ob’ektlar, ixtiyoriy ravishda prefiks ostida. | | **SQL** (`db`) | Ma'lumotlar bazasiga qarshi faqat o'qish uchun mo'ljallangan SQL so'rovidagi qatorlar, hujjatlar sifatida qabul qilingan. | | **Ulashish** (`confluence`) | Confluence Cloud sahifalari (Atlassian API tokeni bilan Basic auth), ixtiyoriy ravishda bitta makonga doir. | Alohida, bir martalik **Slack eksporti** import qo'lda yuklangan workspace-export ZIP faylini oladi — saqlangan maxfiylik yo'q va jadval yo'q. > [!WARNING] > Google Drive ulagichi jonli sinovdan o‘tgan; boshqalari amalga oshirilgan va > sinovlar bilan qamrab olingan, lekin ularga tayanishdan oldin ularni o'z ma'lumotlaringiz bilan tekshiring > ishlab chiqarishda. ## Vektor do'koni va embeddings Standart bo‘yicha, qidiruv quyidagida ishlashi mumkin **xotirada saqlash joyi va hash joylashtiruvchi**, bu boshlash uchun yetarli. Ishlab chiqarish darajasida semantik qidiruv uchun AiHummerni ko‘rsatish kerak **haqiqiy vektor do'koni va o'rnatuvchi**: ```bash AIHUMMER_QDRANT_URL=http://localhost:6333 AIHUMMER_EMBEDDER_URL=http://localhost:8081 ``` Bu o‘rnatilganda, iste’mol va `search_knowledge` Esdagi zaxira o‘rniga tashqi vektor ombori va embedderdan foydalaning. > [!NOTE] > Semantik o'rnatuvchi **tanlash sharti, standart emas**: mezbon-joylashgan o'rnatuvchi > faqat o'tganingizda shartlarni ta'minlaydi `--with-embedder` (Ollama bilan engil > ko‘p tilli model; u keyin ko‘rsatadi `AIHUMMER_EMBEDDER_URL` da > `http://127.0.0.1:11434/api/embeddings`). Embeddersiz, qidiruv ishlaydi > leksik zaxiraga qaytishda. ## Admin API | Resurs | Maqsad | |---|---| | `/v1/admin/knowledge` | Bilim bazasini boshqarish, shu jumladan qabul qilish | | `/v1/admin/knowledge/connectors` | KB ulanishlarini sozlash (Drive, Graph, Notion, Slack, S3, SQL, Confluence) | ## Keyingi qayerga - Ko'r `search_knowledge` va `deep_research` boshqa barcha vositalar bilan birga [Asboblar](/uz/v1.0/concepts/tools) va [asboblar katalogi](/uz/v1.0/reference/tools-catalog). - Har bir suhbat uchun uzoq muddatli eslashni qo'shish [Xotira (Aynshteyn)](/uz/v1.0/concepts/memory-einstein).