用途:在 Zavu Cloud 上以代码优先方式构建无服务器 TypeScript 函数,声明式定义 AI 智能体与工具,适合需要自定义工具处理器、查询数据库或调用内部 API、并希望从 Git 仓库获得可复现配置的场景。
主要能力:用 defineAgent 声明智能体(必填 name、provider、model、prompt),用 defineTool 声明工具(name、description、parameters、handler),可选 defineFunction 处理 message.inbound 等事件。部署时从 index.ts 出发,上传所有相对导入可达的文件;npm 依赖写在 package.json 的 dependencies 中。限制为 200 个文件、总计 900,000 字节,拒绝项目根之上的路径、node_modules 及 __zavu 开头的名称。
使用方式:先运行 npx zavudev@latest --version 与 npx zavudev login;用 npx zavudev fn init --name <名称> --template blank 脚手架,或 npx zavudev agents catalog / agents pull <id> 拉取现成智能体。用 npx zavudev fn secrets set 设置密钥,npx zavudev deploy 部署,npx zavudev fn invoke 本地测试工具或事件,npx zavudev agents test 测试智能体回复(加 --execute-tools 会真实执行工具)。HTTP 端点用 --http 创建,npx zavudev fn info 查看 URL。
限制与注意:本地运行前需 npm install;fn invoke 不注入密钥,需用 .env 或 shell 变量;HTTP 调用传入的是 API Gateway v2 原始负载,不是 { type, data } 事件;agents test 默认不执行工具,回复中的数字可能是编造的;部署标记 +、~、= 表示创建、重写、未变。资料未提供具体收费与价格信息。