Hermes Agent

O Hermes Agent é um agente open source de linha de comando e de mensagens, da Nous Research. Ele aceita qualquer endpoint que implemente o chat completions da OpenAI, incluindo a Bayle.

Copia as instruções de configuração desta página, para colar no seu agente de código.

Ver o prompt

Me ajude a configurar isto para usar a Bayle AI, uma API compatível com a OpenAI. Guia completo: https://docs.bayle.ai/pt-br/guides/agents/hermes-agent/

Objetivo: apontar o Hermes Agent (https://hermes-agent.nousresearch.com) para a Bayle.

1. Instale o Hermes Agent se `hermes --version` falhar (macOS, Linux e WSL2):
   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
   No Windows nativo, siga https://hermes-agent.nousresearch.com/docs/getting-started/installation.
2. Escolha um modelo com suporte a function calling, já que o Hermes chama ferramentas:
   curl -s "https://api.bayle.ai/models?type=text" \
     | jq -r '.data[] | select(.model_spec.capabilities.supportsFunctionCalling) | .id'
   Me mostre a lista, deixe eu escolher e use esse id como MODEL_ID.
3. Configure por arquivo. A key vai em ~/.hermes/.env como referência à minha BAYLE_API_KEY, nunca como a key literal (se o arquivo já tiver uma linha BAYLE_API_KEY, deixe como está; senão peça que eu mesmo a adicione):
   # ~/.hermes/config.yaml
   providers:
     bayle:
       api: https://api.bayle.ai
       key_env: BAYLE_API_KEY
       transport: chat_completions

   model:
     provider: custom:bayle
     default: MODEL_ID
   Mescle isso com a configuração existente, sem sobrescrevê-la. Como alternativa, posso rodar `hermes model`, escolher "Custom endpoint" e informar a mesma base URL e o mesmo modelo; se eu preferir, me guie.
4. Recursos do Hermes como visão e resumo de páginas web têm configurações de modelo próprias. Avise que esta mudança não os move.
5. Verifique com uma execução curta do Hermes no modelo escolhido, ou um curl em POST https://api.bayle.ai/chat/completions se o Hermes não tiver modo não interativo.

Regras:
1. A base URL é https://api.bayle.ai exatamente como está escrita. Não acrescente nenhum caminho a ela.
2. Leia a key da variável de ambiente BAYLE_API_KEY. Nunca escreva a key em um arquivo que você criar, em um comando, em um commit nem no chat. Onde a ferramenta guarda a key na própria tela de configurações, me diga onde colar. Se BAYLE_API_KEY não estiver definida, pare e peça que eu crie uma key em https://chat.bayle.ai/developers e a exporte.
3. Pegue os ids de modelo só de GET https://api.bayle.ai/models (sem key). Nunca chute um.
4. Termine com uma requisição de teste de verdade, me mostre o resultado e liste os arquivos que você alterou.

Instalação

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Esse é o instalador para macOS, Linux e WSL2. Para Windows e outros métodos, veja o guia oficial de instalação.

Configure de forma interativa

Ainda não tem uma chave da Bayle?Obter chave de API

Rode:

hermes model

Escolha Custom endpoint e informe:

Pergunta	Valor
Base URL	`https://api.bayle.ai`
API key	Sua key da Bayle
Modelo	`MODEL_ID`

Configure por arquivo

O Hermes guarda as configurações em ~/.hermes/config.yaml e os segredos em ~/.hermes/.env. Coloque a key no .env:

BAYLE_API_KEY=your-key

Depois declare a Bayle como provedor nomeado e selecione-a:

providers:
  bayle:
    api: https://api.bayle.ai
    key_env: BAYLE_API_KEY
    transport: chat_completions

model:
  provider: custom:bayle
  default: MODEL_ID

O Hermes acrescenta /chat/completions e /models à base URL sozinho.

Escolha um modelo

O Hermes chama ferramentas, então escolha um modelo com suporte a function calling:

curl -s "https://api.bayle.ai/models?type=text" \
  | jq -r '.data[] | select(.model_spec.capabilities.supportsFunctionCalling) | .id'

Bom saber

Alguns recursos do Hermes, como visão e resumo de páginas web, têm configurações de modelo próprias. Apontar o modelo principal para a Bayle não muda esses; configure cada um se quiser que também rodem na Bayle.

Veja A Bayle como backend de agentes sobre retentativas e erros de saldo.