Веды / 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`) | Гісторыя паведамленняў канала Slack праз токен Web API (усе каналы або настроены спіс). | | **S3** (`s3`) | Аб'екты з сумяшчальнага са S3 сховішча (AWS S3, GCS у рэжыме S3, MinIO і інш.), пры жаданні, пад пэўным прэфіксам. | | **SQL** (`db`) | Радкі запыту SQL толькі для чытання да базы данных, загружаныя як дакументы. | | **Зліццё** (`confluence`) | Старонкі Confluence Cloud (асноўная аўтэнтыфікацыя з токенам API Atlassian), па жаданні абмежаваныя адной прасторай. | Адзін асобны **Экспарт Slack** імпартуе 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` побач з усімі іншымі інструментамі ў [Інструменты](/be/v1.0/concepts/tools) і [каталог інструментаў](/be/v1.0/reference/tools-catalog). - Дадаць доўгатэрміновае запамінанне для кожнай размовы [Памяць (Эйнштэйн)](/be/v1.0/concepts/memory-einstein).