共享和管理内置于 Agent Builder 的代理

您可以与组织中的用户共享在 Agent Builder 中构建的代理。 代理支持多个所有者,因此您可以在整个团队中共享所有权。 任何所有者都可以编辑、管理和维护代理。 共享代理可为一组指定的用户提供对它的直接访问。 虽然共享代理非常适合团队协作,但不允许在整个组织中部署或与其他渠道集成。

本文介绍如何共享和管理在 Agent Builder 中构建的代理。 若要跨多个渠道发布代理,需要使用 Copilot Studio。 有关详细信息,请参阅 发布和部署代理。

共享代理

在 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中生成并测试代理后,选择“创建”。 创建代理后,会显示一条确认消息,表明该代理是私有的,只有您可用。 要与他人共享代理, 请选择共享 以打开共享对话框。

从“所有代理”列表中共享代理

共享对话框列出了具有访问权限的每个人、他们的角色、组织范围的共享切换以及你可以随时复制的链接。

注意

管理员可能会应用限制某些代理共享选项的策略。 这些更改不会自动撤销现有的代理访问权限。 禁用组织范围的共享不会阻止与特定人员直接共享。 发布到组织目录需要管理员批准。 如果治理策略发生更改,请在更新代理之前更新代理的共享选项以合规。

了解角色

共享对话框使用两个访问级别。

角色 说明 可以聊天 可以编辑和管理
可以编辑 所有者 — 编辑、共享和管理代理的完全权限。 是 是
可以聊天 对话助手 — 只能与代理交互。 是 否

所有者是具有“ 可以编辑 ”访问权限的任何人。 所有所有者都具有平等的权利,包括可以添加或删除人员、切换角色以及启用组织范围的共享。

注意

不能将组添加为所有者。 添加组时,它只能是聊天用户 (可 ) 聊天 。 要授予所有者权限,请添加单个用户。

添加所有者和聊天用户

  1. 打开要共享的代理,然后选择 “共享”。
  2. 在共享对话框中,在 添加名称、组或电子邮件 框中输入名称、组或电子邮件。
  3. 在“ 添加人员 ”面板上,为要添加的人员设置角色:
    • 选择 可以编辑 ,将他们添加为具有完全编辑和管理权限的所有者。
    • 选择 Can chat (可以聊天 ) 以将其添加为只能与代理交互的聊天用户。
  4. 保持选中“ 发送通知” 复选框,向新用户发送电子邮件,以便他们知道自己具有访问权限。 如果不想发送电子邮件,请清除复选框。
  5. 选择“添加”。

添加人员面板

共享完成后,您会收到确认,可以复制聊天链接以直接共享。

注意

代理功能因用户许可证而异。 用户只有在拥有访问该代理中配置的功能所需的智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 许可证类型时,才能添加与其共享的代理。 如果用户没有代理功能的相应许可证,则尝试使用代理可能会导致错误。 有关详细信息,请参阅 Microsoft 365 用户的智能体功能。

切换用户角色

作为所有者,您可以随时更改任何共享用户的角色。

  1. 打开“ 共享 ”对话框。
  2. 选择用户旁边的角色下拉列表。
  3. 选择新选项:
    • 可以编辑 - 将用户升级为具有完全权限的所有者。
    • 可以聊天 - 将用户更改为聊天用户。
    • 删除 - 撤销用户的访问权限。

更改会立即生效。

“添加角色”下拉列表

共享对话框显示链接,以便您无需离开即可共享访问权限:

  • 对话助手链接 - 适用于只需与代理交互的聊天用户。
  • 编辑链接 - 适用于需要创作和管理代理的所有者。

选择 “复制聊天”链接 或选择“ 编辑”链接,然后将其粘贴到电子邮件、聊天或文档中。

启用组织范围内的共享

若要使租户中的每个人都可以使用代理,请启用组织范围共享以进行聊天访问。

  1. 打开“ 共享 ”对话框。
  2. 打开组织 范围内共享以进行聊天访问开关 。

对于代理存储中管理员审核的发布,请 将代理提交到组织目录。 共享和目录提交是单独的路径。

治理和管理控制

启用代理后,在代理生成器中创建代理是一项核心 Copilot 功能。 管理员无法在保持代理启用状态的同时单独禁用代理生成器中的代理创建。

智能体生成器中内置的代理可根据说明和特定任务的选定知识源自定义 Copilot。 除了 Copilot 之外,它不会引入新的平台功能。 创建代理本身不会授予额外的数据权限。 但是,所有者仍需要查看他们共享的内容,包括任何上传的知识。

管理员可以控制对代理的访问、组织范围内的共享和目录发布的审批:

  • 代理访问:在 Microsoft 365 管理中心,转到“代理>设置>”用户访问权限。 选择 所有用户、 无用户或 特定用户或组 ,以控制谁可以访问和安装代理和插件。 此设置控制代理和插件访问,而不是独立创建代理生成器。 有关详细信息,请参阅 用户访问。
  • 组织范围内的共享: 在 代理>设置>共享中,控制谁可以与组织共享代理生成器中内置的代理。
  • 目录发布: 在共享或发布之前,新代理对其创建者是私有的。 将代理发布到组织目录需要管理员审阅和批准。 有关详细信息,请参阅 将代理提交到组织目录。

