दस्तावेज़API संदर्भ SDK संदर्भ एजेंटिक उपयोग AI स्किल्स

खाता

Tavily फ़ीडबैक सबमिट करें

किसी सर्च अनुरोध या सत्र की प्रासंगिकता और उपयोगिता पर फ़ीडबैक भेजें। BazaarLink अनुरोध स्वीकार करके Tavily का success format लौटाता है, लेकिन फ़ीडबैक अभी केवल स्वीकार किया जाता है, संसाधित नहीं। request_id या session_id में से कम-से-कम एक दें; सत्र की पहचान के लिए X-Session-Id उपयोग कर सकते हैं।

POST/v1/feedback

प्राधिकरण

Authorizationआवश्यक

string · header

Authorization हेडर में bearer token के रूप में API कुंजी।

Body

request_id

string

जिस सर्च अनुरोध पर फ़ीडबैक देना है; देने पर फ़ीडबैक उसी अनुरोध पर लागू होगा।

maxLength: 200

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

session_id

string

जिस सत्र पर फ़ीडबैक देना है; 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"]}'

प्रतिक्रिया उदाहरण

फ़ीडबैक स्वीकार किया गया; response में feedback_id और response_time हैं। फ़ीडबैक की सामग्री अभी संसाधित नहीं होती।

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