GitHub Cloud Pull Requests Microsoft 365 Copilot コネクタをデプロイする

GitHub Cloud Pull Requests Microsoft 365 Copilot コネクタを使用すると、organizationは GitHub リポジトリに格納されている pull request をMicrosoft 365 Copilotおよび Microsoft Search エクスペリエンスにインデックスを作成できます。 この記事では、コネクタをデプロイしてカスタマイズする手順について説明します。 Copilot コネクタのデプロイに関する一般的な情報については、Microsoft 365 管理センターでの Copilot コネクタのセットアップに関するページを参照してください。

GitHub の詳細な構成情報については、「 コネクタ インジェスト用に GitHub サービスを設定する」を参照してください。

前提条件

GitHub Cloud Pull Requests コネクタをデプロイする前に、GitHub 環境がorganizationで構成されていることを確認してください。 次の表は、GitHub 環境を構成し、コネクタをデプロイする手順をまとめたものです。

コネクターをデプロイする前に、次の前提条件を満たしていることを確認してください:

• Microsoft 365 管理者です。
• GitHub インスタンスには API 経由でアクセスできます。
• GitHub アプリが作成され、認証用に構成されます。
• 認証に使用されるアカウントは、リポジトリにアクセスし、インデックスを作成するプル要求を持っています。
• インデックス付き GitHub データにアクセスするユーザーには、アクセス許可マッピングに対応するMicrosoft Entra ID ID があります。

コネクターをデプロイする

organizationの GitHub Cloud Pull Requests コネクタを追加するには:

1. Microsoft 365 管理センターの左側のウィンドウで、[Copilot]>[コネクター] を選択します。
2. [コネクター] タブに移動し、左側のウィンドウで [ギャラリー] を選択します。
3. 使用可能なコネクタの一覧から[ GitHub Cloud Pull Requests]\(GitHub Cloud Pull Requests\) を選択します。

表示名の設定

表示名は、Copilot 応答内の参照を識別するために使用され、ユーザーが関連するファイルまたはアイテムを認識しやすくなります。 表示名は信頼されたコンテンツを示すとともに、コンテンツ ソースのフィルターとしても使用されます。

既定の GitHub Cloud Pull Requests の表示名をそのまま使用することも、organizationのユーザーが認識する表示名を使用するように値をカスタマイズすることもできます。

コネクタの表示名と説明の詳細については、「Microsoft 365 Copilot コネクタ コンテンツを使用した Copilot 検出の強化」を参照してください。

認証の種類を選択する

コネクタでは、次の認証の種類がサポートされています。

• OAuth (推奨): OAuth 認証を使用するには:

  • GitHub Issue GitHub アプリを GitHub organizationにインストールします。
  • ユーザーが接続を認識するのに役立つ表示名を選択します。
  • organization名を入力します。
  • [ 承認] を選択 してサインインし、アクセス権を付与します。

  注:

  この認証方法は現在プレビュー段階です。

• カスタマイズされた GitHub アプリ (ユーザーに代わって): GitHub アプリからクライアント ID とクライアント シークレットを入力し、アクセスを承認します。

• カスタマイズされた GitHub アプリ (インストール): GitHub アプリから生成された秘密キーを使用します。 クライアント ID とorganization名を入力し、秘密キーをアップロードします。

GitHub アプリを作成する方法については、「 認証にカスタム GitHub アプリを使用する」を参照してください。

ロールアウト

限定された対象ユーザーにロールアウトするには、[限定された対象ユーザーへのロールアウト] の横のトグルをオンにし、コネクターをロールアウトするユーザーとグループを指定します。 詳細については、「Copilot コネクターの段階的ロールアウト」を参照してください。

[作成] を選択して接続をデプロイします。 GitHub Cloud Pull Requests Copilot コネクタは、コンテンツのインデックス作成をすぐに開始します。

次の表に、設定される既定値を示します。

これらの値をカスタマイズするには、[カスタム セットアップ] を選択します。 詳細については、「設定のカスタマイズ」を参照してください。

接続を作成したら、Microsoft 365 管理センターの [コネクター] セクションで状態を確認できます。

設定のカスタマイズ (オプション)

GitHub Cloud Pull Requests コネクタ設定の既定値をカスタマイズできます。 設定をカスタマイズするには、管理センターのコネクター ページで [カスタム セットアップ] を選択します。

ユーザー設定をカスタマイズする

アクセス許可

インデックス付きデータを表示するかどうかを選択します。

• このデータ ソースへのアクセス権を持つユーザーのみ (既定)
• すべてのユーザー

[このデータ ソースにアクセスできるユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示されます。 [すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。

ID のマッピング

正しいアクセス許可の適用を確実に行うために、GitHub ユーザー ID を Microsoft Entra ID にマップします。 次のようなオプションがあります。

• Email: GitHub の電子メールをユーザー プロパティMicrosoft Entra IDにマップします。
• ログイン：Microsoft Entra IDユーザー プロパティを使用して GitHub ログインをマップします。
• 名前：GitHub 名をユーザー プロパティMicrosoft Entra IDマップします。

直接マッピングが失敗した場合は、 正規表現 (regex) を 使用してデータを変換します。 例: [a-zA-Z0-9]+

organization管理者がリポジトリへのアクセスを制限する既定のメンバーアクセス許可を設定した場合、コネクタはこの設定を尊重します。 ユーザーは、コラボレーターとして明示的に追加されていない限り、organizationリポジトリを表示できません。

Enterprise Managed Users (EMU) ではなく Bring Your Own Key (BYOK) モデルを使用する企業の場合、各ユーザーは、GitHub アカウント設定で必要な ID フィールドを共有するためのアクセス許可を有効にする必要があります。 この手順により、GitHub とorganizationのディレクトリ間の適切な ID マッピングが保証されます。

コンテンツ設定をカスタマイズする

[ コンテンツ ] タブでは、コンテンツ、ラベル、説明、タイムスタンプなどのメタデータのサンプル データ内のプロパティ マッピングを確認できます。

時間範囲フィルター

時間範囲フィルターを構成できます。 既定の設定は 365 日です。

プロパティを管理する

プロパティの追加または削除、スキーマ属性の割り当て、セマンティック ラベルの定義を行うことができます。 次のプロパティは、既定でインデックスが作成されます。

同期間隔をカスタマイズする

更新間隔によって、データが同期される頻度が決まります。 次の既定値をカスタマイズできます。

• インクリメンタル更新: 15 分ごと
• フル クロール: 毎日

詳細については、「同期設定のガイドライン」を参照してください。

関連コンテンツ

• GitHub Cloud Pull Requests コネクタの概要
• GitHub Cloud Pull Requests コネクタに関する問題のトラブルシューティング
• Microsoft 365 管理センターで Copilot コネクタを設定する