[实验性] 在不运行构建管道的情况下在本地验证代理.yaml。
Synopsis
根据平台模式(包括网络策略规则)验证代理.yaml。捕获构建管道稍后会拒绝的拼写错误和无效值。
默认路径为 ./agent.yaml。传递路径以验证其他位置的文件,例如 monorepo 工作区。
成功时退出 0,验证失败时退出 1,文件/IO 错误时退出 2。
当 artifact_repositories 非空时,validate 还会交叉检查 pyproject.toml 和 uv.lock (Python) 或 package.json、.npmrc、以及 包-锁.json (Typescript) 和 代理.yaml。允许使用未声明的锁文件 URL。登录后,缺失或范围错误的构建密钥会向 stderr 打印警告;--strict 会将其转换为退出 1。
声明连接器时,如果工具沙盒缺少连接器的托管和端口,或者在 sandboxes 块中缺少其身份验证名称的密钥,或者缺少其目录定义的工具的 sandboxes.tool.tools 条目,则验证失败。--fix 将缺失的条目写入 agent.yaml,使用该文件已有的 egress 格式,保留其注释,并且绝不会添加 sandboxes 块。
实验性:随着验证器覆盖更多的 agent.yaml 子树,标志、格式和退出代码可能会发生变化。验证规则来自构建所使用的相同代码路径。
此命令用于验证清单。运行由 agentengine init 安装的功能验证技能,以根据 SDK 支持的形状检查框架代码。
agentengine agent validate [path] [flags]选项
--fix Write the egress rules, tool sandbox secrets and tool sandbox tools that connectors need to agent.yaml-h, --help help for validate --strict Treat artifact registry secret warnings as errors (exit 1)从父命令继承的选项
--log-file string override log file path --log-level string file log verbosity (error|warn|info|debug) (default "info") --no-log disable file logging-q, --quiet silence stderr below error-v, --verbose count raise stderr verbosity (-v info, -vv debug)另请参阅
- agentengine 代理 - 检查、编辑和生成代理配置。