适用于：Dynamics 365 Customer Service 和 Dynamics 365 Sales
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当您需要记录电话、创建任务或预约案件或其他记录时，可以使用此功能。
它的作用是什么
助理会在你指定的记录上创建一个时间线活动。 支持的活动类型包括：
- 任务——to-do 有主题、截止日期和优先级的项目。
- 电话——有记录的通话，并注明方向（来电/打出）、时长和备注。
- 预约——安排会议，约定开始时间、结束时间和地点。
- 电子邮件——快速邮件（如需完整撰写和审核，请使用“draft a email”）。
活动会与笔记、电子邮件及其他活动一同出现在记录的时间线上。
试试像这样的提示
- 针对此案创建一个后续任务。
- 与客户通话。
- 请预约下周二的预约。
- 添加一个任务，要求在周五前给客户回电。
- 记录一个来电——15分钟，讨论账单问题。
- 创建一个任务来审查升级情况。
- 安排明天下午2点与客户的会议。
- 记录一个关于退款请求的外出电话。
你在聊天中会看到的内容
助手会以聊天应用组件的形式显示活动时间线，刷新以展示新创建的活动上下文。
有用的提示
- 对于任务，只需说明主题和截止日期——例如，“创建一个任务，周五前跟进。”
- 对于电话，请指定方向（来电或外发）。 如果你没提，助理会问通话时间。
- 预约时请注明日期和时间。 你也可以添加地点。
- 如果你想添加纯文本笔记（不是活动），可以选择“添加笔记”。
- 活动总是与当前记录相关联。 助理会使用当前案件、工单或预订上下文。
Tip
你可以连续创建多个活动。 创建任务后，说“也记录电话”以添加另一个活动。
接下来会发生什么
活动创建后，你可以继续使用以下提示：
- 展示时间线。
- 创建另一个任务。
- 给客户写一封邮件。
- 这个案子有哪些任务未完成？
- 更新案件状态。
这会改变数据吗？
是的，这创造了一个活动。
在 Dynamics 365 中创建一个新的活动记录（任务、电话、约会或电子邮件）并与该记录关联。 助理在创建活动前会先确认。
你可以通过聊天应用组件做些什么
从聊天中的活动时间线中，你可以：
- 请查看新创建的活动及其他近期案例活动。
- 按时间顺序浏览活动历史。
- 展开活动以查看其详细信息。
- 在 Dynamics 365 中打开该活动以便进一步编辑。
先决条件
该工具适用于本页顶部“申请”栏中列出的产品。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 创建活动 |
| 内部工具名称 | create_activity |
| Purpose | 创建与 Dynamics 365 记录相关的时间线活动（邮件、任务、约会或电话） |
工具行为
创建与 Dynamics 365 记录关联的时间线活动（电子邮件、任务、约会或电话）。 支持所有标准Dataverse活动类型以及租户配置的自定义活动类型。 始终将活动与当前活跃记录关联。entityId/entityType
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具生成数据——智能 Microsoft 365 Copilot 副驾驶® 会提示确认。 |
destructiveHint |
false |
创造一项活动是加法性的，而非破坏性的。 |
idempotentHint |
false |
每次通话都会生成一个新的活动——不安全地重试。 |
openWorldHint |
未设置 | 使用默认值（查询Dataverse）。 |
输入概念
记录上下文
| 输入 | Description | 必需 |
|---|---|---|
entityId、regardingId、entityType、regardingType、incident |
entityId 或 regardingId （记录GUID，必需——始终从激活案例 entityType 传递），或 regardingType （实体逻辑名称，如 incident）。 两种命名对均可接受。 |
是的 |
活动类型
| 输入 | Description | 必需 |
|---|---|---|
activityType |
activityType（必填——例如，phonecalltask， ， appointment， email， 或任何租户配置的Dataverse活动逻辑名称）。 |
是的 |
常见字段
| 输入 | Description | 必需 |
|---|---|---|
subject、description |
subject （活动主题行）， description （正文/描述）。 |
否 |
任务特定
| 输入 | Description | 必需 |
|---|---|---|
dueDate、priority、low、normal、high |
dueDate （ISO 8601）， priority （low， normal， high）。 |
否 |
电话专属
| 输入 | Description | 必需 |
|---|---|---|
phoneNumber、direction、incoming、outgoing、duration |
phoneNumber， （ directionincoming 或 outgoing）， （ duration 分钟数——如未注明，务必向用户确认）。 |
否 |
具体预约
| 输入 | Description | 必需 |
|---|---|---|
scheduledStart、scheduledEnd、location |
scheduledStart以及scheduledEnd（ISO 8601）。 location |
否 |
邮件专属
| 输入 | Description | 必需 |
|---|---|---|
to、cc、bcc、send |
to， cc， （ bcc 实体引用或邮件字符串数组）， send （true 表示立即发送，false 表示草稿）。 |
否 |
草案更新
| 输入 | Description | 必需 |
|---|---|---|
activityId、fieldValues |
activityId （现有活动 GUID 用于更新）， fieldValues （快速创建表单中的额外字段值）。 |
否 |
响应与用户界面行为
该工具会渲染活动时间线以确认活动已被创建。
该 MCP 工具由 MCP 应用支持。
响应类型
交互组件（聊天应用）
时间线小部件会刷新，显示动态中新创建的活动。
路由注释
用于 create_activity ：
- 创建任务，记录通话，预约。
- 任何时间线活动创建（电话、任务、约会、邮件）。
- 租户中配置了自定义活动类型。
不要在以下情况下使用 create_activity ：
- 用户想添加纯文本笔记——use
create_note（note不是有效的 activityType）。 - 用户希望在发送邮件前撰写并审核邮件——请使用
draft_email。 - 用户想立即发送电子邮件——使用
send_email。
相关工具
| 工具 | 关系 |
|---|---|
create_note |
创建一个笔记（注释）——而不是时间线活动 |
get_activity_timeline |
获取记录的完整活动时间线 |
get_activity_quick_create_form |
活动类型元数据的返回 |
draft_email |
打开邮件写作进行审核（邮件流程优先） |
send_email |
立即发送邮件 |
数据变异分类
写作/变异。
该工具在Dataverse中创建一个新的活动记录。 智能 Microsoft 365 Copilot 副驾驶® 在运行前会提示用户确认。