Agentes de IA

Hermes Agent

O agente de código aberto da Nous Research, que guarda o que aprende como skills.

Conecta com: Login, Chave de API e Skill
Conector: SPREVA
Planos: Gratuito e de código aberto. Você usa o seu próprio provedor de modelos.

Antes de começar

O Hermes Agent instalado.
Uma chave de API, criada no SPREVA em Desenvolvimento, depois Chaves de API.

Configuração

1
Adicione a sua chave de API do SPREVA ao arquivo de segredos do Hermes:
~/.hermes/.env
```
SPREVA_API_KEY=POST_API_KEY_...
```

Adicione o SPREVA em mcp_servers na configuração do Hermes:

~/.hermes/config.yaml

mcp_servers:
  spreva:
    url: "https://dev-app.spreva.ai/api/mcp"
    headers:
      Authorization: "Bearer ${SPREVA_API_KEY}"

3
Em uma sessão do Hermes, rode /reload-mcp ou reinicie o Hermes.
4
Confira se o Hermes alcança o SPREVA:
Terminal
```
hermes mcp test spreva
```

Também funciona com

URL do conector e login
Cole o URL do conector no app, entre no SPREVA e clique em Permitir. Nenhuma chave para guardar em segurança.
Terminal
```
hermes mcp add spreva \
  --url https://dev-app.spreva.ai/api/mcp \
  --auth oauth
```
A CLI e a Agent Skill
Instale a linha de comando spreva e a Agent Skill dela, para agentes que trabalham em um terminal.
Terminal
```
export SPREVA_API_KEY=POST_API_KEY_...
npx -y @spreva/cli skill install --target hermes
```

Confira se funciona

Comece uma nova conversa e pergunte:

Peça ao seu agente

O que sai esta semana no SPREVA?

O Hermes Agent chama a ferramenta overview do SPREVA e responde com o fuso horário do espaço de trabalho, o que sai em seguida e o que precisa de atenção. Na primeira vez, o Hermes Agent pode pedir que você permita a ferramenta.

Bom saber

Para a Agent Skill, adicione SPREVA_API_KEY a terminal.env_passthrough em ~/.hermes/config.yaml. O Hermes mantém os segredos fora dos comandos que roda, a não ser que estejam listados ali.

Solução de problemas

O Hermes se recusa a conectar ao SPREVA

O Hermes não conecta enquanto a chave estiver vazia. Confira se ~/.hermes/.env tem SPREVA_API_KEY e rode /reload-mcp.

Outro problema? Solução de problemas cobre login que volta sempre, planos, limites e fusos horários.