Collezioni
Come creare e gestire collezioni di dati strutturati.
Cos'e una collezione
Una collezione e un insieme di dati strutturati che definisce quali informazioni archivi. Ogni collezione ha campi con tipi definiti, e i dati vengono salvati come record individuali.
Le collezioni costituiscono la base dati che i tuoi agenti possono interrogare durante le conversazioni.
Creare una collezione
Ci sono due modi per creare collezioni:
Collezione manuale
- Vai su Dati > Estrazioni.
- Clicca su Nuova collezione.
- Definisci un nome, una descrizione e i campi.
Collezione per estrazione
- Vai su Dati > Estrazioni.
- Crea un modello di estrazione definendo i campi che vuoi estrarre dai documenti.
- La collezione viene creata automaticamente al salvataggio del modello.
Campi
Ogni campo di una collezione ha:
| Proprieta | Descrizione |
|---|---|
| Nome | Identificativo del campo (senza spazi) |
| Tipo | Tipo di dato atteso |
| Descrizione | Guida per l'IA sul contenuto di questo campo |
Tipi di campo supportati
| Tipo | Descrizione | Esempio |
|---|---|---|
| string | Testo libero | "Stampante HP LaserJet" |
| float | Numero decimale | 199.99 |
| int | Numero intero | 42 |
| boolean | Vero/falso | true |
| date | Data | "2024-03-15" |
| list[string] | Lista di testi | ["rosso", "blu", "verde"] |
| file | File allegato | PDF, immagine (archiviato nel cloud) |
Ricerca intelligente
Ogni record salvato genera automaticamente un embedding — una rappresentazione numerica del significato del contenuto. Questo permette di cercare per significato, non solo per parole esatte.
Ad esempio, se cerchi "laptop per design", troverai record come "MacBook Pro per progettazione grafica" anche se le parole non corrispondono esattamente.
Indice di ricerca
La piattaforma crea automaticamente un indice di ricerca vettoriale per ogni collezione. Se hai bisogno di rigenerare gli embedding (ad esempio, dopo aver modificato i campi), puoi utilizzare l'opzione di reindicizzazione tramite l'API.
Modificare una collezione
Puoi aggiornare il nome, la descrizione e i campi di una collezione esistente. Tieni presente che la modifica dei campi non altera i record esistenti — influisce solo sulle future estrazioni e creazioni di record.
Eliminare una collezione
Eliminando una collezione si rimuove la sua definizione. I record esistenti restano nel database ma non saranno piu associati a un modello.