Configuração do Hermes Agent

Uma conexão. Todos os sete modelos.

Configure seu agente uma vez e troque de modelo e esforço de raciocínio na mesma sessão.

Baixar ZIP de configuração com todos os modelos ↗

InterfaceSistema operacional

Prefere pular a configuração manual? Peça à IA para fazer isso por você.

Prompt de configuração com IA

Siga https://siapi.ai/pt-br/docs/hermes?model=deepseek-flash&surface=cli&platform=macos para conectar meu Agent a todos os modelos SI-API. Preserve as configurações existentes e peça minha chave de API quando necessário.

GLM 5.3 Flash
DeepSeek V4.1 Flash
Kimi K3.1 Pro
Kimi K3.1 Pro HighSpeed
GLM 5.3
MiniMax M3.1 Flash
Qwen3.8 Max

Os sete modelos estão neste download. Mantenha a mesma configuração ao trocar de modelo. Obter sua chave de API →

1. Prepare sua ferramenta e sua chave

Instale Hermes Agent pela página oficial. Crie ou copie sua chave SI-API em /pt-br/keys.

Guia oficial de instalação ↗

Selecione o perfil Hermes que pretende usar. Salve config.yaml e .env na pasta desse perfil; o padrão é ~/.hermes.

2. Salve a configuração

Baixe e extraia o ZIP. Substitua YOUR_SIAPI_API_KEY pela sua chave e salve cada arquivo no caminho indicado abaixo. Mescle os campos com o arquivo existente, preservando outros provedores, permissões e preferências. Não substitua toda a configuração existente.

Local da configuração: ~/.hermes

config.yaml

Salvar em: ~/.hermes/config.yaml

Mescle estes campos no arquivo existente, preservando outros provedores, permissões e preferências. Não substitua a configuração inteira. Combine agent.reasoning_overrides e model_overrides, além de providers e model. Os primeiros definem a intensidade inicial por modelo; model_overrides impede o Hermes de enviar Medium automaticamente para MiniMax M3.1. As entradas providers.siapi.models registram os modelos. Para um perfil nomeado, edite o config.yaml desse perfil. Remova um model.base_url antigo que aponte para outro provedor.

Ver ou copiar configuração

config.yaml

Baixar

providers:
  siapi:
    name: SI-API
    api: https://siapi.ai/v1
    key_env: SIAPI_API_KEY
    transport: chat_completions
    default_model: deepseek-flash
    models:
      glm-5.3-flash: {}
      deepseek-flash: {}
      kimi-k3.1-pro: {}
      kimi-k3.1-pro-highspeed: {}
      glm-5.3: {}
      minimax-m3.1: {}
      qwen3.8-max: {}

agent:
  reasoning_overrides:
    "glm-5.3-flash": "max"
    "deepseek-flash": "high"
    "kimi-k3.1-pro": "max"
    "kimi-k3.1-pro-highspeed": "max"
    "glm-5.3": "max"
    "qwen3.8-max": "xhigh"

model_overrides:
  custom:
    minimax-m3.1:
      supports_reasoning: false

model:
  provider: custom:siapi
  default: deepseek-flash

.env.example

Salvar em: ~/.hermes/.env

Adicione esta linha ao .env do perfil ativo e substitua o marcador localmente. Preserve as outras entradas.

Ver ou copiar configuração

.env.example

Baixar

SIAPI_API_KEY=YOUR_SIAPI_API_KEY

3. Inicie seu agente

Inicie uma nova sessão e envie uma mensagem. O modelo inicial é deepseek-flash.

Inicie seu agente

hermes

4. Alterne entre todos os modelos

Após a configuração, escolha qualquer modelo abaixo dentro do agente. A mesma chave e configuração funcionam com os sete modelos; não é necessário baixar ou conectar novamente.

