Iniziare
Crea una chiave API ed esegui la tua prima ricerca di documenti su Nordvec.
Ecco la guida che ti porta da zero al tuo primo risultato di ricerca.
1. Crea una chiave API
Accedi e crea una chiave dalle impostazioni del tuo spazio di lavoro. La chiave grezza viene mostrata una sola volta e mai più, quindi conservala in un luogo sicuro. Le chiavi sono limitate al tuo spazio di lavoro e autenticano come bearer token.
Consulta Autenticazione per il ciclo di vita completo (rotazione, revoca, finestre di grazia).
2. Cerca nei tuoi documenti
Punta qualsiasi client HTTP all'endpoint base dell'API, https://nordvec.com/api/v1, e invia la tua query. I risultati tornano classificati, ognuno con il documento sorgente da cui proviene. query è obbligatorio; limit (1-50, predefinito 20) è opzionale.
curl https://nordvec.com/api/v1/documents/search \
-H "Authorization: Bearer $NORDVEC_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "quarterly revenue", "limit": 10 }'Ogni risultato fa riferimento al suo documento sorgente, così puoi verificare una corrispondenza invece di fidarti ciecamente. Questo è l'intero scopo della piattaforma.
3. Lavora con le conversazioni
Una conversazione è una chat basata sui tuoi documenti, in cui ogni risposta è citata. L'API ti permette di creare conversazioni e di elencarle, recuperarle e cercarle:
# Create a conversation owned by your workspace
curl -X POST https://nordvec.com/api/v1/conversations \
-H "Authorization: Bearer $NORDVEC_API_KEY"