接入方式总览
按照工作需要选择浏览器、CLI、SDK、MCP、OpenAPI、Agent Skill、Webhook、自动化或导入。
无论使用哪种工具,都可以连接同一个工作区。不同方式可以组合使用:Agent 通过 MCP 提出修改,人在浏览器里审核,脚本通过 SDK 读取已通过审核的数据。
选择接入方式
Insights 页的渠道列记录贡献来自哪里。点击渠道名称,可以打开对应指南。
| 渠道 | 适合的工作 | 从这里开始 |
|---|---|---|
Web UI(web_ui)/ Browser(browser) | 在浏览器里查看、编辑和审核 | 浏览器快速开始 |
CLI(cli) | 终端操作、脚本和 CI | 安装并连接 CLI |
SDK(sdk) | TypeScript / JavaScript 应用 | 安装并使用 SDK |
MCP(mcp) | 通过 MCP 客户端给 Agent 提供工具 | MCP 连接与 OAuth |
OpenAPI(openapi) | 使用任意语言调用 HTTP 接口 | OpenAPI 与 REST |
Skill(skill) | 让 Agent 学会 Busabase 的工作流程 | 安装 Agent Skills |
Webhook(webhook) | 响应工作区事件 | Webhook 与事件 |
Automation(automation) | 定期执行或由事件触发的工作流程 | 自动化 |
Import(import) | 安装工作区包或恢复备份 | 导入 |
Skill 是 Agent 的操作指南,CLI、MCP 和 HTTP 是它连接工作区的方式。Webhook 把事件发送给另一个系统,该系统可以再通过 CLI、SDK 或 REST 操作工作区。
自动化
定期任务可以由你自己的定时调度器或 CI 工作流程运行 CLI、SDK 或 REST API。需要响应数据变化时,配置 Webhook 与事件。自动化渠道标识贡献的来源,本身不负责配置执行计划。
先通过只读调用确认目标工作区,需要提出修改时使用 Change Requests。在 API 密钥 中只授予任务需要的权限。
导入
从 GitHub 安装可复用的工作区包,请阅读 安装与导出,先预览将创建的内容,再审核提交的内容。将完整备份恢复到空工作区,请阅读 Busabase dump。
确认连接
连接 Cloud 时,先确认账户、API 密钥或 OAuth 授权,以及目标工作区,再读取或修改数据。CLI 指南包含登录和工作区选择步骤,SDK 与 REST 使用相同的服务地址、密钥和工作区 id。本地和私有化部署的连接细节可在各自指南中查看。
其他接入方式:接入方式总览 · CLI · SDK · MCP · OpenAPI / REST · Agent Skills · Webhook