계정

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입니다. 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
}