注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
该功能将你的会话连接到特定的 Dynamics 365 环境，使你后续的所有操作都会使用该组织的数据。
它的作用是什么
当你在环境选择器中选择环境时，助手会将你的会话连接到该组织。 所有后续操作（查看案件、账户、联系人等）都会自动使用所选环境的数据。 通常你不需要直接调用这个;当你在Picker中选择环境时，就会发生这种情况。
试试像这样的提示
通常你不需要打提示来做这件事。 当你在选择器中选择环境时，会自动触发。 如果你需要更换环境：
- 切换环境（显示拣货器）。
- 显示我的环境（显示选择器）。
你在聊天中会看到的内容
助手会确认你连接的是哪个环境，并显示环境名称。 确认后，你可以开始在该组织中处理数据。
有用的提示
- 你不需要手动输入环境ID。 改用环境选择器吧。
- 连接后，助理会在回复中包含环境名称，这样你总能知道自己在哪个组织工作。
- 如果你不小心连错了环境，只需说“切换环境”即可重新选择。
接下来会发生什么
连接环境后：
- 拿出我的箱子。
- 列出我的账户。
- 我的收件箱里有什么？
- 我连接到哪个环境？ （以确认）。
这会改变数据吗？
不，这不会改变Dynamics 365的数据。
它只会更新你的会话连接。 Dynamics 365 中的记录不会被修改。
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 选择环境 |
| 内部工具名称 | select_environment |
| Purpose | 为当前会话选择一个 Dynamics 365 环境 |
工具行为
为当前会话选择一个 Dynamics 365 环境。 所有后续的工具调用（案例、知识、账户等）都会自动路由到该环境。 当用户选择环境时，通常由组织选择器小部件调用，而不是模型直接调用。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具会修改会话状态。 |
destructiveHint |
false |
选择环境不会销毁数据。 |
idempotentHint |
true |
重复选择相同环境不会有额外影响。 |
openWorldHint |
未设置 | 使用默认值。 |
输入概念
环境 ID
| 输入 | Description | 必需 |
|---|---|---|
environmentId |
environmentId （字符串，必填）。 选择环境的组织GUID。 这是 id 或 get_environment返回的list_environments场。 |
是的 |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。 组织选择器小部件在调用该工具后会乐观地更新自身状态。 响应确认所选环境名称和ID。
路由注释
select_environment 是一个后端操作工具。 它几乎总是由组织选择器控件调用，而非直接模型路由。
-
不要将用户提示如“切换组织”路由到
select_environment。 用list_environments来展示拣选者。 - 只有在你之前回复确认环境GUID时才直接打电话
select_environment。
相关工具
| 工具 | 关系 |
|---|---|
get_environment |
返回当前活跃环境 |
list_environments |
显示组织选择器控件，供用户选择 |
disconnect_environment |
清理活跃环境 |
数据变异分类
写入（会话状态）。
修改会话的主动环境。 不会改变 Dynamics 365 的数据。