注意
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
使用此功能查看组织层面或应用配置文件层面的布局自定义活动。
它的作用是什么
助手会列出请求层级的代理配置。
scope默认为org;与特定应用配置文件使用scope: "profile"。profileId 每个配置都显示其作用域键、名称、补丁数量和最后修改时间。
试试像这样的提示
- 列出我们的代理配置。
- 有哪些组织层面的自定义功能正在进行？
- 给我看看所有的组织布局。
- 列出案件配置。
- 有哪些网格自定义？
- 显示代理配置。
你在聊天中会看到的内容
助手会回复请求层级的活跃配置文本列表。 每个条目显示作用域键（例如）、 grid:incident:*人类可读的名称、应用的补丁数量以及最后修改日期。
有用的提示
- 组织范围内的配置默认列出。 指定一个应用配置文件以列出其配置。
- 作用域键遵循模式
type:entity:target（例如，grid:incident:*表示“所有视图的网格配置”）。 - 如果你想按实体筛选，可以在提示中指定：“列出案件配置文件”或“显示账户配置”。
- 访问或修改这些配置需要服务代理生成器自定义权限。
接下来会发生什么
看到名单后：
- 请给我查看关于[配置名称]的详细信息。
- 移除案件的网格配置（仅管理员）。
- 我个人的偏好是什么？ （与组织配置分开）。
- 帮我设置一个新的配置。
这会改变数据吗？
不，列出配置不会改变数据。
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 登录用户必须拥有服务代理生成器自定义权限。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 列表代理配置 |
| 内部工具名称 | list_agent_configs |
| Purpose | 列出组织级或配置文件级代理配置 |
工具行为
默认列出组织级配置，或在 scope: "profile" 提供和 profileId 时列出配置文件级配置。 显示范围键、名称、补丁数量和最后修改日期。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用（只读工具）。 |
idempotentHint |
未设置 | 不适用（只读工具）。 |
openWorldHint |
未设置 | 使用默认值。 |
输入概念
配置范围
| 输入 | Description | 必需 |
|---|---|---|
scope |
配置层级： org （默认）或 profile。 |
否 |
profileId |
应用配置文件 UUID。 当 scope 是 profile 时为必需项。 |
对于剖面范围 |
实体过滤器
| 输入 | Description | 必需 |
|---|---|---|
entityLogicalName |
entityLogicalName （字符串，可选）。 在提供时，只返回该实体的配置（例如， incident， account）。 省略列出所有实体的所有配置。 |
否 |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。 返回结构化的配置列表及其作用域键（例如）、 grid:incident:*人类可读名称、音色数量和最后修改时间戳。
路由注释
在以下情况下使用 list_agent_configs：
- 用户会问“有哪些组织配置”或“列出我们的自定义”。
- 你需要在删除操作前显示作用域键。
- 用户希望审计现有的组织层面布局。
对于配置文件级配置，调用 list_agent_configs 和 scope: "profile"profileId目标 。
不要在以下情况下使用 list_agent_configs ：
- 用户询问个人偏好。 改用
list_user_prefs。 - 用户想要探索可能性。 改用
browse_agent_config_options。
相关工具
| 工具 | 关系 |
|---|---|
save_agent_config |
创建或更新组织级或配置文件级配置 |
delete_agent_config |
通过范围键移除组织级或配置文件级配置 |
list_user_prefs |
列出当前用户的个人偏好 |
browse_agent_config_options |
可用配置选项的交互指南 |
数据变异分类
只读。