注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时,不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反,设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展,Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想探索代理中可配置的内容,并了解网格、表单、时间线、选择列表、解析策略、工具可视化、外部MCP工具服务器、Copilot Studio代理、跨命名空间工具授权,以及——当服务词汇管理启用且词汇工具对代理开放时——服务词汇(术语表术语和同义词)的可定制选项时,可以使用此功能。
它的作用是什么
该助手提供了交互式的文本式代理配置指南。 它呈现了一个可导航的配置类别树——你可以浏览顶级类别,深入特定领域(如案例网格布局或时间线设置),并通过关键词搜索特定选项。
本指南涵盖了组织范围内的设置(适用于所有用户)和应用配置文件范围的设置(适用于特定用户组)。 除了布局类别外,它还展示了代理的可扩展性和工具选项——工具可视化、外部(第三方)MCP 工具服务器注册、Copilot Studio 代理注册以及跨命名空间工具授权——因此,所有 Maker 可配置的区域都能从一个地方被发现。 当启用服务词汇管理且词汇工具成为代理工具集的一部分时——通常是客户服务代理,或通过跨命名空间授权获得服务工具集的任何代理——服务词汇表(术语表术语和同义词)也会出现;当该工具无法提供或该能力被关闭时,该词汇会被省略,因此指南只列出当前代理实际可配置的内容。 在任何层级,你都可以要求前后对抗示例,看看配置变更在实际中是什么样子。
试试像这样的提示
- 我可以配置什么?
- 帮我安排经纪人。
- 开始配置。
- 我该如何自定义箱子网格?
- 给我看看时间线配置选项。
- 有哪些表态设置可用?
- 搜索选择列表的配置选项。
- 浏览事件实体的座席配置。
- 给我展示工具可见性。
- 管理外部MCP注册。
- 管理Copilot Studio代理注册。
- 我还能添加哪些其他代理工具集?
- 管理服务术语。 (当服务词汇工具是代理工具集的一部分时,可以使用。)
你在聊天中会看到的内容
助手会回复一条短信,显示当前配置树的层级。 每条记录都包含类别名称和简要介绍。 你可以通过询问特定类别或用关键词搜索所有选项来更深入地搜索。
有用的提示
- 从没有具体路径开始,查看所有配置类别的根菜单。
- 说“搜索[关键词]”即可在所有类别中查找配置选项,无需手动导航。
- 在任何层级都请求“展示示例”,查看配置变更的前后预览。
- 指定一个实体(如“事件”或“账户”),以筛选与该实体类型相关的配置选项。
- 在“组织”范围(全组织范围)和“配置文件”范围(应用配置文件)之间选择,以针对正确的配置层。
Tip
本指南帮助你发现哪些可配置。 要应用更改,请跟进指南推荐的具体配置操作。
接下来会发生什么
浏览完配置选项后,你可以继续使用以下提示:
- 给我看看网格配置选项。
- 深入时间线设置。
- 寻找解决方案。
- 请举例说明该选项。
- 保存这个配置。
这会改变数据吗?
不,浏览配置选项不会改变数据。
这是一份只读指南。 配置更改只有在你执行特定保存动作时才会应用。
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 开始使用代理配置 |
| 内部工具名称 | browse_agent_config_options |
| Purpose | 通过交互式、多回合可导航的树,引导制作者通过代理配置选项 |
工具行为
通过交互式、多回合可导航的树,引导制作者了解代理配置选项。 涵盖网格、表单、时间线、选择列表、查找和解析策略,以及代理的可扩展表面——工具可视化、外部MCP工具服务器、Copilot Studio代理以及跨命名空间工具授权。 当服务词汇管理被启用且词汇工具可供代理使用时——通常是客户服务代理,或任何通过跨命名空间授权获得服务工具集的代理——它也会涵盖服务词汇表(术语表术语和同义词);当该工具无法提供或功能被关闭时,该条目将被省略。 返回用户可以深入的分层菜单,每个层级都有前后对比示例。 配置发现的主要入口。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用(只读工具)。 |
idempotentHint |
未设置 | 不适用(只读工具)。 |
openWorldHint |
未设置 | 使用默认值。 |
输入概念
导航路径
| 输入 | Description | 必需 |
|---|---|---|
path |
path (字符串,可选)。 点分隔路径,用于跳转到配置树的任一层级(例如,grid.incident, form, mcp-registrationtool-selectioncopilot-studiotimeline.incidentcross-namespace-grant当代理可以使用服务词汇工具时—)。service-vocabulary
service-vocabulary路径只有在当前代理具备该能力时才会解析;否则返回“未知类别”结果。 省略或空过根菜单。 |
否 |
示例切换
| 输入 | Description | 必需 |
|---|---|---|
showExamples |
showExamples (布尔值,可选)。 当为真时,返回当前树级的前后对比示例。 |
否 |
实体过滤器
| 输入 | Description | 必需 |
|---|---|---|
entity |
entity (字符串,可选)。 将树筛选到特定的实体逻辑名称(例如, incident, account)。 |
否 |
配置层
| 输入 | Description | 必需 |
|---|---|---|
scope |
scope (枚举: org | profile,可选)。 针对特定层。 第一次调用时省略,让工具提示选择。 |
否 |
配置文件 ID
| 输入 | Description | 必需 |
|---|---|---|
profileId |
profileId (UUID字符串,可选)。 当范围为 profile时,必须 。 如果遗漏了,工具中列出了可用的配置文件GUID。 |
多种多样 |
搜寻
| 输入 | Description | 必需 |
|---|---|---|
search |
search (字符串,可选)。 跨类别路径、实体名称、覆盖类型标签和能力表面的自由文本搜索。 返回一个匹配节点的扁平列表,而不是树状导航。 |
否 |
包含图层
| 输入 | Description | 必需 |
|---|---|---|
includeLayers |
includeLayers (布尔值,可选)。 当为真时,搜索还会考虑教育 layers.* 子树。 默认值为 false。 |
否 |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。 返回描述当前树级的结构化文本,包含可用的子路径、描述和导航指令。 多回合:用户通过在后续调用中提供路径来深入挖掘。
路由注释
在以下情况下使用 browse_agent_config_options:
- 用户会问“我可以配置什么?”,“帮我设置”,“开始使用”。
- 用户希望在承诺存档前探索各种选项。
- 用户问“我如何自定义X?”但没有具体说明补丁。
- 用户希望看到配置的示例。
不要在以下情况下使用 browse_agent_config_options :
- 用户已经知道自己想保存什么,并提供具体细节。 直接用相应的范围路由到
save_agent_config。 - 用户要求列出现有配置。 配合合适的范围使用
list_agent_configs。 - 用户询问个人偏好。 使用
list_user_prefs。
相关工具
| 工具 | 关系 |
|---|---|
save_agent_config |
在发现后保存组织级或配置文件级配置 |
get_agent_config_capabilities |
配置前快速权限检查 |
list_agent_configs |
列出组织层面或配置文件层面已配置的内容 |
数据变异分类
只读入口,带有下游突变潜力。
浏览本身不会改变数据。 引导工作流程触发的后续 save_agent_config 操作可以创建或更新配置。