AI Agent 管理
v3.0.0+
tcb agent 命令自 v3.0.0 起提供。
tcb agent 命令用于管理 CloudBase AI Agent（智能体），支持创建、查询、更新和删除。每个 Agent 底层由云函数提供计算能力，CLI 统一封装了代码上传、配置和生命周期管理。
什么是 CloudBase AI Agent
CloudBase AI Agent 是运行在云函数之上的智能体，适合需要长连接、长时间运行的 AI 应用场景（默认超时 7200s）。
tcb agent create
创建 AI Agent。
tcb agent create --name <name> [options]
参数
| 参数 | 说明 | 默认值 |
|---|---|---|
--name <name> | Agent 名称（必填） | — |
-e, --env-id <envId> | 环境 ID | — |
--agent-id <agentId> | 自定义 Agent ID（不填则自动生成） | — |
--code [path] | 本地代码路径（不填则取当前目录），自动打包上传 | 当前目录 |
--runtime <runtime> | 运行时版本 | — |
--timeout <seconds> | 超时时间（秒） | 7200 |
--memory-size <mb> | 内存大小（MB），64 或 128–3072 | 128 |
--install-dep | 自动安装依赖（部署时不含 node_modules 时使用） | — |
--ignore <patterns> | 忽略文件模式，逗号分隔 | .git,node_modules,.DS_Store |
--env <K=V,...> | 环境变量，格式 KEY1=VALUE1,KEY2=VALUE2 | — |
--json | 输出 JSON | — |
示例
# 最简创建（代码取当前目录）
tcb agent create --name my-agent -e my-env-id
# 指定代码目录和运行时
tcb agent create --name my-agent --code ./agent-code --runtime Nodejs20.19 -e my-env-id
# 传入环境变量（供 Agent 代码读取）
tcb agent create --name my-agent \
--env "OPENAI_API_KEY=sk-xxx,MAX_TOKENS=4096" \
-e my-env-id
tcb agent list
查看已创建的 Agent 列表。
tcb agent list [options]
参数
| 参数 | 说明 | 默认值 |
|---|---|---|
-e, --env-id <envId> | 环境 ID | — |
--limit <n> | 每页数量 | 10 |
--offset <n> | 偏移量 | 0 |
--json | 输出 JSON | — |
示例
tcb agent list -e my-env-id
# 分页查看
tcb agent list --limit 5 --offset 10 -e my-env-id
tcb agent detail
查看单个 Agent 的详细信息，包含底层云函数就绪状态、配置等。
tcb agent detail <agentId> [options]
示例
tcb agent detail agent-xxx -e my-env-id
# 输出 JSON（适合脚本判断就绪状态）
tcb agent detail agent-xxx --json -e my-env-id
tcb agent update
更新 Agent 代码或配置。
tcb agent update <agentId> [options]
参数
| 参数 | 说明 |
|---|---|
--code [path] | 更新代码（默认当前目录） |
--runtime <runtime> | 更新运行时版本 |
--timeout <seconds> | 更新超时时间 |
--memory-size <mb> | 更新内存大小（MB） |
--install-dep | 自动安装依赖 |
--ignore <patterns> | 更新忽略模式 |
--env <K=V,...> | 更新环境变量 |
-e, --env-id <envId> | 环境 ID |
示例
# 仅更新代码
tcb agent update agent-xxx --code ./new-agent-code -e my-env-id
# 更新运行时和超时
tcb agent update agent-xxx --runtime Nodejs20.19 --timeout 3600 -e my-env-id
tcb agent delete
删除 Agent 及其底层云函数/云托管资源（不可恢复）。
tcb agent delete <agentId> [options]
参数
| 参数 | 说明 |
|---|---|
-y, --yes | 跳过确认提示（适合脚本/CI 调用） |
-e, --env-id <envId> | 环境 ID |
--dry-run | 模拟运行，仅预览将要删除的 Agent 和底层资源，不实际执行 |
示例
# 交互确认后删除
tcb agent delete agent-xxx -e my-env-id
# 预览将要删除的资源（不实际执行）
tcb agent delete agent-xxx --dry-run -e my-env-id
# 跳过确认（脚本场景）
tcb agent delete agent-xxx --yes -e my-env-id
注意
删除 Agent 会同时清理底层云函数资源，操作不可撤销。建议先使用 --dry-run 预览。