Hermes Agent Tutorial de Configuração
Os modelos, fornecedores e endpoints personalizados do Hermes Agent estão armazenados em ~/.hermes/config.yaml; informações sensíveis como API Key estão armazenadas em ~/.hermes/.env. O ai2save utiliza a interface OpenAI Compatible, e Base URL é https://ai2save.com/v1.
1. Criar API Key
- Abra https://ai2save.com/keys.
- Crie a chave e selecione o grupo que inclui o modelo desejado.
- Copie a Key completa do
sk-.... - Anote o ID real do modelo exibido no console, por exemplo,
gpt-5.5.
2. Recomenda-se usar o assistente interno
Execute no terminal:
hermes model
Selecione conforme as instruções:
Custom endpoint (self-hosted / vLLM / etc.)
Digite na ordem:
API base URL: https://ai2save.com/v1
API key: sk-sua-chave-api
Model name: gpt-5.5
O guia irá escrever esses valores em ~/.hermes/config.yaml. Não escreva Base URL em .env; a convenção oficial da Hermes é que a configuração do endpoint do modelo vem de config.yaml.
3. Editando manualmente o arquivo de configuração
Edite ~/.hermes/config.yaml:
model:
provider: custom
default: gpt-5.5
base_url: https://ai2save.com/v1
key_env: AI2SAVE_API_KEY
Descrição dos campos:
provider: custom: Use qualquer endpoint OpenAI Compatible.default: ID do modelo padrão, deve coincidir exatamente com o ID do modelo disponível no console.base_url: Deve vir acompanhado de/v1, Hermes fará solicitações de/chat/completionscom base nisso.key_env: Refere-se ao nome da variável de ambiente onde a chave é armazenada.
Editar ~/.hermes/.env:
AI2SAVE_API_KEY=sk-sua-chave-api
.env armazena informações sensíveis, config.yaml armazena configurações de modelo não sensíveis. Não envie .env para o Git.
4. Usando comandos de configuração para escrever
Você também pode usar os comandos integrados do Hermes, evitando erros de indentação YAML:
hermes config set model.provider custom
hermes config set model.default gpt-5.5
hermes config set model.base_url https://ai2save.com/v1
hermes config set model.key_env AI2SAVE_API_KEY
hermes config set AI2SAVE_API_KEY sk-sua-chave-api
hermes config check
AI2SAVE_API_KEY é o nome da variável de ambiente em maiúsculas, Hermes escreverá automaticamente em ~/.hermes/.env.
5. Reiniciar e verificar
- Saia completamente da sessão atual do Hermes ou Gateway.
- Reinicie o Hermes.
- Crie uma nova sessão e envie uma pergunta curta.
- Na sessão, digite
/modelpara confirmar que o modelo atual écustom/gpt-5.5ougpt-5.5.
Uso temporário do modelo especificado:
hermes chat --provider custom --model gpt-5.5
Para a primeira verificação, recomenda-se desativar tarefas paralelas e ferramentas complexas, enviando apenas textos curtos. Após a autenticação e a conexão com o modelo, ative gradualmente ferramentas como terminal, web e arquivo.
6. Erros comuns
- 401 / invalid_api_key:
AI2SAVE_API_KEYnão existe ou o valor está incompleto. Executehermes config get model.key_envpara verificar a referência. - 404 / model not found:
model.defaultnão é um ID de modelo real disponível no console. - Falha na conexão:
base_urldeve serhttps://ai2save.com/v1; não escreva comohttps://ai2save.com. - Configuração não aplicada: o antigo
OPENAI_BASE_URLafeta apenasopenai-apiProvider, e não será aplicado automaticamente emcustom; verifiqueconfig.yamlemmodel.base_url. - Falha ao analisar YAML: não deve haver blocos
model:duplicados; combine todos os campos em um único bloco. - Exceção na chamada de ferramenta: primeiro, confirme se o modelo suporta tool calling e use uma solicitação de texto curto para estabelecer a linha de base antes de ativar o conjunto de ferramentas.