推定時間: 10 分
エージェントが根本原因分析を実行できるように、GitHubまたはAzure DevOps リポジトリを接続し、運用環境の問題を特定のコードに関連付けます。
達成する内容
このチュートリアルの終わりまでに、エージェントは次のことができます。
- 調査中にソース コードを分析する
- 問題の特定のファイルと行参照を指定する
- 調査手順を示す To Do プランを作成する
- 運用環境の症状をコードの変更に関連付ける
前提条件
| Requirement | 詳細情報 |
|---|---|
| エージェントが作成されました | 「手順 1: エージェントを最初に作成する」を完了します。 |
| GitHubまたはAzure DevOps組織 | 接続するリポジトリへのアクセス。 |
認証方法を選択します
環境に最適な認証方法を選択します。
| メソッド | いつ使用するか |
|---|---|
| OAuth | GitHub アカウントでサインインします。 トークンは必要なく、最も簡単なセットアップを提供します。 |
| PAT | スコープrepo を持つ個人用アクセス トークンを指定してください。 SSO の制限がある組織に対して機能します。 |
リポジトリを接続する
エージェントがナレッジ ソースとしてインデックスを作成できるように、GitHubまたはAzure DevOps リポジトリを接続します。 ダイアログには、リポジトリの参照可能な一覧が表示されます。 URL を手動で入力する代わりに、ドロップダウンから選択します。
手順 1: [リポジトリの追加] ダイアログを開く
オンボード中に、ナレッジ ベースの手順で [リポジトリの追加] カードを選択します。
既存のエージェントの場合は、 Builder>Knowledge ベース に移動し、[リポジトリの 追加] アクション カードを選択します。
手順 2: プラットフォームを選択する
プラットフォームを選択して認証するには、次の手順に従います。
GitHub または Azure DevOps を選択します。
サインイン方法を選択します。
メソッド いつ使用するか 認証 (OAuth) GitHubまたはAzure DevOps組織でサインインします。 トークンは必要ありません。 PAT スコープ repoを持つ個人用アクセス トークンを指定してください。認証の完了:
- OAuth:Sign in to GitHub (または Sign in to Azure DevOps) を選択し、認証ポップアップを完了します。
- Pat： [ PAT の入力 ] フィールドにトークンを入力し、[ 接続] を選択します。
注
サインイン ダイアログが表示されない場合は、ブラウザーが
sre.azure.comからのポップアップをブロックしていないことを確認します。成功すると、認証済みのアカウントを示す 接続済み カードが表示されます。
次へを選択します。
手順 3: リポジトリを選択する
認証後、[ リポジトリ URL ] フィールドにリポジトリのドロップダウンが表示されます。
-
GitHubリポジトリは
org/repo-nameとして表示され、最終更新日時 (最大 100 個のリポジトリ) で並べ替えられます。 - Azure DevOpsリポジトリは、Azure DevOps Projectドロップダウンからprojectを選択した後に表示されます。
ドロップダウンからリポジトリを選択します。 表示名は、リポジトリ名でオートフィルされます。 有効なリポジトリ URL をフィールドに直接入力することもできます。
複数のリポジトリを追加するには、[ 追加 ] を選択して行をさらに挿入します。
ヒント
ドロップダウンでは、自由形式の入力が可能です。 リポジトリが一覧に表示されない場合 (たとえば、リポジトリが 100 個を超える場合)、完全な URL を直接入力します。
手順 4: 確認して保存する
[ リポジトリの追加] を選択して変更を保存します。
存在しない場合、システムは自動的に適切な GitHub OAuth コネクタまたは Azure DevOps OAuth コネクタを作成します。
手順 5: pull request の作成を試す (プレビュー)
リポジトリが接続された状態で、エージェントはチャットから直接プル要求を作成できるようになりました。
- エージェントでチャット スレッドを開きます。
- "fix/my-branch から main への「Fix connection timeout」というタイトルの PR を https://github.com/OWNER/REPOで作成する" のようなプロンプトを入力します。
- レビュー モードで、[ 続行 ] を選択して PR の作成を承認します。
エージェントは、作成された PR へのクリック可能なリンクを含むツール カードを返します。
注
プル要求を作成するには、レビューまたは自律実行モードが必要です。 ソース ブランチは、変更がコミットされた状態で既に存在している必要があります。
接続されているリポジトリを管理する
[リポジトリの追加] ダイアログを再度開くと、既存の接続されているリポジトリがグリッド内の読み取り専用行として表示されます。
リポジトリを削除する
接続されているリポジトリを削除するには、次の手順に従います。
- Builder>Knowledge ベースに移動し、[リポジトリの追加] アクション カードを選択します。
- グリッド内のリポジトリ行を見つけます。
- 行の ごみ箱アイコン を選択して、削除対象としてマークします。
- [ リポジトリの追加] を選択して変更を保存します。
- [ 変更の確認 ] ダイアログで、削除されたリポジトリを確認します。
- 続行するには [確認 ] を選択し、保持するには [キャンセル] を選択します。
認証を更新する
PAT の有効期限が切れた場合、またはアカウントを切り替える必要がある場合は、[リポジトリの追加] ダイアログを再度開き、新しい資格情報で再認証します。
代替手段: MCP とカスタム エージェント
完全なGitHub API アクセス (検索コード、ファイルの読み取り、すべてのリポジトリのコミットの一覧表示) を行う場合は、専用のカスタム エージェントを使用して MCP サーバーとしてGitHub接続します。
この方法では、モデル コンテキスト プロトコル (MCP) を使用して、GitHub ツールをカスタム エージェントに接続します。 詳細な手順については、「 チュートリアル: MCP コネクタを設定する」を参照してください。
まとめ
エージェントは、調査中にソース コードを分析し、問題のファイルと行の参照を提供し、調査手順を示す To Do プランを作成し、運用環境の症状をコードの変更に関連付け、接続されたリポジトリにチャットから直接プル要求を作成できるようになりました。