Білім AiHummer жауаптарын модельдің оқыту деректерінен емес, сіздің құжаттарыңыздан қалай негіздейтіндігі солай. Сіз мазмұнды енгізесіз, агент сәйкес бөліктерді іздейді search_knowledge құрал, және жауаптар қайтып келеді дәлелдемелерімен. Қиынырақ сұрақтар үшін, deep_research құрал көпсатылы тергеу жүргізеді және дәйекті есеп шығарады. Білім осының негізінде басқарылады /v1/admin/knowledge/* және /v1/admin/knowledge/connectors/*.
Мазмұнды сіңіру
Сіз жұта аласыз құжаттар, PDF файлдар және URL мекенжайлары білім базасына. Жиналған мазмұн индекстеледі, сондықтан оны жауап беру кезінде іздеуге болады және қайнар көзіне жатқызуға болады.
[!TIP]
Құжаттың канондық нұсқасын бір рет енгізіп, агенттердің оны сілтеме жасауына мүмкіндік беріңіз
ұзын үзінділерді нұсқауларға қоюдан гөрі. Дәйексөзделген алу жауаптарды сақтайды
расталатын және сіздің контекстіңіз кіші.
Негізделген жауаптар және құралдар
Екі құрал агентке білім базасын ашады:
Құрал
Не істейді
search_knowledge
Қатысты үзінділерді алып, жауапты сілтемелермен негіздейді.
deep_research
Білімі база бойынша көп сатылы зерттеу процесін жүргізеді және дереккөздер көрсетілген есеп шығарады.
Екеуі де бұрыста келеді құрал нәтижелері, ешқашан енгізілген нұсқаулар ретінде емес — AiHummer жүйесінде барлық жерде қолданылатын сол промпт-енгізу тәртібі. Жауаптар қамтиды дәлелдемелер сонда оқырман дәлелді оның көзіне дейін қадағалай алады.
[!NOTE]
deep_research нақты көп сатылы сұрақтар үшін — ол көбірек уақытты қажет етеді және
біреуіне қарағанда көп токендер search_knowledge шақыру. Бір нәрсені қайтарғанда оған қол созыңыз
жеткіліксіз.
Білім байланыстырғыштары
Қолмен енгізуден тыс, білім сыртқы көздерден қосқыштар арқылы алынуы мүмкін, олар басқару астында /v1/admin/knowledge/connectors/*. Жетінші қосқыштар бар; әрқайсысының тіркелгі деректері шифрланған құпиялар қоймасында сақталады және синхрондауды жүргізетін фондық жоспарлаушы жұмыс істейді:
Коннектор
Не тартады
Google Drive (gdrive)
Google Drive файлдары қызметтік аккаунт арқылы (креденциал JSON).
Microsoft Граф (msgraph)
Microsoft Graph қосымшасы арқылы SharePoint / OneDrive құжаттары.
Ой (notion)
Ішкі интеграция токені арқылы Notion беттері.
Слак (slack)
Web API токені арқылы Slack арнасы хабарламаларының тарихы (барлық арналар немесе конфигурацияланған тізім).
S3 (s3)
S3-сәйкес шелектен (AWS S3, S3 режиміндегі GCS, MinIO және т.б.) объектілер, қажет болса префикс бойынша.
SQL (db)
Дерекқорға қарсы орындалған тек оқуға арналған SQL сұрауының жолдары, құжаттар ретінде енгізілген.
Қосылу (confluence)
Confluence Cloud беттері (Atlassian API токенімен негізгі аутентификация), қажет болса бір кеңістікке шектелген.
Жеке, бір реттік Slack экспорт import қолмен жүктелген workspace-export ZIP файлын алады — сақталған құпия жоқ және кесте жоқ.
[!WARNING]
Google Drive қосқышы тірі дәлелденген; қалғандары қолданылған және
тестілеуден өтті, бірақ оларға сенер алдында өз деректеріңізбен тексеріңіз
өндірісте.
Векторлық дүкен және энбеддингтер
Әдепкі бойынша, іздеу осы жерде іске қосылуы мүмкін хэш енгізгіші бар жадта сақтау, бұл бастау үшін жеткілікті. Өндірістік сапалы семантикалық іздеу үшін AiHummer-ді бағыттаңыз нақты векторлық сақтау және енгізгіш:
Олар орнатылған кезде, жұтылу және search_knowledge ескертпелік жадыдағы балама орнына сыртқы векторлық сақтау және енгізушіні қолданыңыз.
[!NOTE]
Семантикалық енгізгіш қатысуға міндетті емес, әдепкі емес: хост-жергілікті орнатушы
оны тек қана сіз тапсырған кезде қамтамасыз етеді --with-embedder (Оллама жеңіл)
көптілді модель; ол содан кейін нұсқайды AIHUMMER_EMBEDDER_URL де, -де
http://127.0.0.1:11434/api/embeddings). Энбедерсіз, іздеу жұмыс істейді
лексикалық резервке қателік кезінде.
Көріңіз search_knowledge және deep_research әрбір басқа құралмен қатар
Құралдар және
құралдар каталогы.
Әр сөйлесуге арналған ұзақ мерзімді есте сақтауды қосу
Естелік (Эйнштейн).
**Білім** AiHummer жауаптарын модельдің оқыту деректерінен емес, сіздің құжаттарыңыздан қалай негіздейтіндігі солай. Сіз мазмұнды енгізесіз, агент сәйкес бөліктерді іздейді `search_knowledge` құрал, және жауаптар қайтып келеді **дәлелдемелерімен**. Қиынырақ сұрақтар үшін, `deep_research` құрал көпсатылы тергеу жүргізеді және дәйекті есеп шығарады. Білім осының негізінде басқарылады `/v1/admin/knowledge/*` және `/v1/admin/knowledge/connectors/*`.
## Мазмұнды сіңіру
Сіз жұта аласыз **құжаттар, PDF файлдар және URL мекенжайлары** білім базасына. Жиналған мазмұн индекстеледі, сондықтан оны жауап беру кезінде іздеуге болады және қайнар көзіне жатқызуға болады.
> [!TIP]
> Құжаттың канондық нұсқасын бір рет енгізіп, агенттердің оны сілтеме жасауына мүмкіндік беріңіз
> ұзын үзінділерді нұсқауларға қоюдан гөрі. Дәйексөзделген алу жауаптарды сақтайды
> расталатын және сіздің контекстіңіз кіші.
## Негізделген жауаптар және құралдар
Екі құрал агентке білім базасын ашады:
| Құрал | Не істейді |
|---|---|
| `search_knowledge` | Қатысты үзінділерді алып, жауапты сілтемелермен негіздейді. |
| `deep_research` | Білімі база бойынша көп сатылы зерттеу процесін жүргізеді және дереккөздер көрсетілген есеп шығарады. |
Екеуі де бұрыста келеді **құрал нәтижелері**, ешқашан енгізілген нұсқаулар ретінде емес — AiHummer жүйесінде барлық жерде қолданылатын сол промпт-енгізу тәртібі. Жауаптар қамтиды **дәлелдемелер** сонда оқырман дәлелді оның көзіне дейін қадағалай алады.
> [!NOTE]
> `deep_research` нақты көп сатылы сұрақтар үшін — ол көбірек уақытты қажет етеді және
> біреуіне қарағанда көп токендер `search_knowledge` шақыру. Бір нәрсені қайтарғанда оған қол созыңыз
> жеткіліксіз.
## Білім байланыстырғыштары
Қолмен енгізуден тыс, білім сыртқы көздерден қосқыштар арқылы алынуы мүмкін, олар басқару астында `/v1/admin/knowledge/connectors/*`. Жетінші қосқыштар бар; әрқайсысының тіркелгі деректері шифрланған құпиялар қоймасында сақталады және синхрондауды жүргізетін фондық жоспарлаушы жұмыс істейді:
| Коннектор | Не тартады |
|---|---|
| **Google Drive** (`gdrive`) | Google Drive файлдары қызметтік аккаунт арқылы (креденциал JSON). |
| **Microsoft Граф** (`msgraph`) | Microsoft Graph қосымшасы арқылы SharePoint / OneDrive құжаттары. |
| **Ой** (`notion`) | Ішкі интеграция токені арқылы Notion беттері. |
| **Слак** (`slack`) | Web API токені арқылы Slack арнасы хабарламаларының тарихы (барлық арналар немесе конфигурацияланған тізім). |
| **S3** (`s3`) | S3-сәйкес шелектен (AWS S3, S3 режиміндегі GCS, MinIO және т.б.) объектілер, қажет болса префикс бойынша. |
| **SQL** (`db`) | Дерекқорға қарсы орындалған тек оқуға арналған SQL сұрауының жолдары, құжаттар ретінде енгізілген. |
| **Қосылу** (`confluence`) | Confluence Cloud беттері (Atlassian API токенімен негізгі аутентификация), қажет болса бір кеңістікке шектелген. |
Жеке, бір реттік **Slack экспорт** import қолмен жүктелген workspace-export ZIP файлын алады — сақталған құпия жоқ және кесте жоқ.
> [!WARNING]
> Google Drive қосқышы тірі дәлелденген; қалғандары қолданылған және
> тестілеуден өтті, бірақ оларға сенер алдында өз деректеріңізбен тексеріңіз
> өндірісте.
## Векторлық дүкен және энбеддингтер
Әдепкі бойынша, іздеу осы жерде іске қосылуы мүмкін **хэш енгізгіші бар жадта сақтау**, бұл бастау үшін жеткілікті. Өндірістік сапалы семантикалық іздеу үшін AiHummer-ді бағыттаңыз **нақты векторлық сақтау және енгізгіш**:
```bash
AIHUMMER_QDRANT_URL=http://localhost:6333
AIHUMMER_EMBEDDER_URL=http://localhost:8081
```
Олар орнатылған кезде, жұтылу және `search_knowledge` ескертпелік жадыдағы балама орнына сыртқы векторлық сақтау және енгізушіні қолданыңыз.
> [!NOTE]
> Семантикалық енгізгіш **қатысуға міндетті емес, әдепкі емес**: хост-жергілікті орнатушы
> оны тек қана сіз тапсырған кезде қамтамасыз етеді `--with-embedder` (Оллама жеңіл)
> көптілді модель; ол содан кейін нұсқайды `AIHUMMER_EMBEDDER_URL` де, -де
> `http://127.0.0.1:11434/api/embeddings`). Энбедерсіз, іздеу жұмыс істейді
> лексикалық резервке қателік кезінде.
## Әкімші API
| Ресурс | Мақсат |
|---|---|
| `/v1/admin/knowledge` | Білім базасын басқару, соның ішінде енгізу |
| `/v1/admin/knowledge/connectors` | KB қосқыштарын баптау (Drive, Graph, Notion, Slack, S3, SQL, Confluence) |
## Келесі қайда
- Көріңіз `search_knowledge` және `deep_research` әрбір басқа құралмен қатар
[Құралдар](/kk/v1.0/concepts/tools) және
[құралдар каталогы](/kk/v1.0/reference/tools-catalog).
- Әр сөйлесуге арналған ұзақ мерзімді есте сақтауды қосу
[Естелік (Эйнштейн)](/kk/v1.0/concepts/memory-einstein).
