为工具配置用户身份验证

当你为代理创建 工具 时,可以要求用户认证,或者提供一套凭证供代理代表用户使用。

  • 如果对与该工具关联的服务的访问权限是隐式的,或者对于低风险用例,请选择 代理作者身份验证 。 例如,使用此身份验证设置查找给定邮政编码的支持团队的电话号码。 另一个用例可能是使用天气 API 来获取当前预报。
  • 如果您必须将数据访问权限限制在用户社区中的特定群体或个人,请选择用户身份验证。 例如,如果代理用于检索只有用户有权访问的数据或代表用户执行工作,请使用此身份验证设置。

在对话中连接服务

当代理调用使用用户认证的工具时,Copilot Studio 会检查用户是否与该服务建立了有效的连接。 如果有有效的连接,代理会使用它。 否则,代理会显示工具所需服务的连接卡。

创建连接时,用户选择“Connect”,并在一个单独的窗口中完成任何必要的登录或同意步骤。 连接请求是针对当前工具调用所需的服务。

连接成功后,窗口将关闭,智能体会自动重试该工具。 如果 Copilot Studio 无法确认连接或继续工具调用,卡片显示连接失败并重试。 用户可以选择“重新尝试”以刷新连接状态并重试工具。

如果您为由标准框架驱动的智能体托管自定义聊天画布,请实现连接弹出窗口和后续处理。 更多信息请参阅在自定义画布中支持连接设置。

数据访问和权限管理

Copilot Studio 不存储任何凭据。 代理会在访问令牌到期或被服务撤销时提示用户重新连接。 用户还可以访问连接管理页面,刷新或撤销权限。

支持的渠道

下表列出支持工具用户认证的 通道 。

频道 已支持
Azure 机器人服务 通道 不支持
自定义网站 已支持
演示网站 不支持
Facebook 不支持
Microsoft Teams1 已支持
移动应用 不支持
全渠道客户服务2 已支持
SharePoint1 已支持

1 如果您也使用 Teams 频道,请按照 Teams 中“配置 Microsoft Entra ID 的座席单点登录”中的说明操作。 否则,Teams 中的用户将始终无法通过身份验证。

2 仅支持实时聊天渠道。 详情请参阅配置向 Dynamics 365 Customer Service 的交接。