GitHub Server Pull Requests Microsoft 365 Copilot コネクタは、GitHub Enterprise Server からの pull request データを Microsoft 365 に統合します。 コネクタを構成し、GitHub コンテンツにインデックスを付けた後、ユーザーは Microsoft Search、Microsoft 365 Copilot、Copilot Search から直接 pull request 情報を検出、集計、取得できます。 このインデックス作成により、エンジニアリング チームは、アプリケーションを切り替えることなく、進行中の変更、コード レビューの分析情報、リリース情報、リポジトリ アクティビティにすばやくアクセスできます。
GitHub Server Pull Requests コネクタを使用してデータのインデックスを作成する理由
最新のソフトウェア開発チームは、作業の管理、変更に関する共同作業、リリースの準備状況の評価を行うためにプルリクエストに依存しています。 ただし、プル要求データは GitHub でサイロ化されることが多いため、エンジニア、プログラム マネージャー (VM)、DevOps、SRE、利害関係者がリポジトリ間で手動で検索して、関連する PR を見つける必要があります。
GitHub Server Pull Requests コネクタは、GitHub Enterprise Server から pull request メタデータにインデックスを付けることで、この課題に対処します。 ユーザーは、Microsoft 365 から直接 PR を検索、フィルター処理、および要約できます。 Copilot を使用すると、ユーザーは "支払いサービスでレビューを待機しているオープン PR は何か" などの自然言語の質問を行い、GitHub へのリンクを含む実用的で実用的な応答を受け取ることができます。
一般的なユース ケースは次のとおりです。
- コード レビューを高速化する: 状態、ラベル、マイルストーン、またはチーム別の Surface PR。
- リリース管理を改善する: リリース ブランチを対象とする PR、またはデプロイのブロックを特定します。
- 機能間コラボレーションをサポートする: VM、サポート チーム、リーダーシップがエンジニアリングの進捗状況を追跡するのに役立ちます。
- コンテキストの切り替えを減らす: GitHub の作業を参照しながら、開発者と利害関係者が Microsoft 365 内に留まるようにします。
GitHub Server Pull Requests コネクタを使用してエージェントをビルドする
開発者は、このコネクタを、Copilot Studio、Microsoft 365 Copilotのエージェント ビルダー、または Microsoft 365 Agents Toolkit を使用して構築する宣言型エージェントのナレッジ ソースとして使用できます。
GitHub pull request データをエージェントに組み込むことで、開発者はユーザーに次の機能を許可します。
- レビューを待機している PR を取得して要約します。
- 機能の作業、マイルストーン、またはインフラストラクチャの変更に関連付けられている PR を特定します。
- 計画およびリリース サイクル中のエンジニアリングの進捗状況を可視化します。
エージェントプロンプト
次の例では、エージェント ビルダーが GitHub Server Pull Requests から情報を取得するのに役立つプロンプトを示します。
エンジニアリング
- チェックアウト サービスで現在確認を待っているオープン PR は何ですか?
- バックエンド リポジトリに対して今週作成された下書きプル要求を要約します。
- どの PR が自分に割り当てられ、その現在の状態は何ですか?
DevOps / SRE
- リリース ブランチを対象とする PR を一覧表示し、その準備状況を要約します。
- メタデータまたはラベルに基づくインフラストラクチャまたは構成の変更を含む PR はどれですか?
- 今後の運用環境のデプロイをブロックしている PR は何ですか?
IT サポート/ヘルプ デスク
- 内部ツールの更新に関連する PR を検索し、予想される影響を要約します。
- 開発者環境の改善を追跡するプルリクエストは何ですか?
製品管理
- コア リポジトリ間で vNext マイルストーンにリンクされている PR を要約します。
- 次のリリースで計画されている機能に対応するオープン PR はどれですか?
エンジニアリング リーダーシップ
- チーム間で優先度の高い PR の概要を提供します。
- 最も長く開いている PR と、それらを所有するユーザーはどれですか?
GitHub Server Pull Requests コネクタの機能と制限事項
GitHub Server Pull Requests コネクタを使用すると、ユーザーは次のことができます。
- プル要求メタデータに対して自然言語クエリを実行します。
- タイトル、説明、ラベル、マイルストーン、作成者、レビュー担当者、担当者、タイムスタンプなどのプルリクエストの詳細を取得します。
- organizationやリポジトリ メタデータなどの Surface リポジトリ レベルのコンテキスト。
- 承認されたユーザーのみがプライベート リポジトリの PR を表示するように、GitHub のアクセス制御を維持します。
- Microsoft 365 Copilotと Microsoft Search を使用して、PR データを効率的に集計および探索します。
- クロール頻度、ID マッピング、インデックス作成の基本設定をカスタマイズします。
GitHub Server Pull Requests コネクタには、次の制限があります。
- コードの差分、ファイルの変更、インライン コメント、コミット メッセージ、またはコミット レベルの詳細にインデックスを付けることはできません。
- 基本的な状態メタデータを超える CI/CD パイプラインにはインデックスが作成されません。
- API アクセシビリティ要件を満たしていないオンプレミスまたはセルフホステッドの GitHub インスタンスはサポートされていません。
- GitHub Enterprise が必要です。GitHub Free プランまたは Team プランの互換性が低下している可能性があります。
- コメント、スレッドディスカッション、リンクされた成果物はクロールされません。
- セキュリティ上の理由から、コネクタは、すべてのリポジトリがパブリックである組織のインデックス作成をサポートしていません。 このシナリオのブロックを解除するには、Microsoft サポートにお問い合わせください。
GitHub Server Pull Requests からインデックスが作成されたデータ型
次の表では、コネクタによってインデックスが作成されたデータ型について説明します。
| GitHub エンティティ | Copilot でインデックスを作成して表示し、検索する |
|---|---|
| Pull request メタデータ | タイトル、本文/説明、ラベル、状態 (オープン/クローズ)、作成者、校閲者、担当者、マイルストーン、タイムスタンプ |
| リポジトリ メタデータ | PR のランク付けとフィルター処理に使用されるリポジトリ名、organization、コンテキスト フィールド |
コードの差分、ファイルの変更、コメント、コミットの詳細、CI/CD パイプライン、リンクされた成果物など、次のデータ型にはインデックスが作成されません。
アクセス許可モデルとアクセス制御
コネクタは、GitHub のアクセス許可モデルを適用して、ユーザーが表示を許可されているプル要求情報のみを表示するようにします。
リポジトリとチームのアクセス許可は次のとおりです。
- プライベート リポジトリプル要求は、リポジトリアクセス権を持つユーザーに対してのみ表示されます。
- 組織レベルまたはチーム ベースのアクセス制限が適用されます。
- 有効な ID にマップできないコンテンツは、公開を防ぐために非表示になります。
ユーザー ID マッピングには、次のものが含まれます。
- GitHub メール アドレスがMicrosoft Entra IDと一致する場合の自動マッピング。
- メール、サインイン、または名前によるマッピングのサポート。
- 一貫性のある一致のために ID 属性を変換するための省略可能な正規表現ルール。
- 自動マッピングが失敗した場合の手動フォールバック マッピング。
- Bring Your Own User (BYOU) モデルなどのシナリオでユーザーが適切な ID 属性を共有するための要件。