検索結果の並び順をAIで賢くする
この機能は、検索で取得済みの候補一覧を受け取り、クエリとの関連度が高い順に並び替えます。既存の検索の仕組みを変えずに、結果の精度だけを底上げできます。
オンラインで実行
アカウントでログインし、当社のサーバー上で実行します。無料ツールはブラウザ内で動作しますが、これは上記の料金がKIT残高から差し引かれます。
検索エンジンを丸ごと替えなくても精度は上がる
社内の検索システムをすでに運用している場合、丸ごと入れ替えるのは負担が大きい作業です。この機能は既存の検索が返した候補一覧を受け取り、クエリとの関連度をあらためて計算して並び替えるだけなので、検索の仕組み自体はそのまま活かせます。
最初の絞り込みのあとの仕上げに使う
キーワード検索や意味検索で候補を数十件程度に絞り込んだあと、この機能でクエリとの関連度が高い順に並べ直します。最初の絞り込みが粗くても、並び替えの段階で精度を補えます。
何件まで並び替えられるか
1回のリクエストで扱える候補の量は、他の検索機能と同様に最大20,000トークン分です。数十件から百件程度の候補一覧であれば問題なく処理できます。
料金と使い方
基本料金$0.002と1回あたり$0.0015を合わせて、1回の呼び出しが$0.0035です。既存の検索システムから、候補一覧を渡すだけで組み込めます。
活用例
既存の社内検索の精度を底上げ
情報システム担当者が、キーワード検索で得た候補一覧をこの機能で並び替え、上位の結果の的中率を改善しています。
ECサイトの商品検索結果を並び替え
ECサイト運営者が、単純な文字一致で取得した商品候補を、クエリとの関連度で並び替えて表示順を改善しています。
カスタマーサポートのFAQ候補を並び替え
サポート部門が、複数ヒットしたFAQ候補を関連度順に並び替え、担当者が最初に見る候補の精度を高めています。
よくある質問
検索エンジン自体を置き換える必要がありますか?
必要ありません。既存の検索が返した候補一覧を渡すだけで、並び替えの部分だけを担当します。
何件くらいの候補を並び替えられますか?
候補一覧の合計が最大20,000トークン分までです。数十件から百件程度が目安です。
意味検索の結果にも使えますか?
使えます。意味検索やキーワード検索、どちらの結果に対しても関連度の並び替えができます。
料金はどう計算されますか?
基本$0.002+$0.0015、1回の呼び出しが$0.0035です。
並び替えの根拠は確認できますか?
各候補の関連度スコアを結果に含めて返します。
日本語の候補一覧にも対応していますか?
対応しています。
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/search/rerank \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/search/rerank", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/search/rerank",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/rerank", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/rerank", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"input": "…"
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "search.rerank",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
制限
max_chunks | 10000 |
max_tokens | 20000 |
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |