Hermes

Conecta Hermes Agent a VillaSlot para revisar tus anuncios de villas y convertir instrucciones operativas en llamadas a la API. El skill VillaSlot explica los endpoints disponibles, las reglas de reserva y los límites de lo que el agente puede cambiar.

Instalar el skill para Hermes Agent

Desde el espacio de trabajo donde usas Hermes, ejecuta:

npx skills add https://github.com/mikecodeur/skills --skill villaslot

Elige Hermes Agent en el instalador. Su identificador de agente explícito es hermes-agent:

npx skills add https://github.com/mikecodeur/skills --skill villaslot --agent hermes-agent

Instala el skill donde tu entorno de ejecución de Hermes pueda acceder a él, luego abre una nueva sesión y pídele que use villaslot. Si Hermes se ejecuta en remoto, haz la configuración en ese entorno.

Conectar tu organización de VillaSlot

Abre Cuenta → Claves API en VillaSlot y genera una clave para la organización de destino. Ponla a disposición de forma segura como VILLASLOT_API_KEY en el entorno de ejecución del agente, junto con:

export VILLASLOT_BASE_URL="https://www.villaslot.io"

Instalar un skill no configura credenciales ni concede permisos de organización. Mantén la clave fuera de los archivos versionados y asegúrate de que Hermes puede llegar a la API por HTTPS.

Empezar con una revisión de solo lectura

Use the villaslot skill. Read my organization context and list its villas.
For each active villa, show opening hours and the durations with a price.
Report missing configuration without changing anything.

Revisa el nombre de la organización y la zona horaria en el resultado. Una villa sin tarifa para una duración no se puede reservar para esa duración, aunque su calendario parezca vacío.

Revisar un cambio de tarifa

Read Garden Villa's complete hourly rate grid. Prepare a change to its
two-hour rate of 1,500,000 IDR. Preserve all other durations and show me
the full proposed grid before applying it.

Después de que autorices el cambio, Hermes puede enviar la cuadrícula de reemplazo si la clave API pertenece a un propietario o administrador. Las actualizaciones de tarifas reemplazan la colección completa, así que las duraciones omitidas se eliminarían. Las reservas existentes conservan su precio fijado.

Los importes usan la unidad menor de la moneda. Para IDR, 1500000 significa 1 500 000 IDR; para EUR o USD, 2500 significa 25,00. El agente debe leer siempre la moneda de la organización en lugar de suponer una conversión.

Trabajar con las reservas

Find a three-hour slot at Garden Villa on 2026-10-20 after 09:00,
in the organization's timezone. Show the available options and prices.
Wait for my choice before creating the reservation.

Hermes puede entonces buscar o crear el cliente y crear una reserva por horas con el estado que pidas. Conserva el identificador de reserva devuelto para la confirmación, la reprogramación, la finalización o la cancelación.

Recuperarse de los errores

Si una petición agota el tiempo de espera al crear una ficha, pide a Hermes que concilie las fichas existentes antes de reintentar. Las importaciones de clientes por lotes pueden tener éxito parcial; conserva los identificadores creados y reintenta solo las filas fallidas.

El registro de pagos en efectivo o por transferencia, el pago con Stripe y los reembolsos no están disponibles en la API v1. Confirmar una reserva no la marca como pagada. Para el detalle de los endpoints y las operaciones admitidas, consulta la referencia de la API.

Consulta también Agentes, OpenClaw y la documentación de la CLI de Skills.