创建实体记录

适用于：Dynamics 365 Customer Service 和 Dynamics 365 Sales

注释

  • 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
  • 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
  • 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。

当你想直接从聊天创建新的Dataverse记录时，可以使用这个功能。

它的作用是什么

助理在Dynamics 365中创建新的案件（事件）、账户或联系人记录。 你提供记录的详细信息，助理只用你给出的数值来创建——它从不虚构或猜测字段值。

当你以姓名提及相关记录（例如，客户在某个案件中，或联系人所在的公司），助理会帮你查找匹配记录。 如果名字与多条记录相符，助理会问你指的是哪一条。 如果缺少某个必填字段（如案件标题、账户名称或联系人姓氏），助理会在创建记录前向你索取。

试试像这样的提示

  • 为Contoso账户创建一个题为“意式咖啡机泄漏”的案件。
  • 为Contoso账户的账单问题开启支持案件。
  • 为Fabrikam记录一个“磨豆机发出大声噪音”的案例。
  • 创建一个名为Northwind Traders的新账户。
  • 添加一个名叫Priya Nair的联系人，在Contoso。
  • 创建一个联系人，姓Okafor，名字Ada，邮箱 ada@fabrikam.com。

你在聊天中会看到的内容

助理会确认新记录已创建，并告诉你其名称和实体类型。 如果需要更多信息，助理会告诉你缺失哪些字段，或者让你在匹配的相关记录中选择。

有用的提示

  • 事先提供记录细节，以避免后续问题——案件、产权及相关客户;账户中，公司名称;至少要有个联系人，至少姓氏。
  • 当你指定相关记录（比如客户账户或联系人的公司）时，助理会自动解析。 如果有几位匹配，就选助理列出的那一位。
  • 自然地描述你想要什么。 助理选对工具。

Tip

如果助理要求缺少必填字段或消除相关记录歧义，请在聊天中回答，助理继续创建记录。

接下来会发生什么

记录创建后，你可以继续使用以下提示：

  • 拿出这份记录。
  • 更新本记录中的字段。
  • 再创一个纪录。
  • 在 Dynamics 365 中打开此记录。

这会改变数据吗？

是的，这会创建一个新的Dataverse记录。

助理在有所需信息后立即创建记录——没有单独的确认步骤。 如果需要更改，可以之后更新记录。

先决条件

该工具适用于本页顶部“申请”栏中列出的产品。 无需进行额外配置。 你需要对你正在创建的实体拥有Dataverse创建权限。

工具摘要

资产 价值
面向用户的名称 创建实体记录
内部工具名称 create_entity_record
Purpose 创建新的案件（事件）、账户或联系人记录，解决查找名称并预置必要字段

工具行为

在 Dynamics 365 中创建新的案件（事件）、账户或联系人记录。 当用户请求创建、打开或登录支持案件，或创建新账户（公司）或联系人（个人）时使用。 用于任何活动（任务、电话、约会、电子邮件、信件、传真、社交活动）create_activity;用于笔记。create_note 以名称（如客户或联系人公司）提供的查找字段会自动解析为相关记录;名称模糊时，候选人返回去消歧义。 如果缺少某个必填字段，工具会返回缺失字段，方便助理请求并重试。 案件、账户和联系人以外的实体类型——包括系统和安全实体（用户、团队、角色、业务单元）——在这里无法创建。

Annotations

注释 价值 Meaning
readOnlyHint false 该工具会修改数据。
destructiveHint false 该工具创建数据时无需硬删除行为。
idempotentHint false 反复呼叫会生成额外的记录。
openWorldHint 未设置 使用默认值（查询Dataverse）。

输入概念

实体类型

Input 说明 Required
entityLogicalName entityLogicalName （字符串，必填）。 Dataverse 实体的逻辑名称用于创建记录： incident （case）、 account， 或 contact。 Yes

字段值

Input 说明 Required
fields fields （键值映射）。 标量字段逻辑名称到值（文本、数字、选项集代码、ISO 日期）。 例如： { "title": "Espresso machine leaking" } 用于案件、 { "name": "Northwind Traders" } 账户或 { "lastname": "Nair", "firstname": "Priya" } 联系人。 No

查找值

Input 说明 Required
lookups lookups （键值映射）。 查找字段逻辑名称到相关的记录名称或 GUID。 例如： { "customerid": "Contoso" } 在案件中，或 { "parentcustomerid": "Contoso" } 在联系人中。 名字会自动解析;歧义名称返回候选人。 No

响应与用户界面行为

该工具返回文本回复。 成功后，它会报告创建记录的名称和实体类型。 当需要更多输入时，它会返回一个结构化的重提示，描述缺失的必填字段或可选的查找候选项，以便助手收集缺失的输入并重新尝试。

响应类型

短信回复（无聊天应用组件）

路由注释

用于 create_entity_record ：

  • 创建、打开或记录支持案件（incident）。
  • 创建新账户——一家公司或组织（account）。
  • 创建新的联系人——一个人（contact）。

不要在以下情况下使用 create_entity_record ：

  • 创建任何活动 （任务、电话、约会、电子邮件、信件、传真、社交活动）——路由到 create_activity。
  • 创建备注——路径到 create_note。
  • 更新现有记录——路由至 update_entity_record。
  • 删除记录——路径访问 delete_entity_record。
  • 创建任何其他实体 （用户、团队、角色、业务单元、机会、潜在客户或自定义表）——工具会拒绝这些。
工具 关系
get_entity_record 创建记录后查看
update_entity_record 现有记录上的更新字段
delete_entity_record 删除记录
list_entity_records 实体类型的列表记录

数据变异分类

写操作（非破坏性，非幂等型）。

这个工具会生成数据。 新记录会直接插入到 Dataverse 中。 该运算不是幂零的;重复呼叫会生成额外记录。

  • 上次更新时间为