cicora.ai
API-specifikationVektorsøgning

Embeddings

Gør tekst eller understøttede input om til vektorer for søgning, klyngedannelse og anbefalinger.

Integrationsreference: Vælg parametre og tilgængelige funktioner fra API-indstillingerne for kontoen og modelkataloget for dit miljø.

Opret vektorer

Feltet input accepterer ét element eller en batch. Bevar hvert inputs position: et svarindeks skal kunne knyttes til dit kildedokument.

Bland ikke vektorer fra forskellige modeller eller dimensioner i ét indeks uden en udtrykkelig migreringsplan.

Anmodning om embeddings
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"
  }'

Indeksering

  • Normaliser tekst på samme måde ved indeksering og søgning.
  • Opbevar model-ID og dimension sammen med hvert indeks.
  • Del lange dokumenter i meningsfulde segmenter, før de omdannes til embeddings.

Søgning og evaluering

Brug cosinuslighed eller metrikken som vektormotoren kræver, og brug derefter eventuelt rerank på et lille kandidatsæt.

Evaluér kvaliteten regelmæssigt med virkelige forespørgsler. Høj numerisk lighed garanterer ikke et nyttigt brugersvar.