适用于：Dynamics 365 Customer Service
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想找到客户账户、在聊天中查看并采取行动而不离开对话时，可以使用这个功能。
它的作用是什么
助手会显示一个符合你筛选条件的账户列表。 您可以按以下条件进行筛选：
- 账户是否被分配给你。
- 账户状态（活跃或非活跃）。
- 市。
- 帐户名。
- 电话号码涵盖主要或全面电话覆盖范围。
结果会显示在聊天内的互动账户列表中。
试试像这样的提示
- 显示我的活跃账户。
- 列出我的账户。
- 在西雅图展示客户。
- 列出非活跃账户。
- 显示分配给我的账户。
- 找到Contoso账户。
- 查找电话号码为+1-555-0100的账户。
- 列出所有账户。
- 展示科技行业的账号。
你在聊天中会看到的内容
助手作为聊天应用组件显示交互式账户列表。 该列表显示匹配账户，包含账户名称、行业、城市、电话和电子邮件等关键细节。
有用的提示
- 说“我的账户”或“分配给我”，只显示你拥有的账户。
- 使用状态词如活跃或非活跃来筛选结果。
- 通过说类似“显示我在西雅图的活跃账户”来合并筛选条件。
- 使用公司名称或电话号码搜索特定账户。
- 电话查询默认使用三个常见账户电话字段。 要求提供详尽的覆盖，包括可读的自定义和额外的电话格式字段。
- 如果你想要一家公司的全面总结，可以说“简要介绍一下Contoso”。 那是用不同的工具。
Tip
账户列表显示后，您可以对任何显示的账户提出后续问题。 例如，“开设第一个账户”或“总结Contoso”。
接下来会发生什么
列表出现后，你可以继续使用以下提示：
- 开第一个账户。
- 总结一下这个说法。
- 在此账户显示联系人。
- 更新该账户的电话号码。
这会改变数据吗？
不，列出账户不会改变数据。
账户列表为只读。 列表中的后续操作，如更新字段，可能会改变数据。 助理在做修改前会先确认。
你可以通过聊天应用组件做些什么
在聊天账户列表中，你可以：
- 扫描并查看可排序的匹配账户。
- 选择一个账户查看更多详情。
- 在Dynamics 365中打开完整账户表单。
- 在有支持字段时更新内联支持字段。
- 继续在聊天中使用后续提示与账号合作。
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 账户列表 |
| 内部工具名称 | list_accounts |
| Purpose | 按状态、城市、所有者、姓名或电话筛选客户账户，并以互动式网格式聊天应用体验呈现 |
工具行为
按状态、城市、所有者、姓名或电话筛选客户账户，并以互动式网格式的聊天应用体验呈现。 该 search 参数对账户名称进行包含匹配。
phone参数检查 telephone1、 telephone2，telephone3且 主覆盖。 详尽覆盖优先考虑这些常见字段，并搜索最多48个可读的Dataverse电话格式字段，包括自定义字段。 电话匹配首先精确检查存储值，然后对符合条件的7-15位值使用格式不敏感的比较。 当元数据或字段限制、候选检索或请求的结果限制省略匹配时，响应会包含 phoneLookupTruncated: true 并警告可能存在额外的匹配。 退役 additionalFilter 输入被拒绝;使用文档中的一类过滤器。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用（只读工具）。 |
idempotentHint |
未设置 | 不适用（只读工具）。 |
openWorldHint |
未设置 | 使用默认值（查询Dataverse）。 |
输入概念
搜寻
| 输入 | Description | 必需 |
|---|---|---|
| — | 自由文本字符串。 对账户名称进行包含匹配。 | 否 |
城市
| 输入 | Description | 必需 |
|---|---|---|
address1_city |
通过（包含匹配）进行过滤 address1_city 。 当用户指定地理位置时使用。 |
否 |
手机
| 输入 | Description | 必需 |
|---|---|---|
phone |
电话号码与 telephone1、 、 telephone2telephone3和 匹配。 重复匹配则返回以消歧义。 |
否 |
搜索覆盖范围
| 输入 | Description | 必需 |
|---|---|---|
searchCoverage |
primary （默认）搜索三个常见账户电话字段。
exhaustive 搜索最多48个可读的Dataverse电话格式字段，并在存在更多字段时报告截断。 |
否 |
地位
| 输入 | Description | 必需 |
|---|---|---|
active、inactive |
active 或 inactive。 按账户状态代码筛选。 |
否 |
所有权范围
| 输入 | Description | 必需 |
|---|---|---|
assignedToMe |
assignedToMe （布尔值）。 如果为真，范围会显示当前用户拥有的账户。 |
否 |
结果限制
| 输入 | Description | 必需 |
|---|---|---|
top |
top （整数）。 最多可退回的账户数量。 默认是10，最多200。 |
否 |
响应与用户界面行为
该工具会生成一个互动式的聊天应用账户网格。
该 MCP 工具由 MCP 应用支持。
响应类型
交互式网格（列表视图）
网格显示账户名称、行业、城市、电话和电子邮件。 用户可以选择一行深入账户细节，或通过聊天进行后续操作。
路由注释
用于 list_accounts ：
- 我的账户、分配给我的账户、我的活跃账户。
- 基于状态的过滤（激活，非激活）。
- 基于城市的过滤。
- 账户名称搜索。
- 电话号码查询。
当 list_accounts 提示明确写着：
-
按名称查看特定账户，方便查看详情——路由访问
get_account。 -
“简要介绍”或“总结”一家公司——路线至
summarize_account。 -
跨多种实体类型的自由文本搜索——路由至
search_entities。 -
查找字段关联——路径访问
search_lookup_records。
相关工具
| 工具 | 关系 |
|---|---|
get_account |
为所选账户开启完整账户表单 |
summarize_account |
生成由人工智能驱动的账户摘要 |
list_contacts |
联系人列表，常与浏览账户一起使用 |
search_entities |
跨任何实体类型的自由文本搜索 |
search_lookup_records |
搜索查找字段关联的记录 |
list_entity_records |
针对没有专用列表工具的实体类型的通用实体网格 |
数据变异分类
只读入口，带有下游突变潜力。
房源本身不会改变数据。 网格的后续操作（更新、编辑字段）可以通过不同的工具触发写入操作。