cicora.ai
Specifica APIRicerca vettoriale

Embedding

Trasforma testo o input supportati in vettori per ricerca, raggruppamento e raccomandazioni.

Riferimento per l'integrazione: scegli i parametri e le funzionalità disponibili dalle impostazioni API del tuo account e dal catalogo dei modelli per il tuo ambiente.

Crea vettori

Il campo input accetta un elemento o un batch. Conserva la posizione di ogni input: l'indice di una risposta deve corrispondere al documento sorgente.

Non combinare in un unico indice vettori prodotti da modelli o dimensioni differenti senza un piano di migrazione esplicito.

Richiesta di embedding
bash
curl --request POST https://cicora.ai/api/v1/embeddings \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/text-embedding-3-small",
    "input": ["First support note", "Second support note"],
    "encoding_format": "float"
  }'

Indicizzazione

  • Normalizza il testo allo stesso modo per l'indicizzazione e la ricerca.
  • Conserva ID e dimensione del modello con ogni indice.
  • Dividi i documenti lunghi in parti significative prima di creare gli embedding.

Ricerca e valutazione

Usa la similarità del coseno o la metrica richiesta dal tuo motore vettoriale, quindi applica facoltativamente il riordinamento a un piccolo insieme di candidati.

Valuta regolarmente la qualità su query reali. Un'elevata similarità numerica non garantisce una risposta utile all'utente.