使用智能体

Hermes Agent

前提条件

项目值
Hermes Agent 版本0.15.2
配置文件~/.hermes/config.yaml
环境变量文件~/.hermes/.env
Providerjoytoken
模型名auto
JoyToken Base URL从 环境 选择 JOY_TOKEN_OPENAI_BASE_URL
API Key 环境变量JOY_TOKEN_API_KEY

第 1 步：安装

$pipx install hermes-agent==0.15.2
$hermes --version

第 2 步：写入 API Key

把 jt_xxx 替换成你的 JoyToken API Key，然后执行：

写入 ~/.hermes/.env
$JOY_TOKEN_API_KEY="jt_xxx"
$JOY_TOKEN_OPENAI_BASE_URL="https://api-dev.joytokens.ai/openai/v1"
$
$mkdir -p ~/.hermes
$printf '%s\n' "JOY_TOKEN_API_KEY=\"${JOY_TOKEN_API_KEY}\"" > ~/.hermes/.env
$chmod 600 ~/.hermes/.env

这条命令会写入下面的文件内容，其中 base_url 是 JOY_TOKEN_OPENAI_BASE_URL 对应的具体值：

~/.hermes/.env
$JOY_TOKEN_API_KEY="jt_xxx"

第 3 步：配置 provider

执行下面的命令写入 Hermes provider 配置：

写入 ~/.hermes/config.yaml
$JOY_TOKEN_OPENAI_BASE_URL="${JOY_TOKEN_OPENAI_BASE_URL:-https://api-dev.joytokens.ai/openai/v1}"
$mkdir -p ~/.hermes
$cat > ~/.hermes/config.yaml <<EOF
$model:
$  provider: joytoken
$  default: auto
$
$providers:
$  joytoken:
$    name: JoyToken
$    base_url: $JOY_TOKEN_OPENAI_BASE_URL
$    key_env: JOY_TOKEN_API_KEY
$    default_model: auto
$    transport: chat_completions
$EOF

这条命令会写入下面的文件内容：

~/.hermes/config.yaml
1model:
2  provider: joytoken
3  default: auto
4
5providers:
6  joytoken:
7    name: JoyToken
8    base_url: <JOY_TOKEN_OPENAI_BASE_URL>
9    key_env: JOY_TOKEN_API_KEY
10    default_model: auto
11    transport: chat_completions

第 4 步：验证

$hermes config check

发起一次调用：

$hermes chat \
>  -q "Reply with exactly: pong" \
>  --provider joytoken \
>  -m auto \
>  -Q \
>  --ignore-rules

成功时，返回内容包含 pong。

Hermes 可能会在回复前打印 Python 包或 security scanner 的 warning。只要输出里包含 pong，就说明 JoyToken 调用已经成功。

JoyToken 侧检查

位置应看到
Logs请求路径是 /openai/v1/chat/completions
API Key请求归因到 Hermes 使用的 Key
Usage本次调用产生 tokens 和 credits
Model请求模型是 auto

常见错误

错误处理方式
401 Unauthorized检查 ~/.hermes/.env 里的 JOY_TOKEN_API_KEY
Hermes 仍调用其他 provider检查 ~/.hermes/config.yaml 的 model.provider: joytoken
配置检查失败检查 providers.joytoken.key_env 是否是 JOY_TOKEN_API_KEY
JoyToken 没有日志检查 base_url 是否是 JoyToken OpenAI 兼容地址

相关资源