在 Hermes Agent 中接入 VeriAgent

本文介绍如何在 Hermes Agent 中安装并初始化 VeriAgent 插件。你可以选择通过 npx 命令快速接入，也可以通过 Hermes 插件命令安装 VeriAgent 插件。

完成接入后，你可以在 VeriAgent 平台中继续完成 Agent 信息提交、CSR 生成和数字证书申请。认证完成后，当前 Hermes Agent 将具备 VeriAgent 可信数字身份。

前置条件

开始前，请确认你已满足以下条件：

• 已拥有 VeriAgent 平台账号。
• 已准备好 Hermes Agent 运行环境。
• 已安装 Node.js，建议使用 Node.js 18 或以上版本。
• 已安装 npm / npx，且 npx --version 可正常返回。
• 如需通过 Hermes 插件命令安装，请确认 hermes 命令可正常使用。
• 当前网络可访问 npm、GitHub 和 VeriAgent 平台页面。

注意：Hermes Agent 接入过程中，请不要要求用户提供 token、cookie、授权码或其他敏感凭证。用户只需要打开授权链接并在 VeriAgent 平台页面完成授权。

方式一：通过 npx 快速接入

如果你希望快速完成 VeriAgent 插件安装和初始化，建议使用 npx 方式。

1. 打开终端。

2. 执行以下命令：

   bashCopy

   npx -y @esign-ai/veriagent-cli@latest install

3. 根据终端提示选择或确认 Agent 类型为 Hermes Agent。

4. 等待安装和初始化流程完成。

   命令执行完成后，终端会返回 VeriAgent 平台授权地址。

5. 复制终端返回的授权地址，并在浏览器中打开。

6. 按页面提示完成登录授权。

   授权完成后，回到终端查看执行结果。终端会自动获取授权状态，并根据结果继续完成接入流程或提示下一步处理方式。

说明：npx 方式会安装并初始化 VeriAgent 插件。平台登录授权、Agent 信息填写和数字证书申请仍需在 VeriAgent 平台页面中完成。

方式二：通过 Hermes 插件命令安装

如果你的团队已经通过 Hermes 管理 Agent 插件，可以使用 Hermes 插件命令安装 VeriAgent 插件。

步骤一：安装 VeriAgent 插件

在终端执行：

hermes plugins install https://github.com/esign-ai/hermes-veriagent

该命令会从 GitHub 拉取并安装 Hermes VeriAgent 插件。

步骤二：初始化 VeriAgent 插件

插件安装完成后，在终端执行以下命令启动 VeriAgent 初始化流程：

hermes veriagent init

命令执行完成后，终端会返回 VeriAgent 平台授权地址。

复制终端返回的授权地址，并在浏览器中打开。

注意：授权需要用户在 VeriAgent 平台页面中完成。用户完成授权后，不需要回复“已授权”，终端会自动获取授权结果。不要要求用户提供 token、cookie、授权码或其他敏感凭证。

步骤三：在浏览器中完成授权

用户打开授权链接后，请按页面提示完成以下操作：

1. 登录 VeriAgent 平台。
2. 查看应用授权页面。
3. 确认授权主体和授权范围。
4. 勾选相关协议。
5. 单击 登录并授权。

授权完成后，回到终端查看执行结果。终端会自动获取授权状态，并根据结果继续完成接入流程或提示下一步处理方式。

完成 Agent 认证

打开终端返回的 VeriAgent 平台授权地址后，请按照 Agent 认证快速开始 中的步骤，完成登录授权、Agent 信息提交、CSR 生成和数字证书申请。

验证结果

完成 Hermes Agent 接入并通过 Agent 认证后，你可以通过以下方式确认结果：

1. 在 VeriAgent 平台中查看当前 Agent 的认证状态和证书信息。

   建议重点确认以下信息：

   信息	成功结果
   Agent 状态	显示为活跃
   证书状态	显示为有效
   证书编号	已生成证书编号
   证书有效期	已显示证书起止时间
   运行框架	显示为 Hermes Agent

2. 回到本地 Hermes Agent 环境，确认 VeriAgent 插件和认证信息是否正常。

   你也可以执行以下命令查看插件是否已安装：

   bashCopy

   hermes plugins list

   建议确认以下内容：

   检查项	成功结果
   Hermes 插件	已安装 VeriAgent 插件
   初始化状态	hermes veriagent init 已完成，且不再提示需要继续授权
   Agent 信息	可在 VeriAgent 平台中查看当前 Agent 的认证结果

如果以上信息均正常，说明当前 Hermes Agent 已完成 VeriAgent 接入，并具备继续申请或使用可信数字身份的基础。

下一步

完成 Hermes Agent 接入后，你可以继续阅读 Agent 认证快速开始，完成 Agent 信息提交、CSR 生成和数字证书申请。

如需了解 Agent 数字身份的概念，可继续阅读 什么是 Agent 数字身份。