API 總覽
從認證、常見接入場景到上線建議，快速了解如何整合 Buda API。
API 總覽
Buda API 面向需要把 Agent 能力接入自家產品、自動化工作流或內部系統的團隊。
常見 API 使用場景
- 把你自己的產品接到 Buda Agent
- 從外部系統觸發工作流或任務
- 在你自己的應用裡讀取 Agent 輸出
- 圍繞 Buda 建立自訂內部工具
接入前先想清楚
- 哪個 Agent 應該負責這個流程
- 你的系統到底需要 Buda 做哪一個動作
- 哪些資料應該放在 Drive，哪些應該在請求時即時傳入
- 先做一個窄而清晰的整合，再逐步擴展
典型接入流程
- 建立或選定目標 Agent。
- 準備它所需的 Drive 文件或結構化輸入。
- 配置應用認證。
- 呼叫對應 API。
- 保存請求日誌和回應記錄，方便排查問題。
認證建議
請把 API 憑證當作正式環境密鑰來管理：
- 不要硬編碼到前端程式碼裡
- 一旦外洩要及時輪換
- 測試環境與正式環境分開
整合設計建議
- 請求盡量小而明確
- 能做到冪等的重試就做冪等
- 記錄請求 ID 和時間戳
- 為 Agent 無法完成的情況設計兜底路徑