Bitbucket Pull Request Microsoft 365 Copilot コネクタは、Bitbucket pull request コンテンツを Microsoft 365 に統合し、Copilot、Copilot Search、Microsoft Search を使用して、関連するプル要求とエンジニアリング コンテキストを Microsoft 365 内で直接表示できるようにします。 この記事では、Bitbucket Pull Request コネクタをデプロイするときに発生する可能性がある一般的なエラーのトラブルシューティング情報を提供します。
Bitbucket Pull Request コネクタのトラブルシューティング
次の表に、一般的なエラー、考えられる原因、解決手順を示します。
| エラー メッセージ | 考えられる原因 | 解決方法 |
|---|---|---|
| データ ソースに到達できない | Bitbucket API に到達できません。 ネットワークの問題または Bitbucket の停止。 | [Bitbucket の状態] ページを確認します。 この問題は一時的なものになる可能性があります。後で再試行してください。 |
| ソース調整クロール | Bitbucket API (HTTP 429) に対する API 要求が多すぎます。 | 指数バックオフによる自動再試行 (30s 係数、レート 2x)。 永続的な場合はクロールの頻度を減らします。 |
| 認証エラー | OAuth トークンが無効、期限切れ、または欠落しています (HTTP 401)。 アプリの資格情報が正しくない可能性があります。 | 有効な Bitbucket OAuth 資格情報を使用して接続を再認証します。 OAuth アプリのクライアント ID とシークレットを確認します。 |
| 承認エラー | ワークスペース/リポジトリにアクセスするためのアクセス許可が不十分 (HTTP 403)。 | OAuth アプリにリポジトリ、アカウント、プル要求スコープがあることを確認します。 ユーザーがリポジトリへの読み取りアクセス権を持っているかどうかを確認します。 |
| 資格情報の有効期限が切れています | OAuth 更新トークンが無効であるか、有効期限が切れています。 | 新しい OAuth トークンを再認証して取得します。 Bitbucket 設定で OAuth アプリのアクセスが取り消されたかどうかを確認します。 |
| ID マッピング エラー | Bitbucket ユーザー ID がMicrosoft Entra IDプロパティと一致しません。 | 電子メール、サインイン、または名前を使用して ID マッピングを構成します。 直接マッピングが失敗した場合は、正規表現変換を使用します。 |
| コンテンツをプレビューするときに検索可能な項目が見つかりません | プレビューは結果を返さなかった。 プル要求 (PR コネクタ) なし、または検索可能なドキュメントなし (ナレッジ コネクタ)。 | Pr： 選択したリポジトリに少なくとも 1 つのプル要求が存在することを確認します。 ナレッジ： 選択したリポジトリに少なくとも 1 つの .md または .txt ファイルが存在することを確認します。 |
| 内部エラーです | クロール操作中に予期しないエラーが発生しました。 | コネクタ ログを確認します。 永続的な場合は、サポートにお問い合わせください。 |