通过

Bitbucket 智能 Microsoft 365 Copilot 副驾驶® 连接器 (预览)

Bitbucket 智能 Microsoft 365 Copilot 副驾驶® 连接器允许组织为 bitbucket 中存储) 拉取请求和文档 (.txt 和 .md 文件编制索引。 配置连接器并索引 Bitbucket 内容后，用户可以通过Microsoft搜索和智能 Microsoft 365 Copilot 副驾驶®来搜索和检索信息。

本文适用于Microsoft 365 管理员或配置、运行或监视 Bitbucket Copilot 连接器的任何人。

功能

  • 为 Bitbucket 存储库、拉取请求和文档编制索引。
  • 启用Microsoft搜索和智能 Microsoft 365 Copilot 副驾驶®，以有效地检索 Bitbucket 数据。
  • 维护 Bitbucket ACL 和用户权限。
  • 允许管理员自定义爬网频率和索引首选项。

限制

  • 连接器不支持对除状态索引之外的 Bitbucket CI/CD 管道编制索引。
  • 仅对存储库、拉取请求、.md 和 .txt 文件编制索引。
  • 目前不支持本地/自承载 Bitbucket 实例。
  • 如果 Git 更改未映射到 Bitbucket 帐户，连接器可能会将 LastModifiedBy 字段留空。 如果在增量爬网之前未完成将 Git 更改链接到 Bitbucket 用户帐户的手动配置，则会发生这种情况。

先决条件

  1. 可以通过 API 访问 Bitbucket 实例。
  2. 用于身份验证的用户帐户有权访问要编制索引的存储库、拉取请求和知识文件。
  3. 访问索引 Bitbucket 数据的用户具有用于权限映射的相应Microsoft Entra ID标识。
  4. 在 Bitbucket 上设置 OAuth 使用者
    1. 转到 Bitbucket 上的工作区页。
    2. 单击右上角的齿轮图标，然后选择 “工作区设置”。
    3. 在左侧导航栏中，选择“工作流”部分下的“OAuth 使用者”。
    4. 单击“ 添加使用者 ”，并根据以下重定向 URL 填写内容：
    • 对于Microsoft 365 企业版，请使用https://gcs.office.com/v1.0/admin/oauth/callback
    • 对于 Microsoft 365 政府版，请使用 https://gcsgcc.office.com/v1.0/admin/oauth/callback
    1. 启用密钥以将以下权限配置为读取问题：
    • 帐户
    • 存储 库
    • 拉取请求
    1. 保存配置并复制密钥和机密值

建议对每个连接使用单独的用户帐户进行 OAuth 身份验证，因为 Bitbucket 的速率限制按用户单独计算。

入门

选择显示名称

选择帮助用户识别 Copilot 响应中的合并请求或文档的显示名称。

Bitbucket 实例 URL

输入 Bitbucket 实例的 URL， (例如 https://bitbucket.org/testinstance) 。

身份验证类型

  1. 使用 Bitbucket OAuth 使用者的密钥输入客户端 ID，并使用相应的 OAuth 使用者密码输入客户端密码。
  2. 选择 “授权” 以登录并授予访问权限。
  3. 单击“ 授权 ”以登录并授予所需的访问权限。

面向有限受众推出

在部署连接器之前，请在 Copilot 和 Microsoft Search 中使用有限的用户群测试连接。

自定义设置

在自定义设置中，可以编辑用户、内容和同步的任何默认值。

用户

标识映射

默认情况下，由于 Bitbucket API 的限制，连接器使用 Bitbucket 中的公共名称映射Microsoft Entra ID中的电子邮件。 如果此映射与配置不一致，请自定义标识映射。

为确保正确实施权限，请将 Bitbucket 用户标识映射到Microsoft Entra ID。 以下是选项：

  • 全名：将 Bitbucket 全名与Microsoft Entra ID用户属性匹配。
  • 公共名称：使用Microsoft Entra ID用户属性映射 Bitbucket 公共名称。

如果直接映射失败，请使用 正则表达式 (正则表达式) 进行转换。 例如：

  1. 选择“邮件”作为Microsoft Entra用户属性。
  2. 选择“全名”作为非Microsoft Entra用户属性。
  3. 使用 等 ([^@]+) 正则表达式捕获符号前面的一个或多个字符的 @ 序列。
  4. 创建公式以完成映射，例如 {0}@<your-domain>。

内容

在“内容”选项卡上，可以验证示例数据中的内容、标签、说明和时间戳等元数据的属性映射。

同步

可以配置 增量 爬网和 完全 爬网。 下面是默认值：

  • 默认情况下，增量爬网 每 15 分钟运行一次 。
  • 完全爬网每天运行，以确保最新的索引编制。

后续步骤

  • 在Microsoft 365 管理中心查看连接状态。

如果遇到问题或想要提供反馈，请联系 Microsoft Graph 支持。