# Context pack: Perusperiaatteet Source: https://nordvec.com/fi/docs/guides/concepts Pack: https://nordvec.com/fi/docs/packs/concepts This pack bundles one Nordvec guide with the guides it builds on and the guides it links to, in reading order, so an assistant reading it meets no reference it cannot follow. ## Contents 1. [Perusperiaatteet](https://nordvec.com/fi/docs/guides/concepts) (this guide) 2. [Asiakirjat ja haku](https://nordvec.com/fi/docs/guides/concepts/documents) (linked from this guide) 3. [Keskustelut ja viittaukset](https://nordvec.com/fi/docs/guides/concepts/conversations) (linked from this guide) --- # Perusperiaatteet Source: https://nordvec.com/fi/docs/guides/concepts Kaksi asiaa, joihin kaikki Nordvecissä perustuu: dokumentit, joita voit hakea, ja keskustelut, jotka viittaavat niihin. Jokainen liittimen, pushin ja haun toiminto Nordvecissa tuottaa tai lukee dokumentin, ja jokainen avustajan antama vastaus on keskustelu, joka perustuu näihin dokumentteihin. Aloita tästä oppiaksesi, mitä kukin niistä sisältää ja kuka sen voi nähdä. - [Asiakirjat ja haku](https://nordvec.com/fi/docs/guides/concepts/documents): Asiakirjat ovat Nordvecin haettava yksikkö. Tuo ne järjestelmään ja löydä ne koko tekstin haulla API:n kautta. - [Keskustelut ja viittaukset](https://nordvec.com/fi/docs/guides/concepts/conversations): Keskustelu on chatti, joka perustuu sinun dokumentteihisi, ja jokainen vastaus jäljitetään lähteeseensä. --- # Asiakirjat ja haku Source: https://nordvec.com/fi/docs/guides/concepts/documents Asiakirjat ovat Nordvecin haettava yksikkö. Tuo ne järjestelmään ja löydä ne koko tekstin haulla API:n kautta. **Dokumentti** on yksikkö, jota Nordvec hakee: tiedosto, sivu, viesti, sähköposti tai mikä tahansa, jonka tuot sisään. Kun dokumentti on käsitelty, se muuttuu haettavaksi ja sitä voidaan siteerata vastauksessa. ## Dokumenttien tuominen [#dokumenttien-tuominen] Dokumentit saapuvat työtilaasi kolmella tavalla: * **Liittimet** synkronoivat lähteestä, jonka omistat (liittimen omistaja). Uudet ja muuttuneet dokumentit poimitaan automaattisesti. Katso [liittimien katalogi](/docs/guides/connectors). * **Lataukset** ovat tiedostoja, jotka lisäät sovelluksessa. * **Push** lähettää dokumentin suoraan Nordveciin omasta järjestelmästäsi. Katso [Push-dokumentit](/docs/guides/how-to/push-documents). Riippumatta siitä, miten dokumentti saapuu, Nordvec käsittelee sen, jakaa sen kappaleiksi ja indeksoi sen hakua varten. Dokumenttisi tallennetaan ja haetaan EU:n alueella. Dokumentilla on `status`: `processing`, kun sitä indeksoidaan, `indexed`, kun kaikki käsittelyvaiheet on suoritettu, ja `failed`, jos sitä ei voitu käsitellä. ## Kuka näkee dokumentin [#kuka-näkee-dokumentin] Liittimestä peräisin oleva dokumentti on yksityinen henkilölle, joka on liittänyt sen, kunnes tämä jakaa sen. API-avain kuuluu työtilalle, joten se näkee vain sen, mitä työtila jakaa, eikä koskaan henkilön jakamattomia dokumentteja. ## Haku [#haku] `/documents/search` on **kokotekstihaku** dokumentin otsikon ja koko tekstin yli kaikista dokumenteista, jotka näet, riippumatta dokumentin pituudesta. Sanat vastaavat muotoa, jonka kirjoitat, millä tahansa kielellä, ja merkitsevät aksentit jätetään huomiotta molemmilta puolilta, joten `cafe` löytää `café`. Sanavartaloita ei huomioida: `invoice` ei vastaa `invoices`. Haku toimii itsenäisesti, ilman keskustelun kontekstia. Se palauttaa järjestettyjä dokumentteja, joista jokaisessa on katkelma parhaiten vastaavasta kappaleesta ja relevanssipisteet nollasta ylöspäin, mutta ei koskaan saavuttaen ykköstä. ```bash curl https://nordvec.com/api/v1/documents/search \ -H "Authorization: Bearer $NORDVEC_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "renewal terms", "limit": 10 }' ``` Voit myös listata dokumentteja (`/documents/list`) tai hakea yhden tunnisteen perusteella (`/documents/{id}`). Katso [API-viite](/docs/api) kaikista parametreista ja vastauksen muodoista. ### Kokeile [#kokeile] Suorita kysely pientä demokorpusta vastaan. Tämä hakee kuutta esimerkkidokumenttia selaimessasi, järjestettynä ja lähteineen, samassa muodossa kuin oikea haku palauttaa. Semanttinen haku, joka vastaa kappaleita merkityksen perusteella eikä tarkkojen sanojen perusteella, on se, mikä mahdollistaa [keskustelun](/docs/guides/concepts/conversations) siteeratut vastaukset. Hakupäätepiste itse vastaa sanoja. Haku palauttaa aina vain dokumentteja, joita kutsujalla on lupa nähdä. Pääsy valvotaan tietokannassa, ei sovelluskoodissa. ## Sisältötyypit [#sisältötyypit] Dokumentti voi sisältää tiedon tyypin `content_type` (esimerkiksi `decision`, `runbook`, `policy` tai `faq`). Push-dokumentti asettaa sen push-API:n `type`-kentällä. Dokumentilla, jolla ei ole tyyppiä, on `content_type: null`. Sekä haku että listaus suodattavat sen perusteella `contentType`-parametrilla. ## Missä dokumenteita siteerataan [#missä-dokumenteita-siteerataan] Haku antaa sinulle kappaleita, joiden kanssa voit työskennellä suoraan. Kun haluat kirjoitetun vastauksen raakakappaleiden sijaan, [keskustelu](/docs/guides/concepts/conversations) hakee samoista dokumenteista ja siteeraa niitä vastauksessaan. --- # Keskustelut ja viittaukset Source: https://nordvec.com/fi/docs/guides/concepts/conversations Keskustelu on chatti, joka perustuu sinun dokumentteihisi, ja jokainen vastaus jäljitetään lähteeseensä. **Keskustelu** on chatti, joka perustuu sinun dokumentteihisi. Esität kysymyksen, Nordvec hakee olennaiset kohdat, ja vastaa niiden perusteella mainiten käyttämänsä dokumentit. Jos dokumentit eivät tue vastausta, se ilmoittaa siitä sen sijaan, että arvailee. ## Lähteet ovat pointti [#lähteet-ovat-pointti] Jokainen vastaus sisältää lähteet, joihin se perustuu. Tämä on tarkoituksellista: RAG-vastaus, jota et voi jäljittää, on riski, ei ominaisuus. Lähteiden avulla ihminen voi hypätä suoraan dokumenttiin, josta väite on peräisin, ja vahvistaa sen. Tämä on juuri sitä, mitä säännellyt ja korkean panoksen tehtävät vaativat. Vastaukset luo tekoäly. Lähteet ovat se, mikä tekee niistä todennettavia, eivät vain uskottavia. ## Keskustelut kuuluvat henkilölle [#keskustelut-kuuluvat-henkilölle] Keskustelun omistaa kirjautunut henkilö, joka sen aloitti. Sen päätepisteet vastaavat **istuntoon**, eivät koskaan API-avaimeen. Avain on oma toimija, jolla ei ole omaa keskusteluhistoriaa. Katso [Todennus](/docs/guides/authentication). Istunnon avulla voit: * **Luoda** keskustelun (`POST /conversations`). * **Listata** ja **hakea** keskustelujasi (`GET /conversations`, `GET /conversations/search`). * **Hakea** keskustelun viimeisimmät viestit (`GET /conversations/{id}`) ja sivuttaa taaksepäin vanhempaan historiaan (`GET /conversations/{id}/messages`). * **Listata dokumentit**, joihin keskustelu on viitannut (`GET /conversations/{id}/documents`). Katso tarkat pyynnön ja vastauksen muodot [API-viitteestä](/docs/api). ## Palaute [#palaute] Voit lähettää palautetta vastauksesta ja haetuista kohdista. Tätä signaalia käytetään hakutulosten laadun parantamiseen ajan myötä.