创建备注

注释

该工具默认可在以下 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 必需
entityIdentityTypeincidentaccount entityId (必须将笔记附加到GUID的记录), entityType (实体逻辑名称如 incidentaccount)。 是的

备注内容

输入 Description 必需
notetextsubject 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 副驾驶® 在运行前会提示用户确认。