大模型智能助手 Agent 接口规范.docxVIP

大模型智能助手Agent接口规范

大模型智能助手与Agent接口规范文档

文档前言

本文档旨在定义大模型智能助手与智能体（Agent）的统一接口标准，涵盖请求格式、响应格式、字段语义、枚举值规范及设计原则，用于指导前后端开发、内部服务对接，确保接口交互语义一致、结构稳定、可扩展、可维护，降低对接成本，适配多轮对话、智能体执行、工具/函数调用等核心业务场景。

文档基本信息

项目

内容

文档版本

V1.0

适用范围

前后端开发、测试、运维人员，内部服务对接人员

适用场景

多轮对话、智能体（Agent）执行、工具调用、函数调用、统一前后端交互

修订日期

2026-03-03

1.基础约定

为确保接口交互的一致性和规范性，所有相关接口需严格遵循以下基础约定，前后端统一执行，不得擅自修改。

请求方式：统一采用POST方法，确保数据传输的安全性和完整性。

数据格式：请求与响应均采用JSON格式，设置Content-Type:application/json。

字段风格：所有字段命名统一使用小驼峰（camelCase）格式，避免使用下划线、中划线等其他格式。

历史对话：统一使用context字段存储历史对话上下文，禁止使用messages字段，避免语义混淆。

响应结构：所有接口的响应结构保持全局统一，无论成功或失败，均遵循固定格式返回。

2.请求格式（前端→后