百积木文档
开发集成

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 继续使用各自原合同。不要把作者权限当作运行权限,也不要把资源定义服务的内部路径作为公开接口。

本页内容