Conectar Google Vertex AI

Piensa en Google Vertex AI como la “sala VIP” de los modelos Gemini de Google: los mismos modelos excelentes, pero con ventajas empresariales como tarifas estables, facturación a través de tu cuenta de Google Cloud y sin sorpresas de límites de velocidad aleatorios.

¿Por qué no usar simplemente una clave de API normal?

Si has usado otros proveedores de IA, estás acostumbrado a copiar una clave de API estática en un archivo de configuración. Vertex no funciona así. En lugar de una clave que nunca cambia, Vertex utiliza tokens OAuth2 de corta duración, como un pase de abordar que caduca después de aproximadamente una hora.

¿La buena noticia? Hermes Agent se encarga de la creación y renovación automáticamente. Tú nunca tocas un token. Esta es también la razón por la que no puedes simplemente pegar un token temporal en el campo api_key de un proveedor personalizado: caducaría a mitad de la conversación y rompería tu sesión.

Lo que necesitarás (requisitos previos)

• Un proyecto de Google Cloud con la API de Vertex AI habilitada y facturación activa
• Uno de estos tipos de credenciales:
  • Un archivo de clave JSON de cuenta de servicio (recomendado para servidores)
  • Credenciales predeterminadas de la aplicación (ADC) mediante gcloud auth application-default login (ideal para desarrollo local)

Eso es todo. Hermes instalará automáticamente google-auth la primera vez que selecciones Vertex.

Inicio rápido: dos opciones

Opción A — JSON de cuenta de servicio (para servidores/gateways)

Solo añade una línea a tu archivo ~/.hermes/.env:

echo "VERTEX_CREDENTIALS_PATH=/ruta/a/tu/cuenta-de-servicio.json" >> ~/.hermes/.env

Opción B — Credenciales predeterminadas de la aplicación (para desarrollo local)

Ejecuta esto en tu terminal:

gcloud auth application-default login

Luego selecciona Vertex como tu proveedor:

hermes model

Elige “Más proveedores…” → “Google Vertex AI” → introduce tu ID de proyecto de GCP (o déjalo en blanco para usar el que está en tus credenciales) → elige una región (por defecto: global) → selecciona un modelo Gemini.

Finalmente, comienza a chatear:

hermes chat

Dónde viven los ajustes (desglose simple)

Hermes divide la configuración de Vertex en dos archivos según su sensibilidad:

~/.hermes/.env — contiene el puntero secreto (la ruta a tus credenciales):

# Usa una de estas (se verifican en este orden); omite ambas para usar ADC:
VERTEX_CREDENTIALS_PATH=/ruta/a/tu/cuenta-de-servicio.json
GOOGLE_APPLICATION_CREDENTIALS=/ruta/a/tu/cuenta-de-servicio.json

~/.hermes/config.yaml — contiene los ajustes de enrutamiento no secretos (ID de proyecto y región):

model:
  default: google/gemini-...

Resumen y consejo práctico

Vertex AI te ofrece fiabilidad de nivel empresarial con los modelos Gemini, y Hermes gestiona automáticamente el complicado refresco de tokens OAuth2. Solo tienes que apuntar Hermes a tus credenciales una vez, y listo.

Consejo profesional: Si ejecutas Hermes en un servidor o gateway, usa siempre el método de JSON de cuenta de servicio (Opción A): es más seguro y predecible que ADC. Y si alguna vez te quedas atascado, ejecuta hermes setup para reparar una instalación gestionada si la instalación perezosa de google-auth falla. ¡Feliz construcción!

---