Teadmised on see, kuidas AiHummer seob vastused teie dokumentidega, mitte mudeli treeningandmetega. Te võtate sisu vastu, agent otsib seejärel vastavad lõigud üles search_knowledge tööriist, ja vastused tulevad tagasi tsitaatidega. Raskemate küsimuste puhul, deep_research tööriist viib läbi mitmeastmelise uurimise ja koostab viidatud aruande. Teadmisi hallatakse all /v1/admin/knowledge/* ja /v1/admin/knowledge/connectors/*.
Sisu tarbimine
Sa võid tarbida dokumendid, PDF-id ja URL-id teadmistebaasi. Tarbitud sisu indekseeritakse, et seda saaks vastuse ajal välja tuua ja viidata selle allikale.
[!TIP]
Tarbi dokumendi kanonilist versiooni üks kord ja lase agendil sellele viidata, selle asemel
kui pikkade lõikude kleepimine päringutesse. Tsiteeritud tagasivõtmine hoiab vastused
kontrollitav ja teie kontekst on väike.
Põhjalikud vastused ja tööriistad
Kaks tööriista paljastavad teadmistebaasi agendile:
Tööriist
Mida see teeb
search_knowledge
Hangi asjakohased lõigud ja põhjenda vastus viidetega.
deep_research
Viib läbi mitmeastmelise uurimisprotsessi teadmistebaasis ja koostab viidatud aruande.
Mõlemad jõuavad pöördesse kui tööriista tulemused, mitte kunagi süstitud juhistena — sama päringusüsti distsipliini rakendati kõikjal AiHummeri puhul. Vastused kannavad viited nii et lugeja saab väidet jälitada tagasi selle allikani.
[!NOTE]
deep_research on tõeliste mitmeastmeliste küsimuste jaoks — see võtab rohkem aega ja
tokeneid kui üksik search_knowledge kõne. Ulatu selle järele, kui üks otsimine
ei ole piisav.
Teadmiste ühendajad
Lisaks käsitsi sisestamisele saab teadmisi võtta välistest allikatest kaudu ühenduste, mida hallatakse all /v1/admin/knowledge/connectors/*. Saadaval on seitse liidest; igaühe mandaat asub salastatud võtmete hoiukohas ja taustal töötab ajastatud sünkroniseerimise protsess:
Ühendus
Mida see tõmbab
Google Drive (gdrive)
Google Drive’i failid teenusekonto kaudu (volituste JSON).
Microsoft Graph (msgraph)
SharePointi / OneDrive’i dokumendid Microsoft Graphi rakenduse kaudu.
Mõte (notion)
Notioni lehed sisemise integratsioonitokeni kaudu.
Slack (slack)
Slack’i kanali sõnumite ajalugu veebipõhise API tokeni kaudu (kõik kanalid või seadistatud nimekiri).
S3 (s3)
Objektid S3-ühilduvast kogumist (AWS S3, GCS S3-režiimis, MinIO jne), valikuliselt mingi eesliite all.
SQL (db)
Lugemiseks mõeldud SQL-päringu read andmebaasi vastu, mis võetakse dokumentidena sisse.
Koosvoog (confluence)
Confluence Cloudi lehed (põhjauthentimine Atlassiani API-tokiga), valikuliselt piiratud ühele ruumile.
Eraldi, ühekordne Slacki eksport importimine võtab käsitsi üles laetud töölaua-eksport ZIP-faili — salvestatud salajast võtme ega ajakava ei ole.
[!WARNING]
Google Drive’i ühendus on testitud kasutamiseks; teised on rakendatud ja
katetud testidega, kuid kontrollige neid oma andmete põhjal enne, kui neist sõltute
tootmises.
Vektorpood ja manused
Vaikimisi võib päring toimuda mäluandmehoidla koos hajutise manustajaga, mis on piisav alustamiseks. Tootmiskvaliteediga semantilise otsingu jaoks suuna AiHummeri reaalne vektoripood ja sisestaja:
Kui need on seadistatud, imendumine ja search_knowledge kasutage mälus oleva varuvariandi asemel välist vektorihoidlat ja embedderit.
[!NOTE]
Semaantiline manustaja on vali ise, mitte vaikimisi: hosti-lokaalne installer
tingimused ainult siis, kui sa läbida --with-embedder (Ollama koos valgusega
mitmekeelne mudel; seejärel osutab AIHUMMER_EMBEDDER_URL juures
http://127.0.0.1:11434/api/embeddings). Ilma manustajata töötab otsing
leksikaalne tagasivõtmine.
Admin API
Ressurss
Eesmärk
/v1/admin/knowledge
Teadmistebaasi haldamine, sealhulgas andmete sisestamine
Lisa vestlusepõhine pikaajaline meenutamine koos
Mälu (Einstein).
**Teadmised** on see, kuidas AiHummer seob vastused teie dokumentidega, mitte mudeli treeningandmetega. Te võtate sisu vastu, agent otsib seejärel vastavad lõigud üles `search_knowledge` tööriist, ja vastused tulevad tagasi **tsitaatidega**. Raskemate küsimuste puhul, `deep_research` tööriist viib läbi mitmeastmelise uurimise ja koostab viidatud aruande. Teadmisi hallatakse all `/v1/admin/knowledge/*` ja `/v1/admin/knowledge/connectors/*`.
## Sisu tarbimine
Sa võid tarbida **dokumendid, PDF-id ja URL-id** teadmistebaasi. Tarbitud sisu indekseeritakse, et seda saaks vastuse ajal välja tuua ja viidata selle allikale.
> [!TIP]
> Tarbi dokumendi kanonilist versiooni üks kord ja lase agendil sellele viidata, selle asemel
> kui pikkade lõikude kleepimine päringutesse. Tsiteeritud tagasivõtmine hoiab vastused
> kontrollitav ja teie kontekst on väike.
## Põhjalikud vastused ja tööriistad
Kaks tööriista paljastavad teadmistebaasi agendile:
| Tööriist | Mida see teeb |
|---|---|
| `search_knowledge` | Hangi asjakohased lõigud ja põhjenda vastus viidetega. |
| `deep_research` | Viib läbi mitmeastmelise uurimisprotsessi teadmistebaasis ja koostab viidatud aruande. |
Mõlemad jõuavad pöördesse kui **tööriista tulemused**, mitte kunagi süstitud juhistena — sama päringusüsti distsipliini rakendati kõikjal AiHummeri puhul. Vastused kannavad **viited** nii et lugeja saab väidet jälitada tagasi selle allikani.
> [!NOTE]
> `deep_research` on tõeliste mitmeastmeliste küsimuste jaoks — see võtab rohkem aega ja
> tokeneid kui üksik `search_knowledge` kõne. Ulatu selle järele, kui üks otsimine
> ei ole piisav.
## Teadmiste ühendajad
Lisaks käsitsi sisestamisele saab teadmisi võtta välistest allikatest kaudu ühenduste, mida hallatakse all `/v1/admin/knowledge/connectors/*`. Saadaval on seitse liidest; igaühe mandaat asub salastatud võtmete hoiukohas ja taustal töötab ajastatud sünkroniseerimise protsess:
| Ühendus | Mida see tõmbab |
|---|---|
| **Google Drive** (`gdrive`) | Google Drive'i failid teenusekonto kaudu (volituste JSON). |
| **Microsoft Graph** (`msgraph`) | SharePointi / OneDrive'i dokumendid Microsoft Graphi rakenduse kaudu. |
| **Mõte** (`notion`) | Notioni lehed sisemise integratsioonitokeni kaudu. |
| **Slack** (`slack`) | Slack'i kanali sõnumite ajalugu veebipõhise API tokeni kaudu (kõik kanalid või seadistatud nimekiri). |
| **S3** (`s3`) | Objektid S3-ühilduvast kogumist (AWS S3, GCS S3-režiimis, MinIO jne), valikuliselt mingi eesliite all. |
| **SQL** (`db`) | Lugemiseks mõeldud SQL-päringu read andmebaasi vastu, mis võetakse dokumentidena sisse. |
| **Koosvoog** (`confluence`) | Confluence Cloudi lehed (põhjauthentimine Atlassiani API-tokiga), valikuliselt piiratud ühele ruumile. |
Eraldi, ühekordne **Slacki eksport** importimine võtab käsitsi üles laetud töölaua-eksport ZIP-faili — salvestatud salajast võtme ega ajakava ei ole.
> [!WARNING]
> Google Drive'i ühendus on testitud kasutamiseks; teised on rakendatud ja
> katetud testidega, kuid kontrollige neid oma andmete põhjal enne, kui neist sõltute
> tootmises.
## Vektorpood ja manused
Vaikimisi võib päring toimuda **mäluandmehoidla koos hajutise manustajaga**, mis on piisav alustamiseks. Tootmiskvaliteediga semantilise otsingu jaoks suuna AiHummeri **reaalne vektoripood ja sisestaja**:
```bash
AIHUMMER_QDRANT_URL=http://localhost:6333
AIHUMMER_EMBEDDER_URL=http://localhost:8081
```
Kui need on seadistatud, imendumine ja `search_knowledge` kasutage mälus oleva varuvariandi asemel välist vektorihoidlat ja embedderit.
> [!NOTE]
> Semaantiline manustaja on **vali ise, mitte vaikimisi**: hosti-lokaalne installer
> tingimused ainult siis, kui sa läbida `--with-embedder` (Ollama koos valgusega
> mitmekeelne mudel; seejärel osutab `AIHUMMER_EMBEDDER_URL` juures
> `http://127.0.0.1:11434/api/embeddings`). Ilma manustajata töötab otsing
> leksikaalne tagasivõtmine.
## Admin API
| Ressurss | Eesmärk |
|---|---|
| `/v1/admin/knowledge` | Teadmistebaasi haldamine, sealhulgas andmete sisestamine |
| `/v1/admin/knowledge/connectors` | Seadista KB pistikprogrammid (Drive, Graph, Notion, Slack, S3, SQL, Confluence) |
## Kuhu järgmine
- See `search_knowledge` ja `deep_research` koos iga teise tööriistaga
[Tööriistad](/et/v1.0/concepts/tools) ja
[tööriistade kataloog](/et/v1.0/reference/tools-catalog).
- Lisa vestlusepõhine pikaajaline meenutamine koos
[Mälu (Einstein)](/et/v1.0/concepts/memory-einstein).
