TypeSafe AIはまずPlaygroundでテストし、その後APIや公式SDKで統合できます。最短の手順は、コンソールにログインしてAPIキーを取得し、チェックするコンテンツをstateに入れ、jev-latestを選択し、questionsでNoul、Choice、またはScoreを定義することです。キーはサーバー環境変数内に保持してください。ウェブコードに書き込んだりリポジトリに送信したりしないでください。
まず、Playgroundを使って問題の書き方を確認してください
カスタマーサービスのメッセージを状態として貼り付け、「緊急ですか?」という質問を追加します。Noulの質問です。次に部署の選択スコアとセンチメントスコアを追加して確率分布を観察します。結果が不安定な場合は、すぐに背景情報を積み重ねるのではなく、まず指示や基準を明確にしてください。
APIリクエストに必要なフィールドはどれか
{ "state": "付款连续失败三天，请尽快处理", "model": "jev-latest", "questions": { "department": { "type": "choice", "instructions": "应由哪个团队处理？", "criteria": { "billing": "支付、账单或退款", "technical": "故障、接口或集成" } }, "is_urgent": { "type": "noul", "instructions": "消息是否明确表达紧急性？" } } }リクエストはPOST /v1/systemoneに送信され、ベアラートークンで認証されます。応答は質問IDを使用し、読み取りanswers.department.choiceや候補確率などです。本番環境では、アップグレード後のトラブルシューティングを容易にするために、実際のモデルバージョンをレスポンスに記録すべきです。
PythonとJavaScriptのどちらを選ぶか
Python SDKはPython 3.10以上が必要で、インストールtypesafe-sdk可能です。JavaScriptは公式のtypesafe-ai/sdkを使用できます。どちらも環境変数からキーTYPESAFE_API_KEY読み取り、デフォルトでjev-latestを呼び出します。すでにバックエンドフレームワークを持っている場合は、別のTypeSafe技術スタックに切り替えることなく、チームが現在使っている言語を選択できます。
最初のアクセスは自動的に実行されるべきではありません
- 正常、ファジー、極端な条件を含む実際の脱感作サンプルセットが準備されました。
- 各質問は一つのことだけを決定し、金額と日付の比較はコードに任されます。
- まず、実際のビジネス行動を引き起こしずに結果と自信を記録しましょう。
- 誤ったサンプルに基づいて基準を調整し、自動合格と手動検証の閾値を設定します。
- 回帰分析用の固定モデルバージョンで、新しいエイリアスに切り替える前に検証済みです。
401に遭遇した場合は、キーとAuthorizationヘッダーの確認を優先してください。429に遭遇した場合は、応答の再試行時間に基づいて回避してください。失敗したリクエストを無限に即座に再試行すると、レート制限が長引くだけです。
