注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
利用此功能自定义服务代理如何显示组织或应用配置文件的信息。
它的作用是什么
助手保存一个布局配置，可以更改网格、表单、时间线或选项列表的显示方式。
scope 默认为 org;使用 scope: "profile" with profileId 以针对特定应用配置文件。 例如，你可以向案件列表添加列，重新排列表单部分，或配置时间线上显示的活动类型。
组织配置适用于整个组织。 配置文件配置适用于使用所选应用配置文件的代理。
试试像这样的提示
- 在案件网格中始终显示优先级列。
- 将客户列添加到所有代理的案件列表中。
- 为所有人设置案件网格。
- 配置默认的案件表单布局。
- 隐藏所有代理的SLA部分。
- 将默认时间线筛选器改为只显示电子邮件。
你在聊天中会看到的内容
助手会确认保存的布局配置，包括实体、配置类型以及应用的更改摘要。
有用的提示
- 首先使用
browse_agent_config_options以了解可用的配置选项。 - 组织级配置适用于所有用户，除非被配置文件层级或个人偏好覆盖。
- 你需要服务代理生成器自定义权限来保存配置。
- 在更改前，用来
list_agent_configs查看当前激活的配置。
接下来会发生什么
保存配置后，你可以：
- 显示所有代理配置以查看哪些是激活的。
- 移除整个组织范围内的案例回退自定义功能。
- 为L1代理设置不同的布局，创建配置文件特定的配置。
这会改变数据吗？
是的，这会改变配置数据。 组织层级配置影响组织内所有用户;配置文件层级配置影响使用所选应用配置文件的代理。 它不会修改案件、账户或联系记录。
先决条件
该工具需要以下条件：
- 系统管理员或 Copilot 服务管理员角色。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 配置代理布局 |
| 内部工具名称 | save_agent_config |
| Purpose | 创建或更新组织级或配置文件级代理配置 |
工具行为
默认创建或更新组织级配置，或在 scope: "profile" 提供和 profileId 时创建配置文件级配置。 将自然语言布局请求转换为结构化补丁，应用于网格、表单、时间线、选择列表或查找。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具会修改数据。 |
destructiveHint |
false |
创建或更新配置，无需删除现有数据。 |
idempotentHint |
true |
保存同一个配置两次，结果是一样的。 |
openWorldHint |
未设置 | 使用默认值。 |
输入概念
配置范围
| 输入 | Description | 必需 |
|---|---|---|
scope |
配置层级： org （默认）或 profile。 |
否 |
profileId |
应用配置文件 UUID。 当 scope 是 profile 时为必需项。 |
对于剖面范围 |
目标实体
| 输入 | Description | 必需 |
|---|---|---|
entityLogicalName |
entityLogicalName （字符串，必填）。 要配置的实体（例如， incident， account， contact）。 |
是的 |
覆盖类型
| 输入 | Description | 必需 |
|---|---|---|
overrideType |
overrideType （字符串，必填）。 配置范围前缀：， resolutiongrid， ， formform-sectionform-select， form-type， ， timeline， lookup， 。 picklist |
是的 |
目标 ID
| 输入 | Description | 必需 |
|---|---|---|
targetId、* |
targetId （字符串，默认为 *）。 特定的视图或表单GUID，或 * 用于实体范围的应用。 |
否 |
修补程序
| 输入 | Description | 必需 |
|---|---|---|
patches |
patches （数组，必填）。 由 区分 type的有序补丁对象数组。 有效类型包括 column （网格列）、 section （表单部分）、 field （表单字段）、 source （基础视图/表单替换）、 picklist （选项集可视化）、 timeline （时间线配置）。 |
是的 |
显示名称
| 输入 | Description | 必需 |
|---|---|---|
name |
name （字符串，可选）。 这种配置是人类易读的名称。 |
否 |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。 返回确认，包含范围键、补丁数量和有效配置摘要。 回复还包括 propagationDelayMinutes ——所选层级用户变更生效的预计时间。
路由注释
在以下情况下使用 save_agent_config：
- 组织管理员明确要求为所有用户定制布局
- 制作者通过传递
scope: "profile"和来定制特定的应用配置文件profileId - 请求内容涉及全组织范围的网格列、表单字段、时间线设置或选项列表的可见性
- 用户已经通过其他方式探索过各种选项
browse_agent_config_options，准备存档
不要在以下情况下使用 save_agent_config ：
- 用户想保存个人偏好。 改用
save_user_prefs。 - 用户仍在探索各种选项。 先用
browse_agent_config_options。
相关工具
| 工具 | 关系 |
|---|---|
list_agent_configs |
列出现有的组织级或配置文件级配置 |
delete_agent_config |
移除组织层级或配置文件层级的配置 |
browse_agent_config_options |
保存前探索配置选项的互动指南 |
save_user_prefs |
节省个人布局偏好 |
get_agent_config_capabilities |
检查可用的配置类型 |
数据变异分类
写。
根据 ，创建或更新组织级或配置文件级代理配置记录 scope。