Conectar Google Vertex AI

Pense no Google Vertex AI como a “sala VIP” dos modelos Gemini do Google — os mesmos modelos excelentes, mas com benefícios empresariais como tarifas estáveis, cobrança pela sua conta do Google Cloud e sem surpresas de limites de uso aleatórios.

Por que não usar apenas uma chave de API comum?

Se você já usou outros provedores de IA, está acostumado a copiar uma chave de API estática para um arquivo de configuração. A Vertex não funciona assim. Em vez de uma chave que nunca muda, a Vertex usa tokens OAuth2 de curta duração — como um cartão de embarque que expira após cerca de uma hora.

A boa notícia? O Hermes Agent cuida de toda a criação e renovação automaticamente. Você nunca toca em um token. É também por isso que você não pode simplesmente colar um token temporário no campo api_key de um provedor personalizado — ele expiraria no meio da conversa e quebraria sua sessão.

O que você vai precisar (Pré-requisitos)

• Um projeto do Google Cloud com a API Vertex AI ativada e cobrança ativa
• Um destes tipos de credencial:
  • Um arquivo JSON de chave de conta de serviço (recomendado para servidores)
  • Credenciais padrão do aplicativo (ADC) via gcloud auth application-default login (ótimo para desenvolvimento local)

Só isso. O Hermes instalará automaticamente o google-auth na primeira vez que você selecionar a Vertex.

Início rápido: Duas opções

Opção A — JSON de conta de serviço (para servidores/gateways)

Basta adicionar uma linha ao seu arquivo ~/.hermes/.env:

echo "VERTEX_CREDENTIALS_PATH=/caminho/para/service-account.json" >> ~/.hermes/.env

Opção B — Credenciais padrão do aplicativo (para desenvolvimento local)

Execute isto no seu terminal:

gcloud auth application-default login

Em seguida, selecione a Vertex como seu provedor:

hermes model

Escolha “More providers…” → “Google Vertex AI” → digite o ID do seu projeto GCP (ou deixe em branco para usar o que está nas suas credenciais) → escolha uma região (padrão: global) → selecione um modelo Gemini.

Por fim, comece a conversar:

hermes chat

Onde as configurações ficam (Explicação simples)

O Hermes divide as configurações da Vertex em dois arquivos com base na sensibilidade:

~/.hermes/.env — contém o ponteiro secreto (o caminho para suas credenciais):

# Use uma destas opções (verificadas nesta ordem); omita ambas para usar ADC:
VERTEX_CREDENTIALS_PATH=/caminho/para/service-account.json
GOOGLE_APPLICATION_CREDENTIALS=/caminho/para/service-account.json

~/.hermes/config.yaml — contém as configurações de roteamento não secretas (ID do projeto e região):

model:
  default: google/gemini-...

Resumo e dica prática

A Vertex AI oferece confiabilidade de nível empresarial com os modelos Gemini, e o Hermes cuida da complicada renovação do token OAuth2 automaticamente. Você só precisa apontar o Hermes para suas credenciais uma vez, e pronto.

Dica de profissional: Se você estiver executando o Hermes em um servidor ou gateway, use sempre o método do JSON de conta de serviço (Opção A) — é mais seguro e previsível do que o ADC. E se você ficar preso em algum momento, execute hermes setup para reparar uma instalação gerenciada se a instalação automática do google-auth falhar. Boas construções!

---