当 Hermes Agent 开始接入真实业务系统后一个问题会很快变得具体这个 Agent 到底是谁它代表哪个业务或团队在执行任务它后续调用某个工具、触发某个流程、生成某份结果时系统如何确认调用方确实是这个 Agent而不是被冒充的请求这就是 Agent 数字身份要解决的问题。如果把 Agent 看作一个可以持续执行任务的数字员工那么它也需要一张可以被系统识别、校验和管理的“身份证”。在 VeriAgent 里这张身份证不是一个普通编号而是Agent 平台身份记录 X.509 数字证书的组合前者用于平台侧管理后者用于后续身份识别、证书校验、Skill 签名验签等技术场景。本文面向已经在本地使用 Hermes Agent、希望为 Agent 建立可验证数字身份的开发者。完成本文操作后你的 Hermes Agent 会在 VeriAgent 平台生成一条身份记录并申请到对应的 X.509 数字证书。根据你的环境可以选择下面任意一种命令行安装方式方式一推荐通过 npx 一行命令安装并初始化 VeriAgent 插件npx-yesign-ai/veriagent-clilatestinstall方式二通过 Hermes 插件命令安装hermes pluginsinstallhttps://github.com/esign-ai/hermes-veriagent hermes veriagent init两种方式的最终效果一致都会在 Hermes Agent 环境中安装 VeriAgent 插件并返回 VeriAgent 平台授权链接用于进入 Agent 身份认证流程。区别在于 npx 方式自动化程度更高Hermes 插件命令更适合已经通过 Hermes 管理插件的团队。下面我把两种方式的完整流程都走一遍。两种安装方式怎么选安装方式适合人群特点npx 一键安装第一次接入 VeriAgent、想快速跑通流程的用户自动完成插件安装、初始化并在终端返回授权链接Hermes 插件命令安装已经通过 Hermes 管理 Agent 插件的用户安装过程更手动命令路径更贴近 Hermes 插件管理习惯如果你只是想快速体验建议直接使用 npx 方式如果你所在团队已经统一通过 Hermes 插件命令管理插件可以选择第二种方式。说明如果你的 Hermes Agent 已经支持通过自然语言发起 VeriAgent 安装可以参考《Hermes Agent 通过自然语言接入 VeriAgent从一句话到数字身份认证》。本文聚焦命令行安装流程。环境准备开始前确认你的机器满足以下条件环境项要求Node.js已安装 Node.js建议使用 Node.js 18 或以上版本npm / npxnpx --version可正常返回Hermes Agent已准备好 Hermes Agent 运行环境hermes 命令如需使用 Hermes 插件命令安装hermes命令需可正常使用网络可访问 npm、GitHub 和 VeriAgent 平台页面账号有一个已注册并可正常登录的 VeriAgent 平台账号验证环境可用npx--versionhermes--version如果你准备使用npx 方式至少需要确认npx --version正常返回如果你准备使用Hermes 插件命令方式还需要确认hermes --version正常返回。说明如果你的机器在企业内网或代理环境中需要确保终端可以访问 npm 包源、GitHub 插件仓库以及 VeriAgent 平台。第一步安装插件方式一npx 一行命令在终端执行npx-yesign-ai/veriagent-clilatestinstall各参数的含义npx直接从 npm 仓库拉取并执行不需要手动安装依赖-y自动确认安装提示esign-ai/veriagent-clilatest使用最新版 VeriAgent CLIinstall执行完整的插件安装和初始化流程这条命令会完成下载并启动 VeriAgent CLI检查当前 Agent 环境根据终端提示选择或确认 Agent 类型为 Hermes Agent安装 VeriAgent Hermes 插件启动初始化流程在终端输出授权链接需要注意的是npx 方式不是安装 Hermes Agent 本身而是在已有 Hermes Agent 环境中安装 VeriAgent 插件并启动初始化流程。它不会替你完成平台登录、授权、意愿认证和证书申请这些步骤仍然需要你在浏览器页面中按提示确认。提示命令执行完成后终端会返回授权链接。复制该链接到浏览器中打开即可进入 VeriAgent 平台页面。方式二通过 Hermes 插件命令安装如果你的 Hermes Agent 已经配置好并在使用中可以通过 Hermes 插件命令安装。第 1 步安装 VeriAgent 插件hermes pluginsinstallhttps://github.com/esign-ai/hermes-veriagent这条命令会从 GitHub 拉取并安装 Hermes VeriAgent 插件。第 2 步初始化 VeriAgenthermes veriagent init初始化完成后终端会返回授权链接。复制该链接到浏览器中打开即可进入 VeriAgent 平台页面。提示如果没有看到授权链接可以检查终端输出是否完整或重新执行初始化命令。第二步登录并授权安装或初始化完成后终端会返回 VeriAgent 平台授权链接。复制该链接到浏览器中打开进入 VeriAgent 平台页面。系统会检查你的登录状态。如果没有登录按页面提示登录 VeriAgent 平台账号。登录后会进入应用授权页面查看授权信息包括授权主体和授权范围勾选相关协议点击登录并授权这一步用于授权 VeriAgent 平台创建和管理当前账号下的 Agent 身份记录包括发起认证、签发证书、查看证书状态等。具体授权范围以页面展示为准建议在点击前确认授权主体和授权内容。授权不等同于跳过认证流程。后续的 Agent 身份信息填写、责任声明确认和意愿认证仍然需要你主动完成。完成浏览器授权后回到终端查看执行结果。流程会根据授权状态继续完成接入或提示你重新打开链接、重新授权、检查网络等下一步处理方式。第三步开始认证进入认证智能体页面后平台会识别当前 Hermes Agent 环境准备为 Agent 建立认证记录。点击开始认证。如果页面没有识别到当前环境可以回到终端检查VeriAgent Hermes 插件是否安装成功初始化命令是否正常执行终端是否仍在等待后续处理网络连接是否正常第四步填写 Agent 身份信息页面会要求你确认或补充以下信息字段填写建议说明智能体名称使用清晰的业务名称例如“客户支持 Agent”“合同审核 Agent”后续会用于平台列表、证书记录和团队识别智能体描述一句话说明这个 Agent 的主要用途和调用边界方便后续判断该 Agent 的职责范围运行框架选择当前使用的框架例如 Hermes Agent用于标识 Agent 的运行环境监护人信息填写真实负责人用于责任归属、证书管理和后续联系填写完成后勾选责任声明点击提交信息提交后系统进入 CSRCertificate Signing Request证书签名请求生成阶段。第五步等待生成 CSR这一步通常不需要你手动操作。CSR 是申请数字证书时使用的证书签名请求。简单理解它会携带 Agent 的身份相关信息用于向平台申请对应的数字证书。在这个过程中本地 VeriAgent 插件会配合平台完成 CSR 生成和提交。之所以需要保持终端运行是因为 CSR 生成动作由本地插件配合完成页面需要等待本地插件返回生成结果。你只需要保持终端运行不要关闭浏览器页面保持网络连接正常页面显示等待终端生成 CSR时耐心等待即可。如果长时间无变化优先查看终端是否有报错。第六步申请数字证书CSR 生成完成后页面进入申请数字证书步骤点击去认证在弹窗中选择认证方式短信 / 密码 / 人脸按提示完成认证勾选协议点击确认这里的授权和意愿认证用于确认 Agent 负责人/授权主体并完成后续证书签发。具体认证方式、协议内容和授权范围以页面实际展示为准。认证通过后平台会为 Hermes Agent 签发 X.509 数字证书。页面提示证书申请成功即表示签发完成。这张证书可以理解为 Agent 的数字身份证明。后续在进行身份识别、证书校验、Skill 签名验签等场景时平台和相关工具可以基于这张证书确认 Agent 的身份状态。第七步查看认证结果证书签发完成后进入智能体管理页面查看结果。列表页建议确认智能体状态活跃证书状态有效运行框架正确显示为 Hermes Agent创建时间当前时间详情页建议确认Agent ID证书编号证书状态和有效期监护人信息如果这些信息完整说明你的 Hermes Agent 已经拥有了独立的数字身份。也可以在终端侧检查插件是否安装成功hermes plugins list在插件列表中确认 VeriAgent 插件已安装。如果你是通过 Hermes 插件命令安装的也可以再次执行初始化命令确认状态hermes veriagent init如果不再提示需要继续授权说明本地初始化流程已经完成。流程小结整体流程可以概括为安装 VeriAgent Hermes 插件 → 打开终端返回的授权链接 → 登录并授权 → 填写 Agent 身份信息 → 本地生成 CSR → 完成意愿认证 → 签发 X.509 数字证书 → 在智能体管理页查看认证结果如果使用 npx 方式插件安装和初始化由一条命令自动完成如果使用 Hermes 插件命令方式需要先安装插件再执行初始化命令。两种方式都会返回授权链接用户需要手动复制链接到浏览器中打开。其中最费时间的通常是等待 CSR 生成和完成意愿认证。网络正常、认证材料齐全时通常几分钟内可以完成如果遇到企业代理、GitHub 访问受限或认证方式切换耗时会相应增加。常见问题两种安装方式有什么区别最终效果一致都会安装 VeriAgent Hermes 插件并返回授权链接。npx 方式自动化程度更高适合快速上手Hermes 插件命令方式更适合已经通过 Hermes 管理插件的用户。执行 npx 命令后没有看到 Hermes Agent 选项怎么办先确认本地 Hermes Agent 环境是否准备好再检查终端输出是否有环境检测失败、网络访问失败或依赖安装失败等提示。如果命令执行中断可以修复环境后重新执行npx-yesign-ai/veriagent-clilatestinstall执行 hermes plugins install 失败怎么办重点检查hermes命令是否可正常使用当前网络是否可访问 GitHub插件地址是否完整终端是否有权限写入 Hermes 插件目录可以先执行hermes--version确认 Hermes 命令本身可用后再重新安装插件。如果仍然失败建议保留完整终端输出重点查看是否是网络、权限、插件仓库访问或 Hermes 插件目录写入失败。安装命令执行后没有看到授权链接怎么办确认终端命令是否执行完成并检查输出中是否包含授权链接。如果没有看到链接可以先检查网络、Hermes Agent 环境和插件安装状态再重新执行安装或初始化命令。页面一直停留在“等待生成 CSR”怎么办检查终端是否仍在运行网络是否正常Hermes Agent 环境是否正常VeriAgent 插件是否安装成功终端是否有报错信息如果终端已中断可以重新执行安装或初始化命令后再试。授权时需要提供 token、cookie 或授权码吗不需要。Hermes Agent 接入过程中用户只需要打开授权链接并在 VeriAgent 平台页面完成授权。不要在终端、对话窗口或其他地方输入 token、cookie、授权码等敏感凭证。证书申请失败怎么办检查是否已完成登录和授权Agent 身份信息是否填写完整意愿认证是否成功是否已勾选协议终端是否出现 CSR 或网络相关报错如果仍然失败建议保留页面截图和终端报错信息联系 VeriAgent 技术支持。安装完成后你还可以做什么Hermes Agent 拿到身份证只是第一步。接下来你可以在平台管理 Agent 身份查看状态、证书有效期、更新监护人为你的 Skill 做签名验签确保 Agent 调用的能力包没有被篡改接入更多 Agent为不同业务场景中的 Agent 建立独立身份为后续审计和责任归属打基础身份记录和证书状态可以作为 Agent 治理的基础信息当 Agent 从“能执行任务”走向“能接入业务系统”时身份会变成基础设施的一部分。给 Hermes Agent 发一张可验证的数字身份证是把 Agent 纳入可信治理的第一步。VeriAgent 官网https://www.veriagent.ai/
