AiHummer
Lietuvių
PrisijungtiPaskyra
v1.2.x
{ }Swagger

Žinios / RAG

v1.2.x · atnaujinta 2026-07-05

Žinios tai yra kaip AiHummer grindžia atsakymus jūsų dokumentuose, o ne modelio mokymo duomenyse. Jūs įkeliat turinį, agentas gauna atitinkamas pastraipas su search_knowledge įrankis, ir atsakymai grįžta su citatomis. Sudėtingesniems klausimams, tai deep_research įrankis atlieka daugiapakopę tyrimą ir pateikia cituotą ataskaitą. Žinios administruojamos pagal /v1/admin/knowledge/* ir /v1/admin/knowledge/connectors/*.

Turinio vartojimas

Jūs galite vartoti dokumentai, PDF failai ir URL į žinių bazę. Įtrauktas turinys indeksuojamas, todėl jį galima atkurti atsakymo metu ir priskirti atgal prie šaltinio.

[!TIP] Vieną kartą įsisavinkite dokumento kanoninę versiją ir leiskite agentams ją cituoti. nei įklijuojant ilgus tekstus į užklausas. Cituotas atgavimas palaiko atsakymus patikrinama ir jūsų kontekstas mažas.

Pagrįsti atsakymai ir įrankiai

Du įrankiai suteikia agentui galimybę pasiekti žinių bazę:

Įrankis Ką tai daro
search_knowledge Pasiima atitinkamus tekstus ir pagrindžia atsakymą citatoms.
deep_research Vykdo kelių etapų tyrimų procesą visoje žinių bazėje ir pateikia su citatomis paremtą ataskaitą.

Abu atvyksta į posūkį kaip įrankio rezultatai, niekada kaip įterptos instrukcijos — ta pati užklausų įterpimo disciplina taikoma visur AiHummer. Atsakymai turi citatos taip, kad skaitytojas galėtų atsekti teiginį iki jo šaltinio.

[!NOTE] deep_research yra skirtas tikroms kelių žingsnių užduotims — tai užima daugiau laiko ir ženklų nei vienas search_knowledge skambinti. Pasiekti tai, kai yra vienas gavimas nepakanka.

Žinių jungikliai

Be rankinio įvedimo, žinios gali būti gaunamos iš išorinių šaltinių per jungtis, valdomas pagal /v1/admin/knowledge/connectors/*. Yra septyni jungikliai; kiekvieno kredencialai saugomi užšifruotame slaptųjų duomenų saugykloje, o foninis tvarkytuvas vykdo sinchronizacijas:

Jungtis Ką jis traukia
Google Diskas (gdrive) Google Drive failai per paslaugos paskyrą (autentifikacijos JSON).
Microsoft Graph (msgraph) SharePoint / OneDrive dokumentai per Microsoft Graph programėlę.
Suvokimas (notion) Notion puslapiai per vidinį integracijos raktą.
Slack (slack) Slack kanalo žinučių istorija naudojant Web API tokeną (visi kanalai arba sukonfigūruotas sąrašas).
S3 (s3) Objektai iš S3 suderinamo krepšelio (AWS S3, GCS S3 režimu, MinIO ir kt.), pasirinktinai po prefiksu.
SQL (db) Eilučių skaitymo tik SQL užklausos prieš duomenų bazę, įkelta kaip dokumentai.
Santaka (confluence) Confluence Cloud puslapiai (pagrindinis autentifikavimas su Atlassian API raktu), pasirinktinai apriboti vienai erdvei.

Atskirai, vienkartinis Slack eksportas importuoja darbo srities eksportuotą ZIP failą, įkeltą rankiniu būdu — nėra saugomo rakto ir nėra tvarkaraščio.

[!WARNING] „Google Drive“ jungtis yra patikrinta gyvai; kitos jau įgyvendintos ir padengta testais, bet patikrinkite juos pagal savo duomenis prieš jais pasikliaudami gamyboje.

Vektorinė saugykla ir įterpimai

Pagal numatytuosius nustatymus paieška gali vykti atminties saugykla su maišos įterpėju, ko pakanka pradėti. Norint atlikti gamybos kokybės semantinį paiešką, nukreipkite AiHummer į tikras vektorių saugykla ir įterpėjas:

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

Kai tai nustatyta, įsisavinimas ir search_knowledge naudokite išorinę vektorinę saugyklą ir įterpiklį vietoj laikinosios atminties rezervo.

[!NOTE] Semantinis įterpiklis yra pasirinktinai, o ne pagal nutylėjimą: šeimininko-vietinio diegimo programa nuostatos tik tada, kai jūs praeinate --with-embedder (Ollama su šviesa daugiakalbis modelis; tada jis nurodo AIHUMMER_EMBEDDER_URL prie http://127.0.0.1:11434/api/embeddings). Be embedderio, paieška neveikia pagal leksinį atsarginį variantą.

Administratoriaus API

Ištekliai Tikslas
/v1/admin/knowledge Žinių bazės valdymas, įskaitant įvedimą
/v1/admin/knowledge/connectors Konfigūruoti KB jungtis (Drive, Graph, Notion, Slack, S3, SQL, Confluence)

Kur toliau