列表工具的可视化

注释

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

当你想查看组织或个人资料层面哪些工具是可见、隐藏或恢复的时,可以使用此功能。

它的作用是什么

该工具列出所选示波器的当前工具可见性设置。 它返回工具目录、已解析的隐藏集以及为组织或配置文件存储的原始可见性补丁。

试试像这样的提示

  • 哪些工具是隐藏的?
  • 为该组织展示工具可见性。
  • 列表工具的可视化功能。
  • 哪些工具被禁用了?
  • 给我看看当前的工具选择。

你在聊天中会看到的内容

助手返回可见性状态的文本摘要,包括范围、工具名称以及当前隐藏或恢复状态。

有用的提示

  • 用于 level: organization 审查全组织的可见性。
  • 用于 level: profile 检查特定配置文件,并包含 profileId。
  • 该工具为只读。 用 save_tool_selection 来做修改。

接下来会发生什么

  • 隐藏该个人资料的邮件工具。
  • 恢复隐藏工具。
  • 将工具可见性重置为默认状态。

这会改变数据吗?

不,这不会改变数据。

它只读取当前的可见性配置。

先决条件

该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。

工具摘要

资产 价值
面向用户的名称 列表工具的可视化
内部工具名称 list_tool_selection
Purpose 列出所选组织或配置文件范围的当前工具可视化设置

工具行为

列出所选组织或配置文件范围的当前工具可见性设置。 返回完整的工具目录、已解析的隐藏集以及当前保存的原始可见性补丁。

Annotations

注释 价值 Meaning
readOnlyHint true 这个工具不会修改数据。
destructiveHint 未设置 不適用。
idempotentHint 未设置 不適用。
openWorldHint 未设置 使用默认值。

输入概念

级别

输入 Description 必需
level、organization、profile level (organization 或 profile,必修)。 选择检查全组织或配置文件级可见性。 是的

配置文件 ID

输入 Description 必需
profileId profileId (UUID字符串,可选)。 当 level 是 profile 时为必需项。 多种多样

响应与用户界面行为

响应类型

仅文本

没有渲染任何交互组件。 返回描述当前可见性状态的结构化文本,包括范围、工具名称以及隐藏或恢复状态。

路由注释

在以下情况下使用 list_tool_selection:

  • 你需要确认哪些工具是隐藏的或可见的。
  • 你要在更换前检查能见度。
  • 你需要对刀具选择设置进行只读审核。

不要在以下情况下使用 list_tool_selection :

  • 你已经知道自己想要做的具体改变。 改用 save_tool_selection。
工具 关系
save_tool_selection 节省可见性覆盖
delete_tool_selection 清除可见性覆盖
browse_agent_config_options 发现相关配置选项

数据变异分类

只读。

该工具只读取当前的可见性配置。