适用于:Dynamics 365 Customer Service
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时,不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反,设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展,Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想在创建活动前查看活动表单上可用的字段时,可以使用此功能。 当你想知道任务、电话或约会中可以包含哪些信息时,这很有帮助。
它的作用是什么
助手会检索特定活动类型的表单布局,并显示可用的字段、部分和选项。 这告诉你在创建此类活动时可以填写哪些信息。 例如,任务表单显示主题、截止日期和优先级等字段,而电话呼叫表单显示电话号码、方向和持续时间等字段。
试试像这样的提示
- 我可以在任务中设置哪些字段?
- 给我看看电话表单的字段。
- 预约时有哪些字段可用?
- 任务表单是什么样的?
你在聊天中会看到的内容
助手会在时间线小部件中以聊天应用组件的形式显示表单布局,显示所请求活动类型的可用字段和选项。
有用的提示
- 当你想在创建活动前准确掌握哪些细节时,这条信息最有用。
- 你不必在创建活动前使用这个功能——你总可以直接说“创建任务”,助理会引导你完成必需字段。
- 可用的字段可能会根据贵组织的Dynamics 365配置而有所不同。
Tip
如果你已经知道想创建什么活动,可以跳过这一步,直接说“创建任务”或“记录电话”。
接下来会发生什么
查看表单字段后,你可以继续使用以下提示:
- 用这些字段创建一个任务。
- 打个电话。
- 预约。
这会改变数据吗?
不,查看表单字段不会改变数据。
这只显示表单布局和可用字段。 创建活动是一个独立步骤。
你可以通过聊天应用组件做些什么
通过聊天中的快速创建表单,你可以:
- 填写活动详情(主题、描述、截止日期、优先级)。
- 选择活动类型(任务、电话、预约)。
- 直接从表单保存新活动,无需打开 Dynamics 365。
- 保存后立即继续在聊天中工作。
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 活动快速创建表单 |
| 内部工具名称 | get_activity_quick_create_form |
| Purpose | 返回Dynamics 365活动类型的快速创建表单元数据(部分、字段、选项集) |
工具行为
返回 Dynamics 365 活动类型的快速创建表单元数据(部分、字段、选项集)。 小部件调用 get_activity_timeline 它来渲染动态表单以创建活动。 当用户明确询问组织中特定活动类型有哪些字段可用时使用。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
该工具仅返回元数据——不修改任何数据。 |
destructiveHint |
未设置 | 不适用(只读工具)。 |
idempotentHint |
未设置 | 不适用(只读工具)。 |
openWorldHint |
未设置 | 使用默认值(查询Dataverse)。 |
输入概念
活动类型
| 输入 | Description | 必需 |
|---|---|---|
activityType |
activityType(必填——活动类型逻辑名称,例如,phonecall、、taskappointment,或任何租户配置的活动类型)。 |
是的 |
关于背景
| 输入 | Description | 必需 |
|---|---|---|
regardingId、entityId、regardingType、entityType |
regardingId 或 entityId (记录GUID), regardingType 或 entityType (实体逻辑名称)。 两种命名对均可接受。 可选——为表单渲染提供上下文。 |
否 |
响应与用户界面行为
该工具在活动时间线小部件中渲染表单元数据。
该 MCP 工具由 MCP 应用支持。
响应类型
交互组件(聊天应用)
该小部件显示快速创建表单布局,包含字段、分区和请求活动类型的选项集。
路由注释
用于 get_activity_quick_create_form :
- 我可以在[活动类型]上设置哪些字段?
- 内部控件使用——时间线控件调用此功能来渲染动态表单。
不要在以下情况下使用 get_activity_quick_create_form :
- 用户想直接创建活动——使用
create_activity。 - 用户想查看时间线——使用
get_activity_timeline。
相关工具
| 工具 | 关系 |
|---|---|
create_activity |
利用该表单元数据定义的字段创建活动 |
get_activity_timeline |
显示时间线并托管快速创建表单 |
数据变异分类
只读。
该工具仅返回元数据。 未修改任何数据。