検索クエリをAIで書き換え
利用者が入力した検索キーワードを、意味を保ったまま検索処理に適した表現に書き換えるツールです。省略された言い方や言い回しの違いによる検索漏れを減らしたい場合に使われます。
オンラインで実行
アカウントでログインし、当社のサーバー上で実行します。無料ツールはブラウザ内で動作しますが、これは上記の料金がKIT残高から差し引かれます。
なぜ書き換えが必要か
利用者が入力する言葉は、省略されていたり、言い回しが文章と一致しなかったりします。そのままの言葉で検索すると、内容としては合っている文章が見つからないことがあります。表現を整えることで、検索の取りこぼしを減らせます。
何が返るか
入力したキーワードに対して、意味を保ったまま整えた表現、または複数の言い換え候補が返されます。もとの検索処理にそのまま渡して使う想定です。
使い方
検索キーワードをテキストで送ると、書き換えた表現が返されます。自社の検索機能やチャットボットの前段に組み込んで使う使い方が中心です。
向いている場面
サイト内検索や社内資料の検索など、利用者ごとに言葉の選び方が異なる場面に向いています。誤字や表記ゆれの吸収にも使われています。
料金
1回のリクエストにつき基本料金$0.003と$0.0135を合わせた$0.0165です。米ドル建てで、登録不要で利用できます。
活用例
サイト内検索の精度改善
合同会社みどりデザインは、自社サイトの検索窓に入力される言葉を書き換えてから検索処理に渡すことで、表記ゆれによる検索漏れを減らしています。
社内資料検索での言い換え吸収
株式会社山田商事の経理担当は、社内資料の検索システムに組み込み、略語や言い回しの違いを吸収した検索ができるようにしています。
チャットボットの質問理解を補助
問い合わせ対応のチャットボットに組み込み、利用者が短く入力した質問を、検索処理に適した表現へ書き換えてから回答を探す使い方をしています。
よくある質問
書き換えた検索キーワードはそのまま検索に使う必要がありますか?
そのまま使うことを想定していますが、複数の候補を出力させたうえで選ぶ使い方もできます。
対応している言語はどれですか?
日本語を含む主要な言語に対応しています。入力した言語のまま書き換えます。
誤字や表記ゆれも直りますか?
意味を保った書き換えの一環として、誤字や表記ゆれが整えられる場合があります。ただし誤字修正専用の機能ではありません。
入力した検索キーワードは保存されますか?
書き換えの処理にのみ使用し、完了後は保存しません。
1回の書き換えにいくらかかりますか?
基本料金$0.003と$0.0135を合わせた$0.0165です。米ドル建てで、登録不要でご利用いただけます。
検索機能に組み込むにはどうすればいいですか?
書き換え結果をテキストで受け取り、既存の検索処理やチャットボットの入力としてそのまま使えます。特別な設定は必要ありません。
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/rag/query-rewrite \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/rag/query-rewrite", {
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/rag/query-rewrite",
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/rag/query-rewrite", 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/rag/query-rewrite", 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": "rag.query_rewrite",
"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 | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
422 | task_failed | タスクの処理に失敗しました。このタスクは課金されません。 |