开始使用代理配置

注释

  • 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
  • 当你构建代理、集成或编排逻辑时,不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反,设计解决方案时能在运行时发现并使用可用工具。
  • 随着平台的发展,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 操作可以创建或更新配置。