Dataverse MCP 服务器参考文档 (预览版)

注释

本文介绍了由 标准线束驱动的代理或代理流中使用的功能。

Important

这是一项预览功能。

  • Microsoft正式发布之前发布预览版功能,以便客户能够提前访问并提供反馈。
  • 预览功能具有受限的功能,不适用于生产用途。
  • Microsoft可能会更改预览 MCP 工具名称和参数。 避免硬编码依赖项。 Microsoft 提供场景支持。
  • 预览功能受Microsoft补充使用条款的约束。

概述

显示名称 Description
Microsoft Dataverse MCP 服务器 MCP 服务器包含用于 Dataverse 的工具。

可用工具

工具 Description
create_record 允许用户将新记录插入到指定的 Dataverse 表中。 成功创建后,该工具将返回新添加的行的全局唯一标识符(GUID),从而促进与下游作和工作流的无缝集成。
describe_table 检索给定 Dataverse 表的完整 T-SQL 架构 ,包括字段名称、数据类型和关系。 此架构可让开发人员清楚地了解表的结构,以便有效地生成查询和管理数据模型。
list_tables 返回当前 Dataverse 环境中所有可用表的综合列表。 此列表可帮助用户在其组织环境中快速发现和导航数据布局。
read_query 执行 SELECT 语句以直接查询 Dataverse 数据,基于指定的筛选器和条件返回结果。 此工具非常适合需要动态数据检索的数据浏览、分析和集成方案。
update_record 允许用户通过指定要更新的记录的唯一标识符(GUID)和字段来修改 Dataverse 表中的现有记录。 此功能可确保数据的有效维护和同步。
create_table 通过定义架构(包括列名、数据类型和关系)来创建新的 Dataverse 表。 此工具支持灵活的架构管理,以满足不断变化的业务需求。
update_table 有助于修改现有表的架构或元数据(例如添加新列、重命名字段或更新约束),而不会中断现有数据或工作流。
删除表 从 Dataverse 环境中永久删除表,包括其关联的架构和数据。 此作仅限于具有适当权限的用户,以确保治理符合性。
delete_record 使用唯一标识符从 Dataverse 表中删除特定记录。 此操作支持高效的数据生命周期管理以及遵循保留策略的合规性。
搜索 启用跨 Dataverse 的基于关键字的搜索,允许用户有效地查找特定记录、实体或字段。 该工具在大型数据集中的探索性分析和表格发现中尤其有用。
获取 通过表名和记录ID从Dataverse获取完整的记录细节。 此工具提供对记录数据的全面可见性,支持审核、AI 驱动的见解以及报告功能。

主要功能

数据创建和引入

使用业务记录、配置或运作实体的新数据填入 Dataverse 表。

工具:

  • create_record – 将新行插入 Dataverse 表中,并返回记录的 GUID,从而启用下游自动化或链接。
  • create_table – 允许开发人员或管理员定义具有指定架构的新表来存储业务数据。

数据探索和发现

了解现有数据模型的结构,并识别Dataverse中的可用表。

工具:

  • list_tables – 列出连接 Dataverse 环境中可用的所有表。
  • describe_table – 检索任何所选表的 T-SQL 架构,包括列、类型和关系。

数据查询和分析

检索、分析或验证Copilot推理或开发人员工作流的业务数据。

工具:

  • read_query – 执行 SELECT 查询,从 Dataverse 表中提取筛选的数据。
  • 搜索 - 使用关键字跨 Dataverse 搜索以查找符合特定条件的记录。
  • fetch – 使用实体名称和 ID 检索记录的完整详细信息,以便进行更深入的分析。

数据更新和维护

修改现有数据或更新架构,使其与更改的业务逻辑或流程保持一致。

工具:

  • update_record – 更新现有记录中的字段,例如状态、所有者或优先级。
  • update_table – 调整表的模式或元数据。 例如,添加新列或重命名字段。

数据删除和生命周期管理

管理保留策略或清理过时的记录和表,同时维护数据治理。

工具:

  • delete_record – 通过 GUID 删除特定记录,支持自动清理或符合 GDPR 的删除。
  • delete_table – 从 Dataverse 安全地删除未使用的或已弃用的表。

智能助理和 AI 场景

使 AI 副驾驶和智能体(如 Microsoft Copilot Studio 和 Claude Desktop)能够安全地基于 Dataverse 数据进行推理。

工具:

  • 搜索、read_query和提取 - 启用 copilot 以使用企业数据动态定位、解释和响应。
  • create_record和update_record – 允许副手在对话工作流中记录新操作或修改现有记录。