设置工具可见性

注释

该工具默认可在以下 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 探索相关配置选项

数据变异分类

写。

创建或更新所选范围的工具可见性覆盖。