开发集成
API 调用
通过平台 API 调用项目、模块、智能体和运行时能力。
使用平台 API,可以把百积木中的项目、模块、智能体和运行时能力接入自有系统。
调用原则
- 服务端保存长期密钥,浏览器端只使用短期身份凭据。
- 请求应带上明确的工作区、项目或运行时上下文。
- 失败响应需要保留请求编号或日志线索。
调用检查
发起调用后,先确认权限校验通过,再确认工作区和项目上下文,最后查看目标模块、智能体或后端服务的运行日志。
通过 HTTP 修改项目源码
没有 CLI 或 Git 执行环境的 AI,可以通过 Project Git Service 的 JSON 接口批量创建、修改和删除文件并提交。认证、仓库读取、分支策略、提交格式和合并步骤见 项目:没有 CLI 时通过 HTTP 提交文件。
Bundle 资源作者 API
Bundle 内作者操作统一使用 /partner/v1/bundle-service 前缀。原请求方法、参数与响应形状保持,以下后缀由 Bundle Service 提供:
| 对象 | 服务内路径族 |
|---|---|
| Module | /api/modules 与 /api/bundles/{bundleId}/modules/** |
| Agent | /api/agent-config/workspace 与 /api/bundles/{bundleId}/agents/{agentKey}/versions/** |
| Skill | /api/agent-skills 与 /api/bundles/{bundleId}/skills/{skillKey}、其 /versions |
| Platform Application | /api/platform-applications/create、info、update、delete、versions/create、versions/list、bundle-ownership/transfer-resource、source-project/transfer |
| Timer、Workflow、Event Trigger、Permission、Role、Gateway | 继续使用 /api/bundles/{bundleId}/authoring/** 中各资源的正式作者入口 |
旧资源 Owner 前缀下的对应作者入口退役;平台应用 create-with-project 改用 create。应用独立目录、安装态记录、入口地址与 Runtime API 继续使用各自原合同。不要把作者权限当作运行权限,也不要把资源定义服务的内部路径作为公开接口。