GitHub Cloud Knowledge Microsoft 365 Copilot コネクタを使用すると、GitHub リポジトリからコンテンツにインデックスを付け、Microsoft 365 エコシステム内で簡単に検索できます。 このコネクタは、ドキュメント、プロジェクト ファイル、またはコンテンツ管理に GitHub Cloud を使用する組織に最適です。 GitHub データを Microsoft Search と統合することで、ユーザーは Microsoft 365 アプリケーション内の関連コンテンツに直接アクセスし、ワークフローを合理化し、プラットフォーム間の切り替えの必要性を減らすことができます。
この記事は、Microsoft 365 管理者、または GitHub Cloud Knowledge Copilot コネクタを構成、実行、監視するユーザーを対象とします。
機能
- GitHub Cloud リポジトリとマークダウン ファイルにインデックスを付けて、Microsoft 365 でプロジェクト ドキュメントにアクセスできるようにします。
- エンド ユーザーが、プロジェクト ドキュメントとテクニカル ガイドに関連する Copilot で質問できるようにします。
- プロジェクトアルファ操作方法設定しますか?
- デプロイ手順はどこで確認できますか?
- このプロジェクトのアーキテクチャの概要は何ですか?
- クイック リファレンスについては、プロジェクト ドキュメントの主要なセクションをまとめる
- Copilot のセマンティック検索を使用して、ユーザーがキーワード、個人の好み、ソーシャル接続に基づいて関連するコンテンツを検索できるようにします。
制限事項
- インデックスが作成されるのは、リポジトリ メタデータとマークダウン ファイルだけです。 Issue、pull request、コメントなどの他の GitHub エンティティにはインデックスが作成されません。
- 最大 1 MB のマークダウン ファイルのみがサポートされています。 大きいファイルにはインデックスが作成されません。
前提条件
- organizationの Microsoft 365 テナントの検索管理者である必要があります。
- GitHub インスタンスに API 経由でアクセスできることを確認します。
- ここで説明する手順に従って、認証用に GitHub アプリを構成して設定 します。
- インデックス付き GitHub データにアクセスするユーザーが、アクセス許可マッピングに対応するMicrosoft Entra ID ID を持っていることを確認します。
- シングル Sign-On (SSO) を使用して認証するエンタープライズマネージド ユーザーの場合、GitHub 認証フローでは現在 SSO ログインがサポートされていないため、アクションを実行する前にアカウントをサインインする必要があります。
認証用の GitHub アプリを設定する
Graph コネクタで使用する GitHub アプリを作成するには、次の手順に従います。
GitHub で、プロフィール写真 (右上) をクリックし、[組織] を選択し、Graph コネクタがデータをプルするorganizationを選択します。
![[組織] にアクセスする方法を示すスクリーンショット。](media/github-connector/organizations-nav.png)
[organizationの概要] ページで、[設定] をクリックします。
![organization ページ内の [設定] にアクセスする方法を示すスクリーンショット。](media/github-connector/organization-overview.png)
左側のサイドバーで、[ 開発者設定 ] まで下にスクロールし、[ GitHub Apps] をクリックします。
[ 新しい GitHub アプリ] をクリックします。
アプリを構成します。
- GitHub アプリ名: 任意の名前を入力します。
- ホームページ URL: ブラウザーのアドレス バーから URL をコピーします (必要に応じて画像を参照してください)。
-
コールバック URL:
Microsoft 365 Enterpriseの場合:
https://gcs.office.com/v1.0/admin/oauth/callbackMicrosoft 365 Government の場合:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
[インストール中にユーザー承認 (OAuth) を要求する] をオンにし、Webhook オプションを無効にします。
次のアクセス許可を設定します。
- リポジトリのアクセス許可: コンテンツ (読み取り専用)、メタデータ (読み取り専用)
- 組織のアクセス許可: メンバー (読み取り専用)
- アカウントのアクセス許可: Email アドレス (読み取り専用)
[ この GitHub アプリをインストールできる場所] で、[ 任意のアカウント] を選択し、[ GitHub アプリの作成] をクリックします。
GitHub アプリの [ 全般] ページで、[新しい クライアント シークレット の生成] をクリックして クライアント シークレットを生成してコピーします。 次に、[ アプリのインストール] をクリックします。
アプリをインストールするorganizationを選択します。 インストール後、コネクタを構成する準備ができました。
![[組織] にアクセスする方法を示すスクリーンショット。](media/github-connector/organizations-nav.png#lightbox)
![organization ページ内の [設定] にアクセスする方法を示すスクリーンショット。](media/github-connector/organization-overview.png#lightbox)
はじめに
1. 表示名
表示名は、Copilot の各引用文献を識別するために使用され、ユーザーが関連付けられているファイルまたは項目を簡単に認識するのに役立ちます。 表示名は、信頼されたコンテンツも示します。 表示名は、 コンテンツ ソース フィルターとしても使用されます。 このフィールドには既定値が存在しますが、organizationのユーザーが認識する名前にカスタマイズできます。
2. 認証の種類
- 認証方法として GitHub App (ユーザーの代わりに) を選択します。
- 先ほど作成した GitHub アプリのクライアント ID とクライアント シークレットを入力します。
- [ 承認] をクリックしてサインインし、必要なアクセス許可を付与します。
3. 限定対象ユーザーにロールアウトする
ロールアウトを広範な対象ユーザーに展開する前に、Copilot やその他の Search サーフェスで検証する場合は、制限付きユーザー ベースにこの接続をデプロイします。 制限付きロールアウトの詳細については、「 段階的なロールアウト」を参照してください。
カスタム セットアップ
カスタムセットアップは、一覧表示されている設定の既定値を編集する管理者向けです。 [カスタム セットアップ] オプションをクリックすると、[ユーザー]、[コンテンツ]、[同期] の 3 つのタブが表示されます。
ユーザー
アクセス許可
GitHub Cloud Knowledge コネクタでは、 このデータ ソースへのアクセス権を持つユーザーのみ (既定) または Everyone に表示される検索アクセス許可がサポートされています。 [このデータ ソースへのアクセス権を持つユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示され、アクセス権を持つユーザーが表示されます。 [ すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。
ID のマップ
カスタム セットアップでは、ユーザー、コンテンツ、同期の既定値を編集できます。正しいアクセス許可の適用を確実に行うために、GitHub ユーザー ID を Microsoft Entra ID にマップします。 次のようなオプションがあります。
- Email: GitHub の電子メールをユーザー プロパティMicrosoft Entra IDマップします。
- ログイン: Microsoft Entra IDユーザー プロパティを使用して GitHub ログインをマップします。
- 名前: GitHub 名をユーザー プロパティMicrosoft Entra IDマップします。
直接マッピングが失敗した場合は、正規表現 (regex) を使用してデータを変換します。 たとえば、[a-zA-Z0-9]+ 個人用アカウントの場合、電子メール ドメインと個々のメールの可視性設定のバリエーションにより、マッピングの精度が影響を受ける可能性があります。
ID 変換については、「 Azure AD 以外の ID をマップする」を参照してください。
ID 変換の詳細については、「 Azure AD 以外の ID をマップする」を参照してください。
コンテンツ
検索可能にするリポジトリとファイルの種類 (最初はマークダウン ファイルやその他のコード以外のドキュメント) を選択します。
[ プロパティの管理 ] で、GitHub データ ソースから使用可能なプロパティを追加または削除し、プロパティにスキーマを割り当てます (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義する)、セマンティック ラベルを変更し、エイリアスを プロパティに追加します。
同期
更新間隔によって、データ ソースと Graph コネクタ インデックスの間でデータが同期される頻度が決まります。 更新間隔には、フル クロールと増分クロールの 2 種類があります。 詳細については、「 更新設定」を参照してください。
既定値は次のとおりです。
- 増分クロールは、既定で 15 分ごとに実行されます。
- フル クロールは毎日実行され、最新のインデックス作成が保証されます。
必要に応じて、ここから更新間隔の既定値を変更できます。
トラブルシューティング
接続を公開したら、管理センターの [データ ソース] タブの状態を確認できます。 更新と削除を行う方法については、「接続を監視する」をご覧ください。
注:
インデックス ブラウザーを使用してインデックス付きアイテムを識別する場合、リポジトリとファイル名では大文字と小文字が区別されます。 正確な結果を取得するには、必ず正確な大文字と小文字を一致させます。
問題がある場合、またはフィードバックを提供する場合は、Microsoft Graph にお問い合わせください |サポート。