統合エージェントをテストして反復処理する

前のユニットの手順を使用してエージェントを発行した後、継続的なテストと監視によって、エージェントがユーザーに対して確実に実行されるようにします。 このユニットでは、デプロイ後のテスト戦略、一般的な問題のトラブルシューティング、時間の経過に伴うエージェントの監視に重点を置いています。

Foundry プレイグラウンドを超えたテスト

Foundry プレイグラウンドは開発テストには価値がありますが、公開された完全なエクスペリエンスはシミュレートされません。 発行後、Microsoft Teamsでエージェントをテストして、次のことを確認します。

• Teams ユーザー インターフェイスが応答を正しくレンダリングする
• 認証フローは想定どおりに動作します
• 運用環境では応答時間が許容されます
• 公開されたエージェントの識別子には必要な権限がある

複数のユーザーによるテスト

同僚にエージェントをテストして、見逃す可能性のある問題を検出してもらう。 ユーザーごとに質問のフレーズが異なり、新しい視点によって混乱を招く応答が識別されます。 異なる Teams クライアント (デスクトップ、Web、モバイル) 間でテストを行うと、プラットフォーム固有の問題も明らかになる可能性があります。

一般的なトラブルシューティングのシナリオ

問題が発生した場合、次の一般的なシナリオと解決策が役立ちます。

エージェントが Teams で応答しない

次の原因が考えられます。

• Azure Bot Serviceが実行されていません
• Bot Service構成が正しくありません
• Teams とエージェント間のネットワークの問題

解決策:

1. Azure portalにBot Service リソースが存在するかどうかを確認します。
2. エラーを確認するために、Bot Service のログをチェックします。
3. エージェントが発行され、パッケージが正しくアップロードされたことを確認します。

ツールは Foundry で動作しますが、Teams では失敗します

考えられる原因: 発行されたエージェント ID には、必要なアクセス許可がありません。

解決策:

1. Foundry ポータルで、発行されたエージェントの ID を見つけます。
2. Azure ポータルで、ツールがアクセスするリソースを見つけます。
3. 公開されたエージェント ID に適切な RBAC ロールを割り当てます。

ユーザーがエージェントを見つけることができません

次の原因が考えられます。

• 間違った発行スコープが選択されました
• 管理者の承認が保留中です（組織範囲の場合）
• テナント ポリシーによってカスタム アプリがブロックされる

解決策:

• 共有スコープの場合: 直接リンクをユーザーと共有します。
• 組織のスコープの場合: Microsoft 365 admin centerで管理者の承認を確認します。
• カスタム アプリのアクセス許可のテナント設定を確認します。

応答時間が遅い

次の原因が考えられます。

• 拡張処理を必要とする複雑なエージェント命令
• 大規模なデータ セットに対してクエリを実行するツール
• ネットワーク待ち時間

解決策:

• エージェントの指示を可能な限り簡略化します。
• ツール構成を最適化します。
• ネットワークの問題を分離するために、さまざまなネットワークの場所からテストします。

発行済みエージェントの監視

デプロイ後の継続的な監視は、ユーザーが問題を報告する前に特定するのに役立ちます。

Foundry メトリックを確認する

Foundry ポータルは、公開されたエージェントのメトリクスを提供します。

• 要求のボリュームとパターン
• 応答時間
• エラー率
• ツール呼び出しの統計情報

これらのメトリックを定期的に確認して、問題を示す傾向を特定します。

Application Insights を確認する

Application Insights の統合を構成した場合は、次のことができます。

• 個々の会話をトレースする
• エラー パターンの分析
• エンドツーエンドの待機時間を測定する
• 異常のアラートを設定する

ユーザーフィードバックを収集する

ユーザーが問題を報告するためのチャネルを確立します。

• エージェントフィードバック用の Teams チャネルまたはメール アドレスを作成する
• フィードバックを定期的に確認して一般的な問題を特定する
• フィードバックを使用してエージェントの機能強化に優先順位を付ける

開発中エージェントの反復処理

テストで問題が明らかになったり、ユーザーからのフィードバックを受け取ったりした場合は、Foundry ポータルでエージェントを更新し、発行ユニットで説明されているのと同じプロセスに従って再発行します。 組織スコープの展開の場合は、テナントのポリシーを確認して、更新プログラムで再承認が必要かどうかを判断します。