このチュートリアルでは、Azure SRE エージェント ポータルのテスト プレイグラウンドを使用して、ツールをデプロイする前にテストおよびデバッグします。 プレイグラウンドを使用すると、カスタム パラメーターを使用してツールを分離して実行し、すぐに結果を確認できます。
このチュートリアルでは、以下の内容を学習します。
- 任意のツールのテストプレイグラウンドにアクセスする
- ライブ クエリを使用して Kusto ツールをテストする
- カスタム パラメーターを使用してシステム ツールをテストする
- デプロイする前に結果を確認する
推定時間: 5 分
前提条件
開始する前に、次の項目があることを確認します。
- 少なくとも 1 つのツールが作成されました (Kusto ツールまたはシステム ツール)。 詳細については、「 Kusto ツールの作成」を参照してください。
- SRE エージェント ポータルへのアクセス。
遊び場を開く
エージェント キャンバスのテストプレイグラウンドに移動します。
- SRE エージェント ポータルを開き、エージェントを選択します。
- [ ビルダー>Agent Canvas] を選択します。
- ビューの切り替えで [ テスト プレイグラウンド ] を選択します ( [キャンバス ビュー ] と [テーブル ビュー] の横)。
プレイグラウンドの上部に カスタム エージェント/ツール セレクターがあり、"プレイグラウンド セッションを開始するエージェントまたはツールを選択してください" というメッセージが表示された空の状態が表示されます。
ツールを選択する
エンティティ セレクターからテストするツールを選択します。
- 上部にある [カスタム エージェント/ツール ] ドロップダウンを選択します。
- 一覧を参照または検索します。 各エントリには、カスタム エージェントの 自律型 、システム ツール用 の組み込みツール 、 Kusto ツール用 Kusto ツール など、その種類を示すサブラベルが表示されます。
- テストするツールを選択します。
- を選択してを適用します。
プレイグラウンドは、選択したツールの構成とテスト インターフェイスを読み込みます。
Kusto ツールをテストする
Kusto ツールを選択した場合は、次の手順を使用してテストします。
- 左側のパネルを確認します。このパネルには、クエリ構成 (クラスター、データベース、クエリ テキスト、パラメーター定義) が表示されます。
- 右側のパネルで、クエリに必要なすべてのパラメーター値を入力します。
- [テストの実行] を選択します。
テスト パネルには、次の情報が表示されます。
- 成功または失敗の状態
- 返される行数と列数
- テーブルに表示されるクエリ結果
- 実行時間 (ミリ秒)
緑色の成功インジケーターは、接続されているクラスターに対してクエリが正しく実行されていることを確認します。
注
テストが正常に実行されるまで、[ 保存] ボタンは無効になります。 この条件により、実際にクラスターに対して機能するクエリのみが保存されます。
ヒント
クエリから予期しない結果が返された場合は、KQL を調整し、[ テストの再実行 ] を選択します。 遊び場を離れることなく反復できます。
システム ツールをテストする
システム ツールを選択した場合は、次の手順を使用してテストします。
- 左側のパネルを確認します。ツール情報 (名前、説明、プラグイン、カテゴリ) が表示されます。
- 右側のパネルで、必要なパラメーター値を入力します。
- [ ツールの実行] を選択します。
このツールは、JSON 出力を実行し、埋め込みエディターに表示します。 出力が入力に予想される動作と一致するかどうかを確認します。
検証と反復処理
テスト後、結果を確認し、必要に応じて調整します。
- Kusto ツール: 結果が正しくない場合は、KQL を調整して再実行します。 クエリが正しい場合は [保存]を選択します 。 保存は、テストの実行が成功した後にのみ有効になります。
- システム ツール: 出力が予期しない場合は、パラメーター値を確認して再実行します。
[保存] を選択すると、Kusto ツールへの変更が 保存されます。 システム ツールは、指定したパラメーターを使用して実行されるため、保存する必要はありません。
Troubleshooting
一般的な問題を解決するには、次の情報を使用します。
セレクターにツールが表示されない
少なくとも 1 つのツールが作成されている必要があります。 [エージェント キャンバス] ツールバーで、作成>ツール>Kusto ツール を選択して作成します。
Kusto ツールに "コネクタが構成されていない" と表示される
Kusto ツールのテストにはデータ コネクタが必要です。 Builder>Connectors に移動し、クラスターの URL とデータベースを使用して Azure Data Explorer コネクタを追加します。 その後、プレイグラウンドに戻り、Kusto ツールをもう一度選択します。
Kusto テストで承認エラーが表示される
エージェントは Kusto クラスターにアクセスする必要があります。 次の項目を確認します。
- Builder>Connectors でクラスターのデータ コネクタを構成しました。
- コネクタの資格情報には、ターゲット データベースに対するクエリアクセス許可があります。
システム ツールがエラーを返す
次の項目を確認します。
- 必要なすべてのパラメーターを入力しました。
- パラメーター値は、予期される形式 (文字列、数値、および同様の値) と一致します。
- ツール名とプラグインが正しく構成されています。
Python ツールが一覧に表示されない
Python ツールには、Python ツール エディター内に独自のテスト インターフェイスがあります。 エージェント キャンバスからエディターを開きます。 Python ツールをテストするには、エディターの組み込みのテスト パネルを使用します。