用途:在 Buda API Claws 托管 Agent API 之上搭建一个可用的 agent harness,让模型像同事一样工作。API Claws 托管模型接入、运行时与工具沙箱、Drive 持久记忆、Sessions 会话管理、Spaces 租户隔离及空闲 agent 唤醒/休眠;开发者只需实现身份映射、轮次循环、知识写入、前端界面与密钥边界。
主要能力与用法:基础地址 https://buda.im/api/v1,所有调用使用 Bearer 认证,密钥以 sk_ 开头,仅限服务端保存。先用 curl -s https://buda.im/api/v1/users/me -H "Authorization: Bearer $BUDA_API_KEY" 验证密钥。先确定租户形态(Space 是计费与隔离边界),再在 Developer Space 中创建 Agent(POST /api-agents),用 PUT /api-agents/<agentId>/drive/files 写入持久知识,通过 POST /api-agents/<agentId>/sessions 发起轮次并轮询会话状态(pending、in_progress、waiting_for_input、completed、failed、cancelled),mode 可选 chat、agent、thinking、build-app。前端可用 embed-urls 生成 iframe 地址,或 embed-sessions 下发短期令牌,令牌有效期 60 秒至 24 小时,需实现刷新。
适用场景:设备助手、小程序/扩展、SaaS copilot、客服组件、内部工具等。
限制:Developer Space 初始无免费额度,余额耗尽会返回 API_CLAW_CREDITS_EXHAUSTED;轮询需退避与超时;waiting_for_input 是已结算状态而非失败;不得将 sk_ 密钥暴露给浏览器或设备;Drive 不应写入每轮变化或不愿保留的数据。资料未提供具体价格与更多平台细节。