# Context pack: Concetti fondamentali
Source: https://nordvec.com/it/docs/guides/concepts
Pack: https://nordvec.com/it/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. [Concetti fondamentali](https://nordvec.com/it/docs/guides/concepts) (this guide)
2. [Documenti e ricerca](https://nordvec.com/it/docs/guides/concepts/documents) (linked from this guide)
3. [Conversazioni e citazioni](https://nordvec.com/it/docs/guides/concepts/conversations) (linked from this guide)
---
# Concetti fondamentali
Source: https://nordvec.com/it/docs/guides/concepts
Le due cose su cui tutto in Nordvec è costruito: documenti che puoi cercare e conversazioni che li citano.
Ogni connettore, push e ricerca in Nordvec produce o legge un documento, e
ogni risposta che l'assistente fornisce è una conversazione basata su quei documenti.
Inizia qui per scoprire cosa contiene ciascuno e chi può vederlo.
- [Documenti e ricerca](https://nordvec.com/it/docs/guides/concepts/documents): I documenti sono l'unità ricercabile in Nordvec. Inseriscili, poi trovali con la ricerca full-text tramite l'API.
- [Conversazioni e citazioni](https://nordvec.com/it/docs/guides/concepts/conversations): Una conversazione è una chat basata sui tuoi documenti, dove ogni risposta è tracciata alla sua fonte.
---
# Documenti e ricerca
Source: https://nordvec.com/it/docs/guides/concepts/documents
I documenti sono l'unità ricercabile in Nordvec. Inseriscili, poi trovali con la ricerca full-text tramite l'API.
Un **documento** è l'unità su cui Nordvec esegue la ricerca: un file, una pagina, un messaggio, un'email, qualsiasi cosa tu ingerisca. Una volta elaborato, il documento diventa ricercabile e può essere citato in una risposta.
## Ingestione dei documenti [#ingestione-dei-documenti]
I documenti entrano nella tua area di lavoro in tre modi:
* **Connettori** sincronizzano da una fonte di tua proprietà (il proprietario del connettore). I documenti nuovi e modificati vengono rilevati automaticamente. Consulta il [catalogo dei connettori](/docs/guides/connectors).
* **Caricamenti** di file che aggiungi nell'app.
* **Push** invia un documento a Nordvec direttamente dal tuo sistema. Consulta [Push dei documenti](/docs/guides/how-to/push-documents).
Indipendentemente da come arriva, Nordvec elabora il documento, lo suddivide in passaggi e lo indicizza per il recupero. I tuoi documenti sono memorizzati e ricercati nell'UE.
Un documento ha uno `status`: `processing` mentre viene indicizzato, `indexed`
una volta completato ogni passaggio di elaborazione e `failed` se non è stato possibile elaborarlo.
## Chi vede un documento [#chi-vede-un-documento]
Un documento proveniente da un connettore è privato per la persona che lo ha collegato finché questa non lo condivide. Una chiave API appartiene all'area di lavoro, quindi vede ciò che l'area di lavoro condivide e mai i documenti non condivisi di una persona.
## Ricerca [#ricerca]
`/documents/search` è una ricerca **full-text** sul titolo e sull'intero testo
di ogni documento che puoi vedere, indipendentemente dalla lunghezza del documento. Le parole corrispondono nella forma in cui le scrivi, in qualsiasi lingua, e gli accenti vengono ignorati su entrambi i lati, quindi
`cafe` trova `café`. Non c'è stemming: `invoice` non corrisponde a `invoices`.
La ricerca viene eseguita in modo autonomo, senza contesto di conversazione. Restituisce documenti classificati, ognuno con un estratto del passaggio che corrisponde meglio e un punteggio di rilevanza da 0 fino a, ma mai raggiungendo, 1.
```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 }'
```
Puoi anche elencare i documenti (`/documents/list`) o recuperarne uno per id
(`/documents/{id}`). Consulta il [riferimento API](/docs/api) per l'intero set di
parametri e le forme delle risposte.
### Prova [#prova]
Esegui una query su un piccolo corpus dimostrativo. Questa ricerca sei documenti di esempio nel tuo browser, classificati e con fonte, nella stessa forma che restituisce una ricerca reale.
Il recupero semantico, che abbina i passaggi per significato anziché per parole esatte,
è ciò che alimenta le risposte citate di una [conversazione](/docs/guides/concepts/conversations).
L'endpoint di ricerca stesso abbina le parole.
La ricerca restituisce solo documenti che l'utente che la esegue è autorizzato a vedere. L'accesso è applicato nel database, non nel codice dell'applicazione.
## Tipi di contenuto [#tipi-di-contenuto]
Un documento può avere un tipo di conoscenza in `content_type` (ad esempio
`decision`, `runbook`, `policy` o `faq`). Un documento inviato tramite push lo imposta con il `type` dell'API push; un documento senza tipo ha `content_type: null`. Sia la ricerca che l'elenco filtrano in base a esso con `contentType`.
## Dove vengono citati i documenti [#dove-vengono-citati-i-documenti]
La ricerca ti fornisce passaggi con cui lavorare direttamente. Quando desideri una risposta scritta invece di passaggi grezzi, una [conversazione](/docs/guides/concepts/conversations)
recupera gli stessi documenti e li cita nella sua risposta.
---
# Conversazioni e citazioni
Source: https://nordvec.com/it/docs/guides/concepts/conversations
Una conversazione è una chat basata sui tuoi documenti, dove ogni risposta è tracciata alla sua fonte.
Una **conversazione** è una chat basata sui tuoi documenti. Fai una domanda,
Nordvec recupera i passaggi pertinenti e risponde utilizzandoli, citando i
documenti che ha usato. Se i documenti non supportano una risposta, lo dice
invece di fare supposizioni.
## Le citazioni sono il punto centrale [#le-citazioni-sono-il-punto-centrale]
Ogni risposta include le fonti da cui è stata costruita. Questo è intenzionale:
una risposta RAG che non puoi tracciare è un rischio, non una funzionalità. Le
citazioni permettono a una persona di saltare al documento esatto da cui proviene
una affermazione e confermarla, esattamente ciò di cui hanno bisogno i lavori
regolamentati e ad alto rischio.
Le risposte sono generate dall'IA. Le citazioni sono ciò che le rende verificabili, non solo plausibili.
## Le conversazioni appartengono a una persona [#le-conversazioni-appartengono-a-una-persona]
Una conversazione è di proprietà della persona registrata che l'ha avviata,
quindi i suoi endpoint rispondono a una **sessione**, mai a una chiave API. Una
chiave è un proprio principale senza una cronologia di chat propria; consulta
[Autenticazione](/docs/guides/authentication).
Con una sessione puoi:
* **Creare** una conversazione (`POST /conversations`).
* **Elencare** e **cercare** le tue conversazioni (`GET /conversations`,
`GET /conversations/search`).
* **Recuperare** una conversazione con i suoi messaggi recenti
(`GET /conversations/{id}`), e sfogliare la cronologia più vecchia
(`GET /conversations/{id}/messages`).
* **Elencare i documenti** su cui una conversazione si è basata
(`GET /conversations/{id}/documents`).
Consulta il [riferimento API](/docs/api) per le forme esatte di richiesta e risposta.
## Feedback [#feedback]
Puoi inviare feedback su una risposta e sui passaggi che sono stati recuperati.
Questo segnale viene utilizzato per migliorare la qualità del recupero nel tempo.