Clés d’agent pour scripts et automatisations
Créer une clé d’agent, choisir ce qu’elle peut faire, la voir une seule fois, la renouveler avant son expiration et la révoquer.
Sur cette page
Une clé d’agent permet à un script, une automatisation ou une tâche d’intégration continue de dialoguer avec Verimly sans écran de connexion. La clé agit comme la personne qui l’a créée, avec au plus les droits de cette personne. Tout ce qui utilise la clé cesse de fonctionner au moment où vous la révoquez.
Si vous utilisez une app comme Claude ou ChatGPT, vous n’avez pas besoin de clé : connectez-la comme décrit dans Connecter votre propre agent IA à Verimly.
Avant de commencer
- Autoriser les agents doit être activé dans Paramètres › IA et agents. Un propriétaire le contrôle. S’il est désactivé, les clés cessent de fonctionner.
- Une clé agit comme vous : elle ne peut donc jamais voir ni modifier plus que ce que votre rôle permet. Un caissier qui coche Modifier la carte n’obtient rien de plus, car son rôle ne peut pas modifier la carte.
- Si Lecture seule pour tous est activé, toute nouvelle clé est en lecture seule, quel que soit votre choix.
- Traitez une clé comme un mot de passe : toute personne qui la possède peut agir comme vous dans les limites de ses périmètres.
Créer une clé
- Ouvrez Paramètres › IA et agents, repérez Clés d’agent et choisissez Créer une clé.
- Saisissez un Nom qui dit à quoi elle sert, comme Script du rapport hebdomadaire.
- Sous Ce qu’elle peut faire, gardez Lecture seule activée, ou désactivez-la pour autoriser les modifications et cochez les périmètres dont vous avez besoin (voir plus bas). Consulter votre établissement est toujours inclus.
- Sous Établissements, choisissez Tous les établissements, ou Seulement ces sites et choisissez-en au moins un.
- Choisissez Expire le : après 30, 90 ou 365 jours. Chaque clé expire ; il n’existe pas de clé éternelle.
- Choisissez Créer une clé.
- Copiez votre clé maintenant. Elle commence par
vk_live_et n’est affichée qu’une seule fois. Conservez-la dans un gestionnaire de mots de passe ou dans les secrets de votre intégration continue, puis choisissez Je l’ai copiée.
Envoyez la clé dans l’en-tête Authorization comme jeton porteur : Authorization: Bearer vk_live_…. Une clé fonctionne avec l’adresse de serveur complète et avec l’adresse Lecture seule affichées sur la même page. Les clés ne peuvent pas demander à une personne d’approuver plus d’accès : elles ne peuvent donc pas aller au-delà des périmètres que vous leur avez donnés.
Périmètres
| Périmètre | Ce qu’il autorise |
|---|---|
| Consulter votre établissement | Ventes, carte, stock, planning du personnel, réservations et rapports : ce que vous pouvez voir vous-même |
| Modifier la carte | Produits, prix, catégories et ce qui est en rupture |
| Gérer les réservations | Créer, déplacer et annuler des réservations |
| Gérer l’équipe et les services | Profils du personnel, invitations et planning |
| Traiter les commandes en ligne | Accepter les commandes en ligne et mettre à jour leur statut et leurs notes. Jamais de remboursements ni d’annulations. Aucune action d’agent n’utilise encore ce périmètre. |
Les agents ne peuvent jamais déplacer d’argent : ni remboursements, ni annulations, ni versements, ni réglages de paiement.
Voir et gérer les clés
La liste montre chaque clé avec son nom, les premiers caractères de la clé, en tant que qui elle Agit, Utilisée il y a combien de temps (ou Pas encore utilisée), et Expire le ou Expirée avec la date. Les propriétaires voient toutes les clés de l’entreprise ; les autres voient les leurs.
Renouveler une clé avant son expiration
Choisissez Renouveler sur la clé. Vous obtenez un nouveau secret avec les mêmes réglages, et l’ancien cesse de fonctionner immédiatement. La nouvelle clé garde les jours restants. Mettez votre script à jour tout de suite. Un propriétaire qui renouvelle la clé de quelqu’un d’autre la reprend : la nouvelle clé agit comme le propriétaire.
Révoquer une clé
Choisissez Révoquer et confirmez. Tout ce qui utilise la clé cesse de fonctionner immédiatement. Faites-le si la clé a été collée à un endroit où elle ne devrait pas être, si un collègue part, ou si le script est abandonné.
Quand une personne est retirée de l’entreprise, ses clés et ses apps connectées sont aussi révoquées.
Limites
- Les appels sont comptés par mois pour l’entreprise : Starter 3 000, Pro 10 000 et Business 30 000 par établissement, mutualisés. La page affiche … sur … appels d’agents et la date de remise à zéro.
- Chaque clé peut faire 60 appels par minute avec Starter et Pro, 120 avec Business. Au-delà de la limite, l’appel est refusé avec un message demandant d’attendre.
Questions fréquentes
J’ai perdu la clé
Elle ne peut pas être affichée à nouveau. Créez une nouvelle clé (ou renouvelez l’ancienne) et révoquez celle qui est perdue.
La clé fonctionnait hier et renvoie maintenant une erreur
Elle a peut-être été révoquée (AGENT_KEY_REVOKED), a expiré, ou Autoriser les agents est peut-être désactivé (MCP_DISABLED). Vérifiez la clé dans la liste et l’interrupteur de la page.
Pourquoi la clé peut-elle lire mais ne rien modifier ?
Lecture seule est activée pour la clé, ou Lecture seule pour tous est activée pour l’entreprise, ou le périmètre n’a pas été sélectionné. Voir AGENT_READ_ONLY dans Ce que les agents peuvent et ne peuvent pas faire.
En cas de problème
Regardez Activité sur la même page : elle liste chaque action des agents, avec le résultat et l’heure. Pour une clé divulguée, révoquez-la d’abord puis consultez le journal Vérifier qui a changé quoi pour voir ce qu’elle a fait. Utilisez Contacter le support si vous avez besoin d’aide.