Hermes

Connectez Hermes Agent à VillaSlot pour passer en revue vos annonces de villas et transformer des instructions opérationnelles en appels d’API. Le skill VillaSlot explique les endpoints disponibles, les règles de réservation et les limites de ce que l’agent peut modifier.

Installer le skill pour Hermes Agent

Depuis l’espace de travail où vous utilisez Hermes, lancez :

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

Choisissez Hermes Agent dans l’installateur. Son identifiant d’agent explicite est hermes-agent :

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

Installez le skill là où votre environnement Hermes peut y accéder, puis ouvrez une nouvelle session et demandez-lui d’utiliser villaslot. Si Hermes tourne à distance, faites la configuration dans cet environnement.

Connecter votre organisation VillaSlot

Ouvrez Compte → Clés API dans VillaSlot et générez une clé pour l’organisation cible. Rendez-la disponible de façon sécurisée sous le nom VILLASLOT_API_KEY dans l’environnement d’exécution de l’agent, avec :

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

Installer un skill ne configure aucun identifiant et n’accorde aucune permission sur l’organisation. Gardez la clé hors des fichiers versionnés et assurez-vous que Hermes peut joindre l’API en HTTPS.

Commencer par une revue en lecture seule

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.

Vérifiez le nom de l’organisation et le fuseau horaire dans le résultat. Une villa sans tarif pour une durée n’est pas réservable pour cette durée, même si son calendrier semble vide.

Revoir un changement de tarif

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.

Une fois le changement autorisé, Hermes peut soumettre la grille de remplacement si la clé API appartient à un propriétaire ou à un administrateur. Les mises à jour de tarifs remplacent toute la collection : les durées omises seraient supprimées. Les réservations existantes gardent leur prix figé.

Les montants utilisent l’unité mineure de la devise. Pour l’IDR, 1500000 signifie 1 500 000 IDR ; pour l’EUR ou l’USD, 2500 signifie 25,00. L’agent doit toujours lire la devise de l’organisation plutôt que supposer une conversion.

Travailler sur les réservations

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 peut ensuite trouver ou créer le client et créer une réservation à l’heure avec le statut que vous demandez. Gardez l’identifiant de réservation renvoyé pour la confirmation, le déplacement, la clôture ou l’annulation.

Se remettre d’une erreur

Si une requête expire pendant la création d’une fiche, demandez à Hermes de rapprocher les fiches existantes avant de réessayer. Les imports de clients par lot peuvent réussir en partie ; conservez les identifiants des lignes réussies et ne relancez que les lignes en échec.

L’enregistrement des paiements en espèces ou par virement, le paiement Stripe et les remboursements ne sont pas disponibles dans l’API v1. Confirmer une réservation ne la marque pas comme payée. Pour le détail des endpoints et des opérations prises en charge, consultez la référence de l’API.

Voir aussi Agents, OpenClaw, et la documentation du CLI Skills.