Todos os 7 modelos nesta configuração de agente
Modelo / ID na API	Comando / caminho no seletor	Configurações de raciocínio
GLM 5.3 Flash `glm-5.3-flash`	`/model custom:siapi:glm-5.3-flash`	Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.
DeepSeek V4.1 Flash `deepseek-flash`	`/model custom:siapi:deepseek-flash`	Off, Low, High e Max. Medium / XHigh correspondem a High; Ultra corresponde a Max.
Kimi K3.1 Pro `kimi-k3.1-pro`	`/model custom:siapi:kimi-k3.1-pro`	Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.
Kimi K3.1 Pro HighSpeed `kimi-k3.1-pro-highspeed`	`/model custom:siapi:kimi-k3.1-pro-highspeed`	Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.
GLM 5.3 `glm-5.3`	`/model custom:siapi:glm-5.3`	Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.
MiniMax M3.1 Flash `minimax-m3.1`	`/model custom:siapi:minimax-m3.1`	Use o padrão do modelo. Esta rota não oferece controles personalizados de raciocínio.
Qwen3.8 Max `qwen3.8-max`	`/model custom:siapi:qwen3.8-max`	Off, Low, Medium e XHigh. High / Max correspondem a XHigh, sem níveis adicionais.

5. Escolha o esforço de raciocínio

Envie cada comando separadamente dentro do agente. Com DeepSeek V4.1 Flash, alterne de Low para High antes da próxima mensagem.

Dentro do agente

/reasoning low
/reasoning high

Os níveis de esforço disponíveis dependem do modelo; consulte a tabela acima. O MiniMax M3.1 Flash usa o padrão do modelo.

Padrões de esforço e configurações salvas

Comece com o DeepSeek V4.1 Flash. Escolha Low, envie uma tarefa curta de leitura de arquivo, depois escolha High e repita. Confira a configuração atual após cada alteração.

Effort é a quantidade de raciocínio solicitada. Kimi K3.1 Pro / HighSpeed, GLM 5.3 e GLM 5.3 Flash oferecem Low / High / Max, com raciocínio sempre ativado. Escolha Low para raciocínio mais curto; não há opção Off. O padrão desses modelos é Max, mas o cliente pode substituí-lo. DeepSeek e Qwen têm os níveis próprios listados abaixo.

O MiniMax M3.1 Flash usa o raciocínio padrão. As configurações do MiniMax M3 se aplicam a outro modelo.

As entradas agent.reasoning_overrides fornecidas definem um esforço inicial aceito para cada modelo com controles declarados. Elas têm prioridade sobre agent.reasoning_effort global, inclusive após troca de modelo ou nova sessão. Sem elas, um provedor personalizado pode usar Medium por padrão, valor recusado por Kimi K3.1 Pro / HighSpeed e pelas duas rotas GLM.

Use /reasoning para conferir a configuração e /reasoning low ou /reasoning high para a sessão. Execute /reasoning após cada mudança. --global salva o padrão global alternativo, sem substituir as entradas por modelo. Edite a entrada correspondente em reasoning_overrides para mudar o padrão persistente. /reasoning show e /reasoning hide alteram a exibição, não a intensidade.

No agente · envie cada comando separadamente

/reasoning
/reasoning low
/reasoning
/reasoning high
/reasoning
/reasoning low

Confira agent.reasoning_effort, agent.reasoning_overrides e extra_body do perfil ativo se o valor solicitado diferir. Remova reasoning_effort fixo em extra_body. Se o endpoint recusar o raciocínio e a sessão o desativar, corrija a configuração e inicie outra sessão. Ao trocar para Kimi ou GLM, selecione Low, High ou Max; não mantenha Off de outro modelo.

Resultado esperado: No DeepSeek V4.1 Flash, a configuração muda de Low para High e volta a Low antes da próxima mensagem. Os demais modelos seguem os controles abaixo.

Controles de raciocínio do Hermes ↗

Confira o modelo e execute sua primeira tarefa

Abra um projeto com README.md. Permita que a ferramenta leia o arquivo e envie o prompt abaixo. Confirme a leitura e o retorno de um resumo. Para testar outro modelo, troque pela tabela acima e repita a tarefa.

Na sua ferramenta

/model

Envie esta tarefa na sua ferramenta

Use a ferramenta de leitura de arquivos para ler o README.md deste projeto e resumir sua finalidade em uma frase. Não modifique nenhum arquivo.

Observações sobre a ferramenta

CLI e aplicativo de desktop devem selecionar o mesmo perfil. Confira o provedor exibido antes de enviar uma tarefa.
A busca é configurada separadamente nas ferramentas do Hermes. Revise modelos auxiliares e provedores alternativos se quiser que essas requisições também usem a SI-API.

Referência oficial de configuração ↗ · Configuração do modelo

A conexão não funciona? · Uso

Compatibilidade dos Agents — Versões dos clientes, campos de raciocínio testados e limitações conhecidas.

Baixar instruções de configuração