用途:为 Eve 兼容应用构建领域专用 CLI,使智能体通过命令而非原始 REST 调用与应用交互,减少 URL 拼接、JSON 转义、认证头和错误解析带来的多次 LLM 调用。
主要能力:将 CLI 命令映射到业务领域而非 HTTP 端点;自动从环境变量读取 API 地址与令牌完成认证;默认输出人类可读表格,--json 输出机器可读 JSON;错误写入 stderr 并返回退出码 1;支持单资源自动检测与逐级 --help;可用 esbuild 打包为单文件零依赖二进制,也支持通过 Docker 镜像分发编译型 CLI。
使用方式:在 cli/src 下编写入口、API 客户端与命令模块,用 commander 定义命令;用 esbuild 打包并前置 shebang,注意不要在 package.json 设置 "type": "module";在 .eve/manifest.yaml 的 x-eve.cli 中声明 name 与 bin,平台会自动向带 with_apis 的智能体提供该 CLI。本地测试可设置 EVE_APP_API_URL_API 与 EVE_JOB_TOKEN 后直接运行。
环境变量:EVE_APP_API_URL_{SERVICE}、EVE_JOB_TOKEN、EVE_PROJECT_ID、EVE_ORG_ID 由平台注入,无需手动配置。
适用场景:需要让智能体以稳定、自描述命令操作 Eve 应用 API 的团队。
限制:资料未提供具体收费、价格与效果数据;打包需遵循 CJS 与 shebang 等约束,镜像分发有约 2-5 秒延迟。