GitHub Cloud Knowledge Microsoft 365 Copilot コネクタを使用すると、組織は GitHub リポジトリからマークダウンとテキスト ファイルにMicrosoft 365 Copilotおよび Microsoft Search エクスペリエンスにインデックスを作成できます。 GitHub コンテンツを Microsoft 365 と統合することで、ユーザーは使い慣れたアプリでプロジェクト ドキュメントやテクニカル ガイドに直接アクセスでき、コンテキストの切り替えを減らし、生産性を向上させることができます。
GitHub Cloud Knowledge コネクタを使用してデータのインデックスを作成する理由
GitHub Cloud Knowledge コネクタは、ドキュメント、プロジェクト ファイル、またはコンテンツ管理に GitHub を使用する組織に最適です。 コネクタを使用すると、次のことができます。
- Microsoft 365 でプロジェクト ドキュメントを検索できるようにします。
- 次のような Copilot の質問をユーザーに許可します。
- プロジェクトアルファ操作方法設定しますか?
- デプロイ手順はどこで確認できますか?
- このプロジェクトのアーキテクチャの概要は何ですか?
- プロジェクト ドキュメントの主要なセクションを要約して、クイック リファレンスを行います。
GitHub Cloud Knowledge コネクタを使用してエージェントを構築する
開発者は、このコネクタを、Copilot Studio、Microsoft 365 Copilotのエージェント ビルダー、または Microsoft 365 Agents Toolkit を使用して構築する宣言型エージェントのナレッジ ソースとして使用できます。
エージェントプロンプト
次の例では、エージェント ビルダーが GitHub Cloud Knowledge コネクタから情報を取得するのに役立つプロンプトを示します。
| 役割 | サンプル プロンプト |
|---|---|
| Developer | Project Alpha のアーキテクチャの概要を要約します。 |
| プロジェクト管理者 | 最新リリースのすべてのデプロイ手順を一覧表示します。 |
| サポート エンジニア | API 統合のトラブルシューティング手順はどこで確認できますか? |
GitHub Cloud Knowledge コネクタの機能と制限事項
GitHub Cloud Knowledge コネクタを使用すると、ユーザーは次のことが可能になります。
- Microsoft 365 でプロジェクト ドキュメントにアクセスできるように、GitHub Cloud リポジトリ、マークダウン、テキスト ファイルにインデックスを付けます。
- Copilot で自然言語クエリを実行して、テクニカル ガイドとドキュメントを取得します。
- セマンティック検索を使用して、キーワード、好み、ソーシャル接続に基づいて関連するコンテンツを検索します。
- プロジェクトのドキュメントを要約して、クイック リファレンスを確認します。
GitHub Cloud Knowledge コネクタには、次の制限があります。
- インデックスが作成されるのは、リポジトリ メタデータ、マークダウン、テキスト ファイルのみです。 問題、プル要求、コメントにはインデックスが作成されません。
- 最大 30 MB のマークダウン ファイルとテキスト ファイルのみがサポートされています。 大きいファイルにはインデックスが作成されません。
- セキュリティ上の理由から、コネクタは、すべてのリポジトリがパブリックである組織のインデックス作成をサポートしていません。 このシナリオのブロックを解除するには、Microsoft サポートにお問い合わせください。
GitHub Cloud Knowledge からインデックスが作成されたデータ型
コネクタは、次のデータ型にインデックスを付けます。
| データ型 | 説明 |
|---|---|
| Markdown ファイル | プロジェクトのドキュメントとガイド |
| テキスト ファイル | 技術的な注意事項と手順 |
| リポジトリ メタデータ | 基本的なリポジトリ情報 |
インデックス付きコンテンツは、Microsoft 365 Copilot応答と Microsoft Search の結果に表示されます。
アクセス許可モデルとアクセス制御
コネクタは、検索結果を表示するときに GitHub のアクセス許可を適用します。 インデックス付きデータは、次の場合に表示できます。
- このデータ ソースへのアクセス権を持つユーザー ( 既定値): 結果は、GitHub でアクセスできるユーザーに対してのみ表示されます。
- すべてのユーザー: organizationのすべてのユーザーの結果が表示されます。
正確なアクセス許可の適用には、GitHub とMicrosoft Entra IDの間の ID マッピングが必要です。 マッピング オプションは次のとおりです。
- 電子メール
- サインイン
- 名前
直接マッピングが失敗した場合は、正規表現 (regex) を使用して ID データを変換できます。