管理 Copilot Studio 代理

注释

  • 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
  • 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
  • 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。

当你想注册、编辑或移除服务代理在对话中可以委派问题的Copilot Studio代理时，可以使用此功能。

它的作用是什么

助理会打开一个管理界面，你可以管理Dynamics 365环境下的Copilot Studio代理注册。 Copilot Studio 代理是发布的机器人，服务代理可以通过模式名称将问题交接给它们。

通过注册小部件，你可以添加新的代理委托，编辑现有委托，测试连接性，并移除不再需要的注册。 每个注册都包含显示名称、机器人身份、描述、模式名称和可选输入参数。

试试像这样的提示

  • 管理我的Copilot Studio经纪人。
  • 注册一个次代理。
  • 出示我的MCS代理人注册信息。
  • 添加一个Copilot Studio机器人委派。
  • 委托给代理人。
  • 我想添加一个MCS代理。

你在聊天中会看到的内容

助手作为聊天应用组件显示一个交互式注册管理小部件。 如果你已经有注册，小部件会以显示显示名称、工具名称、描述和模式名称等关键细节的列表显示它们。

有用的提示

  • 你需要服务代理生成器自定义权限来管理注册。
  • 只有你环境中发布的活跃 Copilot Studio 机器人才能注册。
  • 保存前务必使用测试连接按钮，确认代理是否可通过代理SDK访问。
  • 您的环境支持最多10个Copilot Studio代理注册。
  • 你提供的描述会在路由时向服务代理展示，所以要清晰地写出来，帮助代理决定何时委派。

Tip

注册代理后，服务代理可以在未来的对话中将问题委托给代理。 代理以前缀 mcs_为前缀的工具出现。

接下来会发生什么

注册小部件出现后，您可以：

  • 新增一个Copilot Studio代理。
  • 测试一下我的经纪人关系。
  • 移除常见问题机器人。
  • 编辑我的注册代理人描述。

这会改变数据吗？

这一步是只读的，但后续操作可能会改变数据。

打开注册小部件不会改变数据。 在小部件内添加、编辑或移除注册确实会改变环境配置。

你可以通过聊天应用组件做些什么

通过聊天中的注册小工具，你可以：

  • 查看所有注册的 Copilot Studio 代理，适用于您的环境。
  • 通过从你的环境中选择已发布的机器人来添加新的代理注册。
  • 编辑现有注册的制作者自撰工具描述。 要更改所选机器人或其显示身份，请移除注册并重新添加。
  • 测试与注册代理的连接，以确认其可达性。
  • 取消一个你不再需要的注册。

先决条件

该工具需要以下条件：

  • Copilot 可扩展性，需要配置 Copilot Studio。 需要系统管理员或Copilot服务管理员角色。

在使用 Copilot Studio 的 Extend Copilot 中了解更多信息。

工具摘要

资产 价值
面向用户的名称 管理 Copilot Studio 代理
内部工具名称 manage_copilot_studio_registration
Purpose 打开管理 Copilot Studio 代理注册的管理界面

工具行为

打开管理 Copilot Studio 代理注册的界面。 管理员可以列出、注册或取消注册已发布的 Copilot Studio 机器人，服务代理可通过模式名称委派问题。 该工具仅涵盖 Copilot Studio 的代理委托;HTTPS工具服务器端点通过manage_mcp_registration管理。

Annotations

注释 价值 Meaning
readOnlyHint true 该工具不会直接修改数据。 小部件调用了独立的保存/删除工具。
destructiveHint 未设置 不适用（只读启动器）。
idempotentHint 未设置 不适用（只读启动器）。
openWorldHint 未设置 使用默认值（查询Dataverse + Power Platform）。

输入概念

Action

输入 Description 必需
open、list open （default） 或 list. 两者都返回注册管理小部件;该值记录请求的交互意图。 否

组织 URL

输入 Description 必需
orgUrl orgUrl（可选）。 当主机未提供当前选择的环境 URL 时，会覆盖当前选择的环境 URL。 否

响应与用户界面行为

该 MCP 工具由 MCP 应用支持。

响应类型

交互式注册管理小部件

在这两个操作中，小部件显示注册管理界面，管理员可以浏览、添加、测试和移除 Copilot Studio 代理注册。 action该价值在回复中仍是意图提示。

路由注释

在以下情况下使用 manage_copilot_studio_registration：

  • 用户提到了Copilot Studio、MCS代理、子代理或机器人委托。
  • 用户希望添加、移除或浏览代理集成。

以下情况下请勿使用此工具：

  • 用户提到MCP服务器、工具端点或HTTPS URL——路由到 manage_mcp_registration。
  • 用户希望配置代理布局（网格、表单、时间线）——路由到 browse_agent_config_options。
工具 关系
save_copilot_studio_registration 一个由小部件调用的工具，能够在新的或更新的代理注册后持续存在
delete_registration 一个小部件调用工具，可以移除代理注册，使用 type: "mcs"
test_copilot_studio_registration_connection 测试代理可达性的小部件调用工具
list_copilot_studio_registration_bots 控件调用工具，列出可供机器人选择的可用机器人
manage_mcp_registration 管理HTTPS MCP工具服务器注册（独立范围）

数据变异分类

启动器本身不会更改数据。 该小部件调用 save_copilot_studio_registration 和 delete_registration ， type: "mcs" 用于写入操作。

  • 上次更新时间为