Agent 项目怎样和前端、业务团队对接接口,避免联调时各自理解不同?
先对齐用户流程、各方负责的状态与验收结果,再约定请求字段、权限、错误、超时和版本兼容。Agent 接口还要区分“已接收任务”“处理中”“需要确认”和“最终完成”,不能只提供一段自然语言让前端猜状态。
给出正常、缺字段、越权、超时和重复提交的具体样例,前后端用同一契约做 Mock 与联调。外部副作用要说清谁提交、谁查询最终状态、重试复用哪个标识;模糊之处先确认,不靠双方各自补默认值。
字段或事件变化时说明旧客户端的行为、发布顺序与回退方式。以真实链路的验收结果确认交付,代码合并、接口返回 200 或各自单测通过,都不能单独证明整个业务已打通。
资料
核对于 2026-10-16。OpenAPI specification、HTTP semantics。工程场景与实现取舍由本站解释,不代表原帖公司的实际架构。