适用于：Dynamics 365 Customer Service
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你有一封之前开始的草稿邮件，想从中断处继续时，可以使用这个功能。 助理会以“写”形式打开已有的草稿，这样你可以继续编辑，然后保存或发送。
它的作用是什么
助理会找到你最近草拟的邮件（或你引用的某个草稿），并以“写作”表格打开。 主旨、正文、收件人和案例上下文从保存的草稿加载。 你所做的任何编辑都会更新相同的草稿记录——不会创建重复的草稿。
试试像这样的提示
- 打开我的草稿邮件。
- 编辑本案草稿。
- 继续我的邮件草稿。
- 打开最新的草稿。
- 编辑我为CAS-01010-A0A0A0案件的草稿。
- 继续写我的草稿。
你在聊天中会看到的内容
助手将邮件写作表单作为聊天应用组件显示，预先填写了草稿已有的主题、正文和收件人。 你可以从上次停下的地方继续编辑。
有用的提示
- 如果你有多份草稿，请通过提及案例或主题来指定是哪一个。
- 只展示你自己的草稿——你不能修改其他经纪人的草稿。
- 只有未寄出的汇票才能通过这种方式打开。 如果邮件已经发送，改用“查看邮件”。
- 保存会更新同一个草稿记录——不会创建重复的记录。
Tip
如果你想开始一封全新的邮件，而不是编辑已有草稿，可以说“草拟一封新邮件”。
接下来会发生什么
草稿打开后，你可以继续写以下提示：
- 现在就发。
- 保存草稿。
- 加一段关于决心的段落。
- 换个话题。
这会改变数据吗？
这一步会打开已有的草稿，但本身不会改变数据。
从compose表单保存或发送邮件会更新Dynamics 365中的草稿记录。
你可以通过聊天应用组件做些什么
通过聊天中的写作表单，你可以：
- 请编辑邮件主题和正文。
- 添加或移除收件人。
- 保存更新后的草稿。
- 直接发送邮件。
- 在Dynamics 365中打开完整的邮件表单。
先决条件
该工具需要以下条件：
- Copilot 电子邮件功能
在客户服务中的“管理 Copilot 功能”中了解更多信息。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 编辑草稿邮件 |
| 内部工具名称 | edit_email_draft |
| Purpose | 在 compose 表单中打开已有的草稿邮件，方便用户继续编辑 |
工具行为
在写作表单中打开已有的草稿邮件，方便用户继续编辑。 从Dataverse加载主题、正文、收件人及相关记录，并预先填写表格。 保存和发送操作更新的是同一草稿记录——不会创建重复草稿。 拒绝非草稿邮件（statecode ！= 0）。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
智能 Microsoft 365 Copilot 副驾驶®跳过了确认提示。 该控件负责管理持久性。 |
destructiveHint |
未设置 | 不适用（打开现有草稿供编辑）。 |
idempotentHint |
未设置 | 不适用（每次调用都会开启一个编排会话）。 |
openWorldHint |
未设置 | 使用默认值（查询Dataverse）。 |
输入概念
具体选秀
| 输入 | Description | 必需 |
|---|---|---|
activityId |
activityId （邮件活动GUID，选秀打开）。 当用户引用特定草稿时使用，比如在时间线中选择草稿行的编辑按钮。 执行业主平等审查。 |
否 |
最新记录草案
| 输入 | Description | 必需 |
|---|---|---|
entityId、entityType、incident |
entityId （父记录 GUID，通常为案例）， entityType （实体逻辑名称，默认为 incident）。 返回该记录中当前用户最近修改的草稿。 |
否 |
互斥性
| 输入 | Description | 必需 |
|---|---|---|
activityId、entityId |
activityId 和 entityId 是互斥的——同时传递两者都会被处理方拒绝。 必须精确设置一个。 |
否 |
响应与用户界面行为
该工具呈现一个交互式电子邮件写作表单。
该 MCP 工具由 MCP 应用支持。
响应类型
交互组件（聊天应用）
Compose 表格加载草稿中已有的内容——主题、正文、收件人及相关上下文——以便继续编辑。
路由注释
用于 edit_email_draft ：
- 打开我的草稿，继续我的草稿，编辑草稿。
- 在时间线中的草稿行选择铅笔编辑按钮。
- 打开X案的最新草稿。
不要在以下情况下使用 edit_email_draft ：
- 用户想写一封新邮件——使用
draft_email。 - 用户想查看收到或发送的邮件（而非草稿）——使用
view_email。 - 用户想立即发送电子邮件——使用
send_email。
相关工具
| 工具 | 关系 |
|---|---|
draft_email |
创建新的邮件草稿（新的写作会话） |
send_email |
立即发送邮件，无需进行文稿审核 |
view_email |
显示已接收或发送的只读邮件 |
get_activity_timeline |
显示草稿出现的活动时间线 |
数据变异分类
只读入口，带有下游突变潜力。
该工具标记 readOnlyHint: true为 。 compose 小部件管理保存和发送操作——用户选择保存或发送时，更新会应用到Dataverse中的同一草稿记录。