注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你通过注册管理小部件浏览可用的Copilot Studio机器人时，这项功能在幕后工作。
它的作用是什么
当你在 Copilot Studio 代理注册表单中打开机器人选择器时，该工具会查询你的 Dynamics 365 环境中发布的活跃 Copilot Studio 机器人。 它会返回最近发布的机器人，这样你可以选择一个注册为服务代理委托。
该工具检索机器人元数据，包括显示名称、模式名称和机器人ID。 这些信息用于在你选择机器人时填写注册表单。
试试像这样的提示
不適用。 当你通过管理小部件浏览机器人时，这个工具会自动调用。 输入提示词不会调用它。
你在聊天中会看到的内容
注册小部件在注册表单中的选择器中显示可用机器人列表。 每个机器人都会显示其显示名称和模式名称。 如果在你的环境中找不到发布的机器人，选择器会显示为空状态。
有用的提示
- 列表中只显示已发布和活跃的机器人。 如果你没看到机器人，确认它已经发布在 Copilot Studio 上。
- 列表先显示最近发布的机器人。
- 已经注册的机器人不会出现两次，但你仍然可以选择新的机器人并注册它。
接下来会发生什么
选择机器人后，你可以：
- 测试与这个机器人的连接。
- 填写描述并保存注册信息。
这会改变数据吗？
不，这不会改变数据。
列出可用机器人为只读。 配置不被修改。
先决条件
该工具需要以下条件：
- Copilot Copilot Studio的可扩展性。
在使用 Copilot Studio 的 Extend Copilot 中了解更多信息。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 列表：可用的MCS机器人 |
| 内部工具名称 | list_copilot_studio_registration_bots |
| Purpose | 在开发者选择的 Dataverse 环境中返回多达 50 个最近发布的活跃 Copilot Studio 机器人 |
工具行为
在开发者选择的 Dataverse 环境中返回最多 50 个最新发布的活跃 Copilot Studio 机器人。 这是MCS注册表单机器人选择器使用的控件支持工具。 它不适合模型直接调用。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用（只读工具）。 |
idempotentHint |
未设置 | 不适用（只读工具）。 |
openWorldHint |
未设置 | 使用默认设置（查询Power Platform）。 |
输入概念
组织 URL
| 输入 | Description | 必需 |
|---|---|---|
orgUrl |
orgUrl（可选）。 覆盖当前选择的环境URL。 |
否 |
响应与用户界面行为
该 MCP 工具由 MCP 应用支持。
响应类型
Widget data（Bot list for picker）
返回小部件机器人选择器下拉菜单的机器人元数据（ID、名称、环境ID）。
路由注释
该工具仅由 manage_copilot_studio_registration 小部件的机器人选择器调用。 不要直接调用它。
相关工具
| 工具 | 关系 |
|---|---|
manage_copilot_studio_registration |
启动器工具，可以打开注册小部件 |
save_copilot_studio_registration |
将选中的机器人保存为注册对象 |
test_copilot_studio_registration_connection |
选择后测试机器人可达性 |
数据变异分类
只读。 列出Power Platform可用的Copilot Studio机器人，无需修改任何数据。