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

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

達成する内容

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

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

前提条件

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

認証方法を選択します

メソッド いつ使用するか
OAuth GitHub アカウントでサインインします。 トークンは必要なく、最も簡単なセットアップです。
PAT スコープrepo を持つ個人用アクセス トークンを指定してください。 SSO の制限がある組織で動作します。

リポジトリを接続する

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

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

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

既存のエージェントの場合は、 Builder>Knowledge ベース に移動し、[リポジトリの 追加] アクション カードを選択します。

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

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

  2. サインイン方法を選択します。

    メソッド いつ使用するか
    認証 (OAuth) GitHub または Azure DevOps アカウントでサインインします。 トークンは必要ありません。
    PAT repoスコープを持つ個人用アクセス トークンを指定する

  3. 認証の完了:

    • Oauth： [ GitHub にサインインする ] または [Azure DevOps にサインイン] を選択し、認証プロセスを完了します。
    • Pat： [ PAT の入力 ] フィールドにトークンを入力し、[ 接続] を選択します。

    注

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

  4. 結果を確認します。 認証 されたアカウントが表示された接続済みカードが表示されます。

  5. 次へを選択します。

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

認証後、[ リポジトリ URL ] フィールドにリポジトリのドロップダウンが表示されます。

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

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

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

複数のリポジトリを追加するには、[ 追加 ] を選択して行をさらに挿入します。

ヒント

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

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

[ リポジトリの追加] を選択して保存します。

存在しない場合、システムは自動的に適切な GitHub OAuth コネクタまたは Azure DevOps OAuth コネクタを作成します。

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

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

  1. エージェントでチャット スレッドを開きます。

  2. "fix/my-branch から main への「Fix connection timeout」というタイトルの PR を https://github.com/OWNER/REPOで作成する" のようなプロンプトを入力します。

  3. レビュー モードで、[ 続行 ] を選択して PR の作成を承認します。

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

注

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

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

[ リポジトリの追加 ] ダイアログを再度開くと、既存の接続されているリポジトリがグリッド内の読み取り専用行として表示されます。

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

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

  1. Builder>Knowledge ベースに移動し、[リポジトリの追加] アクション カードを選択します。

  2. グリッド内のリポジトリ行を見つけます。

  3. 行の ごみ箱アイコン を選択して、削除対象としてマークします。

  4. [ リポジトリの追加] を選択して変更を保存します。

  5. 削除されたリポジトリが一覧表示された [ 変更の確認 ] ダイアログが表示されます。

  6. 続行するには [確認 ] を選択し、保持するには [キャンセル] を選択します。

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

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

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

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

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

学習した内容

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

関連するコンテンツ

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