适用于：Dynamics 365 Customer Service 和 Dynamics 365 Sales
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想修正拼写错误、添加信息或修改案件或其他记录上的现有笔记时，可以使用此功能。
它的作用是什么
助手通过标识符找到已有的笔记，并用你的新内容更新文本。 更新后的说明取代了唱片时间线上的前一版本。 这对于纠正错误或补充你之前写的笔记细节非常有用。
试试像这样的提示
- 纠正我笔记里的错别字。
- 更新备注，说明客户确认了解决办法。
- 改变这个案子的说明。
- 修改我最后的笔记。
- 更新备忘录文本，加入新的电话号码。
你在聊天中会看到的内容
助手会以聊天应用组件的形式显示活动时间线，刷新后显示更新后的笔记内容。
有用的提示
- 助理需要知道该更新哪个笔记。 如果有多个注释，请按内容或标题来说明。
- 你可以说“更新笔记”然后提供新文本，或者把所有内容都包含在一个提示里。
- 只有你拥有的笔记才能更新。
- 如果你想添加一个全新的笔记，而不是编辑已有的，请说“添加一个笔记”。
Tip
先查看时间线查看已有笔记，然后告诉助理更新哪一条。
接下来会发生什么
笔记更新后，你可以继续使用以下提示：
- 展示时间线。
- 再加一注。
- 给客户写一封邮件。
- 这个案子还需要做些什么？
这会改变数据吗？
是的，这会更新已有的笔记。
备注文本会被你提供的新内容替换。 助理在更改前会先确认。
你可以通过聊天应用组件做些什么
从聊天时间线中，你可以：
- 请查看更新后的说明。
- 浏览完整的活动时间线。
- 选择任意活动以查看其详细信息。
- 在Dynamics 365中打开完整的记录表。
先决条件
该工具适用于本页顶部“申请”栏中列出的产品。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 更新说明 |
| 内部工具名称 | update_note |
| Purpose | 通过 Dynamics 365 中已有的笔记（注释）的文本 GUID 更新 |
工具行为
通过 Dynamics 365 中已有的笔记（注释）的文本 GUID 更新。 当用户想修正拼写错误、修改或修改已有笔记时使用。 这些信息 annotationId 可以从 get_activity_timeline 回答中获得。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具会修改数据——智能 Microsoft 365 Copilot 副驾驶® 会提示确认。 |
destructiveHint |
false |
更新笔记会替换内容，但不会破坏性。 |
idempotentHint |
true |
使用相同输入调用结果相同——可以安全重试。 |
openWorldHint |
未设置 | 使用默认值（查询Dataverse）。 |
输入概念
音符标识符
| 输入 | Description | 必需 |
|---|---|---|
annotationId |
annotationId （注释 GUID 以更新，必备）。 从 get_activity_timeline得到。 |
是的 |
更新的内容
| 输入 | Description | 必需 |
|---|---|---|
notetext、subject |
notetext （更新的注释正文，必修）， subject （可选更新标题）。 |
多种多样 |
响应与用户界面行为
该工具会渲染活动时间线以确认笔记是否已更新。
该 MCP 工具由 MCP 应用支持。
响应类型
交互组件（聊天应用）
时间线小部件刷新以显示更新后的笔记内容。
路由注释
用于 update_note ：
- 修正音符，更新音符，修改音符。
- 对现有注释文本或标题的任何编辑。
不要在以下情况下使用 update_note ：
- 用户想创建新笔记——使用
create_note。 - 用户想更新时间线活动（任务、电话等）——使用
create_activity。activityId
相关工具
| 工具 | 关系 |
|---|---|
create_note |
在唱片上创建一个新笔记 |
get_activity_timeline |
检索时间线，包括注释（来源：annotationId） |
create_activity |
创建时间线活动（非注释） |
数据变异分类
写作/变异。
该工具更新Dataverse中的现有注释记录。 智能 Microsoft 365 Copilot 副驾驶® 在运行前会提示用户确认。 该操作是幂等的——用相同输入重试结果。