cicora.ai
Špecifikácia APIVektorové vyhľadávanie

Vektorové reprezentácie

Transformujte text alebo podporované vstupy na vektory na vyhľadávanie, zhlukovanie a odporúčania.

Referenčná dokumentácia integrácie: parametre a dostupné funkcie vyberte z nastavení API účtu a katalógu modelov pre svoje prostredie.

Vytvorte vektory

Pole input prijíma jednu položku alebo dávku. Zachovajte pozíciu každého vstupu: index odpovede musí zodpovedať vášmu zdrojovému dokumentu.

Vektory vytvorené rôznymi modelmi alebo s rôznymi rozmermi nemiešajte v jednom indexe bez výslovného plánu migrácie.

Požiadavka na vektorové reprezentácie
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"
  }'

Indexovanie

  • Text normalizujte rovnakým spôsobom na indexovanie aj vyhľadávanie.
  • Pri každom indexe uchovávajte ID modelu a rozmer.
  • Pred vytvorením vektorových reprezentácií rozdeľte dlhé dokumenty na zmysluplné časti.

Vyhľadávanie a hodnotenie

Použite kosínusovú podobnosť alebo metriku požadovanú vaším vektorovým nástrojom a potom voliteľne použite reranking na malej množine kandidátov.

Kvalitu pravidelne vyhodnocujte na skutočných dopytoch. Vysoká číselná podobnosť nezaručuje užitočnú odpoveď pre používateľa.