Bilig / RAG

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

**Bilim** AIHummeriň jogaplary modeliň tälim maglumatlaryndan däl-de, siziň resminamalaryňyzda nädip esaslanýandygy. Siz mazmuny girizýärsiňiz, agent degişli tekst parçalaryny alýar `search_knowledge` gural, we jogaplar yzyna gaýdýar **sitata bilen**. Has kyn soraglar üçin, `deep_research` gural köp basgançakly barlag geçirýär we sitata berlen hasabat taýýarlaýar. Bilik aşakdaky ýagdaýda dolandyrylýar `/v1/admin/knowledge/*` we `/v1/admin/knowledge/connectors/*`. ## Mazmuny siňdirmek Siz siňdirip bilersiňiz **resminamalar, PDF-fayllar we URL-ler** bilig binasyna. Iýmitlenen mazmun, jogap wagtynda gaýtadan alynyp bilinsin we çeşmesine gaýtadan degişli edilip bilinsin diýip indekslenýär. > [!TIP] > Resminamanyň kanoniki wersiýasyny bir gezek girizýärsiňiz we agentleriň ony sitirlemegine mümkinçilik berýärsiňiz, munuň tersine däl > uzyn parçalary bölümlere goýup ýazmakdan has gowudur. Sitat berlen alşyk jogaplary saklaýar > tassyklanyp bolýan we siziň kontekstiňiz kiçi. ## Esasan jogaplar we enjamlar Iki gurall agentiň bilimiň bazasyna elýeterliligini açýar: | Gural | Ol näme edýär | |---|---| | `search_knowledge` | Degişli bölümleri alýar we jogaby sitatlar bilen esaslandyryp berýär. | | `deep_research` | Bilik bazasy boýunça köp ädimli barlag işini geçirýär we sitirlenen hasabat döredýär. | Iki sanysy hem burçyň içinde gelýär **gurmatlaryň netijeleri**, hiç haçan goýmalar hökmünde däl — AiHummerde her ýerde ulanylýan şol bir prompt-goýma düzgünleri. Jogaplar eýe bolýar **sitirler** şonuň üçin okyjy daýanyjyny onuň çeşmesinden yzarlap biler. > [!NOTE] > `deep_research` hakyky köpmarja öňegidiş soraglar üçin — has köp wagt talap edýär we > birden köp token `search_knowledge` jaň. Bir alş wagtynda el bilen ýetjek boluň > ýeterlik däl. ## Biliş baglanyşdyryjylary El bilen girizmekden başga-da, bilim daşarky çeşmelerden idarä edilen birleşdirijiler arkaly elde edilip bilner `/v1/admin/knowledge/connectors/*`. Ýedi birleşdiriji elýeterlidir; hersiniň şahsy maglumatlary şifrlenen gizlinler skafynda saklanýar we fon meýilçisi sinhronizasiýalary işledýär: | Baglaýjy | O näme çekýär | |---|---| | **Google Drive** (`gdrive`) | Google Drive faýllary hyzmat hasaby (credential JSON) arkaly. | | **Microsoft Graf** (`msgraph`) | Microsoft Graph programy arkaly SharePoint / OneDrive resminamalary. | | **Düşünje** (`notion`) | Iňlik integrasiýa tokeni arkaly Notion sahypalary. | | **Slack** (`slack`) | Web API nyşany arkaly Slack kanal habarlary taryhy (umuǵat kanallar ýa-da sazlanan sanaw). | | **S3** (`s3`) | S3 bilen utgaşykly suwukly gutudan (AWS S3, S3 ulgamynda GCS, MinIO we ş.m.) obýektler, islegiňize görä öňki söz astynda. | | **SQL** (`db`) | Maglumatlar bazasyna garşy okamak üçin niýetlenen SQL soragynyň setirleri, resminamalar hökmünde girizilen. | | **Bileleşmek** (`confluence`) | Confluence Cloud sahypalary (Atlassian API tokeni bilen Esasy tassyklama), islege baglylykda bir giňişlige gönükdirilen. | Aýry-aýry, bir gezeklik **Slack eksport** import el bilen ýüklän workspace-export ZIP-i alýar — saklanan gizlinlik ýok we meýilnama ýok. > [!WARNING] > Google Drive birikdiriji göni synaldy; beýlekiler ýerine ýetirildi we > synag bilen öňden barlanýar, ýöne olara bil baglamazdan öň öz maglumatlaryňyz bilen barlaň > önümi öndürmekde. ## Wektor dükan we embeňments Öňünden kesgitlenilen ýagdaýynda, gözleg şu ýerde işläp biler **hash embedder bilen ýatda saklaýyş magaziny**, bu başlamak üçin ýeterlik. Önümçilik hili semantik alşyk üçin, AiHummer-i şu ýere gönüldiriň **hakyky wektor dükan we embedder**: ```bash AIHUMMER_QDRANT_URL=http://localhost:6333 AIHUMMER_EMBEDDER_URL=http://localhost:8081 ``` Bularyň goýulanynda, iýmitlenme we `search_knowledge` Ýatdaky öňündäki çalşyryjy ýerinediňiz ýerine, daşarky wektor ambar we embedder ulanyň. > [!NOTE] > Semantik ornaşdyrýan **ynam bildirmek, standart däl**: myhman-şahsy gurnama programma > şertnamalary diňe geçeniňiz bilen `--with-embedder` (Ýaşyllyň bilen Ollama > köp dilli model; soňra görkezýär `AIHUMMER_EMBEDDER_URL` at > `http://127.0.0.1:11434/api/embeddings`). Embedder bolmasa, almak işlemleri işleýär > leksikal çalşma bilen. ## Administrator API | Görnüş | Maksat | |---|---| | `/v1/admin/knowledge` | Biziňleşdirilen bilim bazasyny dolandyrmak, şol sanda öwrenmek | | `/v1/admin/knowledge/connectors` | KB birikdirijilerini sazla (Drive, Graph, Notion, Slack, S3, SQL, Confluence) | ## Indi nire? - Gör `search_knowledge` we `deep_research` her bir beýleki gurallaryň bilen bir hatarda [Gural](/tk/v1.0/concepts/tools) we [gurallar katalogy](/tk/v1.0/reference/tools-catalog). - Her gepleşik üçin uzak möhletli beýdiriş goşuň [Ýady (Einstein)](/tk/v1.0/concepts/memory-einstein).