何が変わったか
Jev AI APIは、従来のチャット型エンドポイントとは異なるアプローチを採用しています。このAPIはState、Model、Questionsの3つの明確な入力を中心に設計されており、アプリケーションロジックにAI判断を統合するための構造化された結果を返します。特に、**Choice（分類・ルーティング）、Score（順位評価）、Noul（1つのYes/No判断）**の3種類の質問タイプをサポートし、それぞれに異なるユースケースに対応しています。
（出典: Jev AI API Tutorial: Build Your First Structured Decision with Choice, Score, and Noul）
仕組みの詳細
Jev AI APIの処理フローは以下のステップで構成されます。
- Stateの準備: テキスト、JSONオブジェクト、または配列形式で文脈を提供します。
- 質問タイプの選択:
- Choice: 分類やルーティングに使用。例: サポートチケットの部門を決定。
- Score: スペクトル評価に使用。例: リスクスコアの算出。
- Noul: 1つのYes/No判断に使用。例: レビューが必要かの判断。
- APIリクエストの送信: APIキーを準備し、最小限のNoulリクエストを送信します。
- レスポンスの処理: 質問IDごとに結果を読み取り、確率をシグナルとして扱います。
（出典: How to Use the Jev AI Model: A Step-by-Step Developer Guide）
移行手順
Jev AI APIをサーバーサイドワークフローに統合するには以下の手順を実施します。
- Jev AI Playgroundで検証: リクエストの構造を確認し、結果の形式を理解します。
- APIキーの準備: Jev AI公式サイトからAPIキーを取得します。
- サーバー側のコード統合: リクエストを送信し、返却された構造化結果をアプリケーションロジックに反映します。
- エラー処理の実装: タイムアウトやエラー時のフォールバックロジックを設計します。
（出典: Jev AI API Tutorial: Build Your First Structured Decision with Choice, Score, and Noul）
パフォーマンス特性
Jev AI APIは、以下の特徴を持っています。
- 非チャット型設計: チャットインターフェースを代替せず、ソフトウェアが消費可能な構造化された判断を提供します。
- 複数質問のサポート: 1つのリクエストで複数の質問を含めることができます。
- 確率の扱い: 確率を判断のシグナルとして扱い、最終的な結果としての信頼度を考慮します。
（出典: How to Use the Jev AI Model: A Step-by-Step Developer Guide）
まとめ
- Jev AI APIを活用して、サポートチケットの優先度付けやリスクスコアの算出などの構造化された判断を実現できます。
- APIキーを準備し、Jev AI Playgroundでリクエストを検証した後、サーバーサイドに統合することで、アプリケーションロジックにAI判断を組み込みます。
- 複数の質問タイプ（Choice、Score、Noul）を活用し、確率と信頼度をシグナルとして扱うことで、柔軟な判断ロジックを構築できます。
- エラー処理とタイムアウト対策を事前に設計することで、信頼性の高いシステムを構築します。
- Jev AIの公式ドキュメント（Jev AI homepage）を参照し、自社のユースケースに最適な実装方法を検討します。