Dokumentasi Referensi API Referensi SDK Penggunaan Agentik Skill AI

Akun

Kirim umpan balik Tavily

Kirim umpan balik tentang relevansi dan kegunaan permintaan pencarian atau sesi. BazaarLink menerima permintaan dan mengembalikan bentuk sukses Tavily, tetapi umpan balik baru diterima dan belum diproses. Berikan setidaknya request_id atau session_id; X-Session-Id dapat mengidentifikasi sesi.

POST/v1/feedback

Otorisasi

Authorizationwajib

string · header

API key sebagai bearer token di header Authorization.

Body

request_id

string

Permintaan pencarian yang diberi umpan balik; jika ada, umpan balik berlaku untuk permintaan itu.

maxLength: 200

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

session_id

string

Sesi yang diberi umpan balik; tanpa request_id, umpan balik berlaku untuk seluruh sesi.

maxLength: 200

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

agent_score

number | string

Skor agen keseluruhan untuk relevansi dan kegunaan hasil.

string maxLength: 64

Example: 1

human_score

number | string

Skor pengguna akhir jika dikumpulkan.

string maxLength: 64

Example: 1

extra_scores

array<object>

Daftar dimensi berlabel tambahan; setiap item memerlukan label dan value.

maxItems: 50

labelwajib

string

Nama dimensi yang dinilai.

maxLength: 64

Example: freshness

valuewajib

number | string

Skor numerik atau label string pendek dengan panjang maksimal 64 karakter.

string maxLength: 64

Example: 0.8

comment

string

Penjelasan umpan balik dalam teks bebas.

maxLength: 10000

Example: Results were authoritative but several were old.

response_delivered

string

Jawaban akhir yang Anda buat menggunakan hasil.

maxLength: 50000

Example: The results show that ...

used_ids

string[]

ID hasil yang digunakan dalam jawaban; alternatif untuk used_urls.

maxItems: 100; item maxLength: 200

Example: ["a3f9c2-04"]

used_urls

string[]

URL hasil yang digunakan dalam jawaban; alternatif untuk used_ids.

maxItems: 100; item maxLength: 2000

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

used_citations

string[]

Cuplikan sumber spesifik yang dikutip dalam jawaban.

maxItems: 100; item maxLength: 2000

Example: ["A cited sentence."]

urls_scores

array<object>

Umpan balik per hasil; setiap item harus menyertakan id atau url.

maxItems: 100

id

string

ID hasil dari respons pencarian; berikan id ini atau url.

maxLength: 200

Example: a3f9c2-04

url

string

URL hasil; gunakan jika tidak memiliki ID hasil, dan berikan url atau id.

maxLength: 2000

Example: https://example.com/article

agent_score

number | string

Skor agen untuk hasil ini, berupa angka atau string pendek.

string maxLength: 64

Example: 1

scores

array<object>

Skor berlabel tambahan untuk hasil ini; setiap item memiliki label dan value.

maxItems: 20

labelwajib

string

Nama dimensi yang dinilai.

maxLength: 64

Example: freshness

valuewajib

number | string

Skor numerik atau label string pendek dengan panjang maksimal 64 karakter.

string maxLength: 64

Example: 0.8

comment

string

Umpan balik teks bebas tentang hasil ini.

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

Contoh respons

Umpan balik diterima; respons berisi feedback_id dan response_time. Isi umpan balik belum diproses.

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