# Hermes Agent · SI-API

Todos os 7 modelos da SI-API · uma configuração de agente
Modelo inicial padrão: deepseek-flash
Interface: cli
Sistema: macos

Modelos incluídos: GLM 5.3 Flash (glm-5.3-flash), DeepSeek V4.1 Flash (deepseek-flash), Kimi K3.1 Pro (kimi-k3.1-pro), Kimi K3.1 Pro HighSpeed (kimi-k3.1-pro-highspeed), GLM 5.3 (glm-5.3), MiniMax M3.1 Flash (minimax-m3.1), Qwen3.8 Max (qwen3.8-max).

Os modelos de configuração contêm apenas marcadores. Salve sua chave real localmente. Preserve configurações e permissões não relacionadas.

## 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.

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



## 3. Inicie seu agente

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

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.





### GLM 5.3 Flash · glm-5.3-flash

/model custom:siapi:glm-5.3-flash

Configurações de raciocínio: 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

Configurações de raciocínio: 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

Configurações de raciocínio: 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

Configurações de raciocínio: 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

Configurações de raciocínio: 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

Configurações de raciocínio: 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

Configurações de raciocínio: 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

```text

/reasoning low
/reasoning high

```





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

```text

/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: https://hermes-agent.nousresearch.com/docs/user-guide/configuration

## 6. 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.

/model

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.

## 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.

## .env.example

Salvar em: ~/.hermes/.env

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

## Observações

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.

Off, Low, High e Max. Medium / XHigh correspondem a High; Ultra corresponde a Max.

Referência: https://hermes-agent.nousresearch.com/docs/integrations/providers/

Configuração dos modelos: https://siapi.ai/pt-br/docs/models#configuration

Compatibilidade dos Agents: https://siapi.ai/pt-br/docs/compatibility
