代理使用工具和知识代表用户执行作,并收集相关的上下文信息。 这些工具和知识源通常存储在外部系统中,例如 Microsoft Dataverse、Microsoft SharePoint 或其他 API。 若要安全地访问这些资源,代理需要进行身份验证才能建立连接。 代理可以使用代理作者身份验证或用户身份验证,具体取决于方案。
在 Microsoft Copilot Studio 中, 连接 用于安全地访问经过身份验证的服务以获取工具和知识。 可以创建与各种数据源的连接,例如 Microsoft Dataverse、Microsoft SharePoint 或外部 API。
查看和管理代理连接
在 Copilot Studio 中,可以在 “连接设置” 页上查看和配置代理使用的连接。
在 “连接设置” 页上,可以配置和管理代理使用的连接。 可以查看现有连接、创建新连接,并根据需要编辑或断开连接。
在“连接设置”页上查看连接
通过选择 “代理 ”,然后选择想要查看的代理,导航到 Copilot Studio 中的代理页面。
代理概述页打开。
选择 “设置” 以打开“代理 设置” 页。
在左侧导航窗格中,选择“ 连接设置”。
列表显示在表中,其中包含与代理关联的所有连接。 对于每个连接,可以使用连接、连接状态以及上次更新连接日期查看其名称、工具和知识。
筛选连接
如果您的智能体有很多连接,可以进行筛选以缩小视图,然后找到您想要处理的连接。 可以应用不同的筛选器,根据连接状态查看连接,例如已激活/已停用、已连接/、已停用、已过期或连接错误。
选择或创建连接
在列表中的连接条目 的状态 下,选择“ 管理 ”以打开 “创建”或“选择连接 ”窗格。
打开 连接 配置。 从列表中选择现有连接,或选择“ 创建新连接 ”以创建新连接。
如果选择“ 创建新连接”,将打开连接设置窗格。 根据需要,系统可能会提示你登录到服务或提供其他信息来完成连接设置。
完成后,选择提交以保存更改。
连接现在与代理关联,代理可以使用连接来访问工具和知识。
配置连接参数
在列表中的“ 管理 ”下,选择“ 查看详细信息 ”以查看有关连接的详细信息。
信息显示在两个选项卡中:
- 详细信息:显示连接名称、说明、状态和创建详细信息。
- 连接参数:显示连接参数,例如身份验证详细信息、API 密钥或其他必需信息,并允许配置详细信息。
共享 On-Behalf-Of(OBO)身份验证的连接参数
对于支持单一 Sign-On(SSO)的某些连接,可以将连接设置为使用 On-Behalf-Of(OBO)身份验证。 在 OBO 流中,用户委托代理代表用户使用服务的共享连接参数。 当代理需要访问具备用户特定权限的资源,或需要在用户身份上下文中执行操作时,这将非常有用。
为 OBO 启用参数共享
在列表中的连接条目 的连接参数 下,可以允许用户授权共享特定的连接参数。
在 “连接参数”下,打开 “允许共享参数”权限。
选中要允许用户共享的参数的复选框。
当代理使用 OBO 身份验证时,系统会提示用户授予这些参数的权限。
OBO 身份验证的用户体验
当代理使用 OBO 身份验证时,系统会提示用户授予代理使用其连接参数的权限。 用户可以选择允许或拒绝此权限。 如果用户允许,代理可以访问资源并代表用户执行作。 代理使用共享连接参数以透明方式连接到服务。