近乎良机

适用于：Dynamics 365 Sales

注释

• 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
• 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
• 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。

当卖方交易结束并希望将机会锁定为已赢或失败时，可以使用此功能。

它的作用是什么

助理会根据赢得或输掉的 WinOpportunity 或 LoseOpportunity 消息关闭 Dynamics 365 Sales 商机。 它记录了结果，并可选择实际收入、成交日期、结局说明以及获胜或失败的竞争对手。 你提供机会的GUID和结果。

试试像这样的提示

• 关闭此机会，赢得24万美元。
• 把这笔交易标记为失败——我们输给了竞争对手。
• 用今天的日期结束这个机会。
• 把这笔交易算作丢失，卖出去。

你在聊天中会看到的内容

助理会显示文本回复，确认该机会已关闭，判定为赢或输。 该助手没有显示该功能的互动应用聊天组件。

有用的提示

• 在成交前与卖方确认结果——这是一个生命周期的变更。
• 为赢得的交易提供供应 actualRevenue ，确保管道报告准确。
• 提供 competitorId 竞争对手赢得或输掉交易的时间，且 statusCode 仅因特定身份原因（例如 Out-Sold）。

接下来会发生什么

• 总结一下这个机会。
• 起草一封感谢邮件或跟进邮件。
• 重新开启这个机会。

这会改变数据吗？

是的，这可能会改变数据。

先决条件

该工具需要在所选 Dynamics 365 环境中获得写入机会和创建机会关闭活动的权限。

工具摘要

财产	价值
面向用户的名称	近乎良机
内部工具名称	close_opportunity
Purpose	将机会视为赢家或输家。

工具行为

该工具调用WinOpportunity（获胜）或LoseOpportunity（失败），创建机会关闭活动，包含提供的收入、成交日期、竞争对手和备注，并相应设置机会的状态和状态。 它不会生成报价、订单或后续活动。

附注

注释	价值	Meaning
readOnlyHint	false	该工具会修改数据。
destructiveHint	false	关闭是一种状态转换;记录不会被删除。
idempotentHint	false	关闭已经关闭的机会并不是一种可重复的 no-op。
openWorldHint	未设置	使用默认行为。

输入概念

机遇与结果

Input	说明	必需
opportunityId	Dataverse GUID 开放机会以关闭。	是
status	接近结果： won 或 lost。	是
actualRevenue	可选择在结算时登记的实际收入（非负数）。 通常是在赢得交易时提供的。	否
closeDate	可选的交割日期作为ISO 8601字符串。 默认为当前时间。	否
competitorId	可选的胜负竞争者GUID可记录在关闭上。	否
description	关闭活动描述中可选择性地记录关闭说明。 主体根据结果自动设定。	否
statusCode	可选状态理由覆盖（例如，3 = 获胜，4 = 取消，5 = Out-Sold）。 按结果违约：获胜即为获胜;失去者在选手被指定时作为 Out-Sold 结束，否则取消。	否

响应与用户界面行为

响应类型

仅文本

没有渲染任何交互组件。

路由注释

当用户想确定交易是否已赢时使用 close_opportunity 。 不要用 close_opportunity 来重新开启已成交的交易（使用 reopen_opportunity）、移动销售阶段（使用 update_bpf_stage）、或更新普通字段（使用 update_entity_record）。

相关工具

工具	关系
reopen_opportunity	重新打开了一个封闭的机会。
get_opportunity_summary	在成交前审查交易。
link_competitor_to_opportunity	记录竞争对手在一个开放的机会上。

数据变异分类

写作/变异。

工具在关闭机会并创建关闭活动时会更改Dataverse数据。 闭合是一个单向生命周期的过渡（用 reopen_opportunity 来反转），所以它不标记为幂等性。