配置和管理连接

代理使用工具和知识代表用户执行作,并收集相关的上下文信息。 这些工具和知识源通常存储在外部系统中,例如 Microsoft Dataverse、Microsoft SharePoint 或其他 API。 若要安全地访问这些资源,代理需要进行身份验证才能建立连接。 代理可以使用代理作者身份验证或用户身份验证,具体取决于方案。

在 Microsoft Copilot Studio 中, 连接 用于安全地访问经过身份验证的服务以获取工具和知识。 可以创建与各种数据源的连接,例如 Microsoft Dataverse、Microsoft SharePoint 或外部 API。

查看和管理代理连接

在 Copilot Studio 中,可以在 “连接设置” 页上查看和配置代理使用的连接。

“连接设置” 页上,可以配置和管理代理使用的连接。 可以查看现有连接、创建新连接,并根据需要编辑或断开连接。

在“连接设置”页上查看连接

  1. 通过选择 “代理 ”,然后选择想要查看的代理,导航到 Copilot Studio 中的代理页面。

    代理概述页打开。

  2. 选择 “设置” 以打开“代理 设置” 页。

  3. 在左侧导航窗格中,选择“ 连接设置”。

列表显示在表中,其中包含与代理关联的所有连接。 对于每个连接,可以使用连接、连接状态以及上次更新连接日期查看其名称、工具和知识。

代理设置下的“连接设置”页

筛选连接

如果您的智能体有很多连接,可以进行筛选以缩小视图,然后找到您想要处理的连接。 可以应用不同的筛选器,根据连接状态查看连接,例如已激活/已停用已连接/、已停用已过期连接错误

选择或创建连接

  1. 在列表中的连接条目 的状态 下,选择“ 管理 ”以打开 “创建”或“选择连接 ”窗格。

  2. 打开 连接 配置。 从列表中选择现有连接,或选择“ 创建新连接 ”以创建新连接。

    如果选择“ 创建新连接”,将打开连接设置窗格。 根据需要,系统可能会提示你登录到服务或提供其他信息来完成连接设置。

  3. 完成后,选择提交以保存更改。

    连接现在与代理关联,代理可以使用连接来访问工具和知识。

配置连接参数

在列表中的“ 管理 ”下,选择“ 查看详细信息 ”以查看有关连接的详细信息。

查看连接详细信息

信息显示在两个选项卡中:

  • 详细信息:显示连接名称、说明、状态和创建详细信息。
  • 连接参数:显示连接参数,例如身份验证详细信息、API 密钥或其他必需信息,并允许配置详细信息。

共享 On-Behalf-Of(OBO)身份验证的连接参数

对于支持单一 Sign-On(SSO)的某些连接,可以将连接设置为使用 On-Behalf-Of(OBO)身份验证。 在 OBO 流中,用户委托代理代表用户使用服务的共享连接参数。 当代理需要访问具备用户特定权限的资源,或需要在用户身份上下文中执行操作时,这将非常有用。

为 OBO 启用参数共享

在列表中的连接条目 的连接参数 下,可以允许用户授权共享特定的连接参数。

  1. “连接参数”下,打开 “允许共享参数”权限

    启用参数共享

  2. 选中要允许用户共享的参数的复选框。

    当代理使用 OBO 身份验证时,系统会提示用户授予这些参数的权限。

OBO 身份验证的用户体验

当代理使用 OBO 身份验证时,系统会提示用户授予代理使用其连接参数的权限。 用户可以选择允许或拒绝此权限。 如果用户允许,代理可以访问资源并代表用户执行作。 代理使用共享连接参数以透明方式连接到服务。