GitHub Microsoft Graph コネクタ (プレビュー)

GitHub Graph コネクタを使用すると、GitHub リポジトリのコンテンツにインデックスを付け、Microsoft 365 エコシステム内で簡単に検索できます。 このコネクタは、ドキュメント、プロジェクト ファイル、またはコンテンツ管理に GitHub を使用する組織に最適です。 GitHub データを Microsoft Search と統合することで、ユーザーは Microsoft 365 アプリケーション内の関連コンテンツに直接アクセスし、ワークフローを合理化し、プラットフォーム間の切り替えの必要性を減らすことができます。

この記事は、Microsoft 365 管理者、または GitHub Graph コネクタを構成、実行、監視するユーザーを対象とします。

注:

GitHub Graph コネクタはプレビュー段階です。 早期アクセスを取得して試したい場合は、 このフォームを使用してサインアップしてください。

機能

• GitHub リポジトリとマークダウン ファイルにインデックスを付けて、Microsoft 365 でプロジェクト ドキュメントにアクセスできるようにします。
• エンド ユーザーが、プロジェクト ドキュメントとテクニカル ガイドに関連する Copilot で質問できるようにします。
  • プロジェクトアルファ操作方法設定しますか?
  • デプロイ手順はどこで確認できますか?
  • このプロジェクトのアーキテクチャの概要は何ですか?
  • クイック リファレンスについては、プロジェクト ドキュメントの主要なセクションをまとめる
• Copilot のセマンティック検索を使用して、ユーザーがキーワード、個人の好み、ソーシャル接続に基づいて関連するコンテンツを検索できるようにします。

制限事項

• インデックスが作成されるのは、リポジトリ メタデータとマークダウン ファイルだけです。 Issue、pull request、コメントなどの他の GitHub エンティティにはインデックスが作成されません。
• 最大 1 MB のマークダウン ファイルのみがサポートされています。 大きいファイルにはインデックスが作成されません。

前提条件

• organizationの Microsoft 365 テナントの検索管理者である必要があります。

• インデックスを作成するすべてのリポジトリにアクセスできるアクティブな GitHub アカウントが必要です。

  a. 個人用リポジトリの場合は、次のいずれかである必要があります。

  • リポジトリ所有者
  • リポジトリコラボレーター

  b. organization所有リポジトリの場合は、次のいずれかである必要があります。

  • 外部コラボレーター
  • 直接コラボレーターとしてのorganization メンバー
  • チーム メンバーシップを介したアクセス権を持つorganization メンバー
  • 既定のorganizationアクセス許可によるアクセス権を持つorganization メンバー
  • organization所有者。

• 個人用アクセス トークン (PAT) が必要です。 個人用アクセス トークンの詳細については、「 個人用アクセス トークンの管理 - GitHub Docs」を参照してください。

• 個人用アクセス トークンには、インデックスを作成するすべてのリポジトリへのアクセス権が必要であり、以下に示すアクセス許可が付与されている必要があります。

  クラシック トークンの場合:

  カテゴリ	アクセス許可	解説
  レポ	すべて	プライベート リポジトリのフル コントロール
  User	read:user	すべてのユーザー プロファイル データを読み取る
  User	read:email	ユーザーのメール アドレスにアクセスする (読み取り専用)

  きめ細かいトークンの場合:

  カテゴリ	アクセス許可	アクセス許可レベル
  リポジトリのアクセス許可	コンテンツ	読み取り専用
  リポジトリのアクセス許可	Metadata	読み取り専用
  アカウントのアクセス許可	電子メール アドレス	読み取り専用

• organization所有のリポジトリがある場合は、次の追加手順に従います。

  • organization管理者は、個人用アクセス トークンを介したアクセスを許可する必要があります。 手順については、「organizationの個人用アクセス トークン ポリシーの設定 - GitHub Docs」を参照してください。
  • きめ細かいトークンを使用している場合は、リソース所有者としてorganizationを選択します。

はじめに

1. 表示名

表示名は、Copilot の各引用文献を識別するために使用され、ユーザーが関連付けられているファイルまたは項目を簡単に認識するのに役立ちます。 表示名は、信頼されたコンテンツも示します。 表示名は、 コンテンツ ソース フィルターとしても使用されます。 このフィールドには既定値が存在しますが、organizationのユーザーが認識する名前にカスタマイズできます。

2. 認証の種類

GitHub からコンテンツを認証および同期するには:

1. 認証の種類
   [基本] オプションを選択します

2. 個人用アクセス トークン (PAT)
   

パスワードの代わりに個人用アクセス トークンを使用します。 インデックス作成に使用できるリポジトリは、トークンによって付与されるアクセスによって異なります。

カスタム セットアップ

カスタムセットアップは、一覧表示されている設定の既定値を編集する管理者向けです。 [カスタム セットアップ] オプションをクリックすると、[ユーザー]、[コンテンツ]、[同期] の 3 つのタブが表示されます。

ユーザー

アクセス許可

GitHub コネクタでは、このデータ ソースにアクセスできる Everyone に表示される検索アクセス許可がサポートされています。 [すべてのユーザー] の場合、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 ID 変換については、「 Azure AD 以外の ID をマップする |Microsoft Learn。

コンテンツ

検索可能にするリポジトリとファイルの種類 (最初はマークダウン ファイルやその他のコード以外のドキュメント) を選択します。

プロパティの管理

ここでは、GitHub データ ソースから使用可能なプロパティの追加または削除、プロパティへのスキーマの割り当て (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義する)、セマンティック ラベルを変更し、プロパティにエイリアスを追加できます。

同期

更新間隔によって、データ ソースと Graph コネクタ インデックスの間でデータが同期される頻度が決まります。 更新間隔には、フル クロールと増分クロールの 2 種類があります。 詳細については、「 更新設定」を参照してください。

必要に応じて、ここから更新間隔の既定値を変更できます。

トラブルシューティング

接続を公開したら、管理センターの [データ ソース] タブの状態を確認できます。 更新と削除を行う方法については、「接続を監視する」をご覧ください。

問題がある場合、またはフィードバックを提供する場合は、Microsoft Graph にお問い合わせください |サポート。