Документация API Ссылка SDK Ссылка Агентное использование AI Навыки

Аккаунт

Отправить отзыв Tavily

Отправляет отзыв о релевантности и полезности поискового запроса или сеанса. BazaarLink принимает запрос и возвращает успешный ответ в формате Tavily, но пока только принимает отзывы и не обрабатывает их. Укажите request_id или session_id; сеанс можно определить заголовком X-Session-Id.

POST/v1/feedback

Авторизация

Authorizationобязательно

string · header

Ключ API как Bearer-токен в заголовке Authorization.

Тело

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 и укажите url или 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
}