手順 3: Azure SRE エージェントでソース コードを接続する

GitHub または Azure DevOps リポジトリを接続します。 エージェントは、運用環境の問題を特定のコードに関連付けることで 、根本原因分析 を実行できるようになりました。

達成する内容

この手順を完了すると、エージェントは次の操作を行います。

  • 調査中にソース コードを分析する
  • 問題のためにファイルおよび行の参照を提供します
  • 調査手順を示す To-Do プランを作成します
  • 運用環境の症状をコードの変更に関連付ける

前提条件

Requirement 詳細情報
エージェントが作成されました 最初に手順 1 を完了する
GitHub または Azure DevOps アカウント 接続するリポジトリへのアクセス

認証方法を選択します

メソッド いつ使用するか
GitHub アプリ 組織によって管理されるアプリと、Key Vault によって裏付けられた署名キーを使用します。 *.ghe.comに必要です。
マネージド ID 長期間有効なユーザー資格情報なしで Azure DevOps を接続します。
OAuth GitHub または Azure DevOps アカウントでサインインします。
PAT ターゲットサービスに必要な最低限の権限を持つ個人アクセストークンを提供してください。

リポジトリを接続する

エージェントがナレッジ ソースとしてインデックスを作成できるように、GitHub リポジトリを接続します。 ダイアログには、リポジトリの参照可能な一覧が表示されます。 URL を手動で入力する代わりに、ドロップダウンから選択します。

手順 1: [リポジトリの追加] ダイアログを開く

オンボード中に、ナレッジ ベースの手順で [リポジトリの追加] カードを選択します。

既存のエージェントについては、[ビルドとセットアップ]>[コンテキスト]>[コード アクセス] に移動し、サービス タブを選択して [リポジトリの追加] を選択します。

手順 2: プラットフォームを選択する

  1. GitHub または Azure DevOps を選択します。

  2. 接続ステップで、GitHub の完全なリポジトリ URL、または Azure DevOps の組織名を入力します。

  3. 既存の接続があれば選択するか、新しい接続を設定しましょう。

  4. 認証方法を選択し、各項目を入力してください。 GitHubはOAuth、パーソナルアクセストークン(PAT)、そしてUse Your GitHub Appを提供しています。 Azure DevOpsはYour Account、Managed Identity、PATを提供しています。

  5. 選択した方法で表示されたサインインまたは接続テストを完了してください。 メソッド固有の指示については、「 ソースコードサービスを接続する」を参照してください。

    注

    サインイン ダイアログが表示されない場合は、ブラウザーが sre.azure.comからのポップアップをブロックしていないことを確認します。

  6. 接続が成功しているか確認してください。

  7. 次へを選択します。

手順 3: リポジトリを選択する

リポジトリを追加で、初期リポジトリを確認し、必要に応じてエントリを追加してください。 リポジトリURLフィールドはリポジトリ選択と直接URL入力をサポートします:

  • GitHub リポジトリはorg/repo-nameとして表示され、アルファベット順に並べ替えられます (最大 100 個のリポジトリ)。

  • Azure DevOps リポジトリは 、 Azure DevOps プロジェクト のドロップダウンからプロジェクトを選択すると、アルファベット順に並べ替えられた後に表示されます。

ドロップダウンからリポジトリを選択します。 表示名は、リポジトリ名と共にオートコンプリートします。 有効なリポジトリ URL をフィールドに直接入力することもできます。

GitHubでは、エントリを追加するには「リポジトリを追加」を選択してください。 各エントリを展開して [表示名] を編集するか、[説明の追加] を使用します。 Azure DevOpsの場合は、グリッド内で追加を使い、それらのフィールドを編集します。

ヒント

ドロップダウンでは、自由形式の入力が可能です。 リポジトリが一覧に表示されない場合 (たとえば、リポジトリが 100 個を超える場合)、完全な URL を直接入力します。

手順 4: 確認して保存する

保存 を選択します。 リポジトリは コードアクセス ページに接続情報と最終同期情報とともに表示されます。

手順 5: pull request の作成を試す (プレビュー)

リポジトリが接続された状態で、エージェントはチャットから直接プル要求を作成できるようになりました。

  1. エージェントでチャット スレッドを開きます。
  2. "fix/my-branch から main への「Fix connection timeout」というタイトルの PR を https://github.com/OWNER/REPOで作成する" のようなプロンプトを入力します。
  3. レビュー モードで、[ 続行 ] を選択して PR の作成を承認します。

エージェントは、作成された PR へのクリック可能なリンクを含むツール カードを返します。

注

プル要求を作成するには、レビューまたは自律実行モードが必要です。 ソース ブランチは、変更がコミットされた状態で既に存在している必要があります。

接続されているリポジトリを管理する

コードアクセスページには、接続されたリポジトリとその接続名が一覧化されています。

リポジトリを削除するには:

接続されているリポジトリを削除するには、次の手順に従います。

  1. ビルド + セットアップ>コンテキスト>コード アクセスに移動してください。
  2. サービス タブを選択し、リポジトリのチェックボックスをオンにします。
  3. 削除を選択し、確認内容を確認してから先に進めてください。

認証を更新するには: PAT の有効期限が切れた場合、またはアカウントを切り替える必要がある場合は、[ リポジトリの追加 ] ダイアログを再度開き、新しい資格情報で再認証します。

代替手段: MCP + カスタム エージェント

完全な GitHub API アクセス (すべてのリポジトリでコードの検索、ファイルの読み取り、およびコミットの一覧表示) を取得するには、専用のカスタム エージェントを使用して GitHub を MCP サーバーとして接続します。

この方法では、モデル コンテキスト プロトコル (MCP) を使用して、GitHub ツールをカスタム エージェントに接続します。 詳細なチュートリアル「 MCP コネクタのセットアップ」に従います。

エージェントは、調査中にソース コードを分析し、問題のファイルと行の参照を提供し、調査手順を示す To Do プランを作成し、運用環境の症状をコードの変更に関連付け、接続されたリポジトリにチャットから直接プル要求を作成できるようになりました。

学習した内容

  • エージェントが調査中にソース コードを分析するようになりました。
  • これは、問題のファイルと行参照を提供します。
  • 調査手順を示す To-Do プランが作成されます。
  • 運用環境の症状とコードの変更を関連付ける。

関連するコンテンツ

リソース Description
根本原因分析 エージェントがソース コードを使用して根本原因を見つける方法。
詳細な調査 接続リポジトリを利用した拡張マルチハイポセシス分析。
エージェントプレイグラウンド MCP ツールとカスタム エージェントを対話形式でテストします。
カスタム エージェント カスタム エージェントがエージェントの機能を拡張する方法。
コネクタ すべてのコネクタの種類とそのしくみ。
  • 最終更新: