Jev bewertet einen JSON-Zustand anhand benannter Fragen und gibt Antworten vom Typ boolean, choice oder score zurück. Verwenden Sie es, wenn eine Anwendung klare Kriterien in maschinenlesbare Ergebnisse umwandeln soll.
Nur für Bewertung und Beurteilung
Jev unterstützt keinen Chat. Senden Sie Jev-Anfragen an POST /v1/evaluations; eine Anfrage an POST /v1/chat/completions liefert HTTP 400.
POST/v1/evaluations
Rufen Sie diesen Endpunkt mit Ihrem BazaarLink-API-Schlüssel auf. Vollständige URL: https://api.bazaarlink.ai/v1/evaluations.
Feldreferenz
model
string
Optional. Ohne Angabe gilt typesafe-ai/jev. Jede andere Modell-ID führt zu HTTP 400 mit dem Code model_not_available.
state
string | object | array
Erforderlich. Geben Sie den auszuwertenden Zustand als JSON-Zeichenfolge, Objekt oder Array an. Überschreiten der gemeinsam serialisierten state- und questions-Daten 32.000 tokens, lautet der Fehlercode context_length_exceeded.
questions
record<string, Question>
Erforderlich. Ein nicht leeres Objekt mit benannten Fragen. Jeder Fragenname wird zum Schlüssel im Antwortobjekt answers.
type
boolean | choice | score
Für jede Frage erforderlich: boolean, choice oder score.
instructions
string | object | array
Für jede Frage erforderlich. Eine JSON-Zeichenfolge, ein Objekt oder Array, das die gewünschte Entscheidung beschreibt.
criteria
object | array
Abhängig vom Typ: bei boolean optional; falls angegeben, ein Objekt mit ausschließlich den Schlüsseln true oder false. Für choice ist ein nicht leeres Objekt erforderlich, für score ein geordnetes Array mit mindestens zwei Einträgen.
Antworttypen
boolean — criteria ist optional; falls angegeben, sind nur die Schlüssel true und false zulässig. Die Antwort enthält einen numerischen probability-Wert.
choice — criteria muss ein nicht leeres Objekt sein, das Optionsnamen JSON-Kriterien zuordnet. Die Antwort enthält choice als Zeichenfolge; probabilities sind nach Optionsnamen indiziert.
score — criteria muss ein geordnetes Array mit mindestens zwei Einträgen sein. score ist eine Zahl und der Erwartungswert der Indizes 0..N-1 in criteria-Reihenfolge; probabilities sind mit diesen Indizes als Zeichenfolgen indiziert.
Anfragebeispiele
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
curl --fail-with-body https://api.bazaarlink.ai/v1/evaluations \
-H "Authorization: Bearer $BAZAARLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "typesafe-ai/jev",
"state": "The support agent issued a full refund and apologised for the delay.",
"questions": {
"refunded": {
"type": "boolean",
"instructions": "Was a refund issued?"
},
"tone": {
"type": "choice",
"instructions": "Tone of the agent?",
"criteria": {
"apologetic": "The agent apologises",
"neutral": "No emotional language",
"hostile": "The agent is rude"
}
},
"quality": {
"type": "score",
"instructions": "How complete was the resolution?",
"criteria": [
"poor",
"partial",
"complete"
]
}
}
}'
Beispiel für eine erfolgreiche Antwort
Die Beispielantwort enthält id, object, model, answers, usage, rounding und warnings. answers ist nach Fragennamen indiziert. usage enthält input_tokens, output_tokens und total_tokens; rounding zeigt probabilityDecimals und scoreDecimals. warnings ist ein Array und in diesem Beispiel leer. In answers verwenden die probabilities von choice Optionsnamen als Schlüssel; die probabilities von score verwenden Kriterienindizes als Zeichenfolgenschlüssel.
Eine Jev-Anfrage an einen Chat-Endpunkt liefert HTTP 400. Die folgenden Felder und Werte entsprechen dem Handler; message ist als Platzhalter dargestellt und der tatsächliche Text kommt vom Server.
