API 总览
从认证、常见接入场景到上线建议，快速了解如何集成 Buda API。
API 总览
Buda API 面向需要把 Agent 能力接入自家产品、自动化工作流或内部系统的团队。
常见 API 使用场景
- 把你自己的产品接到 Buda Agent
- 从外部系统触发工作流或任务
- 在你自己的应用里读取 Agent 输出
- 围绕 Buda 构建自定义内部工具
接入前先想清楚
- 哪个 Agent 应该负责这个流程
- 你的系统到底需要 Buda 做哪一个动作
- 哪些数据应该放在 Drive，哪些应该在请求时实时传入
- 先做一个窄而清晰的集成，再逐步扩展
典型接入流程
- 创建或选定目标 Agent。
- 准备它所需的 Drive 文件或结构化输入。
- 配置应用认证。
- 调用对应 API。
- 保存请求日志和响应记录，便于排查问题。
认证建议
请把 API 凭证当作生产环境密钥来管理：
- 不要硬编码到前端代码里
- 一旦泄露要及时轮换
- 测试环境和正式环境分开
集成设计建议
- 请求尽量小而明确
- 能做到幂等的重试就做幂等
- 记录请求 ID 和时间戳
- 为 Agent 无法完成的情况设计兜底路径