小程序开放平台

文档中心
命令概览
login/logout登录与账号管理
fun 云函数调试
env 云环境相关
agent智能命令行
命令组合使用示例

agent智能命令行

CLI工具
>
CLI命令行全览
>
agent智能命令行
>
更新时间:2025-12-25 11:32:42

rcb agent new
- 创建 AI 智能体模板项目

创建一个新的 AI Agent 项目模板,用于快速开始开发智能体应用。

命令格式

rcb agent new [options]

参数说明

参数
说明
是否必填
-p, --projectName <projectName>
指定项目名称
-d, --dir <dir>
指定项目创建的目标目录,默认为当前目录

使用示例

# 在当前目录创建名为 my-agent 的项目
rcb agent new -p my-agent

# 在指定目录创建项目
rcb agent new -p my-agent -d ./projects

# 使用简写形式
rcb agent new --projectName my-agent --dir ./projects

输出示例

📋 项目创建信息
────────────────────────────────────────
创建目录:   /path/to/projects/my-agent
目录名称:   my-agent
────────────────────────────────────────

✓ 模板文件复制完成

✔️ 项目创建成功: /path/to/projects/my-agent
下一步操作:
  - cd /path/to/projects/my-agent
  - npm install
  - npm run dev

说明

  • 项目名称不能为空
  • 如果目标目录已存在同名项目,会提示错误并退出
  • 创建的项目包含完整的 Agent 开发模板和配置文件
  • 创建完成后需要进入项目目录安装依赖并启动开发服务器

rcb agent dev
- 启动 AI Agent 本地开发服务器

在本地启动 AI Agent 开发服务器,提供模拟器界面进行代码编辑和调试。

命令格式

rcb agent dev [options]

参数说明

参数
说明
是否必填
-d, --dir <dir>
指定服务调试的目录,默认为当前目录
-o, --open
自动打开浏览器访问模拟器
-p, --port <port>
指定 Agent Server 端口,默认自动分配
-sp, --simulatorport <port>
指定 Agent 模拟器端口,默认自动分配
-w, --watch
启用文件监听模式,文件变化时自动重启服务
--enableRedLangfuse
开启 Red Langfuse 上报

使用示例

# 在当前目录启动开发服务器
rcb agent dev

# 指定项目目录并自动打开浏览器
rcb agent dev -d ./my-agent -o

# 指定端口
rcb agent dev -p 3000 -sp 8080

# 开启文件监听模式
rcb agent dev -w

# 组合使用多个参数
rcb agent dev -d ./my-agent -o -w --enableRedLangfuse

输出示例

🚀 [rcb-ff log] 开发环境启动完成!
🚀 [rcb-ff log] 正在打开浏览器访问 localhost:8080

说明

  • 启动后会启动 Agent Server 和模拟器服务
  • 使用
    -o/--open
    参数会自动打开浏览器访问模拟器界面
  • 使用
    -w/--watch
    时,本地文件变更会自动重启服务
  • 端口会自动分配,如果指定端口被占用会自动选择其他可用端口
  • 详细使用说明请参考在小组件内调试本地智能体

rcb agent build
- 打包 AI Agent 为可部署的云函数代码

将本地 Agent 项目打包为可部署的云函数代码包。

命令格式

rcb agent build [options]

参数说明

参数
说明
是否必填
-d, --dir <dir>
指定 agent 项目所在的目录,默认为当前目录
-o, --output <output>
指定构建输出目录,默认为项目目录下的 dist 文件夹
-n, --filename <filename>
指定输出文件名,默认为 agent.zip
-u, --upload
构建完成后自动部署到云端

使用示例

# 在当前目录构建项目
rcb agent build

# 指定项目目录
rcb agent build -d ./my-agent

# 指定输出目录和文件名
rcb agent build -o ./dist -n my-agent-v1.0.0.zip

# 构建并自动部署
rcb agent build -u

# 组合使用多个参数
rcb agent build -d ./my-agent -o ./dist -n agent.zip -u

输出示例

工作目录: /path/to/my-agent
构建项目中...
✓ 构建完成: /path/to/my-agent/dist/agent.zip
文件大小: 2.45 MB
✅ 部署完成

说明

  • 构建流程包括:代码打包、依赖处理、文件压缩等
  • 构建产物为 zip 压缩包,可直接用于部署
  • 使用
    -u/--upload
    参数会在构建完成后自动部署到云端
  • 部署前需要先完成登录:
    rcb login
  • 部署前建议先在本地使用
    rcb agent dev
    进行调试

rcb agent deploy
- 部署 Agent 项目到云端

将已构建的 Agent 项目部署包上传并部署到云端。

命令格式

rcb agent deploy [options]

参数说明

参数
说明
是否必填
-t, --targetPath <targetPath>
指定 agent 产物文件路径
-c, --projectConfig <projectConfig>
指定 project.config.json 项目配置文件,默认为当前目录

使用示例

# 部署指定路径的构建产物
rcb agent deploy -t ./dist/agent.zip

# 指定项目配置文件
rcb agent deploy -t ./dist/agent.zip -c ./project.config.json

# 使用简写形式
rcb agent deploy --targetPath ./dist/agent.zip --projectConfig ./project.config.json

输出示例

✓ 开始部署 agent 项目...
✓ 部署完成 ✅

说明

  • 部署前会进行预检,包括验证 agentId、version 等配置信息
  • version 必须符合 semver 规范(如:1.0.0)
  • 需要先完成登录:
    rcb login
  • project.config.json 必须包含 agentId、version、desc 等必要字段
  • 建议先使用
    rcb agent build
    构建项目,再使用此命令部署