借助 Dropbox 智能 Microsoft 365 Copilot 副驾驶® 连接器,M365 中的组织可以使用Microsoft Copilot和搜索为 Dropbox 中任何人都可以访问的文件编制索引。
本文适用于 Microsoft 365 管理员或配置、运行和监视 Dropbox Copilot 连接器的任何人。
功能
- 使用语义搜索功能访问 Dropbox 文件
- 保留组织定义的 (ACL) 访问控制列表
- 自定义爬网频率
- 从 Microsoft Copilot Studio 使用此连接和插件创建工作流
限制
- 文件夹、答复 & 批注不可编制索引
先决条件
在创建 Dropbox Copilot 连接器之前,必须:
1.设置团队管理员用户
创建了适用于企业的 Dropbox 帐户并设置了团队管理员用户。
2.配置 Dropbox 应用
使用唯一的应用名称、激活的作用域访问和完全 Dropbox 权限配置 Dropbox 应用。 请参阅 有关创建应用的 Dropbox 文档。
3. 添加直接 URL
将以下链接添加到 Dropbox 应用控制台中设置选项卡的“OAuth 2”部分中的“重定向 URL”中:
对于 M365 企业版,请复制并粘贴: https://gcs.office.com/v1.0/admin/oauth/callback
对于 M365 政府版,请复制并粘贴: https://gcsgcc.office.com/v1.0/admin/oauth/callback
4.添加 API 范围
导航到 Dropbox 应用控制台上的“权限”选项卡,并添加了以下权限:
单个范围:
files.metadata.read
files.content.read
sharing.read
file_requests.read
团队范围:
team_info.read
team_data.member
team_data.governance.write
team_data.governance.read
team_data.content.read
files.team_metadata.read
members.read
groups.read
events.read
5.获取应用密钥和应用机密
从左侧导航窗格中导航到“设置”选项卡,从此页面获取应用密钥和应用机密。
设置
1. 显示名称
选择有助于用户轻松识别 Copilot 响应中的关联文件或项的显示名称。
2.身份验证类型
输入从 Dropbox 应用控制台获取的应用密钥和应用机密。
3. 向有限受众推出
如果要先在 Copilot 和其他搜索图面中验证此连接,然后再将此连接部署到有限的用户群,然后再将它扩展到更广泛的受众。
对于其他设置(如访问权限、数据包含规则、架构、爬网频率等),我们根据最适用于 Dropbox 中的数据设置默认值。 默认值设置如下所示。
Page | 设置 | 默认值 |
---|---|---|
用户 | 访问权限 | 在 Dropbox 中,任何人都可以访问的所有文件对租户中的所有Microsoft 365 用户可见,Microsoft搜索或 Copilot。 |
内容 | 为内容编制索引 | 默认情况下会选择所有已发布的帖子和页面。 |
内容 | 管理属性 | 若要检查默认属性及其架构。 |
同步 | 增量爬网 | 频率:每 4 小时 |
同步 | 完全爬网 | 频率:每天 |
如果要编辑这些值中的任何一个,则需要选择 “自定义设置” 选项。
自定义设置
自定义设置适用于想要编辑设置的默认值的管理员。 单击“自定义设置”选项后,应会看到其他三个选项卡 -“用户”、“内容”和“同步”。
用户
访问权限
Dropbox Copilot 连接器支持对有权访问此数据源的人员可见的数据 (建议) 或所有人。 如果选择“所有人”,则所有用户的搜索结果中将显示索引数据。
如果选择“仅有权访问此数据源的人员”,则需要进一步选择Microsoft Entra ID预配用户还是非 AAD 用户。
若要确定哪个选项适合你的组织,请执行以下作:
如果 Dropbox 用户的电子邮件 ID 与 Microsoft Entra ID 中用户的 UserPrincipalName (UPN) 相同,请选择“Microsoft Entra ID”选项。
如果 Dropbox 用户的电子邮件 ID 与 Microsoft Entra ID 中用户的 UserPrincipalName (UPN) 不同,请选择非 AAD 选项。
重要
- 如果选择Microsoft Entra ID作为标识源的类型,连接器会将从 Dropbox 获取的用户的电子邮件 ID 直接映射到 Microsoft Entra ID 的 UPN 属性。
- 如果为标识类型选择了“非 AAD”,请参阅映射非 Azure AD 标识以获取有关映射标识的说明。 可以使用此选项提供从电子邮件 ID 到 UPN 的映射正则表达式。
- 汇报管理访问权限的用户或组仅在完全爬网中同步。 增量爬网当前不支持处理权限更新。
内容
管理属性
在这里,你可以在 Dropbox 数据源中添加或删除可用属性。 将架构分配给属性 (定义属性是 可搜索的、可查询的、可检索的还是可精简 的) ,更改语义标签并向属性添加别名。 默认情况下选择的属性包括:
Source 属性 | Label | 说明 | 架构 |
---|---|---|---|
CreatedBy | 创建者 | 创建者的电子邮件地址 | 查询、检索、搜索 |
FileExtension | 文件扩展名 | 文件扩展名。 | 查询、优化、检索 |
IconUrl | IconUrl | 图标的 URL。 | 取回 |
LastModifiedBy | 上次修改日期时间 | 上次修改此文件的用户的电子邮件地址。 | 查询、检索、搜索 |
LastModifiedTime | lastModifiedDateTime | 最后一个修改文件的用户。 执行最后一次修改的用户这必须是登录用户。 | 查询、优化、检索 |
名称 | 文件名 | 文件名 | 查询、检索、搜索 |
PreviewUrl | url | 用于显示共享文件的 Web 预览的 URL。 | 取回 |
Size | 以字节为单位的文件大小。 |
同步
可以根据此处提供的计划选项配置完整爬网和增量爬网。 默认情况下,增量爬网设置为每 4 小时一次,并且每天设置完全爬网。 如果需要,可以调整这些计划以满足数据刷新需求。
疑难解答
1. 缺少所需的权限范围。 确保在 Dropbox 应用中选择了必要的范围。
缺少所需的权限范围,请确保在 Dropbox 应用控制台中选择了所有范围:
单个范围:
files.metadata.read
files.content.read
sharing.read
file_requests.read
团队范围:
team_info.read
team_data.member
team_data.governance.write
team_data.governance.read
team_data.content.read
files.team_metadata.read
members.read
groups.read
events.read
2.OAuth 2.0 流失败。 验证凭据信息,并确保为 Dropbox 应用配置了正确的设置。
常见的身份验证错误。 返回 Dropbox 应用控制台,如果正确配置了设置选项卡中的 OAuth2,检查。
3.OAuth 2.0 流失败。 确认与此团队访问令牌关联的 Dropbox 用户拥有团队管理员角色,并且是活动用户。
常见的身份验证错误。 返回 Dropbox 应用控制台,如果创建者具有管理员角色且帐户状态为活动,则检查。
4. 此会话的安全凭据已过期。 返回并使用应用密钥和应用机密再次登录。
凭据信息已过期。 刷新 Dropbox 应用控制台,并从“设置”选项卡中复制最新的“应用密钥”和“应用机密”进行身份验证。
5.检测到无效凭据。 检查凭据信息并检查 Dropbox 应用的权限范围。
常见凭据错误。 返回 Dropbox App 控制台,如果正确配置了权限选项卡中的范围,检查。