列出环境

注释

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

利用此功能查看你能访问的所有 Dynamics 365 环境，并在它们之间切换。

它的作用是什么

助手会显示一个交互式环境选择器，显示租户中所有可用的 Dynamics 365 组织。 你可以选择在任何环境中连接它。 这在你有多个组织（比如生产环境和测试环境）需要在它们之间切换时非常有用。

试试像这样的提示

  • 展示我的环境。
  • 换环境。
  • 列出我的组织。
  • 我想连接一个不同的环境。
  • 我能访问哪些环境？
  • 改变组织。

你在聊天中会看到的内容

助手以聊天应用组件的形式显示交互式环境选择器。 选择器会显示所有可用环境及其名称和网址。

有用的提示

  • 如果你有多个环境（生产环境、沙盒环境、测试环境），可以用它在它们之间切换。
  • 选择环境后，所有后续操作（查看案件、账户等）都会使用该组织的数据。
  • 切换前不需要断开连接。 只要说“切换环境”，然后选一个新的。

Tip

如果你不确定用哪个环境，可以找一个与你团队制作组织相符的友好名称。

接下来会发生什么

选择环境后，你可以继续使用以下提示：

  • 拿出我的箱子。
  • 列出我的账户。
  • 我现在的环境是什么？ （以确认交换）。

这会改变数据吗？

不，列出环境不会改变数据。

选择环境会更新会话连接，但不会修改任何 Dynamics 365 数据。

你可以通过聊天应用组件做些什么

通过聊天中的环境选择器，你可以：

  • 浏览你租户中所有可用的环境。
  • 选择一个环境连接到它。
  • 请参阅环境名称和网址以识别正确的组织。

先决条件

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

工具摘要

资产 价值
面向用户的名称 列出环境
内部工具名称 list_environments
Purpose 列出用户在其租户中可访问的所有 Dynamics 365 环境，并渲染组织选择器控件

工具行为

列出用户在其租户中可访问的所有 Dynamics 365 环境，并渲染组织选择器控件。 当用户明确请求切换组织、查看所有可用环境，或 get_environment 返回无活跃组织时，使用该工具。

Annotations

注释 价值 Meaning
readOnlyHint true 这个工具不会修改数据。
destructiveHint 未设置 不适用（只读工具）。
idempotentHint 未设置 不适用（只读工具）。
openWorldHint 未设置 使用默认值（查询租户发现）。

输入概念

该工具不接受任何输入参数。

响应与用户界面行为

该 MCP 工具由 MCP 应用支持。

响应类型

交互式小部件（组织选择器）

组织选择器小部件显示所有可用环境及其友好名称和网址。 用户选择一个环境来选择它，该环境会 select_environment 从小部件中触发。

路由注释

在以下情况下使用 list_environments：

  • 用户明确要求切换环境或查看所有可用组织。
  • get_environment 退货 selectedOrg: null 后，用户需要选择一个。
  • 用户会说“切换组织”、“更换环境”或“显示我的环境”。

不要在以下情况下使用 list_environments ：

  • 你只需要检查当前处于活跃环境的状态。 改用 get_environment。
  • 用户想断开连接但不重新连接。 改用 disconnect_environment。
工具 关系
get_environment 返回当前活跃环境，但不显示拣选器
select_environment 拯救了选择的环境。 由组织选择器控件调用
disconnect_environment 清除活跃环境并显示组织选择器

数据变异分类

只读。

  • 上次更新时间为