适用于：Dynamics 365 Sales
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你需要将Dataverse记录分配给其他所有者或将其路由到队列时，可以使用此功能。 该工具支持通用记录，如账户、联系人、机会、潜在客户、案件和自定义表格。
它的作用是什么
助手通过Dataverse assign操作更新用户或团队目标的记录所有权。 对于队列目标，当表支持队列路由时，它会将记录路由到队列。
在进行更改之前，助手会在Dataverse元数据可用时检查表的元数据。 如果该表是组织拥有的（其记录没有所有者），或者你请求从未启用队列的表路由记录，助手会返回清晰的解释，而不是尝试 Dataverse 会拒绝的操作。 如果元数据无法读取，Dataverse仍然是真实信息源，操作会进入平台检查阶段。
如果目标名称不明确，助理会返回匹配的候选人，这样你可以在记录更改前选择正确的用户、团队或队列。
试试像这样的提示
- 把这个机会分配给我。
- 将这条线索引导到企业销售队列。
- 把这个账户分配给乔丹·雷耶斯。
- 把这个自定义记录转到续订团队。
你在聊天中会看到的内容
助手会显示文本回复确认分配结果，或者当显示名称匹配多个用户、团队或队列时，要求你从候选目标中选择。 该助手没有显示该功能的互动应用聊天组件。
有用的提示
- 当他们有额外的业务需求时，使用专门针对记录的工具。 例如，对于需要交接说明的支持案件。
reassign_case - 尽量使用精确的目标名称、电子邮件地址或GUID，以避免歧义匹配。
- 仅在分配给当前用户时使用
targetId值me，且targetType为user。
接下来会发生什么
- 打开唱片。
- 显示最近的活动。
- 加个关于交接的说明。
这会改变数据吗？
是的，这可能会改变数据。
先决条件
该工具需要读取和分配所请求Dataverse记录的权限，以及分配目标的权限。 队列路由要求表支持队列，目标队列必须可访问。
工具摘要
| 财产 | 价值 |
|---|---|
| 面向用户的名称 | 分配实体 |
| 内部工具名称 | assign_entity |
| Purpose | 将Dataverse记录分配给用户或团队，或将其路由到队列。 |
工具行为
该工具会为用户和团队目标更改记录的所有者。 对于队列目标，当Dataverse支持该表的队列路由时，会将该记录添加到指定的队列中。 它不会创建切换笔记，也不会执行特定领域的工作流程步骤。
在分配或路由记录之前，工具会读取Dataverse的表 OwnershipType 和 IsValidForQueue 元数据。 当分配无法成功时，它会返回清晰的预检信息——例如，当表为组织拥有且无可更改的所有者，或表未启用队列时。 如果无法读取该元数据，工具将继续执行，并让Dataverse执行该规则。
附注
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具会修改数据。 |
destructiveHint |
false |
这个工具不会进行破坏性改变。 |
idempotentHint |
false |
重复调用并不保证等价——队列路由每次都会添加一个队列项目。 |
openWorldHint |
未设置 | 使用默认行为。 |
输入概念
记录与目标
| Input | 说明 | 必需 |
|---|---|---|
entityLogicalName |
Dataverse 为记录分配的逻辑名称，例如 account、 opportunity、 lead或 incident。 |
是 |
recordId |
Dataverse GUID 用于记录分配。 | 是 |
targetType |
分配目标类型： user、 team、 或 queue。 |
是 |
targetId |
目标用户、团队或队列 GUID; me 当前用户;支持电子邮件地址;或显示名称。 |
是 |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。
路由注释
用户想要时使用 assign_entity ：
- 将一个通用的Dataverse记录分配给用户或团队。
- 将支持的记录路由到队列。
- 更改没有更具体分配工具的记录类型的所有权。
用户想用时不要使用 assign_entity ：
- 在传输支持案件时添加切换备注;使用
reassign_case。 - 更新一个常规字段值;使用
update_entity_record。 - 创建任务或时间线活动;使用
create_activity。
相关工具
| 工具 | 关系 |
|---|---|
reassign_case |
用于需要交接备注的支持案件转移。 |
update_entity_record |
用于非所有者或队列分配的字段更新。 |
get_entity_record |
用于在分配前后检查记录。 |
数据变异分类
写作/变异。
当工具成功分配所有权或将记录路由到队列时，会更改Dataverse数据。 重复同一所有者（用户或团队）对同一目标是幂等，但重复队列路径可能会添加另一个队列项目，因此该工具整体上不会被标记为幂等。