数据服务智能助手是API 全生命周期智能管理工具。它允许用户通过自然语言描述需求,自动完成 API 的逻辑构建、参数解析、环境测试及上线发布,极大地降低了数据接口开放的技术门槛。
助手入口与意图识别
访问路径:在首页点击“数据服务智能助手”进入对话界面。
智能导引:助手会根据您的输入,自动识别以下意图:
创建类:基础模式创建、脚本模式(SQL)创建。
运维类:测试、上线、下线、复制、删除。
查询类:查询 API 列表、查看 API 详情。
核心场景操作步骤
脚本模式创建 API(SQL 脚本)
适用于需要复杂逻辑查询的场景,助手将通过 AI 自动生成 SQL 并解析参数。
输入需求:输入如“帮我写一个 API,查询事故 ID 对应的地点和车辆类型”。
选择数据源:助手引导您确认 API 类型(如 SQL 脚本 API)及目标数据源(如 MySQL 行业专用库)。
智能 SQL 生成与解析:
助手自动生成 SQL 骨架,并支持点击“SQL 解析”提取参数。
参数配置:系统根据解析结果自动生成“请求参数”和“返回参数”列表,您可进行细节微调。
基础信息完善:配置 API 标识、协议(http/https)、请求方法(POST/GET)及超时时间。
API 测试与结果校验
在发布前,助手引导您进行真实环境测试以确保接口可用性。
点击“测试”后,助手根据参数类型推荐合理的测试输入值。
执行测试:点击“执行测试”,侧边栏将实时展示请求详情(JSON 结构)与响应体。
结果处理:
成功:展示响应代码及数据内容,支持“保存为示例”。
失败:助手进行智能根因分析(如 SQL 语法错误或数据源连接超时)。
API 运维管理
上线/下线:通过对话输入“上线 XXX API”,助手将执行发布前检查(如测试是否通过),确认后返回 API 调用路径。
查询:支持查询 API 列表(展示前 20 条)。