Bitbucket Pull Request Microsoft 365 Copilot コネクタは、Bitbucket pull request コンテンツを Microsoft 365 に統合し、Copilot、Copilot Search、Microsoft Search を使用して、関連するプル要求とエンジニアリング コンテキストを Microsoft 365 内で直接表示できるようにします。 この記事では、Bitbucket Pull Request コネクタをデプロイしてカスタマイズする手順について説明します。
前提条件
Bitbucket Pull Request コネクタをデプロイする前に、次の前提条件を満たしていることを確認してください。
- Microsoft 365 管理者です。
- Bitbucket インスタンスには API 経由でアクセスできます。
- 認証に使用されるユーザー アカウントは、インデックスを作成するリポジトリ、pull request、ナレッジ ファイルにアクセスできます。
- インデックス付き Bitbucket データにアクセスするユーザーには、アクセス許可マッピングに対応するMicrosoft Entra ID ID があります。
- Bitbucket で OAuth コンシューマーを設定します。
- Bitbucket のワークスペース ページに移動します。
- 右上隅にある歯車アイコンを選択し、[ ワークスペースの設定] を選択します。
- 左側のウィンドウの [ ワークフロー] で、[ OAuth コンシューマー] を選択します。
- [ コンシューマーの追加] を選択し、リダイレクト URL を指定します。
- Microsoft 365 Enterpriseの場合:
https://gcs.office.com/v1.0/admin/oauth/callback - Microsoft 365 Government の場合:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- キーに、次のアクセス許可が構成され、問題を読み取ることができるように許可します。
- 取引
- リポジトリ
- Pull requests
- 構成を保存し、キーとシークレットの値をコピーします。
Bitbucket のレート制限はユーザーごとに個別に計算されるため、接続ごとに OAuth 認証には個別のユーザー アカウントを使用することをお勧めします。
コネクタをデプロイする
organizationの Bitbucket Pull Request コネクタを追加するには:
- Microsoft 365 管理センターの左側のウィンドウで、[Copilot>Connectors] を選択します。
- [ ギャラリー ] タブを選択します。
- 使用可能なコネクタの一覧から、[ Bitbucket Pull Request] を選択します。
表示名を設定する
表示名は、関連付けられたファイルまたはアイテムをユーザーが認識するのに役立つ Copilot 応答の参照を識別するために使用されます。 既定の Bitbucket Pull Request 表示名をそのまま使用することも、organizationのユーザーが認識する表示名を使用するように値をカスタマイズすることもできます。
インスタンス URL の設定
Bitbucket インスタンスの URL を入力します。 例: https://bitbucket.org/testinstance。
認証の種類を選択する
認証するには、 OAuth 2.0 を選択します。
- Bitbucket OAuth コンシューマーのキーと、対応する OAuth コンシューマー シークレットを使用してクライアント シークレットを使用して、クライアント ID を入力します。
- [ 承認] を選択 してサインインし、アクセス権を付与します。
- もう一度 [承認] を 選択して、必要なアクセス許可を付与します。
限定された対象ユーザーにロールアウトする
コネクタをデプロイする前に、Copilot と Microsoft Search の制限付きユーザー ベースとの接続をテストします。 制限付き対象ユーザーにロールアウトするには、[制限対象ユーザー へのロールアウト] の横にあるトグルを選択し、コネクタをロールアウトするユーザーとグループを指定します。
[ 作成] を 選択して接続をデプロイします。 Bitbucket Pull Request Copilot コネクタは、コンテンツのインデックス作成をすぐに開始します。
次の既定値が設定されます。
- ユーザー: ID マッピングでは、Microsoft Entra ID プロパティにマップされた Bitbucket パブリック名が使用されます。 直接マッピングが失敗した場合は、正規表現変換を使用します。
- データ: プル要求と関連付けられたメタデータにインデックスを作成します。
-
クロール:
- 増分クロールは、既定で 15 分ごとに 実行されます。
- フル クロールは 毎日 実行され、最新のインデックス作成が保証されます。
これらの値をカスタマイズするには、[ カスタム セットアップ] を選択します。 詳細については、「設定の カスタマイズ」を参照してください。
接続を作成したら、Microsoft 365 管理センターの [コネクタ] セクションで状態を確認できます。
設定のカスタマイズ (省略可能)
Bitbucket Pull Request コネクタ設定の既定値をカスタマイズできます。 設定をカスタマイズするには、管理センターのコネクタ ページで [ カスタム セットアップ] を選択します。
ユーザー設定をカスタマイズする
アクセス許可
アクセス許可を構成して、承認されたユーザーのみがインデックス付きコンテンツを表示できるようにします。 以下のオプションがあります。
- このデータ ソースへのアクセス権を持つユーザー ( 既定値): インデックス付きデータは、アクセス権を持つユーザーにのみ表示されます。
- すべてのユーザー: すべてのユーザーの検索結果にインデックス付きデータが表示されます。
ID のマッピング
Bitbucket ユーザー ID を Microsoft Entra ID ID にマップします。 オプションは以下のとおりです。
- フル ネーム マッピング
- パブリック名マッピング
- 正規表現変換 (たとえば、
{0}@<your-domain>)
コンテンツ設定をカスタマイズする
プロパティの管理
コンテンツ、ラベル、説明などのメタデータのサンプル データ内のプロパティ マッピングを確認します。 サンプル データをテストするには、[ プレビュー データ] を選択します。
クロール間隔をカスタマイズする
増分クロールとフル クロールを構成できます。 既定値は次のとおりです。
- 増分クロール: 15 分ごとに
- フル クロール: 毎日
詳細については、「 同期設定のガイドライン」を参照してください。