创建笔记

适用于:Dynamics 365 Customer Service 和 Dynamics 365 Sales

注释

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

当你想为案件、账户或其他记录添加备注时,可以使用此功能。 注释是出现在记录时间线上的自由文本条目。

它的作用是什么

助理会创建一个备注(注释),并将其附加到你指定的记录上。 该备注显示在记录的活动时间线上,与电子邮件、电话和任务并列。 笔记对于记录内部观察、客户互动或后续提醒非常有用。

试试像这样的提示

  • 给这个案子加个说明。
  • 记录客户回电的记录。
  • 留个便条说我们需要跟进。
  • 补充说明:通过电话联系了客户,问题出在单点登录。
  • 在这个账户上记录一条笔记。
  • 注:客户确认这个变通方法有效。

你在聊天中会看到的内容

助手会将活动时间线作为聊天应用组件显示,刷新后将新创建的笔记与记录中其他活动进行对应。

有用的提示

  • 只需自然输入笔记内容——助手会用你的文字创建笔记。
  • 你可以写标题,比如“添加标题为'需要跟进'的备注并附上文本......”。
  • 笔记和任务是不同的。 如果你需要一个可追踪的行动项并有截止日期,可以说“创建任务”。
  • 注释附带到当前记录上下文中。 如果你需要在另一条记录中添加备注,请指定是哪一个。

Tip

创建笔记后,你可以通过说“更新笔记”或“修正笔记中的错别字”来更新。

接下来会发生什么

笔记创建后,你可以继续使用如下提示:

  • 再加一注。
  • 创建一个后续任务。
  • 展示时间线。
  • 给客户写一封邮件。

这会改变数据吗?

是的,这会生成一个音符。

在 Dynamics 365 中创建一个新的注释并附加到记录上。 助理在创建便条前会先确认。

你可以通过聊天应用组件做些什么

从聊天时间线中,你可以:

  • 请将新笔记与其他活动一同查看。
  • 浏览完整的活动时间线。
  • 选择任意活动以查看其详细信息。
  • 在Dynamics 365中打开完整的记录表。

先决条件

该工具适用于本页顶部“申请”栏中列出的产品。 这种方式无需任何其他配置。

工具摘要

资产 价值
面向用户的名称 创建备注
内部工具名称 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 副驾驶® 在运行前会提示用户确认。