チュートリアル: Azure SRE エージェントで DocsGuide を使用する

このチュートリアルでは、DocsGuide (組み込みのドキュメント機能) を使用して、Azure SRE エージェントの機能、構成、概念についてエージェントに質問します。 DocsGuide はライブの公式ドキュメントから回答するため、機能の進化に伴って応答は最新の状態に保たれます。

推定時間: 5 分

このチュートリアルでは、次の操作を行います。

• 概念に関する質問をし、DocsGuide 応答カードを確認する
• セットアップに関する質問をして、詳細なガイダンスを受け取る
• 機能に関する質問をして機能の詳細を確認する
• DocsGuide をトリガーするさまざまな質問パターンを調べる

前提条件

開始する前に、次のリソースがあることを確認します。

• 実行中の状態の Azure SRE エージェント
• エージェントのチャット インターフェイスへのアクセス
• sre.azure.comへの外向きのネットワークアクセス (DocsGuideは実行時にドキュメントページをフェッチします)

エージェント チャットを開く

まず、エージェント ポータルに移動し、会話を開きます。

1. sre.azure.com に移動し、エージェントを選択します。
2. チャット インターフェイスが開き、 新しいスレッド ビューと入力フィールドが表示されます。

チェックポイント： チャット入力が表示され、「質問をするかスラッシュ(/)を入力してコマンドを使用してください」というプレースホルダーが表示されます。

概念に関する質問

Azure SRE エージェントの概念について質問して、DocsGuide がどのように応答するかを確認してみてください。

チャット入力に次の質問を入力します。

What are run modes?

応答まで約 10 秒待ちます。

チェックポイント： あのう：

• 「1エージェント・1完了」を持つ並列探索カード
• 検索アイコンと緑色のチェックマークが付いた入れ子になった DocsGuide カスタム エージェント カード
• DocsGuide カードには、そのタスクが表示されます (例: "実行モードの定義")
• カードの下で、実行モードに関するエージェントの合成された回答

セットアップに関する質問をする

次に、セットアップ指向の質問を試して、DocsGuide で詳細なガイダンスがどのように提供されるかを確認します。

次の質問を入力します。

How do I connect PagerDuty to my agent?

チェックポイント： 応答には、特定のセットアップ手順が含まれています。 Settings>Incident プラットフォームに移動し、API キーを入力して、公式の PagerDuty チュートリアル ドキュメントから入手したクイック スタート応答プランを有効にします。

機能に関する質問をする

DocsGuide で機能がどのように説明されているかを確認するには、特定の機能について質問します。

次の質問を入力します。

How do scheduled tasks work?

チェックポイント： 応答では、スケジュールされたタスクの作成、繰り返しオプション、およびスケジュールされたタスク機能とチュートリアル ページから取得されたカスタム エージェントへの接続方法について説明します。

"Can I" の質問を試す

"Can I..." 質問パターンも DocsGuide をトリガーします。

次の質問を入力します。

Can I use Python to extend my agent?

チェックポイント： DocsGuide は、Python コード実行ドキュメントから入手したカスタム Python ツールを作成してデプロイする方法など、Python ツールに関する情報を返します。

効果的な質問に関するヒント

これらの質問パターンを使用して、DocsGuide から最も正確で完全な回答を取得します。

質問の種類	良い例	効果の低い例
特定の機能	"インシデント対応計画を設定するにはどうすればよいですか?	"エージェントについて教えてください"
セットアップ手順	"Kusto コネクタを接続するにはどうすればよいですか?	"すべてを設定する"
概念の明確化	「スキルと知識の違いは何ですか?	エージェントを説明する
機能チェック	"Teams 経由で通知を送信できますか?	"何ができますか?

ヒント

3 つの質問パターンが最適です。 "How do I..."、 "Can I..."、" What is..."。 質問の具体的な方が、回答の対象が多くなります。

まとめ

このチュートリアルでは、次の方法を学習しました。

• DocsGuide を使用して、エージェント チャットでドキュメントの質問を直接行います。
• 概念、セットアップ、機能に関する質問をして、正確で引用された回答を得ます。
• 参照されたドキュメント ページを示す DocsGuide カスタム エージェント タスク カードを認識します。
• 最適な結果を得るには、特定の質問パターン ("How do I..."、"Can I...."、"What is....") を使用します。

DocsGuide の回答は、トレーニング データではなく、sre.azure.com の公式ドキュメントに由来します。 この機能は、ポータル チャットと Teams ボットでも同じように機能します。

次のステップ

DocsGuide のしくみを確認する

関連するコンテンツ

• チャットで学習する
• サブエージェント
• エージェントプレイグラウンド