适用于：Dynamics 365 Sales
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当卖家想从现有机会开始新交易，而不是从零开始录入所有内容时，可以使用此功能。
它的作用是什么
助理将现有的 Dynamics 365 Sales 机会克隆到新机会中，复制其字段、产品线项和利益相关者。 新机会从 开放 状态开始，由当前用户拥有。 价格表、折扣、实际收入和成交数据不会被带入，因此卖方可以重新设定价格和目标。 你只需提供源机会的GUID，并且可选地为该文案命名。
试试像这样的提示
- 克隆这个机会
- 复印一份Contoso续约协议
- 复制这个机会，称之为“2027财年续期”
- 复制这笔交易，这样我可以重新设计成第二个业务单元
你在聊天中会看到的内容
助理会显示一条文本回复，确认该机会已被克隆，并附上新机会的名称。 该功能没有交互式聊天应用组件。
有用的提示
- 克隆最好是在新协议与现有协议非常相似时——产品线和利益相关者会自动出现。
- 请
name自行提供标题;否则标题为“{source name}的副本”。 - 在工作前先设定价格表，刷新克隆的估算值，因为价格和实际数据不会被带入。
接下来会发生什么
- 总结一下新的机会
- 在克隆机上添加或更新产品
- 推进新机遇的舞台
这会改变数据吗？
是的，这创造了新纪录。
先决条件
该工具需要权限才能读取源机会并在所选的 Dynamics 365 环境中创建机会。 复制源的产品线和利益相关者受你Dynamics 365对这些记录的权限限制。
工具摘要
| 财产 | 价值 |
|---|---|
| 面向用户的名称 | 克隆机遇 |
| 内部工具名称 | clone_opportunity |
| Purpose | 将一个机会，包括其产品和利益相关者，复制成一个新的开放机会。 |
工具行为
该工具创建新机会，并通过平台的复制机会操作复制源机会字段、产品线项和利益相关者。 克隆被设置为开放状态，归当前用户所有;业务流程阶段、实际收入、实际成交日期、价格表和折扣都被有意不复制。 它不会修改源机会，也不会生成报价、订单或后续活动。
附注
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
这个工具会生成数据。 |
destructiveHint |
false |
克隆会创建新记录;来源不会被更改或删除。 |
idempotentHint |
false |
每次通话都会创造一个新的机会，因此不是一个可重复的 no-op。 |
openWorldHint |
未设置 | 使用默认行为。 |
输入概念
来源与名称
| Input | 说明 | 必需 |
|---|---|---|
opportunityId |
Dataverse GUID 是源机会的克隆机会。 | 是 |
name |
新机会的可选名称。 默认为“{source opportunity name}的复制品”。 | 否 |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。
路由注释
当用户希望将现有机会——包括其产品和利益相关者——复制成新交易时使用 clone_opportunity 。 不要用 clone_opportunity 来从零开始创建全新机会（用 create_entity_record）、 用来总结交易（用 get_opportunity_summary），或者用来重新开启已结案的交易（用 reopen_opportunity）。
相关工具
| 工具 | 关系 |
|---|---|
create_entity_record |
从零开始创造全新的机会。 |
get_opportunity_summary |
克隆前先审查源协议。 |
close_opportunity |
无论赢了还是输了，都关闭了机会。 |
数据变异分类
写作/变异。
该工具在创建新机会并将产品线和利益相关者复制到该机遇上时，会更改Dataverse的数据。 它会在每次通话中创建一个新记录，因此不会被标记为幂等，且源机会保持不变。