ドキュメント APIリファレンス SDKリファレンスエージェント利用 AIスキル

アカウント

Tavily フィードバックを送信

検索リクエストまたはセッションの関連性と有用性に関するフィードバックを送信します。BazaarLink はリクエストを受け付けて Tavily の成功形式を返しますが、フィードバックは受け付けるだけでまだ処理しません。request_id または session_id の少なくとも一方が必要です。セッション識別には X-Session-Id も使えます。

POST/v1/feedback

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして API キーを渡します。

Body

request_id

string

フィードバック対象の検索リクエスト ID。指定するとそのリクエストに適用されます。

maxLength: 200

Example: 8442d8d0-8b74-4fca-a89e-5b1b6dd33295

session_id

string

フィードバック対象のセッション ID。request_id がない場合はセッション全体に適用されます。

maxLength: 200

Example: 5874812a-2e9b-43ea-8978-6cc9225b587b

agent_score

number | string

結果の関連性と有用性に対するエージェントの総合評価。

string maxLength: 64

Example: 1

human_score

number | string

収集している場合のエンドユーザー評価。

string maxLength: 64

Example: 1

extra_scores

array<object>

追加する評価指標の一覧。各項目に label と value が必要です。

maxItems: 50

label必須

string

評価する指標の名前。

maxLength: 64

Example: freshness

value必須

number | string

数値スコア、または 64 文字以内の短い文字列ラベル。

string maxLength: 64

Example: 0.8

comment

string

フィードバックの自由記述。

maxLength: 10000

Example: Results were authoritative but several were old.

response_delivered

string

結果を使って生成した最終回答。

maxLength: 50000

Example: The results show that ...

used_ids

string[]

回答で実際に使った結果 ID。used_urls の代わりに指定できます。

maxItems: 100; item maxLength: 200

Example: ["a3f9c2-04"]

used_urls

string[]

回答で実際に使った結果 URL。used_ids の代わりに指定できます。

maxItems: 100; item maxLength: 2000

Example: ["https://example.com/article"]

used_citations

string[]

回答で引用した具体的なソース断片。

maxItems: 100; item maxLength: 2000

Example: ["A cited sentence."]

urls_scores

array<object>

結果ごとのフィードバック。各項目に id または url が必要です。

maxItems: 100

id

string

検索レスポンスの結果 ID。url と少なくとも一方を指定します。

maxLength: 200

Example: a3f9c2-04

url

string

検索結果の URL。結果 ID がない場合に使い、id と少なくとも一方を指定します。

maxLength: 2000

Example: https://example.com/article

agent_score

number | string

この結果に対するエージェント評価。数値または短い文字列です。

string maxLength: 64

Example: 1

scores

array<object>

この結果の追加ラベル付き評価。各項目に label と value を含めます。

maxItems: 20

label必須

string

評価する指標の名前。

maxLength: 64

Example: freshness

value必須

number | string

数値スコア、または 64 文字以内の短い文字列ラベル。

string maxLength: 64

Example: 0.8

comment

string

この結果に関する自由記述のフィードバック。

maxLength: 2000

Example: Directly answered the question.

POST /v1/feedback

1
2
3
4
curl -X POST https://api.bazaarlink.ai/v1/feedback \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"request_id":"8442d8d0-8b74-4fca-a89e-5b1b6dd33295","agent_score":1,"used_ids":["a3f9c2-04"]}'

レスポンス例

フィードバックを受け付け、feedback_id と response_time を返します。フィードバック内容はまだ処理されません。

1
2
3
4
5
{
  "success": true,
  "feedback_id": "f1c0f0a5-0f9b-4a62-9e0e-1b6b2f0a6d31",
  "response_time": 0.05
}