注释
该工具默认可在以下 MCP 服务器上使用:Dynamics 365 Customer Service。
本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
当你构建代理、集成或编排逻辑时,不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反,设计解决方案时能在运行时发现并使用可用工具。
随着平台的发展,Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想在组织或配置文件层面隐藏或展示MCP工具时,可以使用这个功能。
它的作用是什么
该工具可以节省工具可见性覆盖。 你可以在组织层面隐藏工具,隐藏配置文件的额外工具,或者恢复在配置文件范围下隐藏在组织层面的工具。
试试像这样的提示
- 为所有人隐藏邮件列表。
- 展示该资料的电子邮件工具。
- 关闭管理员配置文件的工具可见性。
- 为所有特工隐藏一个工具。
- 让这个工具在配置文件中再次可见。
你在聊天中会看到的内容
助理会确认更新的瞄准镜,以及哪些工具被隐藏或展示。
有用的提示
- 用于
level: organization全组织的可视化变更。 - 当更改只适用于一个配置文件时使用
level: profile。 - 包含
profileId当level时 。profile - 制造工具无法隐藏。
接下来会发生什么
- 列表工具可见性以验证变更。
- 重置工具可见性。
- 退出配置模式。
这会改变数据吗?
是的,这会改变配置数据。
它会更新所选范围的可见性覆盖。
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 设置工具可见性 |
| 内部工具名称 | save_tool_selection |
| Purpose | 在组织或配置文件层面保存工具可见性覆盖 |
工具行为
在组织或配置文件层面避免工具的可见性覆盖。 支持在组织范围隐藏工具,在配置文件范围隐藏额外工具,并在配置文件范围允许时恢复该组织范围隐藏的工具。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具会修改数据。 |
destructiveHint |
false |
更新可见性覆盖,但不删除范围。 |
idempotentHint |
true |
保存同一个可见性状态二次得到的结果是一样的。 |
openWorldHint |
false |
不会调用配置好的 Dynamics 365 范围之外的外部系统。 |
输入概念
级别
| 输入 | Description | 必需 |
|---|---|---|
level、organization、profile |
level (organization 或 profile,必修)。 选择覆盖可见性范围。 |
是的 |
配置文件 ID
| 输入 | Description | 必需 |
|---|---|---|
profileId |
profileId (UUID字符串,可选)。 当 level 是 profile 时为必需项。 |
多种多样 |
修补程序
| 输入 | Description | 必需 |
|---|---|---|
patches |
patches (数组,必填)。
tool-selection一系列补丁。 |
是的 |
工具名称
| 输入 | Description | 必需 |
|---|---|---|
toolName |
toolName (字符串,每个音色都需要)。 精确的MCP工具名称以便隐藏或显示。 |
是的 |
Action
| 输入 | Description | 必需 |
|---|---|---|
action、hide、show |
action (hide 或 show,每个补丁都要求)。 隐藏工具或恢复它。 |
是的 |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。 返回确认,包含更新的范围、保存的工具名称和可见性变更摘要。
路由注释
在以下情况下使用 save_tool_selection:
- 用户希望隐藏或显示一个或多个工具。
- 用户希望在组织范围或配置文件范围内更改可见性。
- 用户已经清楚了目标工具和操作。
不要在以下情况下使用 save_tool_selection :
- 用户只想检查可见性。 使用
list_tool_selection。 - 用户想移除所有覆盖。 使用
delete_tool_selection。
相关工具
| 工具 | 关系 |
|---|---|
list_tool_selection |
列表变更前后可见状态 |
delete_tool_selection |
移除已保存的可见性覆盖 |
browse_agent_config_options |
探索相关配置选项 |
数据变异分类
写。
创建或更新所选范围的工具可见性覆盖。