注释
该工具默认可在以下 MCP 服务器上使用：Dynamics 365 Customer Service。
本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
利用此功能移除组织层面的布局配置，并恢复到默认显示。
它的作用是什么
助手通过其范围键移除全组织的布局配置。 移除后，受影响的网格、表单或时间线会恢复为组织内所有用户的系统默认状态。 此操作需明确确认后才能继续。
试试像这样的提示
- 移除整个组织范围内对案件的定制。
- 在箱子网格上重置特工配置。
- 删除组织层级的案件表格布局。
- 将案例网格恢复为默认值。
- 移除所有账户的组织自定义功能。
你在聊天中会看到的内容
助理在移除配置前会先确认。 确认后，它会报告被移除的配置，布局已恢复为系统默认。
有用的提示
- 使用
list_agent_configs“first”查看当前配置及其作用域键。 - 移除是永久性的。 该配置在删除后无法恢复。
- 移除组织层级配置时，配置文件级别和个人偏好不会影响。
- 你需要服务代理生成器自定义权限来移除组织层的配置。
接下来会发生什么
移除配置后，你可以：
- 显示所有代理配置以验证移除情况。
- 设置一个新的案例网格布局，创建一个新的配置。
- 我可以配置什么？探索可用的选项。
这会改变数据吗？
是的，这会移除配置数据。 组织范围的布局配置被永久删除。 案件、账户和联系记录不受影响。
先决条件
该工具需要以下条件：
- 系统管理员或 Copilot 服务管理员角色。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 移除代理配置 |
| 内部工具名称 | delete_agent_config |
| Purpose | 移除组织层级的代理按范围键配置 |
工具行为
通过范围键移除组织级代理配置。 当组织管理员请求移除或重置之前应用的全组织自定义时，请使用。 需要明确确认以防止意外删除。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具会修改数据。 |
destructiveHint |
true |
该工具会永久移除配置数据。 |
idempotentHint |
true |
删除已移除的瞄准镜不会有额外影响。 |
openWorldHint |
未设置 | 使用默认值。 |
输入概念
范围说明
| 输入 | Description | 必需 |
|---|---|---|
scope |
scope （字符串，必填）。 用于移除的示范键（例如， grid:incident:*， form:account:*， timeline:incident:*）。 用 list_agent_configs 来查找现有的范围键。 |
是的 |
确认
| 输入 | Description | 必需 |
|---|---|---|
confirm、true |
confirm （字面意思 true，必修）。 必须明确设置为 以 true 确认删除。 防止意外取出。 |
是的 |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。 返回配置已被移除的确认，或如果找不到示波器键则返回错误。
路由注释
在以下情况下使用 delete_agent_config：
- 用户明确请求移除或重置组织层的配置。
- 用户提供一个作用域键或描述一个配置以删除。
- 如果用户没有指定作用域密钥，务必先调用
list_agent_configs以显示可用的作用域密钥。
不要在以下情况下使用 delete_agent_config ：
- 用户希望移除配置文件级别的配置。 改用
delete_profile_config。 - 用户想删除个人偏好。 改用
delete_user_prefs。 - 用户想要修改（而非删除）已有配置。 改用
save_agent_config。
相关工具
| 工具 | 关系 |
|---|---|
list_agent_configs |
列出现有配置以识别可删除的范围键 |
save_agent_config |
创建或更新组织层级配置 |
delete_profile_config |
去除配置文件级配置 |
delete_user_prefs |
移除个人布局偏好 |
数据变异分类
写作（破坏性）。
永久移除组织级代理配置。 这影响了组织中的所有用户。 助理在执行前会先确认。