平台侧 API

按单一能力接入、最小调用验证、上下文扩展和失败处理的顺序联调业务接口。

功能概述

平台侧 API 主要服务于业务系统接入。
它让外部系统能够调用 Agent、触发工作流、管理对话、文件和知识能力。

适合：

开始前建议确认：

第一次联调时，不要同时接多个 Agent、工作流和文件接口。
建议只选一种能力，例如：

先把一条链路跑通，再继续扩展。

先用最简单的请求确认：

只有这一步成功后，后面的上下文和业务参数才值得继续加。

基础调用通过后，再逐步加入：

建议每次只增加一类参数，便于定位问题来源。

业务系统接入时，应提前定义：

如果接口返回结果异常，不要只盯着调用方代码。
应回到平台中的 Agent 或工作流页面，确认应用本身是否配置正确。

平台侧 API 接入完成后，至少应满足：

常见原因是应用本身配置不正确，例如提示词、知识库或工作流节点有问题。

因为一旦出问题，你很难判断是鉴权、参数、文件、上下文还是应用配置导致的。

因为平台侧 API 最终调用的仍然是平台里的实际应用能力，而不是一个完全独立的后端接口。