Dokumentation API-Referenz SDK-Referenz Agentic-Nutzung KI-Skills

Konto

Tavily-Feedback senden

Übermittelt Feedback zur Relevanz und Nützlichkeit einer Suchanfrage oder Sitzung. BazaarLink nimmt die Anfrage an und gibt das Tavily-Erfolgsformat zurück, verarbeitet das Feedback aber noch nicht. request_id oder session_id muss angegeben werden; X-Session-Id kann eine Sitzung identifizieren.

POST/v1/feedback

Autorisierung

Authorizationerforderlich

string · header

API-Schlüssel als Bearer-Token im Authorization-Header.

Body

request_id

string

Suchanfrage, zu der Feedback abgegeben wird; Feedback gilt dann für diese Anfrage.

maxLength: 200

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

session_id

string

Sitzung, zu der Feedback abgegeben wird; ohne request_id gilt es für die gesamte Sitzung.

maxLength: 200

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

agent_score

number | string

Gesamtbewertung des Agenten für Relevanz und Nützlichkeit der Ergebnisse.

string maxLength: 64

Example: 1

human_score

number | string

Bewertung des Endbenutzers, sofern erhoben.

string maxLength: 64

Example: 1

extra_scores

array<object>

Zusätzliche bewertete Dimensionen; jedes Element benötigt label und value.

maxItems: 50

labelerforderlich

string

Name der bewerteten Dimension.

maxLength: 64

Example: freshness

valueerforderlich

number | string

Eine numerische Bewertung oder ein kurzes Textlabel mit höchstens 64 Zeichen.

string maxLength: 64

Example: 0.8

comment

string

Freitext-Erklärung des Feedbacks.

maxLength: 10000

Example: Results were authoritative but several were old.

response_delivered

string

Die mit den Ergebnissen erzeugte endgültige Antwort.

maxLength: 50000

Example: The results show that ...

used_ids

string[]

IDs der für die Antwort verwendeten Ergebnisse; alternativ zu used_urls.

maxItems: 100; item maxLength: 200

Example: ["a3f9c2-04"]

used_urls

string[]

URLs der für die Antwort verwendeten Ergebnisse; alternativ zu used_ids.

maxItems: 100; item maxLength: 2000

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

used_citations

string[]

Konkrete in der Antwort zitierte Quellenausschnitte.

maxItems: 100; item maxLength: 2000

Example: ["A cited sentence."]

urls_scores

array<object>

Feedback pro Ergebnis; jedes Element muss id oder url enthalten.

maxItems: 100

id

string

Ergebnis-ID aus der Suchantwort; entweder diese oder url angeben.

maxLength: 200

Example: a3f9c2-04

url

string

URL des Ergebnisses; verwenden, wenn keine Ergebnis-ID vorliegt, und url oder id angeben.

maxLength: 2000

Example: https://example.com/article

agent_score

number | string

Agentenbewertung für dieses Ergebnis als Zahl oder kurze Zeichenfolge.

string maxLength: 64

Example: 1

scores

array<object>

Zusätzliche bewertete Dimensionen für dieses Ergebnis; jedes Element enthält label und value.

maxItems: 20

labelerforderlich

string

Name der bewerteten Dimension.

maxLength: 64

Example: freshness

valueerforderlich

number | string

Eine numerische Bewertung oder ein kurzes Textlabel mit höchstens 64 Zeichen.

string maxLength: 64

Example: 0.8

comment

string

Freitext-Feedback zu diesem Ergebnis.

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

Antwortbeispiele

Das Feedback wurde angenommen; die Antwort enthält feedback_id und response_time. Der Inhalt wird noch nicht verarbeitet.

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