Bilik / RAG

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

**Bilik** AiHummer-in cavabları modelin təlim datası əvəzinə sizin sənədlərinizə əsaslandırma üsuludur. Siz məzmunu qəbul edirsiniz, agent `search_knowledge` aləti ilə müvafiq parçaları əldə edir və cavablar **sitatlarla** qayıdır. Daha çətin suallar üçün `deep_research` aləti çoxaddımlı bir araşdırma aparır və sitatlı hesabat yaradır. Bilik `/v1/admin/knowledge/*` və `/v1/admin/knowledge/connectors/*` altında idarə olunur. ## Məzmunun qəbulu Siz bilik bazasına **sənədləri, PDF-ləri və URL-ləri** qəbul edə bilərsiniz. Qəbul edilmiş məzmun indeksləşdirilir ki, cavab zamanı əldə edilə və mənbəyinə aid edilə bilsin. > [!TIP] > Sənədin kanonik versiyasını bir dəfə qəbul edin və agentlərin onu sitat > gətirməsinə icazə verin, uzun parçaları promptlara yapışdırmaq əvəzinə. Sitatlı > əldəetmə cavabları yoxlanıla bilən, kontekstinizi isə kiçik saxlayır. ## Əsaslandırılmış cavablar və alətlər İki alət bilik bazasını agentə açır: | Alət | Nə edir | |---|---| | `search_knowledge` | Müvafiq parçaları əldə edir və cavabı sitatlarla əsaslandırır. | | `deep_research` | Bilik bazası boyunca çoxaddımlı tədqiqat prosesi aparır və sitatlı hesabat yaradır. | Hər ikisi növbəyə **alət nəticələri** kimi gəlir, heç vaxt yeridilmiş təlimatlar kimi yox — AiHummer-də hər yerdə tətbiq edilən eyni prompt-injection intizamı. Cavablar **sitatlar** daşıyır ki, oxucu iddianı mənbəyinə qədər izləyə bilsin. > [!NOTE] > `deep_research` həqiqi çoxaddımlı suallar üçündür — o, tək `search_knowledge` > çağırışından daha çox vaxt və token tələb edir. Bir əldəetmə kifayət etmədikdə > ona müraciət edin. ## Bilik konnektorları Əl ilə qəbuldan əlavə, bilik `/v1/admin/knowledge/connectors/*` altında idarə olunan konnektorlar vasitəsilə xarici mənbələrdən çəkilə bilər: | Konnektor | Status | |---|---| | **Google Drive** (Service Account) | Canlı | | **Microsoft Graph** | Tətbiq edilib, **canlı şəkildə** sübut edilməyib | > [!WARNING] > Microsoft Graph konnektoru tətbiq edilib, lakin canlı bir kirayəçiyə qarşı > doğrulanmayıb. Onu öncədən baxış (preview) kimi qəbul edin və istehsalatda ona > etibar etməzdən əvvəl öz mühitinizdə yoxlayın. > [!NOTE] > Notion və Slack bilik konnektorları **mövcud deyil** — onlar ləğv edildi. > Onların ətrafında planlaşdırma aparmayın. ## Vektor anbarı və embeddinqlər Defolt olaraq, əldəetmə **hash embedder ilə yaddaşdaxili anbarda** işləyə bilər ki, bu da başlamaq üçün kifayətdir. İstehsalat keyfiyyətli semantik əldəetmə üçün AiHummer-i **real vektor anbarına və embedder-ə** yönləndirin: ```bash AIHUMMER_QDRANT_URL=http://localhost:6333 AIHUMMER_EMBEDDER_URL=http://localhost:8081 ``` Bunlar təyin edildikdə, qəbul və `search_knowledge` yaddaşdaxili ehtiyat əvəzinə xarici vektor anbarından və embedder-dən istifadə edir. ## Admin API | Resurs | Məqsəd | |---|---| | `/v1/admin/knowledge` | Bilik bazasının idarəsi, qəbul daxil olmaqla | | `/v1/admin/knowledge/connectors` | KB konnektorlarının konfiqurasiyası (Drive, MS Graph) | ## Sonra haraya - `search_knowledge` və `deep_research` alətlərini hər digər alətlə yanaşı [Alətlər](/az/v1.0/concepts/tools) və [alətlər kataloqu](/az/v1.0/reference/tools-catalog) bölmələrində görün. - Hər söhbət üçün uzunmüddətli xatırlama əlavə edin: [Yaddaş (Einstein)](/az/v1.0/concepts/memory-einstein).