GitLab Knowledge Server Microsoft 365 Copilot コネクタを使用すると、組織は GitLab 自己管理 (オンプレミス) インスタンス (Markdown ファイル、wiki ページ、その他のドキュメント リポジトリなど) に格納されているナレッジ コンテンツにインデックスを作成し、Microsoft Search とMicrosoft 365 Copilotを通じてこのコンテンツを利用できるようにします。 コネクタが構成され、データのインデックスが作成されると、GitLab のナレッジは、Teams、Outlook、SharePoint などの Microsoft 365 アプリケーションに直接表示されます。 このインデックス作成を使用すると、従業員は毎日のワークフローを離れることなく、組織の知識を検出して再利用できます。
GitLab Knowledge Server コネクタを使用してデータのインデックスを作成する理由
GitLab Knowledge Server コネクタは、この情報を Microsoft 365 全体で検出できるようにする必要がある、GitLab リポジトリに技術ドキュメント、内部 Wiki、ナレッジ ベースを格納する組織向けに設計されています。
一般的なユース ケースは次のとおりです。
- エンジニアやテクニカル ライターが、内部ドキュメント、アーキテクチャ ノート、ベスト プラクティスをすばやく見つけることができます。
- IT チームとサポート チームがトラブルシューティング ガイド、Runbook、運用ドキュメントにアクセスできるようにします。
- Copilot と Microsoft Search を通じて新入社員の内部知識を確認することで、オンボードを改善します。
- ビジネスリーダーと技術リーダーが、GitLab を直接移動することなく、プロジェクトのドキュメントと技術コンテキストを取得できるようにします。
GitLab Knowledge Server コネクタを使用してエージェントを構築する
開発者は、このコネクタを、Copilot Studio、Microsoft 365 Copilotのエージェント ビルダー、または Microsoft 365 Agents Toolkit を使用して構築する宣言型エージェントのナレッジ ソースとして使用できます。 この知識により、カスタム エージェントは GitLab でホストされている知識を推論し、organizationのドキュメントに記載されている質問に回答できます。
エージェントプロンプト
次の例は、エージェント ビルダーが GitLab Knowledge Server から情報を取得するのに役立つプロンプトを示しています。
- プラットフォーム エンジニアリング チームの最新の Wiki 更新プログラムを表示します。
- 社内サービスのトラブルシューティング に関するドキュメントをご覧ください。
- 新しいバックエンド開発者向けのオンボード ガイドを一覧表示します。
- GitLab ナレッジ リポジトリから セキュリティ でタグ付けされたドキュメントを取得します。
GitLab Knowledge Server コネクタの機能と制限事項
GitLab Knowledge Server コネクタを使用すると、ユーザーは次のことが可能になります。
- GitLab リポジトリ、Wiki、およびドキュメントにインデックスを作成します。
- Microsoft Search と Microsoft 365 Copilotを使用して GitLab データを取得します。
- GitLab アクセス制御リスト (ACL) を維持し、ユーザーのアクセス許可を適用します。
- クロールの頻度とインデックス作成の基本設定をカスタマイズします。
GitLab Knowledge Server コネクタには、次の制限があります。
- CI/CD パイプラインは、状態インデックス作成以外ではサポートされていません。
- インデックスが作成されるのは、
.md、.txt、Wiki のみです。 - ユーザーの禁止はサポートされていません。代わりに、グループからユーザーを削除します。
- IP ベースのグループ アクセス制限はサポートされていません。プライベート グループを使用します。
- Planner ロールのサポートは非推奨になりました。レポーターロール以上が必要です。
- プロジェクト メンバーに制限されたパブリック プロジェクトの場合、マージ要求アクセスは Reporter 以上に設定されます。
GitLab Knowledge Server からインデックスが作成されたデータ型
コネクタは、次の GitLab コンテンツ タイプにインデックスを付けます。
- Markdown ファイル (
.md) - GitLab Wiki ページ
- リポジトリに格納されているテキスト ベースのドキュメント
インデックス付きコンテンツは、Microsoft 365 Copilotと Microsoft Search の結果に表示され、ユーザーが Microsoft 365 アプリケーション内で GitLab の知識を直接操作するのに役立ちます。
アクセス許可モデルとアクセス制御
管理者は、Microsoft Entra ID ID マッピングを使用して、インデックス付き GitLab データのアクセス制御を構成できます。 コネクタでは、次のアクセス モデル オプションがサポートされています。
- このデータ ソースへのアクセス権を持つユーザー ( 既定値): 検索結果は、対応する GitLab リポジトリにアクセスできるユーザーにのみ表示されます。
- 全員: インデックス付き GitLab の知識は、Microsoft 365 のすべてのユーザーに表示されます。
ID マッピング オプションには、次のマッピングが含まれます。
- 電子メール
- ログイン
- 名前
直接マッピングが失敗した場合、管理者は正規表現 (regex) を適用して ID 属性を変換できます。 Emailの可視性設定と GitLab のドメインの不整合は、マッピングの精度に影響する可能性があります。