删除注册

注释

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

此功能可从注册管理小部件中移除外部 MCP 服务器注册或 Copilot Studio MCS 代理注册。 它不是直接从聊天中调用的。

它的作用是什么

注册管理小部件通过注册ID和显式类型调用此功能：mcp适用于外部MCP服务器或mcsCopilot Studio代理。 移除后，注册及其相关工具将不再可用。

试试像这样的提示

不適用。 打开相应的注册管理小部件，并使用其删除操作。

你在聊天中会看到的内容

管理小部件在删除注册前会先确认，然后显示操作是否成功。

有用的提示

  • 首先查看 manage_mcp_registration 有效注册及其身份证。
  • 用于manage_copilot_studio_registration管理Copilot Studio代理注册。
  • 移除是永久性的。 注册在删除后无法恢复。
  • 移除注册会阻止相关工具使用。
  • 你需要相应的管理员角色来移除注册。

接下来会发生什么

移除后，管理小部件会刷新其注册列表。 你可以在同一个小部件中添加替换注册。

这会改变数据吗？

是的，这会移除注册数据。 注册记录将永久删除。

先决条件

该工具需要以下条件：

  • 系统管理员或 Copilot 服务管理员角色

工具摘要

财产 价值
面向用户的名称 删除注册
内部工具名称 delete_registration
Purpose 移除外部MCP服务器或Copilot Studio MCS代理的ID注册

工具行为

通过ID移除注册。 调用小部件必须通过type，才能指定注册是外部MCP服务器（mcp）还是Copilot Studio MCS代理（mcs）。 确认由小部件处理，然后才调用该工具。

Annotations

注释 价值 Meaning
readOnlyHint false 该工具会修改数据。
destructiveHint true 该工具会永久移除注册数据。
idempotentHint true 重复删除不会带来额外的数据变化，但当注册已被移除时，工具会返回“未找到”错误。
openWorldHint 未设置 使用默认值。

输入概念

注册 ID

注册的唯一标识符，需要移除。

类型

无论注册是外部MCP服务器（mcp）还是Copilot Studio MCS代理（mcs）。 此值是必需的。

响应与用户界面行为

响应类型

控件动作响应

成功后，工具将已删除的注册ID和类型返回到调用注册管理小部件。 然后小部件会刷新其注册列表。 如果未找到注册或操作失败，响应会包含错误，小部件保持现有列表状态。

路由注释

该工具在管理员确认删除后，由注册管理小部件调用。 不要直接从聊天中调用 delete_registration 。

  • 用于 type: "mcp" 外部 MCP 服务器注册。
  • 用于type: "mcs"Copilot Studio代理注册。
  • 使用对应管理小部件返回的注册ID。
工具 关系
manage_mcp_registration 打开或列出外部MCP服务器注册，并调用删除，使用 type: "mcp"
manage_copilot_studio_registration 打开或列出 Copilot Studio 代理人注册，并调用删除type: "mcs"
save_mcp_registration 创建或更新外部MCP服务器注册
save_copilot_studio_registration 创建或更新Copilot Studio代理注册

数据变异分类

写操作（破坏性，幂零）。

该工具会永久移除所选的注册。 重复成功删除不会带来额外的数据变化;当注册不存在时，工具会报告错误。

  • 上次更新时间为