cicora.ai
Specyfikacja APIWyszukiwanie wektorowe

Osadzenia

Przekształcaj tekst lub obsługiwane dane wejściowe w wektory do wyszukiwania, grupowania i rekomendacji.

Materiały dotyczące integracji: wybierz parametry i dostępne funkcje w ustawieniach API konta oraz w katalogu modeli dla swojego środowiska.

Utwórz wektory

Pole input przyjmuje jeden element lub partię. Zachowaj pozycję każdego wejścia: indeks odpowiedzi musi odpowiadać dokumentowi źródłowemu.

Nie mieszaj w jednym indeksie wektorów utworzonych przez różne modele lub o różnych wymiarach bez jawnego planu migracji.

Żądanie osadzenia
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"
  }'

Indeksowanie

  • Normalizuj tekst w ten sam sposób podczas indeksowania i wyszukiwania.
  • Przechowuj identyfikator modelu i wymiar przy każdym indeksie.
  • Przed utworzeniem osadzeń podziel długie dokumenty na spójne znaczeniowo fragmenty.

Wyszukiwanie i ocena

Użyj podobieństwa cosinusowego lub metryki wymaganej przez silnik wektorowy, a następnie opcjonalnie zastosuj zmianę kolejności wyników do małego zbioru kandydatów.

Regularnie oceniaj jakość na rzeczywistych zapytaniach. Wysokie podobieństwo liczbowe nie gwarantuje użytecznej odpowiedzi dla użytkownika.