用途
agent-integration 是 Veris 提供的一个技能，目标是把这个 agent 仓库从「普通的客户 agent 源码」变成「Veris 就绪且可推送」的状态。如果用户提供了 agent 仓库路径，就以此为仓库根目录；否则使用当前工作目录。
核心框架是：agent 是常量，Veris 是测试夹具。Veris 的存在是为了在真实条件下测试 agent，agent 是被测试的对象，Veris 是围绕它的夹具。这一不对称性驱动了该技能中的所有决策。
主要能力
- 安装或校验 veris-cli（优先
uv tool install veris-cli，回退pip install veris-cli），并校验 Veris 登录状态。 - 校验或创建
.veris/目录，按需运行veris env create --self-serve --name "<name>"创建环境。 - 盘点仓库当前的运行方式、基础设施文件、环境变量与密钥、依赖、源码入口点。
- 识别平台托管型 agent（config-only 仓库，如 CrewAI、LangServe、AutoGen、Dify、n8n、Flowise 等）。
- 判定集成接口：HTTP、WebSocket、Email、Function 四类。
- 将每个依赖分类为「用 Veris 模拟 / 打包进容器 / 外部 / 跳过」。
- 选择集成模式与容器架构，生成
.veris/veris.yaml、.veris/Dockerfile.sandbox及支持文件。 - 配置运行时环境变量、校验并推送（
veris env push）。 - 用单个场景加仿真做冒烟验证。
工作方式
工作流分为 8 个阶段（Phase 0–7）：
- Phase 0：引导 Veris 工具链与环境（校验仓库根目录、veris-cli、认证、
.veris/）。 - Phase 1：发现仓库与当前运行时（已有 Veris 状态、基础设施文件、环境与密钥、依赖、源码入口、平台托管型 agent、集成接口）。
- Phase 2：分析依赖与服务策略（分类为 mock、bundle、external、skip）。
- Phase 3：选择集成模式与容器架构。
- Phase 4：生成
.veris/veris.yaml。 - Phase 5：生成
.veris/Dockerfile.sandbox及支持文件。 - Phase 6：配置运行时环境变量、校验并推送。
- Phase 7：用单个场景加仿真做冒烟验证。
该技能提供快进模式：如果用户说「go all the way」「do everything」或预先批准整个流程，可跳过中间检查点，但对外部或不可逆操作（如 veris env create、veris env push、设置真实密钥的 veris env vars set）仍会停下来询问；遇到真正有歧义的权衡也会暂停询问。
核心规则包括：每个主要步骤前先解释将要做什么；对有真实权衡的决策让用户选择；分类依赖或决定集成方式时引用仓库中的具体证据；不要静默保留过时的 Veris 配置；不要生成 .env.simulation；优先使用当前的 actor.channels schema 与规范服务名。
集成约束
- 不允许编写 Python 包装器、shell 垫片或任何在 Veris 与 agent 之间做转换的「适配」代码。
- 不要修改 agent 源码使其在 Veris 中工作；若 agent 假设了 Veris 无法满足的条件，应作为平台缺口记录，或视为 agent 本身在生产中也会出问题的真实缺陷。
- 传输桥（transport bridge）是显式例外：仅在「相同字节、不同网络格式」且框架无法直接配置为 actor 通道格式时允许，且必须作为 agent 仓库中的生产代码（如
app/bridge.py），不能放在.veris/。 - 向评分器上报客户端工具调用是另一项被认可的例外，仅限基于托管语音到语音平台的语音 agent，采用 no-op outside simulation、fire-and-forget fail-soft、只观察不重塑的最小形态。
适用场景
适用于需要把现有 agent 仓库接入 Veris 进行仿真测试的开发者，包括传统应用型 agent（HTTP/WebSocket/Email/Function 入口）以及平台托管型 config-only agent。
限制与暂未提供
该技能要求用户按提示授权安装 veris-cli、登录、创建环境、设置环境变量和推送等操作。关于具体的费用、支持的具体服务清单、各平台适配的完整细节，资料中暂未提供。