对于组织范围内的共享,管理员可以配置以下选项之一:

  • 所有用户 (默认) : 每个人都可以与组织共享代理。
  • 特定用户或组: 将组织范围的共享权限限制为所选用户或组。
  • 无用户: 禁用组织范围内的共享。 用户仍可直接与特定人员共享。

注意

对共享设置的更改仅适用于新的共享操作。 除非您手动更新现有共享代理的共享设置,否则仍可访问现有共享代理。

禁用组织范围内的共享时, 组织范围内共享聊天访问权限 开关将灰显,并显示解释限制的工具提示。 有关详细信息,请参阅 共享设置。 此设置仅适用于智能体生成器中内置的智能体。

对代理的访问和对其知识源的访问是不同的:

  • SharePoint 和 OneDrive 源: 现有文件权限和敏感度标签适用。 单独共享代理不会授予对其所有源内容的访问权限。 所有者可以单独共享所选 SharePoint 文件和文件夹(如果有权)。 有关详细信息,请参阅 自动共享 SharePoint 文件和文件夹。
  • 上传的文件:从设备上传的 Files 成为嵌入式知识。 任何可以访问代理的人都可以收到基于该内容的响应,但需遵守嵌入式内容的敏感度标签权限。 在共享代理之前,请查看上传的内容。 有关详细信息,请参阅 嵌入式文件内容。

下载 ZIP 包以旁加载代理

智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®提供了一个下载 ZIP 包以用于手动旁加载的选项。 此 ZIP 包包含将 代理旁加载到 Microsoft Teams 中所需的文件。

若要下载 ZIP 包并手动旁加载代理,请执行以下操作:

  1. 在智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®的左窗格中,选择“新建代理”。
  2. 在 New agent (新代理) 页面的 My agents (我的代理) 下,选择 View all agents(查看所有代理)。 “新建代理”页面上“查看所有代理”选项的屏幕截图。
  3. 选择要下载的代理,然后选择省略号 (...) 。
  4. 选择 下载 .zip 文件。 .zip 文件包含代理清单和应用图标。 *下载 .zip 文件*选项的屏幕截图
  5. 将代理旁加载到 Microsoft Teams 中。

注意

  • ZIP 包不能包含嵌入文件。 从 ZIP 包中删除任何嵌入的文件内容。
  • macOS 不支持 Teams 中的旁加载代理。

自动共享 SharePoint 文件和文件夹

共享代理时,Copilot 用户可能无权访问所有基础知识源。 将他人添加为聊天用户或所有者时,可以与他人共享 SharePoint 知识源。 但是,代理尊重最终用户的信息和敏感度权限。 因此,如果用户无权访问知识源,则代理在生成响应时不会包含知识源包含的内容。

你可以选择要共享的 SharePoint 文件夹和文件。 仅当代理的所有者已具有共享或更新共享权限的权限时,共享才有效。 遵守应用于 SharePoint 或 OneDrive 中文件的文件敏感度标签。 如果文件或文件夹上的共享失败,代理仍将与用户共享。 所有者需要联系文件所有者或 SharePoint 网站管理员,以直接从 SharePoint 授予对文件或文件夹的权限。

注意

只有专门添加到代理的文件和文件夹可以自动共享。 与之共享代理的人员不会自动获得对 SharePoint 网站的完全访问权限。 站点管理员必须通过站点设置授予用户权限。

当用户对代理的访问权限被删除时,不会影响他们对共享文件或文件夹的访问。 管理用户直接通过 SharePoint 访问文件和文件夹的权限。

更新代理的“关于”信息

使用“关于此代理”对话框更新代理商店和智能智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®中代理的“关于信息”中可见的元数据。 可以为拥有的任何代理打开此对话框,无论它是共享还是发布到组织目录。

若要打开对话框,请在代理创作标头中选择 “更多 省略号 () ”,然后选择“ 关于此代理”。

提供有以下字段。

域 必需或可选 最大长度 说明
简短说明 必需 80 个字符 代理工作的简明摘要。 显示在代理商店和代理的“关于”信息中。 默认:使用 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 代理生成器生成。
创建者网站 可选 2,048 个字符 指向有关你或你的团队的详细信息的链接,例如你的个人资料页面、团队的 SharePoint 网站或内部支持页面。 当用户在代理详细信息窗格中选择创建者的名称时打开。 必须是有效的 HTTPS URL。
隐私声明 可选 2,048 个字符 指向组织隐私声明的链接。 必须是有效的 HTTPS URL。
使用条款 可选 2,048 个字符 指向组织使用条款的链接。 必须是有效的 HTTPS URL。

为 创建者网站、 隐私声明和 使用条款提供默认占位符 URL。 将每个占位符替换为适合您的代理的 URL;否则,代理生成器会在字段上显示警告。

