测试MCS代理连接

Note

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

当你通过注册管理小部件测试与Copilot Studio代理的连接时，这项功能在幕后工作。

它的作用是什么

当你在Copilot Studio代理注册表单中选择“测试连接”时，该工具会验证服务代理能够联系到所选机器人。 它执行三阶段检查：从Dataverse获取机器人身份和元数据、解析Power Platform环境，以及通过代理SDK验证可达性。

如果连接成功，工具会返回机器人身份、模式名称、已解析环境ID、只读描述预览、取用时间戳和可达性结果。 这些数据会填写在注册表中。 如果连接失败，工具会返回分阶段错误，指示哪一步失败（例如，找不到机器人、机器人非活跃、环境未解决或SDK不可达）。

试试像这样的提示

不適用。 当你通过管理小部件测试连接时，这个工具会自动调用。 输入提示词不会调用它。

你在聊天中会看到的内容

注册小部件内联显示测试结果。 成功后，你会看到机器人身份预填，并预览Dataverse描述的只读预览。 注册描述仍是一个独立的制作者作者字段。 失败时，你会看到一个特定的错误信息，说明连接测试的哪个阶段失败了。

有用的提示

  • 保存前一定要测试。 成功测试的机器人元数据会填充注册表单中的必填字段。
  • 如果测试在“找不到机器人”阶段失败，请确认机器人ID是否正确，且机器人是否已发布到Copilot Studio。
  • 如果测试在“机器人非激活”阶段失败，请重新发布该机器人到Copilot Studio以激活它。
  • 如果测试失败且出现同意或权限错误，请检查你的用户账户是否具备所需的Power Platform权限。
  • 测试有超时限制。 如果代理SDK响应缓慢，即使机器人技术上可达，测试也可能失败。

接下来会发生什么

测试成功后，你可以：

  • 保存这张登记。
  • 检查机器人元数据。
  • 为这位经纪人写一份描述。

这会改变数据吗？

不，这不会改变数据。

连接测试是只读的。 它获取元数据并验证可达性，但不修改任何配置。

先决条件

该工具需要以下条件：

  • Copilot Copilot Studio的可扩展性。

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

工具摘要

财产 价值
面向用户的名称 测试MCS代理连接
内部工具名称 test_copilot_studio_registration_connection
Purpose 获取 Copilot Studio 机器人的身份和只读描述预览，解析其环境，并通过 Agents SDK 验证可达性

工具行为

获取 Copilot Studio 机器人的身份和 Dataverse 的只读描述预览，解析 Power Platform 环境，并通过 Agents SDK 验证可达性。 预览不会作为注册描述持久化;制作者单独创建了该字段。 这是一个从注册管理小部件自动调用的小部件支持工具。

Annotations

注释 价值 Meaning
readOnlyHint true 这个工具不会修改数据。
destructiveHint 未设置 不适用（只读工具）。
idempotentHint 未设置 不适用（只读工具）。
openWorldHint 未设置 使用默认值（查询Dataverse + Power Platform）。

输入概念

机器人 ID

输入 说明 必需
botId botId （UUID，必修）。 Copilot Studio 机器人的数据宇宙bot.botid测试。 Yes

环境 ID

输入 说明 必需
environmentId environmentId （UUID，可选）。 Power Platform 环境 GUID。 提供时，跳过环境解析器的API调用。 No

组织 URL

输入 说明 必需
orgUrl orgUrl（可选）。 覆盖当前选择的环境URL。 No

响应与用户界面行为

该 MCP 工具由 MCP 应用支持。

响应类型

连接测试结果的小部件更新

返回机器人身份、模式名称、环境ID、只读描述预览和 fetchedAt可达状态。 小部件显示成功或机密错误。

路由注释

该工具仅由 manage_copilot_studio_registration 小部件调用。 不要直接调用它。

工具 关系
manage_copilot_studio_registration 启动器工具，可以打开注册小部件
save_copilot_studio_registration 保存了由制作者编写的描述和输入配置的注册
list_copilot_studio_registration_bots 列出可供机器人选择器使用的机器人
delete_registration 当 type 是时，移除代理人注册 "mcs"

数据变异分类

只读。 测试连接性并获取元数据，无需修改任何数据。

  • 上次更新时间为