注意
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时,不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反,设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展,Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想停止使用当前的 Dynamics 365 环境或切换到其他组织时,可以使用此功能断开连接。
它的作用是什么
助手会断开你当前连接的Dynamics 365环境的会话连接。 断开连接后,它会自动显示环境选择器,这样你可以重新连接到其他组织。 当你需要在生产环境和测试环境之间切换,或者想确保不再连接时,这非常有用。
试试像这样的提示
- 与这个环境断开联系。
- 登出Dynamics。
- 我想换个组织。
- 切断我的环境连接。
- 重置我的连接。
你在聊天中会看到的内容
助手会确认断线,然后显示环境选择器,让你重新连接到另一个环境。
有用的提示
- 如果你只是想切换环境,可以直接说“切换环境”。 那个直接显示拣选器,没有单独断开步骤。
- 断开连接后,其他工具(比如列表案件)在重新连接环境后将无法使用。
- 这不会让你登出Microsoft 365或Teams。 它只会清除 Dynamics 365 组织连接以配合这个聊天会话。
接下来会发生什么
断开连接后,你会看到环境选择器。 接下来:
- 选择一个环境重新连接。
- 显示我的环境(如果拣选器关闭了)。
这会改变数据吗?
不,这不会改变Dynamics 365的数据。
它只清除你的会话连接。 Dynamics 365 中的记录不会被修改。
你可以通过聊天应用组件做些什么
断开连接后,环境选择器会出现。 你可以从中获得:
- 浏览所有可用的环境。
- 选择一个不同的环境来连接。
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 断开环境 |
| 内部工具名称 | disconnect_environment |
| Purpose | 断开当前选择的 Dynamics 365 环境 |
工具行为
断开当前选择的 Dynamics 365 环境连接。 清除当前的连接和会话缓存,使用户能够连接到不同的组织。 断开连接后,组织选择器小部件会自动显示,方便用户重新连接或选择其他环境。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
这个工具会清除会话状态,但不会修改 Dynamics 365 的数据。 |
destructiveHint |
未设置 | 不适用(Dynamics 365 数据未被更改)。 |
idempotentHint |
未设置 | 不适用(只读工具)。 |
openWorldHint |
未设置 | 使用默认值。 |
输入概念
该工具不接受任何输入参数。
响应与用户界面行为
该 MCP 工具由 MCP 应用支持。
响应类型
交互式小部件(组织选择器)
清除连接后,组织选择器控件会被渲染出来,用户可以重新连接或选择其他环境。
路由注释
当用户明确要求断开连接、登出或重置环境连接时使用 disconnect_environment 。
- 如果用户说“切换组织”或“更换环境”,直接选择
list_environments(它会显示拣选器,但不会先断开连接)。 - 如果用户说“断开连接”或“登出”,请使用这个工具。
相关工具
| 工具 | 关系 |
|---|---|
get_environment |
返回当前活跃环境 |
list_environments |
显示组织选择器小部件,但不先断开连接 |
select_environment |
重新连接后保存所选环境 |
数据变异分类
写入(会话状态)。
清除会话的活跃环境和 Redis 缓存。 不会改变 Dynamics 365 的数据。