注意

你保存的值 关于 此代理 将代理提交到组织目录时,请预填充提交 到组织目录 对话框中的相应字段。 有关更多信息,请参阅 Agent Builder 中代理的隐私声明和使用条款。

将代理提交到组织目录

代理的共享版本和代理存储版本是单独管理的。 您可以管理共享版本,并可以随时继续迭代它,更改与谁共享版本,或将其保密以进行测试。 发布代理后,管理员将管理代理商店版本。

若要使代理在组织中广泛可发现,请将其发布到组织目录。 管理员在 Microsoft 365 管理中心审阅代理,如果获得批准,则会将代理部署到代理商店的“由组织生成”部分。

有关提交步骤、必填字段、审批状态跟踪和审批后更新,请参阅 将代理从代理生成器提交到组织目录。

管理代理

可以访问 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中的代理管理功能:

若要管理最近访问的代理,请在要管理的代理名称旁边的左窗格中选择 “更多 省略号 (...) ”。

若要管理最近未访问的代理,请执行以下操作:

  • 选择左窗格中的所有 代理 。
  • 在 代理商店的“你的 代理”下,选择“ 查看更多 ”,然后选择要管理的代理名称旁边的省略号 (...) 。

或者:

  • 在左侧窗格中选择新座席,然后选择查看所有座席。
  • 选择要管理的代理名称旁边的省略号 (更多省略号) ...

注意

在 Agent Builder 中, “我的代理” 列表仅包含您拥有的代理或您具有“ 可以编辑 ”访问权限的代理。 作为聊天用户与你共享的代理不会显示在此列表中。

编辑代理

如果共享后需要更改,代理的任何所有者都可以对其进行编辑。

  • 使用 “管理代理”中所述的方法之一访问代理列表。
  • 从“更多省略号 () ”菜单中 (铅笔图标) 选择“编辑”。

在这里,可以使用自然语言描述更改。 您还可以使用 “配置” 选项卡对代理的功能和知识来源进行更精细的控制。

对代理所做的更改会自动保存。 但是,在你提供更改之前,用户看不到这些更改。 要使现有代理的更改可用,请选择右上角的 Update (更新 )。 您的更改可能需要几分钟时间才能提供给最终用户。

注意

如果更新以前共享的具有 SharePoint 文件和文件夹知识源的代理,请将其重新共享给相同的用户。 这样做会自动再次与用户共享文件和文件夹,以确保一致的代理体验。

删除代理

代理的任何所有者都可以删除它。 删除代理后,您将无法使用它,并且其他所有者或与之共享代理的用户也无法使用它。

重要

删除代理是永久性的,无法撤消。

若要删除代理,请执行以下操作:

  • 使用 “管理代理”中所述的方法之一访问代理列表。
  • 选择 “更多 省略号 () ”菜单, 然后选择“删除 ” (垃圾桶图标) 。

重新分配代理的所有权

您可以通过在共享对话框中添加具有“ 可以编辑 ”角色的用户来直接共享代理的所有权。 所有所有者都具有编辑、共享和管理代理的平等权利。 有关详细信息,请参阅 添加所有者和聊天用户。

管理员还可以更新组织内共享代理的所有者。 有关更多信息,请参阅 重新分配共享代理的所有权。

疑难解答

共享代理及其知识源时,您可能会遇到下表列出的错误。

问题 说明
出现错误 发生内部服务错误。 如果此错误继续出现,请联系支持人员。
无法共享 用户没有足够的权限更新某些文件的共享权限。 该错误会列出无法共享的文件。 代理所有者应进入 SharePoint 以尝试手动更新这些权限。 有关详细信息,请参阅:
代理共享失败,未授予知识访问权限 如果代理共享失败,则可能无法与预期用户或组共享基础知识源。 因此,无权访问这些文件的用户不会收到基于这些文件生成的响应。 要解决此问题,请确保您与之共享代理的所有个人和组都存在于您的组织中,然后通过在共享设置中选择它们来重新共享知识源,以授予用户对它们的访问权限。
无法再更新代理 当代理的当前共享设置不再符合新的管理策略时,就会发生此错误。 代理所有者必须在进一步更新代理之前将共享设置更改为合规选项。 横幅将指导你进行此更改。
由于出现错误,我们无法创建此代理。 当系统在创建代理时遇到问题时发生。 请在几分钟后重试。
此代理至少包含一个具有不受支持的敏感度标签的文件。 检查上传的文件并将其删除。 在上传具有不受支持的敏感度标签的文件时发生。 检查上传文件旁边的盾牌图标,并删除带有红色错误图标的文件。 有关详细信息,请参阅 不支持的敏感度标签方案。
无法更新代理,因为它可能会鼓励有害操作。 当系统检测到有害内容时发生。 查看代理的名称、说明和说明并删除任何有害内容,然后再次尝试更新代理。 以了解详细信息。 请参阅 负责任的 AI 验证。