Azure AI Agents Persistent SDK for Java
Azure SDK を使用して永続的な AI エージェントを作成する
セッション間で状態を維持する永続的な AI エージェントを構築します。この SDK は、Java アプリケーションにおけるエージェントのスレッド、メッセージ、および実行に対する低レベルの制御を提供します。
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「Azure AI Agents Persistent SDK for Java」を使用しています。 代数を学ぶ学生を支援する数学チューターエージェントを作成する
期待される結果:
- エージェント 'Math Tutor' が ID: agent_abc123 で正常に作成されました
- ID: thread_xyz789 でスレッドが作成されました
- メッセージがスレッドに追加されました
- 実行が開始され、完了しました
- アシスタント: 2x + 5 = 15 を解くには、まず両辺から 5 を引きます...
「Azure AI Agents Persistent SDK for Java」を使用しています。 二次方程式を解くためのコードを実行する
期待される結果:
- 実行ステータス:RequiresAction
- ツール呼び出し:code_interpreter
- コードが実行されました:numpy.roots([1, -5, 6])
- アシスタント: 解は x = 2 および x = 3 です
セキュリティ監査
安全Static analysis scanned 0 files with 0 lines. Risk score: 0/100. This skill contains only documentation (SKILL.md) describing the Azure AI Agents Persistent SDK for Java. No executable code, scripts, or security-sensitive patterns detected. The documentation describes standard Azure authentication patterns using DefaultAzureCredential which is the recommended secure approach.
品質スコア
作れるもの
カスタマーサポートエージェントの統合
カスタマーセッション間で会話履歴を維持する永続的なサポートエージェントを Java バックエンドに埋め込みます。
教育チュータリングシステム
学生の進捗を追跡し、複数セッションにわたって指導スタイルを適応させるパーソナライズされたチュータリングエージェントを構築します。
エンタープライズアシスタントワークフロー
ドキュメント処理やデータ分析などの一般的なエンタープライズタスク向けの再利用可能なエージェントインスタンスを作成します。
これらのプロンプトを試す
Java を使用して基本的な Azure AI 永続エージェントを作成する方法を教えてください。DefaultAzureCredential での認証設定、カスタム指示を持つエージェントの作成、およびシンプルなメッセージの送信方法を示してください。
Azure AI 永続エージェントを使用してマルチターン会話フローを構築する方法を教えてください。スレッドの作成、メッセージの追加、エージェントの実行、完了のポーリング、およびスレッドからのすべてのメッセージの取得を含めてください。
カスタムツールを使用する Azure AI エージェントを作成する必要があります。ツールの定義、エージェントへのアタッチ、RequiresAction ステータスの処理、およびツール出力を実行に送信する方法を示してください。
Java での Azure AI 永続エージェントの完全な本番対応の例を作成してください。すべての実行ステータスの適切なエラー処理、高スループットのための非同期クライアントの使用、finally ブロックでのリソースクリーンアップ、および環境ベースの設定を含めてください。
ベストプラクティス
- ハードコードされたキーの代わりに、安全な本番認証に DefaultAzureCredential を使用する
- レート制限を回避するために、実行ステータスチェックの間に適切なポーリング遅延 (500ms を推奨) を実装する
- 不要になったときは常にスレッドとエージェントを削除してリソースをクリーンアップする
回避
- 実行ステータスチェックの間のポーリングをスキップし、状態遷移を見逃す
- 環境変数と Azure 管理アイデンティティを使用する代わりに、認証情報をハードコードする
- すべての実行ステータス (RequiresAction、Failed、Cancelled) を処理せず、ワークフローが停止する