Билүү / RAG

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

**Билим** бул 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 Драйв** (`gdrive`) | Google Drive файлдары кызматтык эсеп аркылуу (креденциал JSON). | | **Microsoft Graph** (`msgraph`) | SharePoint / OneDrive документтерин Microsoft Graph колдонмосу аркылуу бөлүшүү. | | **Түшүнүк** (`notion`) | Notion барактарын ички интеграциялык токен аркылуу. | | **Слак** (`slack`) | Веб 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` ар бир башка курал менен кошо [Куралдар](/ky/v1.0/concepts/tools) жана [куралдар каталогу](/ky/v1.0/reference/tools-catalog). - Ар бир сүйлөшүү үчүн узак мөөнөттүү эскерүүнү кошуңуз [Эстутум (Эйнштейн)](/ky/v1.0/concepts/memory-einstein).