You need to enable JavaScript to run this app.
数据智能体

数据智能体

复制全文
创建与配置智能分析Agent
MCP 服务管理
复制全文
MCP 服务管理

智能分析 Agent 为您提供 MCP 服务接入和管理能力,您可以通过此功能接入和管理外部MCP服务,扩展DataAgent 的数据获取范围(通常为外部数据,如联网搜索、第三方平台数据等)和分析能力(用于增强智能体的数据分析能力,如归因、预测等)。本文为您介绍 MCP 服务管理功能说明与操作详情。

功能概述

智能分析 Agent 为您提供系统级和 Agent 级的 MCP 接入能力,两类 MCP 服务的对比介绍如下。

Agent 级

系统级

  • 适用范围:仅当前智能体可使用的 MCP 服务。
  • 操作入口:
    Image
  • 适用范围:所有智能体可使用的 MCP 服务,仅系统管理员可添加。
  • 操作入口:
    Image

接入 MCP 服务后,后续在使用深度研究、洞察报告等功能时,大模型会基于您的问题和 MCP 服务配置结果判断是否需要调用 MCP服务,来进一步提高分析结果质量。

注意与限制
  • 当前智能问数功能不支持使用接入的 MCP 服务能力,您可以在深度研究和洞察报告功能中使用 MCP 服务。
  • 当前添加的自定义 MCP 服务的 MCP 协议版本需为2025-06-18及以后的版本。

添加与配置MCP服务

Agent 级与系统级的 MCP 服务除了适用范围外,在配置操作上没有差异,以下以添加与配置 Agent 级的 MCP 服务为例,为您示例操作详情。

添加MCP服务

智能分析 Agent 为您预置了一个系统 MCP 服务(insight-agent),包含了多种高级分析工具,您也可以添加更多您自己的 MCP 服务。

  1. 登录并进入智能体的管理后台,在左侧导航栏单击 MCP 服务管理,进入 MCP 服务管理页面后单击右上角的添加 MCP 服务按钮。
    Image

  2. 在弹出的页面中配置 MCP 服务的基本信息,完成后单击“下一步”。
    Image

    参数

    配置说明

    MCP 服务 & 描述

    自定义 MCP 服务的名称和描述,用于标识添加的 MCP 服务的作用,便于后续使用和管理 MCP 服务。

    分类

    选择当前添加的 MCP 服务的用途类型,支持选择:

    • 数据拓展:用于拓展智能体的数据获取范围,通常为外部数据,如联网搜索、第三方平台数据等。
    • 分析能力:用于增强智能体的数据分析能力,如归因、预测等。

    添加方式

    选择连接MCP服务的方式,当前支持:StreamableHTTP、SSE、OpenAPI。

    URL

    配置 MCP 服务的连接 URL。请确保 Data Agent 所处网络能访问该 URL。

    Header 鉴权

    配置 MCP 服务连接时的鉴权信息。如果 MCP 服务无需鉴权,您可单击配置框后的删除按钮,删除 Header 鉴权配置参数。

  3. (可选)在工具管理页面单击添加工具按钮,在弹窗中配置工具参数,完成后即可给加 MCP 服务添加对应工具。

    说明

    仅通过 OpenAPI 方式添加 MCP 服务时需手动添加工具,通过 StreamableHTTP、SSE 方式添加 MCP 服务时,系统会自动为您拉取 MCP 服务中已注册的工具。

    Image

    • 基本信息

      参数

      配置说明

      工具名称

      自定义添加的工具名称。后续工具名称会在智能分析 Agent 使用页面面向最终用户展示。

      模型调用标识

      配置为 MCP 服务在注册对应工具时设置的模型调用标识。

      注意

      此处配置的模型调用标识不支持配置为中文字符。

      描述

      为添加的工具补充描述信息,为大模型介绍工具的用途,有助于帮助其正确调用工具。

      Input Schema & Output Schema

      配置后续大模型调用工具时,工具的输入参数和输出参数的格式要求。

      • Input Schema(必填):必须配置,您需要明确后续智能体调用工具时的输入参数要求,格式需为 JSON Schema 。
        配置示例: {"type": "object", "properties": {"location": {"type": "string"}}},则,后续输入参数为{"location": "Seattle"}进行测试时,等同于执行:

        curl -X POST http://*****/api/v0/web_search -H 'Content-Type: application/json' -d '{"location": "Seattle"}'
        
      • Output Schema(可选):您可根据情况灵活配置,如果配置了输出参数的格式要求,则在后续大模型调用工具时,会对输出结果进行格式校验。输出参数的Schema也必须为 JSON Schema 格式。

      说明

      配置完成后,后续调用 MCP 工具时,对 MCP 工具的输入输出的校验与处理流程详情可参见下文的参考:调用 MCP 工具时的处理流程

    • 工具功能

      参数

      配置说明

      URL & 请求方式

      需配置为工具的 API URL 及其请求方法。

      Request Schema & Response Schema

      • Request Schema 用于将传入的 Input Schema 转化为工具 API 实际接受的格式,可为空,如果配置Request Schema,配置的格式需要为 JSONata 格式。
      • Response Schema 用于将工具 API 实际返回格式转换为 Output Schema,可为空,如果配置 Response Schema,配置的格式需要为 JSONata 格式。

      说明

      Header 鉴权

      配置调用工具时的鉴权信息。如果无需鉴权,您可单击配置框后的删除按钮,删除 Header 鉴权配置参数。

  4. 重复上述步骤,可为 MCP 服务添加多个工具。完成工具添加后,您可参考下文对添加的工具进行测试。

