Saltar al contenido
ES
Añadir a Chrome

Conecta un agente Hermes

Guía prácticaNuevo

Para quien tiene un agente Hermes en un equipo propio y quiere hablar con él desde Riff Home. Los agentes son solo para el chat: Riff nunca envía una respuesta ni una publicación a un agente, porque llevan texto de la web y un agente puede ejecutar comandos.

Añade el agente, pon en su .env la línea que muestra la tarjeta, reinicia el gateway y se conecta.

1. Activa el servidor de API de Hermes

En el equipo del agente, añade estas líneas a ~/.hermes/.env:

LíneaQué hace
API_SERVER_ENABLED=trueActiva el servidor de API con el que habla Riff (puerto 8642)
API_SERVER_KEY= y una clave larga y aleatoriaLa clave que enviará Riff. Cualquiera con esta clave y la dirección puede usar tu agente
API_SERVER_CORS_ORIGINS=chrome-extension:// y el ID de RiffDeja entrar a esta copia de Riff (el paso 3 muestra la línea exacta)

Añade API_SERVER_HOST=0.0.0.0 solo si Riff llega al agente por tu red y no por un túnel.

2. Reinicia el gateway

El servidor de API forma parte del gateway de Hermes. Desde un terminal en ese equipo, ejecuta hermes gateway restart (o inícialo con hermes gateway).

  • No hermes serve: ese inicia el panel de control, no el servidor de API.
  • Reinícialo desde un terminal normal. Si le pides al agente que reinicie su propio gateway, se cierra la sesión en la que está trabajando.

3. Añádelo en Riff

  1. En Riff Home › Models (Modelos), haz clic en Add (Añadir) en Add a model app (Añadir una app de modelos).
  2. App: Hermes agent (Agente Hermes). Dirección: donde responde, como 192.168.1.30:8642 o la de tu túnel, agent.yourdomain.com. Clave de API: la API_SERVER_KEY del paso 1.
  3. Haz clic en Save and connect (Guardar y conectar) y permite lo que pregunta el navegador sobre esa dirección.
  4. La tarjeta dice Connected (Conectado) y Chat with this agent (Chatear con este agente). Listo: consulta Chatea con tu agente.

«Falta un ajuste»: la línea del ID de la extensión

Hermes deja que cualquiera con la clave lea su lista de modelos, pero solo actúa para las extensiones de navegador que conoce. Por eso la tarjeta puede encontrar el agente mientras se rechaza cada mensaje del chat. Riff lo comprueba, y entonces la tarjeta dice Needs one setting (Falta un ajuste) con la línea exacta, incluido el ID de Riff:

API_SERVER_CORS_ORIGINS=chrome-extension:// seguido del ID de Riff.

  1. Copia la línea de la tarjeta en ~/.hermes/.env. Si la línea ya existe, añade el nuevo ID después de una coma.
  2. Ejecuta hermes gateway restart.
  3. Haz clic en Connect (Conectar) en la tarjeta.

El ID pertenece a esta copia de Riff en este navegador. Riff en otro navegador, o cargado de nuevo como copia nueva, tiene su propio ID y necesita su propia entrada.

Llega desde cualquier sitio: un túnel

Un túnel le da al agente una dirección https sin abrir ningún puerto en tu router. Con un Cloudflare Tunnel, dirige un nombre de host al puerto del agente en ese equipo. En ~/.cloudflared/config.yml:

  • hostname: agent.yourdomain.com
  • service: http://localhost:8642

Después añade agent.yourdomain.com en Riff como antes. El agente puede seguir escuchando en localhost, así que no necesitas API_SERVER_HOST. Con un túnel, lo que escribes pasa por Cloudflare hasta tu equipo.

Protege la clave

Con un túnel, la clave es el único cerrojo entre internet y un agente que puede ejecutar comandos en tu equipo.

  • Usa una clave larga y aleatoria, y cámbiala si ha podido filtrarse.
  • Riff la guarda separada del resto de tu configuración, donde solo las páginas de Riff pueden leerla. Nunca va en una copia de seguridad ni en Copy agent log (Copiar el registro del agente).
  • Recorta la lista de comandos que el agente puede ejecutar sin preguntar. Riff muestra las peticiones de aprobación del agente Chatea con tu agente, pero solo de lo que el agente pregunta.