注释
该工具默认可在以下 MCP 服务器上使用:Dynamics 365 Customer Service。
本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
当你构建代理、集成或编排逻辑时,不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反,设计解决方案时能在运行时发现并使用可用工具。
随着平台的发展,Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想为案件、账户或其他记录添加备注时,可以使用此功能。 注释是出现在记录时间线上的自由文本条目。
它的作用是什么
助理会创建一个备注(注释),并将其附加到你指定的记录上。 该备注显示在记录的活动时间线上,与电子邮件、电话和任务并列。 笔记对于记录内部观察、客户互动或后续提醒非常有用。
试试像这样的提示
- “给这个案子加个笔记”
- “记录客户回电的记录”
- “留个便条说我们需要跟进。”
- “添加备注:通过电话联系客户,问题出在单点登录(SSO)”
- “在这个账户上记录一条笔记”
- “注:客户确认变通方法有效”
你在聊天中看到的内容
助手会将活动时间线作为聊天应用组件显示,刷新后将新创建的笔记与记录中其他活动进行对应。
有用的提示
- 只需自然地输入笔记内容——助理会用你的文字创建笔记。
- 你可以写标题,比如“添加标题为'需要跟进'的备注并附上文本......”。
- 笔记和任务是不同的。 如果你需要一个可追踪的行动项并有截止日期,可以说“创建任务”。
- 注释附带到当前记录上下文中。 如果你需要在另一条记录中添加备注,请指定是哪一个。
Tip
创建笔记后,你可以通过说“更新笔记”或“修正笔记中的错别字”来更新。
接下来会发生什么
笔记创建后,你可以继续使用如下提示:
- “再加一注”
- “创建后续任务”
- “显示时间线”
- “给客户起草一封邮件”
这会改变数据吗?
是的。 这会生成一个音符。
在 Dynamics 365 中创建一个新的注释并附加到记录上。 助理在创建便条前会先确认。
你可以通过聊天应用组件做些什么
从聊天时间线中,你可以:
- 请查看您的新记录及其他活动
- 浏览完整的活动时间线
- 选择任意活动查看详情
- 在Dynamics 365中打开完整记录表单
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 创建备注 |
| 内部工具名称 | create_note |
| Purpose | 在 Dynamics 365 记录上创建注释(注释) |
工具行为
在 Dynamics 365 记录上创建备注(注释)。 注释是附加在记录时间线上的自由文本条目。 当用户请求添加备注、记录备注,或将文本保存为备注时,请使用该功能。 对于任务、邮件、电话或约会,请使用 create_activity ——这些是时间线活动,不是注释。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具生成数据——智能 Microsoft 365 Copilot 副驾驶® 会提示确认。 |
destructiveHint |
false |
创建笔记是加法的,而非破坏性的。 |
idempotentHint |
false |
每次通话都会生成一个新的音符——重试是安全的。 |
openWorldHint |
未设置 | 使用默认值(查询Dataverse)。 |
输入概念
记录上下文
| 输入 | Description | 必需 |
|---|---|---|
entityId、entityType、incident、account |
entityId (必须将笔记附加到GUID的记录), entityType (实体逻辑名称如 incident 或 account)。 |
是的 |
备注内容
| 输入 | Description | 必需 |
|---|---|---|
notetext、subject |
notetext (必填正文), subject (可选简短标题)。 |
多种多样 |
响应与用户界面行为
该工具会渲染活动时间线以确认笔记已被创建。
该 MCP 工具由 MCP 应用支持。
响应类型
交互组件(聊天应用)
时间线小部件刷新,显示活动信息流中新创建的笔记。
路由注释
用于 create_note :
- “添加笔记”、“记录笔记”、“保存笔记”
- 附加在记录上的自由形式文本注释
不要在以下情况下使用 create_note :
- 用户想创建任务、电话、约会或电子邮件——使用
create_activity - 用户想更新已有的笔记——使用
update_note - 用户想查看时间线——使用
get_activity_timeline
相关工具
| 工具 | 关系 |
|---|---|
update_note |
更新已有笔记的文本 |
create_activity |
创建时间线活动(任务、电话、约会、邮件) |
get_activity_timeline |
获取记录的完整活动时间线 |
数据变异分类
写作/变异。
该工具在Dataverse中创建一个新的注释记录。 智能 Microsoft 365 Copilot 副驾驶® 在运行前会提示用户确认。