Tieto / RAG

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

**Tieto** on tapa, jolla AiHummer perustaa vastauksensa asiakirjoihisi sen sijaan, että se perustuisi mallin koulutusdataan. Sinä syötät sisältöä, agentti noutaa siihen liittyvät kohdat `search_knowledge` työkalu, ja vastaukset tulevat takaisin **viitteineen**. Vaikeampiin kysymyksiin, `deep_research` työkalu suorittaa monivaiheisen tutkimuksen ja tuottaa viitatun raportin. Tietoa hallitaan `/v1/admin/knowledge/*` ja `/v1/admin/knowledge/connectors/*`. ## Sisällön nauttiminen Voit syödä **asiakirjat, PDF:t ja URL-osoitteet** tietopohjaan. Syötetty sisältö indeksoidaan, jotta se voidaan hakea vastausaikana ja liittää takaisin sen lähteeseen. > [!TIP] > Ota käyttöön dokumentin kanoninen versio kerran ja anna agenttien viitata siihen sen sijaan > kuin liittää pitkiä kohtia kehotteisiin. Lainattu hakutoiminto pitää vastaukset > tarkistettavissa ja kontekstisi pieni. ## Perustellut vastaukset ja työkalut Kaksi työkalua paljastavat tietopohjan agentille: | Työkalu | Mitä se tekee | |---|---| | `search_knowledge` | Hakee asiaankuuluvia kohtia ja perustaa vastauksen lähdeviitteisiin. | | `deep_research` | Suorittaa monivaiheisen tutkimusprosessin tietopohjan kautta ja tuottaa viitatun raportin. | Molemmat saapuvat käännökseen samalla tavalla **työkalun tulokset**, ei koskaan injektoituina ohjeina — samaa kehoite-injektion kurinalaisuutta sovellettiin kaikkialla AiHummerissa. Vastaukset sisältävät **viittaukset** jotta lukija voi jäljittää väitteen sen lähteeseen. > [!NOTE] > `deep_research` on aitoihin monivaiheisiin kysymyksiin — se vie enemmän aikaa ja > tokeneita kuin yksi `search_knowledge` soita. Ota se, kun yksi haku > ei ole tarpeeksi. ## Tietoyhteydet Manuaalisen tiedonkeruun lisäksi tietoa voidaan hakea ulkoisista lähteistä liittimien kautta, joita hallinnoidaan alla `/v1/admin/knowledge/connectors/*`. Seitsemän liitintä on käytettävissä; kunkin tunnistetiedot sijaitsevat salatussa salaisuuksien holvissa, ja taustalla toimiva ajastin suorittaa synkronoinnit: | Liitin | Mitä se vetää | |---|---| | **Google Drive** (`gdrive`) | Google Driven tiedostot palvelutilin kautta (tunnistetiedot JSON). | | **Microsoft Graph** (`msgraph`) | SharePoint / OneDrive -asiakirjat Microsoft Graph -sovelluksen kautta. | | **Käsite** (`notion`) | Notion-sivut sisäisen integraatiotunnuksen kautta. | | **Slack** (`slack`) | Slack-kanavan viestihistoria Web API -tunnuksen kautta (kaikki kanavat tai määritetty lista). | | **S3** (`s3`) | Objekteja S3-yhteensopivasta säilöstä (AWS S3, GCS S3-tilassa, MinIO jne.), mahdollisesti tietyn etuliitteen alla. | | **SQL** (`db`) | Rivejä vain-luku SQL-kyselystä tietokantaa vastaan, luettuina asiakirjoina. | | **Yhdistyminen** (`confluence`) | Confluence Cloud -sivut (perusautentikointi Atlassian API -tokenilla), valinnaisesti rajattuna yhteen tilaan. | Erikseen, kertaluonteinen **Slackin vienti** importoi työtila-viennin ZIP-tiedoston, joka on ladattu manuaalisesti — ei tallennettua salaisuutta eikä aikataulua. > [!WARNING] > Google Driven liitin on käytännössä testattu; muut on toteutettu ja > testien kattama, mutta varmista ne omien tietojen perusteella ennen luottamista niihin > tuotannossa. ## Vektorisäilö ja upotukset Oletusarvoisesti haku voi toimia **muistissa oleva tallennus hash-upottajalla**, mikä riittää aloittamiseen. Tuotantotason semanttiseen hakuun ohjaa AiHummerin kohti **todellinen vektorivarasto ja upottaja**: ```bash AIHUMMER_QDRANT_URL=http://localhost:6333 AIHUMMER_EMBEDDER_URL=http://localhost:8081 ``` Kun nämä on asetettu, imeytyminen ja `search_knowledge` käytä ulkoista vektorivarastoa ja upotinta sisäisen varajärjestelmän sijaan. > [!NOTE] > Semanttinen upottaja on **valinnainen, ei oletus**: isäntäkohtainen asentaja > määräykset vain kun läpäiset `--with-embedder` (Ollama kevyellä > monikielinen malli; se osoittaa sitten `AIHUMMER_EMBEDDER_URL` luona > `http://127.0.0.1:11434/api/embeddings`). Ilman upottajaa nouto toimii > leksikaalisessa varalta. ## Ylläpitäjän API | Resurssi | Tarkoitus | |---|---| | `/v1/admin/knowledge` | Tietämyksen hallinta, mukaan lukien tiedon vastaanotto | | `/v1/admin/knowledge/connectors` | Määritä KB-liittimet (Drive, Graph, Notion, Slack, S3, SQL, Confluence) | ## Minne seuraavaksi - Katsoa `search_knowledge` ja `deep_research` yhdessä jokaisen muun työkalun kanssa [Työkalut](/fi/v1.0/concepts/tools) ja [työkaluluettelo](/fi/v1.0/reference/tools-catalog). - Lisää keskusteluittain tapahtuva pitkäaikainen muistaminen [Muisti (Einstein)](/fi/v1.0/concepts/memory-einstein).