このチュートリアルでは、独自の命令、ツール、スキルを使用して、サブエージェント ビルダーで特殊なサブエージェントを作成します。 サブエージェントは、正常性レポート、アラートトリアージ、通知配信などのフォーカスされたタスクを処理します。 サブエージェントの動作の詳細については、 サブエージェントを参照してください。
推定時間: 5 分
このチュートリアルでは、以下の内容を学習します。
- サブエージェント ビルダーでカスタム命令を使用してサブエージェントを作成する
- スキル、ツール、フックをサブエージェントに割り当てる
- ダイアログとプレイグラウンドでサブエージェントをテストする
- フォームまたは YAML を使用してサブエージェント構成を編集および管理する
前提条件
- Azure SRE エージェント ポータルで作成されたエージェント。
- サブエージェントで外部ツールを使用する場合は、少なくとも 1 つのコネクタが構成されています。
サブエージェントを作成する
ポータルから新しいサブエージェントを作成するには、次の手順に従います。
SRE エージェント ポータルを開き、エージェントを選択します。
Builder>Subagent builder を選択します。
ツール バーの [ 作成 ] ドロップダウンを選択し、[ カスタム エージェント] を選択します。
作成ダイアログが開き、 フォーム と YAML の 2 つのタブが表示されます。
必須フィールドを入力してください。
フィールド 値の例 カスタム エージェント名 (必須) health-check-reporter手順 (必須) 「あなたは健康チェックレポーターです。 運用リソース グループ内のコンテナー アプリの Azure リソース正常性を確認します。 正常、警告、および重大な数値をまとめます。 概要を電子メールで送信します。 ヒント
[手順] フィールドの上にある [ AI で絞り込む ] を選択して、エージェントが自動的に手順を改善できるようにします。 [ AI 候補の表示 ] を選択して、手順、ツール、スキルを改善するための推奨事項を表示します。
(省略可能)ダイアログの残りのセクションを構成します。 これらのセクションをスキップすると、サブエージェントは既定ですべてのグローバル スキルとツールを継承します。
[スキル]: [ スキルの選択] を選択 して、サブエージェントに特定のスキルを割り当てます。 特定のスキルを選択すると、グローバルな既定値がオーバーライドされます。 すべてのグローバル スキルを許可するには、選択内容を空のままにします。 詳細については、「 スキル」を参照してください。
ツール: [ ツールの選択] を選択 して、ツール ピッカー パネルを開きます。 カテゴリ別に整理されたツール (Kusto ツールや通知ツールなど) を参照または検索します。 サブエージェントで使用するツールを選択します。 最初にカスタム ツールを作成するには、「 Kusto ツールの作成 」または 「Python ツールの作成」を参照してください。 詳細については、「 ツール」を参照してください。
フック: [ フックの管理 ] を選択して、安全性とガバナンスの制御を追加します。 フックは、アクション (プロンプト フック) の前またはツールの使用後 (コマンド フック) の前に実行されます。 セットアップ手順については、 ポータルでのフックの作成と管理に関するページを参照してください。 詳細については、「 エージェントフック」を参照してください。
を選択してを作成します。
サブエージェントは、接続されたツールが表示されたサブエージェント ビルダー キャンバス上のノードとして表示されます。
ヒント
ツールを割り当てる前に、 テストプレイグラウンド で個別にテストし、期待したデータが返されることを確認します。
サブエージェントをテストする
サブエージェントを作成したら、それをテストして、期待どおりに動作することを確認します。
ダイアログからテストする
[作成または編集] ダイアログで、右上隅にあるテスト アイコンを選択して、[ テスト ライブ エージェント ] パネルを開きます。 プロンプトを入力し、サブエージェントが現在の命令とツールで応答する方法を確認します。
遊び場でテストする
プレイグラウンドを使用して、分割画面レイアウトを使用した対話型のテスト エクスペリエンスを実現します。
- サブエージェント ビルダーのツール バーで、[ テスト プレイグラウンド ビュー] トグルを選択します。
- 分割画面レイアウトには、サブエージェントの構成が一方の側に表示され、もう一方の側にライブ チャットが表示されます。
- サブエージェントを選択し、テスト プロンプトを入力して、期待どおりに動作するかどうかを確認します。
- 命令を編集するか、ツールをスワップして反復処理し、出力が期待値と一致するまでもう一度テストします。
詳細については、「エージェントプレイグラウンド」または「プレイグラウンドでツールをテストする」を参照してください。
サブエージェントを編集する
既存のサブエージェントを変更するには、サブエージェント ビルダー キャンバスでその構成を開きます。
サブエージェント ノードを選択し、[ 編集] を選択します (または、ノードをダブルクリックします)。 編集ダイアログが開き、現在のすべての値が事前設定されています。
| 変更する内容 | 更新するフィールド |
|---|---|
| 動作内容 | 手順 |
| どのスキルを使用するか | スキル> スキルの選択 |
| どのツールを使用していますか | ツール> ツールの選択 |
| 安全管理 | フック> フックの管理 |
終わったら、保存を選択します。
YAML を使用して編集する
構成をコピーしたり、コードとして構成を管理したりするために、サブエージェントの構成を YAML として表示または編集できます。
作成または編集ダイアログの上部にある [YAML ] タブを選択して、YAML モードに切り替えます。 YAML モードの変更は、フォーム ビューに同期されます。