测试工具

完成工具添加后,可在工具列表中单击“测试”按钮,在弹出的页面中输入测试的“输入参数”,单击“测试”对工具进行调用测试。
Image

启停 MCP 服务

完成 MCP 服务添加与配置后,您可以在 MCP 服务管理页面中配置是否启用/停用 MCP 服务,以及后续使用智能体的时候是否默认使用对应的 MCP 服务。
Image

应用示例

深度研究

洞察报告

启用 MCP 服务后,后续在深度研究页面进行问数时,可在问题输入框的“拓展”中灵活勾选使用MCP服务中的哪个工具。
Image

启用 MCP 服务后,后续在洞察报告页面使用“AI 分析”时,可在问题输入框的“拓展”中灵活勾选使用 MCP 服务中的哪个工具。
Image

参考:调用 MCP 工具时的处理流程

您在使用智能分析 Agent 时,如果勾选了需要使用某个 MCP 服务中的工具,则智能体的大模型与工具间的主要交互流程如下。
Image
智能体的大模型会基于 MCP 服务中工具的调用规则:

  • 在调用 MCP 工具时:
    • 会进行工具调用输入的校验,对标 MCP 工具的Input schema规则将用户问题转为符合规则的格式,并进行校验。
    • 如果MCP 工具还配置了 Request schema 规则,则大模型会进一步将 Input schema 转化为符合 Request schema 规则的请求格式,向 MCP 工具发起调用请求。
  • MCP 工具完成处理反馈调用结果后:
    • 如果 MCP 工具配置了 Response schema 规则,则大模型会将 MCP 工具返回的原始结果转为符合 Response schema 规则的格式。
    • 如果 MCP 工具配置了 Output schema 规则,则大模型会进一步将返回结果进行校验,校验是否符合 Output schema 规则的格式。

说明

如果 MCP 工具没有设置 Request Schema、Response Schema,大模型在此过程中如果发现工具调用过程中有格式问题,会尝试纠错改写,如果纠错改写后仍旧有问题,则需要您手动调整 MCP 工具的相关配置。

最近更新时间:2025.12.16 15:25:21
这个页面对您有帮助吗?
有用
有用
无用
无用