cicora.ai
Specifikace APIVektorové vyhledávání

Embeddings

Převádějte text nebo podporované vstupy na vektory pro vyhledávání, shlukování a doporučení.

Referenční dokumentace integrace: parametry a dostupné možnosti vybírejte v nastavení API svého účtu a v katalogu modelů pro své prostředí.

Vytvoření vektorů

Pole input přijímá jednu položku nebo dávku. Zachovejte pozici každého vstupu: index odpovědi musí odpovídat zdrojovému dokumentu.

Nekombinujte vektory vytvořené různými modely nebo s různými rozměry v jednom indexu bez výslovného plánu migrace.

Požadavek na 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"
  }'

Indexování

  • Normalizujte text stejným způsobem pro indexování i vyhledávání.
  • U každého indexu uchovávejte ID modelu a rozměr.
  • Před vytvořením embeddingů rozdělte dlouhé dokumenty na smysluplné části.

Vyhledávání a vyhodnocování

Použijte kosinovou podobnost nebo metriku vyžadovanou vaším vektorovým systémem a poté případně na malou sadu kandidátů použijte přeřazení.

Pravidelně vyhodnocujte kvalitu na skutečných dotazech. Vysoká číselná podobnost nezaručuje užitečnou odpověď pro uživatele.