保存MCS代理注册

注释

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

当你通过注册管理小部件添加或编辑Copilot Studio代理注册时，这项功能在幕后工作。

它的作用是什么

当你在 Copilot Studio 代理管理小部件中填写注册表并选择保存时，这个工具会将注册永久保存到你的 Dynamics 365 环境。 它既负责创建新注册，也负责更新现有注册。

该工具验证机器人身份和模式名称，强制执行注册上限（每个环境10个），并防止重复机器人ID或模式名称。 成功后，它会存储注册信息并刷新服务代理的工具列表，从而使新的代理委派可用。

试试像这样的提示

不適用。 当你从管理小部件保存注册时，这个工具会自动调用。 输入提示词不会调用它。

你在聊天中会看到的内容

注册小部件会更新以确认存档成功，显示注册ID以及是否创建或更新。 如果验证失败（例如，机器人ID或模式名称重复），小部件会显示错误信息，说明需要修复的问题。

有用的提示

  • 你必须先运行测试连接，才能保存新注册。 测试中的机器人元数据用于填充必需字段。
  • 每个机器人只能注册一次。 如果需要重新注册同一个机器人，先移除现有注册。
  • 你提供的描述是服务代理在决定是否将问题委托给该代理时看到的。 要明确具体。
  • 模式名称必须在你环境中所有 Copilot Studio 注册中保持唯一。

接下来会发生什么

保存后，注册小部件会返回列表视图。 您可以：

  • 再测试一次连接。
  • 编辑我刚保存的注册信息。
  • 再加一个Copilot Studio代理。

这会改变数据吗？

是的，这会改变数据。

保存注册可以在你的 Dynamics 365 环境中创建或更新配置文件记录，并刷新服务代理可用的工具列表。

先决条件

该工具需要以下条件：

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

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

工具摘要

资产 价值
面向用户的名称 保存MCS代理注册
内部工具名称 save_copilot_studio_registration
Purpose 新的或更新的 Copilot Studio（MCS）代理注册会持续存在

工具行为

保持新的或更新的 Copilot Studio（MCS）代理注册。 这是一个小部件支持工具，用户在与可扩展性注册小部件交互时会自动调用。 它不适合模型直接调用。

Annotations

注释 价值 Meaning
readOnlyHint false 该工具创建或更新注册数据。
destructiveHint false 更新是非破坏性的（upsert 模式）。
idempotentHint true 同一输入的重复调用会产生相同的结果。
openWorldHint 未设置 使用默认值。

输入概念

注册对象

输入 Description 必需
botId、name、displayName、description、inputParameters、environmentId、schemaName、m365AppId 包含代理注册详情，包括botId（Dataverse机器人GUID）、 name （唯一标识符）、displayName、、 descriptioninputParametersenvironmentId（Power Platform 环境）、schemaName和。m365AppId 否

注册 ID

输入 Description 必需
id id（可选）。 提供后，更新现有注册;省略时，会生成新的。 否

组织 URL

输入 Description 必需
orgUrl orgUrl（可选）。 覆盖当前选择的环境URL。 否

响应与用户界面行为

该 MCP 工具由 MCP 应用支持。

响应类型

小部件更新

小部件刷新显示已保存的注册信息。

路由注释

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

工具 关系
manage_copilot_studio_registration 启动器工具，可以打开注册小部件
delete_registration 当 type 是时，移除代理人注册 "mcs"
test_copilot_studio_registration_connection 保存前测试代理可达性
list_copilot_studio_registration_bots 列出可供机器人选择器使用的机器人

数据变异分类

写（upsert）。 在组织范围的注册存储中创建或更新 Copilot Studio 代理注册。

  • 上次更新时间为