查看帐户

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

注释

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

当你想直接在聊天中查看特定客户账户的完整信息时，可以使用这个功能。

它的作用是什么

助理会为你指定或用ID指定的账户开一个详细的账户表单。 你可以查看所有账户字段，内联编辑支持字段，并在Dynamics 365中导航到完整表单。

如果你提供账户名称且多个账户匹配，助理会告诉你，并建议使用“列表账户”来找到合适的账户。

试试像这样的提示

  • 显示Contoso账户详情。
  • 开设账户 Adventure Works。
  • 查看Fabrikam账户。
  • 给我看看Northwind Traders的账户。
  • Litware账户的详细信息是什么？
  • 开这个账户。

你在聊天中会看到的内容

助手会在聊天中显示一个互动账户表单，作为应用中的组件。 表单显示账户字段，如姓名、行业、地址、电话号码、电子邮件以及表单上设置的任何自定义字段。

有用的提示

  • 你可以用账户名称或GUID来开设特定账户。
  • 如果助理说多个账户匹配，试试“列出账户”，然后选择你想要的。
  • 如需快速的文字摘要而非完整表格，请说“总结此账户”或“简要介绍一下Contoso”。

Tip

账户表单出现后，你可以问后续问题，比如“显示该账户的联系人”或“列出该账户的案件”。

接下来会发生什么

账户表单出现后，你可以继续使用以下提示：

  • 总结一下这个说法。
  • 在此账户显示联系人。
  • 更新该账户的电话号码。
  • 列出该账户的案例。

这会改变数据吗？

不，查看账户不会改变数据。

账户表单默认为只读。 表单中的内联编辑可能会更改数据。 助理在做修改前会先确认。

你可以通过聊天应用组件做些什么

在聊天中的账户表单中，你可以：

  • 请审核所有账户详情。
  • 编辑支持字段内嵌。
  • 在Dynamics 365中打开完整账户表单。
  • 继续在聊天中使用后续提示与账号合作。

先决条件

该工具适用于本页顶部“申请”栏中列出的产品。 这种方式无需任何其他配置。

工具摘要

资产 价值
面向用户的名称 查看帐户
内部工具名称 get_account
Purpose 通过内联编辑打开单个CRM账户记录的完整视图

工具行为

通过内联编辑打开单个CRM账户记录的完整视图。 接受GUID或账户名称，并自动解析唯一名称。 当多个账户匹配该名称时返回错误;用于 list_accounts 消歧。

Annotations

注释 价值 Meaning
readOnlyHint 未设置 实际操作中只读;这个工具不会直接修改数据。
destructiveHint 未设置 不适用（只读工具）。
idempotentHint 未设置 不适用（只读工具）。
openWorldHint 未设置 使用默认值（查询Dataverse）。

输入概念

记录标识符

输入 Description 必需
recordId recordId （字符串，必填）。 一个账号GUID或账号名称可以搜索。 当提供名称时，工具会在服务器端解析该名称。 如果多个账户匹配，会返回错误，引导用户前往 消 list_accounts 歧义。 是的

形式选择

输入 Description 必需
formId formId （字符串，可选）。 一个用于渲染的系统形式 GUID。 省略时默认使用主要形式。 否

响应与用户界面行为

该工具会生成一个互动式的聊天应用账户表单。

该 MCP 工具由 MCP 应用支持。

响应类型

交互式表单（详细视图）

表单显示账户字段，如所选系统表单定义的，包括账户名称、行业、地址、电话、电子邮件和自定义字段。

路由注释

用于 get_account ：

  • 开设账户X，显示账户详情，查看Contoso。
  • 任何提示，具体点名一个账户并想查看其形式。

当 get_account 提示明确写着：

  • “列表”或“显示我的账户”——路由到 list_accounts。
  • “总结”或“简要介绍” 一家公司——路线至 summarize_account。
  • 逻辑名称为通用实体——路径映射到 get_entity_record。
工具 关系
list_accounts 列出账户;用于区分多个名字匹配的歧义
summarize_account 账户上下文的AI文本摘要
update_entity_record 账户记录中的更新字段
get_contact 打开一个联系表单;常与账目细节一起使用
get_entity_record 非账户实体类型的通用实体详情

数据变异分类

只读入口，带有下游突变潜力。

表单视图本身不会改变数据。 内联编辑触发写入操作。update_entity_record

  • 上次更新时间为