开放集成介绍

1.1 功能简介

Data Agent 提供外部 AI 平台集成、开放 API 和外接 MCP 等开放能力，可与 OpenClaw、企业业务系统及其他外部工具进行集成，进一步满足企业自动化分析需求。不同集成方式适用的身份凭证不同，具体请参见相应章节。

1.2 使用场景

通过 Data Agent 开放集成能力，可以实现：

• 将 Data Agent 分析生成的图表或报表等内容定时推送给负责人；

• 在企业门户、业务系统或自定义应用中调用 Agent；

• 自动创建或发布 Agent；

• 自动查询历史会话；

• 对接 OpenClaw 等外部 AI 平台；

• 通过 MCP 扩展 Agent 可使用的数据和工具。

1.3 开放API对接

除外部集成能力外，Data Agent 还提供开放 API，支持企业门户、业务系统或自定义应用调用 Agent 对话、会话管理、会话文件、Agent 配置等能力。

开放 API 使用前端单点登录返回的 fine_auth_token 进行身份认证：

Authorization: Bearer <FINE_AUTH_TOKEN>

接口路径、请求方式、请求参数、鉴权要求及响应示例，请参见：DataAgent 开放 API 接口文档。

fine_auth_token 的获取方式，请参见：前台单点登录接口。

注：

1）开放 API 使用前端单点登录返回的 fine_auth_token；

2）「Key 管理」页签中创建的 Key 主要用于 OpenClaw 等外部 AI 平台或工具的集成访问；

3）调用开放 API 时，不建议使用「Key 管理」中创建的 Key，以避免安全风险；

4）请勿将 fine_auth_token、Key 等身份凭证写入前端代码、公开仓库或日志。

按照界面提示，完成「发送安装对话>发送集成对话>检查集成状态」操作后，即可完成 Data Agent  与 外部 AI 的集成对接。

在「Key 管理」页签中，可以为 OpenClaw 等外部 AI 平台或工具创建访问 Data Agent 的 Key。

选择勾选以下一个或多个接口权限，即可生成新的外部 AI 访问 Key：

• 查询已发布 Agent 详情 openclaw:agents:detail

• 中断对话 openclaw:interrupt

• 查询会话历史 openclaw:history

• 查询已发布 Agent 列表 openclaw:agents:list

• 查询会话列表 openclaw:sessions:list

• 查询 Skill 列表 openclaw:skills:list

• 创建 Agent 草稿 openclaw:agents:create

• 发布 Agent openclaw:agents:publish

• 流式对话 openclaw:chat:sse

• 查询产物预览内容 openclaw:artifact:content

• 下载产物 openclaw:artifact:download
  

• 查询 Agent 可编辑配置 openclaw:agents:editable

• 保存 Agent 配置 openclaw:agents:save

• 查询 LLM 配置列表 openclaw:llm:configs:list

• 对话 openclaw:chat

注：

1）「Key 管理」中创建的 Key 主要用于 OpenClaw 等外部 AI 平台或工具的集成访问；

2）如需通过企业门户、业务系统或自定义应用调用 DataAgent 开放 API，请参见本文「1.3 开放 API 对接」，不建议使用本页面创建的 Key，以避免安全风险；

3）完整 Key 仅在创建成功后展示一次，请立即复制并妥善保存。

在 Agent 创建过程中，用于扩展 Agent 的可使用数据、技能工具范围。

详情可参考文档：外接MCP。