适用于：Dynamics 365 Sales
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当卖家需要添加联系人作为利益相关者或更改利益相关者在机会或账户中的角色时，可以使用此功能。
它的作用是什么
助理会在Dynamics 365商机或账户上添加联系人作为利益相关者，或更新现有利益相关者的连接角色，并返回带有结构化内容的文本回复，供代理编排使用。
试试像这样的提示
- 再加上乔丹·雷耶斯作为这次机会的决策者。
- 将此联系人记录为技术买家。
- 让Sarah成为这笔交易的利益相关者。
- 改变这个利益相关者的角色，成为支持者。
你在聊天中会看到的内容
助手会直接在聊天中显示文本回复。 该助手没有显示该功能的互动应用聊天组件。
有用的提示
- 在调用该工具之前，先将联系人名称解析为其联系人ID。
- 在添加或更新利益相关者之前，用来
get_stakeholder审查当前利益相关者。 - 在更改机会或账户关系之前，务必确认并写好操作。
接下来会发生什么
回复出现后，你可以继续使用如下提示：
- 向利益相关者展示这一机会。
- 安排与该利益相关者开会。
- 起草一封介绍邮件。
- 打开这个机会。
这会改变数据吗？
是的，数据会变update_stakeholder。
该工具创建或更新主机记录与联系人之间的连接。 运行前确认联系人和职位。
先决条件
该工具需要创建和写入 Dynamics 365 连接的访问权限，并附加对所选环境的主机商机或账户及联系人的访问权限。
工具摘要
| 财产 | 价值 |
|---|---|
| 面向用户的名称 | 更新利益相关方 |
| 内部工具名称 | update_stakeholder |
| Purpose | 添加或更新关于商机或账户的利益相关者连接。 |
工具行为
该工具创建 connection 将主机机会或账户与联系人关联，或在联系人已成为利益相关者时更新连接角色。 当角色名被提供时，会被解析为; connectionrole未解决的角色会被报告，而连接不会失败。 它仅为文本，返回所需的销售操作的结构化内容。
附注
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
未设置 | 该工具会修改数据。 |
destructiveHint |
false |
添加或更新关系;不删除记录。 |
idempotentHint |
false |
用新角色重新运行会更新现有连接。 |
openWorldHint |
未设置 | 使用默认值（写入Dataverse）。 |
输入概念
销售背景
| Input | 说明 | 必需 |
|---|---|---|
recordId |
解决利益相关者所属机会或账户的GUID。 | 是 |
contactId |
已解决联系人添加或更新利益相关者的GUID。 | 是 |
entityLogicalName |
主机记录类型： opportunity （默认）或 account。 |
否 |
role |
利益相关者称为连接角色，如决策者或利益相关者。 | 否 |
响应与用户界面行为
该工具返回的回复仅为文本，没有应用聊天成分。
该 MCP 工具由 MCP 应用支持。
响应类型
文本叙述
回复内容包括针对销售操作的结构化内容。
路由注释
当用户想将联系人添加到交易的利益相关者中或更改利益相关者的角色时，可以使用 update_stakeholder 。 不要用 update_stakeholder 来更改记录所有权（使用 assign_entity）或编辑标量字段（使用 update_entity_record）。
相关工具
| 工具 | 关系 |
|---|---|
get_stakeholder |
记录中列出当前利益相关者 |
schedule_meeting |
安排与利益相关者开会 |
get_entity_record |
打开完整的Dataverse记录表单 |
数据变异分类
写入——创建或更新利益相关者连接。