活动快速创建表单

适用于: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 显示时间线并托管快速创建表单

数据变异分类

只读。

该工具仅返回元数据。 未修改任何数据。