Buildify Agents

Buildify Agents 是在本地机器上运行的代理程序，通过连接 Buildify Agent Broker，接收平台下发的 AI 编码任务并在本地执行，再将结果、Token 用量与错误信息回传 Broker。

这样你可以在 Buildify 工作流中编排 AI Agent 任务，而实际的代码执行发生在自己的开发机或内网服务器上——代码与凭证不出本地环境。

可用 Agent

Agent	说明	安装包
Buildify Cursor Agent	对接本地 Cursor CLI，执行 `cursor.task` 任务	`@buildify-cli/cursor-agent`
Buildify OpenCode Agent	对接本地 OpenCode CLI，执行 `opencode.task` 任务	`@buildify-cli/opencode-agent`

工具下载

也可前往官网工具下载页面查看安装命令与入口。

工作原理

Buildify 工作流
      ↓ 提交任务（AgentCursorSubmitTaskNode / AgentOpenCodeSubmitTaskNode）
Agent Broker（平台侧）
      ↓ 分发 cursor.task / opencode.task
本地 Agent（buildify-cursor-agent / buildify-opencode-agent）
      ↓ 调用 Cursor / OpenCode CLI
本地工作目录（cwd）
      ↓ 回传结果、Token 用量、错误
Agent Broker → 工作流继续执行

环境要求

两种 Agent 的通用要求：

Node.js 18+
本地 Agent 机器能访问 Buildify Agent Broker 的网络地址
已在 Broker 注册并获得 Token 与 Client ID

各 Agent 的额外要求见对应文档：

Buildify Cursor Agent — 需安装 Cursor CLI 与 Cursor API Key
Buildify OpenCode Agent — 需安装 OpenCode CLI 及所用模型的 Provider 凭证

快速安装

bash

# Cursor Agent
npm install -g @buildify-cli/cursor-agent

# OpenCode Agent
npm install -g @buildify-cli/opencode-agent

安装后按各 Agent 文档完成配置并启动：

bash

# 以 Cursor Agent 为例
buildify-cursor-agent config init
buildify-cursor-agent config set server=<broker-url> token=<token> clientId=<client-id>
buildify-cursor-agent start --logs

在 Buildify 中使用

工作流中通过对应节点提交任务：

节点	对应 Agent
`AgentCursorSubmitTaskNode`	Buildify Cursor Agent
`AgentOpenCodeSubmitTaskNode`	Buildify OpenCode Agent

提交任务时需填写：

Broker 实例
Client ID（须与本地运行的 Agent 配置一致）
Prompt（任务指令）
工作目录 cwd（Agent 机器上的本地路径，不是 Buildify 服务器路径）

关于工作目录

cwd 必须是 Agent 所在机器上的真实路径。若目录可能不存在，请在节点中启用「目录不存在时自动创建」。

文档导航

获取帮助

商务咨询、产品演示与技术支持：business@buildify.com
文档与社区：support@buildify.com（工作日 24 小时内回复）

Buildify Agents ​

可用 Agent ​

工作原理 ​

环境要求 ​

快速安装 ​

在 Buildify 中使用 ​

文档导航 ​

获取帮助 ​