Tài liệu Tham chiếu API Tham chiếu SDK Sử dụng Agent Kỹ năng AI

Tài khoản

Gửi phản hồi Tavily

Gửi phản hồi về mức độ liên quan và hữu ích của một yêu cầu tìm kiếm hoặc phiên. BazaarLink chấp nhận yêu cầu và trả về dạng thành công của Tavily, nhưng phản hồi mới chỉ được tiếp nhận và chưa được xử lý. Cần có request_id hoặc session_id; X-Session-Id có thể xác định phiên.

POST/v1/feedback

Xác thực

Authorizationbắt buộc

string · header

API key dưới dạng bearer token trong header Authorization.

Body

request_id

string

Yêu cầu tìm kiếm cần phản hồi; khi có, phản hồi áp dụng cho yêu cầu đó.

maxLength: 200

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

session_id

string

Phiên cần phản hồi; nếu không có request_id, phản hồi áp dụng cho toàn bộ phiên.

maxLength: 200

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

agent_score

number | string

Điểm tổng thể của agent về mức độ liên quan và hữu ích của kết quả.

string maxLength: 64

Example: 1

human_score

number | string

Điểm của người dùng cuối nếu bạn thu thập.

string maxLength: 64

Example: 1

extra_scores

array<object>

Danh sách các khía cạnh bổ sung; mỗi mục cần label và value.

maxItems: 50

labelbắt buộc

string

Tên của khía cạnh được chấm điểm.

maxLength: 64

Example: freshness

valuebắt buộc

number | string

Điểm số hoặc nhãn chuỗi ngắn tối đa 64 ký tự.

string maxLength: 64

Example: 0.8

comment

string

Giải thích phản hồi dạng văn bản tự do.

maxLength: 10000

Example: Results were authoritative but several were old.

response_delivered

string

Câu trả lời cuối cùng bạn tạo bằng các kết quả.

maxLength: 50000

Example: The results show that ...

used_ids

string[]

ID các kết quả thực sự dùng trong câu trả lời; thay thế cho used_urls.

maxItems: 100; item maxLength: 200

Example: ["a3f9c2-04"]

used_urls

string[]

URL các kết quả thực sự dùng trong câu trả lời; thay thế cho used_ids.

maxItems: 100; item maxLength: 2000

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

used_citations

string[]

Các đoạn nguồn cụ thể được trích dẫn trong câu trả lời.

maxItems: 100; item maxLength: 2000

Example: ["A cited sentence."]

urls_scores

array<object>

Phản hồi theo từng kết quả; mỗi mục phải có id hoặc url.

maxItems: 100

id

string

ID kết quả từ phản hồi tìm kiếm; cung cấp id này hoặc url.

maxLength: 200

Example: a3f9c2-04

url

string

URL của kết quả; dùng khi không có ID và cung cấp url hoặc id.

maxLength: 2000

Example: https://example.com/article

agent_score

number | string

Điểm của agent cho kết quả này, dưới dạng số hoặc chuỗi ngắn.

string maxLength: 64

Example: 1

scores

array<object>

Các điểm có nhãn bổ sung cho kết quả này; mỗi mục có label và value.

maxItems: 20

labelbắt buộc

string

Tên của khía cạnh được chấm điểm.

maxLength: 64

Example: freshness

valuebắt buộc

number | string

Điểm số hoặc nhãn chuỗi ngắn tối đa 64 ký tự.

string maxLength: 64

Example: 0.8

comment

string

Nhận xét dạng văn bản tự do về kết quả này.

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"]}'

Ví dụ phản hồi

Phản hồi đã được tiếp nhận; phản hồi trả về feedback_id và response_time. Nội dung chưa được xử lý.

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