DataStax 智能 Microsoft 365 Copilot 副驾驶® 连接器允许组织为 DataStax Astra DB 集合中的记录编制索引。 配置连接器并索引 DataStax 数据库中的内容后，用户可以在智能 Microsoft 365 Copilot 副驾驶®中搜索这些项。
本文适用于 Microsoft 365 管理员或配置、运行和监视 DataStax Copilot 连接器的任何人。
功能
- 为 DataStax Astra DB 集合中的记录编制索引。
- 使用户能够根据 Copilot 中 DataStax 的知识征求建议。 例如，已将连接器配置为访问 DataStax 中的电影评论集合：
- 根据评论文本和兴趣推荐电影。
- 汇总电影 Paa 上的评论文本。
- 确定引发激烈讨论的电影。
限制
- 不为非矢量数据库编制索引。
- 不为 Langflow 编制索引。
- 不支持垂直搜索。
先决条件
- 你必须是组织的 Microsoft 365 租户的搜索管理员。
- 若要连接到 DataStax 数据库，需要 DataStax API 终结点和数据库 ID。
- 若要连接到 DataStax 并允许 Copilot 连接器定期更新 DataStax 任务，需要具有读取权限的应用程序令牌。
入门
1.选择显示名称
显示名称用于标识 Copilot 中的每个引文，以帮助用户轻松识别关联的文件或项目。 显示名称还表示受信任的内容，并用作 内容源筛选器。
提供了默认值;你可以将其自定义为组织中的用户可识别的名称。
2.添加 DataStax API 终结点
若要连接到 DataStax 数据库，需要 DataStax API 终结点。 可以在数据库的概述中找到终结点，通常为： https://<your-database-id>-<region>.apps.astra.datastax.com。
3.添加 DataStax 数据库 ID
若要连接到 DataStax 数据库，需要 DataStax 数据库 ID。 可以在数据库概述中找到数据库 ID。
4.生成应用程序令牌
若要使用 DataStax 应用程序令牌 进行身份验证，DataStax 管理员需要为具有适当用户角色的数据库生成应用程序令牌，例如使用“只读用户”。
从令牌详细信息复制生成的应用程序令牌，该详细信息通常是以“AstraCS：...” 开头的长字符串并将其粘贴到连接器设置中。 选择“ 授权”，并使用相同的令牌对爬网权限进行身份验证。
5. 面向有限受众推出
如果要先在 Copilot 和其他搜索图面中验证连接，然后再将其部署到有限的用户群，然后再将其推广到更广泛的受众。 有关详细信息，请参阅 连接器的分阶段推出。
此时，已准备好为 DataStax 创建连接。 选择 “创建” ，从 DataStax 帐户发布连接和索引文章。
对于其他设置（如 访问权限、 架构和 爬网频率），将根据最适用于 DataStax 数据的方式设置默认值。
| 用户 | 说明 |
|---|---|
| 访问权限 | 仅有权访问数据源中内容的人员。 |
| 地图标识 | 使用 Microsoft Entra ID 映射的数据源标识。 |
| 内容 | 说明 |
|---|---|
| 管理属性 | 有关默认属性及其架构的信息，请参阅 内容。 |
| 同步 | 说明 |
|---|---|
| 完全爬网 | 每天运行。 |
自定义设置
在自定义设置中，可以编辑用户、内容和同步的任何默认值。
用户
访问权限
DataStax Copilot 连接器支持对 “所有人 ”或 “仅有权访问此数据源的人员”可见的搜索权限。 如果选择“ 所有人”，则所有用户的搜索结果中将显示索引数据。 如果选择“ 仅有权访问此数据源的人员”，则索引数据将显示在有权访问这些数据源的用户的搜索结果中。 在 Atlassian DataStax 中，安全权限是使用包含站点级组和项目角色的项目权限方案定义的。 还可以使用任务级权限方案定义任务级安全性。
映射标识
使用 Microsoft Entra ID 映射数据源标识的默认方法是验证 DataStax 用户的电子邮件 ID 是否与 Microsoft Entra ID 中用户的 UPN) 用户主体名称 (相同。 如果默认映射不适用于组织，则可以提供自定义映射公式。 有关详细信息，请参阅 映射非 Azure AD 标识。
若要确定哪个选项最适合你的组织，请执行以下作：
- 如果 DataStax 用户的电子邮件 ID 与 Microsoft Entra ID 中的 UPN 相同，请选择“Microsoft Entra ID”选项。
- 如果 DataStax 用户的电子邮件 ID 与用户在 Microsoft Entra ID 中的 UPN 和电子邮件不同，请选择“非Microsoft Entra ID”选项。
内容
管理属性
若要查看 DataStax 数据源中的可用属性，请将架构分配给属性， (定义属性是可搜索的、可查询的、可检索的还是可精简的) 、更改语义标签并在属性中添加别名。 某些属性默认处于选中状态。
| 默认属性 | 标签 | 说明 | 架构 |
|---|---|---|---|
| 集合 | 不适用 | 集合名称 | 查询、检索、搜索。 |
| 内容 | 不适用 | 集合中的记录 | 搜索。 |
| IconUrl | IconUrl | 记录的图标 URL | 取回。 |
| Id | url | 集合中的记录 ID | 查询、检索。 |
| Keyspace | 不适用 | 创建此任务的人员 | 查询、检索、搜索。 |
| 标题 | 标题 | 通过组合集合名称和记录 ID 创建的标题 | 查询、检索、搜索。 |
预览数据
使用预览结果按钮验证所选属性和查询筛选器的示例值。
同步
刷新间隔确定数据在数据源和 DataStax Copilot 连接器索引之间同步的频率。 DataStax 图形连接器仅支持刷新间隔 - 完全爬网。 有关详细信息，请参阅 刷新设置。
可以更改刷新间隔的默认值。
后续步骤
发布连接后，可以在管理中心的“数据源”下查看状态。 若要了解如何进行更新和删除，请参阅 管理连接器。
如果遇到问题或想要提供反馈，请参阅 Microsoft Graph 支持。