cicora.ai
日本語
API仕様ベクトル検索

埋め込み

テキストや対応入力をベクトルに変換し、検索、クラスタリング、レコメンデーションに使用します。

連携リファレンス：お使いの環境に合わせて、アカウントのAPI設定とモデルカタログからパラメーターおよび利用可能な機能を選択してください。

ベクトルを作成

inputフィールドは一件またはバッチを受け付けます。各入力の位置を保持してください。応答インデックスは元の文書に対応していなければなりません。

明示的な移行計画がない限り、異なるモデルや次元で生成したベクトルを一つのインデックスに混在させないでください。

埋め込みリクエスト
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"
  }'

インデックス作成

  • インデックス作成時と検索時で、同じ方法によりテキストを正規化します。
  • 各インデックスにモデルIDと次元を保持します。
  • 長い文書は、埋め込みを作成する前に意味のあるチャンクへ分割します。

検索と評価

コサイン類似度またはベクトルエンジンが要求する指標を使用し、必要に応じて小規模な候補群に再ランクを適用します。

実際のクエリで定期的に品質を評価します。数値的な類似度が高くても、有用なユーザー回答になるとは限りません。

次に読む