TypeSafe AI kann zuerst in Playground getestet und dann über die API oder das offizielle SDK integriert werden. Der kürzeste Prozess besteht darin: sich in der Konsole anmelden, um den API-Schlüssel zu erhalten, den zu prüfenden Inhalt in die state eingeben, jev-latest auswählen und dann Noul, Choice oder Score im questions definieren. Den Schlüssel in der Serverumgebungsvariable behalten; Schreibe ihn nicht in Webcode und reiche ihn nicht ins Repository ein.
Verwenden Sie zunächst Playground, um zu überprüfen, wie die Frage formuliert ist
Füge eine Kundenservice-Nachricht als Zustand ein und füge dann eine "Ist es dringend?"-Noul-Frage hinzu. Füge dann eine Abteilungswahl und einen Sentiment-Score hinzu, um die Wahrscheinlichkeitsverteilung zu beobachten. Wenn die Ergebnisse instabil sind, erkläre zuerst die Anweisungen und Kriterien, anstatt sofort mehr Hintergrundinformationen zu sammeln.
Welche Felder werden für API-Anfragen benötigt
{ "state": "付款连续失败三天，请尽快处理", "model": "jev-latest", "questions": { "department": { "type": "choice", "instructions": "应由哪个团队处理？", "criteria": { "billing": "支付、账单或退款", "technical": "故障、接口或集成" } }, "is_urgent": { "type": "noul", "instructions": "消息是否明确表达紧急性？" } } }Anfragen werden an POST /v1/systemone gesendet und mit Inhabertoken authentifiziert. Die Antworten verwenden die Frage-ID, zum Beispiel das Lesen von answers.department.choice- und Kandidatenwahrscheinlichkeiten. Produktionsumgebungen sollten auch die tatsächliche Modellversion in der Antwort aufzeichnen, um die Fehlersuche nach Upgrades zu erleichtern.
Wie man zwischen Python und JavaScript auswählt
Das Python SDK benötigt Python 3.10 oder höher und kann typesafe-sdk installieren; JavaScript kann die offizielle typesafe-ai/sdk verwenden. Beide lesen Schlüssel aus TYPESAFE_API_KEY Umgebungsvariablen und rufen standardmäßig jev-latest auf. Wenn Sie bereits ein Backend-Framework haben, können Sie die Sprache wählen, die Ihr Team derzeit verwendet, ohne auf einen separaten TypeSafe-Tech-Stack umsteigen zu müssen.
Der erste Zugriff sollte nicht automatisch ausgeführt werden
- Eine Reihe von echten Desensibilisierungsproben, darunter normale, verschwommene und extreme Bedingungen, wurde vorbereitet.
- Jede Frage bestimmt nur eine Sache, wobei die Berechnung von Betrag und Datum dem Code überlassen bleibt.
- Erstens: Ergebnisse und Selbstvertrauen dokumentieren, ohne echte geschäftliche Maßnahmen auszulösen.
- Passen Sie die Kriterien anhand der falsch eingeschätzten Stichprobe an und setzen Sie dann automatische Bestehens- und manuelle Verifizierungsschwellenwerte fest.
- Feste Modellversionen für Regressionstests, validiert vor dem Wechsel zu neuen Aliasen.
Wenn Sie auf 401 stoßen, priorisieren Sie die Überprüfung des Schlüssels und des Autorisierungsheaders; Wenn Sie auf 429 stoßen, vermeiden Sie basierend auf der Wiederholungszeit in der Antwort. Ein unendlich unmittelbares erneutes Wiederholen einer Anfrage führt nur dazu, dass die Geschwindigkeitsbegrenzung länger dauert.
