建立活跃的环境

注释

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

在处理案件、账户或其他数据之前，请利用此功能检查您当前连接的 Dynamics 365 环境。

它的作用是什么

助理会检查你当前的会话，告诉你哪个Dynamics 365环境处于激活状态。 每次对话开始时都会自动完成。 如果没有连接环境，助理会提示你选择一个。

试试像这样的提示

  • 我连接到哪个环境？
  • 我用的是什么组织？
  • 我和Dynamics有连接吗？
  • 给我看看我现在的环境。

你在聊天中会看到的内容

助理会回复一条短信，显示你连接环境的名称和详细信息。 如果你没有连接到任何环境，助理会告诉你，并提供展示环境选择器。

有用的提示

  • 当你开始新对话时，这个检查会自动进行。 通常不需要特别问。
  • 如果助理说没有选择环境，就说“显示我的环境”以查看拣选器。
  • 回答中显示的环境名称有助于你确认自己所在的组织是对的（例如，生产部门与测试部门）。

接下来会发生什么

  • 展示我的环境（如果你需要切换的话）。
  • 列出我的情况（以便开始在互联环境中工作）。
  • 如果你想换组织，就要断开这个环境。

这会改变数据吗？

不，这不会改变数据。

先决条件

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

工具摘要

资产 价值
面向用户的名称 建立活跃的环境
内部工具名称 get_environment
Purpose 返回当前选择的 Dynamics 365 环境

工具行为

返回当前选择的 Dynamics 365 环境。 该工具在每次会话开始时被调用，先于其他工具，以确定用户连接的组织。 如果未选择环境，响应提示用户应从中选择一个环境 list_environments。

Annotations

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

输入概念

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

响应与用户界面行为

响应类型

仅文本

没有渲染任何交互组件。 响应返回所选组织的 friendlyName、 id和连接详情，作为结构化 JSON。 如果没有选择任何组织，则 selectedOrg 为零。

路由注释

作为会话初始化器使用 get_environment 。 它应该在每次对话开始时自动调用，而不是其他工具。

  • 如果 selectedOrg 回复中为空，请继续 list_environments 显示组织选择器小部件。
  • 当用户明确要求切换环境或查看所有环境时 ，请勿 使用 get_environment 。 改用 list_environments。
工具 关系
list_environments 显示组织选择器控件及所有可用环境
select_environment 保存会话中所选环境
disconnect_environment 清除活跃环境并显示组织选择器

数据变异分类

只读。

  • 上次更新时间为