Confluence Cloud 智能 Microsoft 365 Copilot 副驾驶® 连接器允许组织为 Confluence 内容编制索引。 配置连接器并索引 Confluence 站点中的数据后，最终用户可以在Microsoft搜索和智能 Microsoft 365 Copilot 副驾驶®中搜索该内容。
本文适用于Microsoft负责配置、运行和监视 Confluence Cloud Copilot 连接器的 365 名管理员。 它补充了在 Microsoft 365 管理中心 中设置Microsoft Copilot连接器时提供的一般说明。
功能
- 用户可以询问有关 Copilot 中 Wiki 内容的自然语言问题，例如汇总体系结构文档或获取对门户的访问权限。
- 用户可以执行自然语言查询以获取准确的响应。
先决条件
- 你必须是组织的 Microsoft 365 租户的管理员，以及组织的 Confluence 站点的管理员。
- 请确保具有具有正确访问权限的身份验证凭据。
重要
- 2024 年 1 月，Atlassian (版本 1) 弃用了一组 Confluence 云 API， (版本 2) 发布了新的 API。 有关详细信息，请参阅 更改日志更新 和 常规更新。 其中一些已弃用的 v1 API 仅由连接器用于 OAuth 连接 。 因此，在此更改后，现有的 Confluence 连接可能会停止工作。
- 2023 年 12 月，向所有客户发布了一组新的 v2 API。 发布后，现有连接需要重新进行身份验证。 与以前的 v1 API) 相比，新的 v2 API 还需要更多范围 (，这些范围需要在重新身份验证期间提供。 需要新的范围集 (完整列表) –
read:group:confluence、、read:user:confluence、Read:space:confluenceRead:permission:confluenceread:content-details:confluence、read:audit-log:confluenceread:content.metadata:confluence和 。read:page:confluence - 从 2025 年 7 月开始，Confluence Cloud 连接器支持对页面上的注释和分页编制索引。 若要利用这项新功能，现有连接需要重新进行身份验证，另外两个范围 (
read:comment:confluence，read:attachment:confluence) 必须添加到 OAuth 2 托管应用。
入门
1. 显示名称
显示名称用于标识 Copilot 中的每个引用，帮助用户轻松识别关联的文件或项。 显示名称还表示受信任的内容。 显示名称也用作 内容源筛选器。 此字段存在默认值，但你可以将其自定义为组织中的用户可识别的名称。
2. Confluence 云 URL
若要连接到 Confluence 站点，请使用站点 URL。 Confluence 云站点 URL 通常类似于 https://< organization_name.atlassian.net/>。
3.身份验证类型
若要对 Confluence 本地内容进行身份验证和同步，请选择 以下两种受支持的方法之一 ：
提示
确保服务 帐户有权查看 要编制索引的 Confluence 内容。
a. 基本身份验证
若要使用基本身份验证进行身份验证，请输入用户名 (通常为电子邮件) 和 API 令牌。 若要帮助生成 API 令牌，请参阅 Atlassian 指南。
b. OAuth 2.0 (建议)
在 Confluence Cloud 中注册应用，以便Microsoft搜索应用和智能 Microsoft 365 Copilot 副驾驶®可以访问该实例。 若要了解详细信息，请参阅 Atlassian 支持文档，了解如何 启用 OAuth 2.0。
以下步骤提供了有关如何注册应用的指南：
使用 Atlassian Confluence 管理员帐户登录到 Atlassian 开发人员控制台。
单击“创建”，然后选择 。
OAuth 2.0 integration为应用程序提供适当的名称并创建新应用。
Permissions从左侧导航窗格导航到 。 单击 “添加”。Confluence API添加后，单击“ 配置”和“ 编辑范围”，然后选择以下范围。范围名称 代码 说明 查看内容详细信息 read:content-details:confluence对满足条件的内容进行爬网。 查看组 read:group:confluence访问内容的组权限。 查看用户详细信息 read:user:confluence访问单个用户详细信息以支持权限。 查看审核记录 read:audit-log:confluence访问 Confluence 事件的审核记录以支持权限。 查看页面 read:page:confluence访问页面内容详细信息以支持权限。 查看空间 read:space:confluence访问空间详细信息以支持权限。 查看内容摘要 read:content.metadata:confluence访问有关内容的信息以支持权限。 查看内容限制和空间权限 read:permission:confluence访问内容限制和空间权限详细信息以支持权限。 查看批注 read:comment:confluence查看页面或博客文章上的评论。 查看和下载内容附件 read:attachment:confluence查看和下载你有权访问的页面或博客文章的附件。 单击保存。
Authorization从左侧导航窗格导航到 。 为 Microsoft 365 Government 添加Microsoft 365 企业版https://gcs.office.com/v1.0/admin/oauth/callback的回调 URL，https://gcsgcc.office.com/v1.0/admin/oauth/callback并保存更改。从左侧导航窗格导航到“设置”。 可从此页面获取 客户端 ID 和 机密 。
使用 客户端 ID 和 机密完成连接设置步骤。
6. 向有限的受众推出
如果要先在 Copilot 和其他搜索图面中验证此连接，然后再将此连接部署到有限的用户群，然后再将它扩展到更广泛的受众。 若要了解有关有限推出的详细信息， 请单击此处。
此时，已准备好为 Confluence Knowledge 创建连接。 可以单击“创建”按钮，Confluence Cloud Microsoft Graph 连接器将从 Confluence 帐户启动索引页。
对于其他设置（如访问权限、数据包含规则、架构、爬网频率等），我们根据最适合 Confluence 数据的内容设置默认值。 默认值如下所示：
| 用户 | |
|---|---|
| 访问权限 | 仅有权访问数据源中内容的人员。 |
| 映射标识 | 使用 Microsoft Entra ID 映射的数据源标识。 |
| 内容 | |
|---|---|
| 包含/排除空间 | 全部 |
| 管理属性 | 若要检查默认属性及其架构，请单击此处 |
| 同步 | |
|---|---|
| 增量爬网 | 频率：每 15 分钟 |
| 完全爬网 | 频率：每天 |
如果要编辑这些值中的任何一个，则需要选择 Custom Setup 选项。
自定义设置
在自定义设置中，可以编辑用户、内容和同步的任何默认值。
用户
访问权限
confluence Cloud Copilot 连接器支持对 “所有人 ”或 “仅有权访问此数据源的人员”可见的搜索权限。 如果选择“ 所有人”，则所有用户的搜索结果中将显示索引数据。 如果选择“ 仅有权访问此数据源的人员”，则有权访问该数据源的用户的搜索结果中会显示索引数据。 在 Confluence Cloud 中，用户和组的安全权限是使用空间权限和页面限制定义的。 页面级限制（如果存在）优先于空间权限。
如果没有页面限制，连接器会检查空间级权限 -
- 如果空间启用了“匿名用户”访问，则内容对租户中的所有用户可见。
- 如果未启用“匿名访问”，则遵循空间级权限。
- 如果未定义空间级权限，则租户中的任何用户都看不到内容。
重要
权限仅在空间和页面级别进行管理，不考虑父页权限。
如果选择“仅有权访问此数据源的人员”，则需要进一步选择 Confluence 站点具有Microsoft Entra ID预配用户还是非 AAD 用户。
若要确定哪个选项适合你的组织，请执行以下作：
- 如果 Confluence 用户的电子邮件 ID 与 Microsoft Entra ID 中用户的 UserPrincipalName (UPN) 相同，请选择“Microsoft Entra ID”选项。
- 如果 Confluence 用户的电子邮件 ID 不同于 userPrincipalName (UPN Microsoft Entra ID 用户) ，请选择非 AAD 选项。
注意
- 如果选择Microsoft Entra ID作为标识源的类型，连接器会将从 Confluence 获取的用户的电子邮件 ID 直接映射到 Microsoft Entra ID 的 UPN 属性。
- 如果为标识类型选择了“非 AAD”，请参阅 映射非 Azure AD 标识 ，获取有关映射标识的说明。 可以使用此选项提供从电子邮件 ID 到 UPN 的映射正则表达式。
- 汇报管理访问权限的用户或组仅在完全爬网中同步。 增量爬网当前不支持处理权限更新。
内容
包含或排除要编制索引的数据
使用 Confluence 查询语言 (CQL) 字符串，可以指定同步页面的条件。 它类似于 SQL Select 语句中的 Where 子句。 例如，可以选择仅为过去两年修改的页面编制索引。 若要了解如何创建自己的查询字符串，请参阅 使用 CQL 进行高级搜索。 默认情况下，连接器为所有博客和页面编制索引。
提示
可以使用 CQL 筛选器为 特定时间后修改的内容 编制索引， lastModified >= “2018/12/31”
使用预览结果按钮验证所选属性和 CQL 字符串的示例值。
管理属性
若要在 Aha！中添加或删除可用属性，请将架构分配给属性， (定义属性是可搜索的、可查询的、可检索的还是可精简的) ，更改语义标签，并向属性添加别名。 默认情况下为以下属性编制索引。
| 默认属性 | 标签 | 说明 |
|---|---|---|
| 作者 | authors |
参与/协作处理数据源中项的人员的名称。 |
| CreatedByName | createdBy |
数据源中项的最近编辑者的姓名。 |
| CreatedOn | createdDateTime |
在数据源中创建项的日期和时间。 |
| IconUrl | iconUrl |
项的关联图标 URL。 |
| 标题 | title |
要在搜索和其他体验中显示的项的标题。 |
| UpdatedByName | lastModifiedBy |
数据源中项的最近编辑者的姓名。 |
| UpdatedOn | lastModifiedDateTime |
上次在数据源中修改项的日期和时间。 |
| URL | url |
数据源中项的目标 URL。 |
预览数据
使用“预览结果”按钮验证所选属性和筛选器。
同步
刷新间隔确定数据在数据源和 Confluence Cloud Copilot 连接器索引之间同步的频率。 有两种类型的刷新间隔 - 完全爬网和增量爬网。 有关更多详细信息， 请单击此处。 如果需要，可以从此处更改刷新间隔的默认值。
查看并测试连接
对于Microsoft搜索，如果需要自定义搜索结果页。 若要了解如何自定义搜索结果，请参阅 自定义搜索结果页。
如果遇到问题或想要提供反馈，请联系 Microsoft Graph |支持。