Connexion à Performance Hub

Sur cette page

Ce qui distingue votre Agent IA d'un chatbot générique, c'est qu'il est connecté à votre activité. Grâce à la connexion MCP de Performance Hub, l'agent peut rechercher des clients et des membres, consulter les réservations et les visites, vérifier l'état des appareils, générer des rapports — les mêmes données opérationnelles que celles que vous voyez dans Performance Hub, mises à disposition de l'agent lors des conversations et dans ses automatisations.

Vous contrôlez précisément quelle part de Performance Hub l'agent peut atteindre : quelles installations, quelles fonctionnalités et même quels outils individuels. Cette page explique les différentes options.

Le MCP access se configure dans Device management, sous Configuration → MCP access.

Section MCP access permettant à l'agent d'utiliser les outils Performance Hub sur cette installationSection MCP access permettant à l'agent d'utiliser les outils Performance Hub sur cette installation

Figure 1 : La section MCP access — Portée d'accès, fonctionnalités et interrupteur marche/arrêt

Référence rapide

ParamètrePar défautOptions
MCP accessActivéActivé / Désactivé
Portée d'accèsCette installationCette installation · Installations sélectionnées · Régions · Organisation entière
FonctionnalitésToutes les fonctionnalitésToutes les fonctionnalités · Uniquement les fonctionnalités sélectionnées · Toutes les fonctionnalités sauf celles sélectionnées
Sélection d'outils (sous Avancé)Tous les outils des fonctionnalités accordéesTous les outils des fonctionnalités accordées · Uniquement les outils sélectionnés · Tous les outils sauf ceux sélectionnés

Recommandation : Laissez le MCP access activé (valeur par défaut). C'est cette connexion qui rend l'agent réellement utile pour votre activité. Par défaut, elle est strictement limitée à l'installation à laquelle l'agent a été ajouté. Si vous avez besoin par la suite que l'agent traite des données plus larges (plusieurs sites, une région ou toute l'organisation), élargissez la Portée d'accès plutôt que de fonctionner sans cette connexion. « Si cette option est désactivée, l'agent ne pourra accéder à aucune des fonctionnalités, aucun des outils et aucune des données de Performance Hub. »

Ce que la connexion apporte à l'agent

Le MCP (Model Context Protocol) est le standard ouvert utilisé par l'agent pour appeler Performance Hub : « Permettre à cet agent d'appeler les outils Performance Hub via un compte de service. Aucune clé n'est stockée sur l'appareil — l'accès est vérifié à chaque requête et révoqué dès que vous désactivez cette option. » En pratique, vous pouvez par exemple lui poser des questions telles que :

  • "Combien de visiteurs se sont enregistrés à la réception cette semaine par rapport à la semaine dernière ?"
  • "Quels contrôleurs de porte sont actuellement hors ligne ?"
  • "Trouvez le client dont le paiement a échoué hier et résumez son compte."

…et l'agent répond à partir des données en direct de Performance Hub, dans la limite de la portée que vous lui avez accordée. Cette même connexion alimente les automatisations — un résumé matinal des réservations de la veille, un compte-rendu hebdomadaire de l'état des appareils — ainsi que le manuel opérationnel intégré décrit dans Skills.

L'agent agit avec sa propre identité dans Performance Hub (un compte de service lié à l'appareil), et non en tant qu'utilisateur particulier. Chaque appel qu'il effectue est vérifié par rapport aux accès que vous lui avez accordés ici, du côté de Performance Hub — l'autorisation est appliquée de manière centralisée, et non par simple confiance.

Portée d'accès — les installations visibles par l'agent

  • Cette installation (par défaut) — l'installation à laquelle l'agent a été ajouté. Idéal pour un agent gérant un site unique.
  • Installations sélectionnées — uniquement les installations que vous listez. Utile pour un agent desservant quelques sites.
  • Régions — toutes les installations des régions sélectionnées. Utile pour l'agent d'un responsable régional.
  • Organisation entière — l'ensemble des données. Adapté aux agents du siège social effectuant des rapports multisites.

"Vous ne pouvez accorder des accès qu'au sein de vos propres installations, régions et permissions."

Fonctionnalités — ce que l'agent peut utiliser

Les fonctionnalités sont des groupes d'outils liés aux modules Performance Hub.

  • Toutes les fonctionnalités (par défaut) — "L'agent peut utiliser toutes les fonctionnalités disponibles, y compris les nouvelles fonctionnalités au fur et à mesure de leur ajout."
  • Uniquement les fonctionnalités sélectionnées — "L'agent ne peut utiliser que les fonctionnalités que vous sélectionnez ci-dessous." L'agent obtient exactement ces éléments et rien d'autre, même si vos abonnements évoluent.
  • Toutes les fonctionnalités sauf celles sélectionnées — "L'agent peut utiliser toutes les fonctionnalités à l'exception de celles que vous sélectionnez ci-dessous. Les nouvelles fonctionnalités sont automatiquement incluses." Un bon compromis : toute l'utilité, avec (par exemple) la facturation en moins.

Cette section dispose également d'un commutateur en lecture seule : activez-le pour que l'agent puisse consulter des informations sans pouvoir rien modifier, les outils effectuant des modifications étant masqués et rejetés. C'est la méthode la plus simple pour exploiter un agent strictement informatif.

Sélection d'outils (avancé)

Pour un contrôle plus précis, développez Avancé et choisissez une Sélection d'outils — Uniquement les outils sélectionnés ou Tous les outils sauf ceux sélectionnés — afin d'inclure ou d'exclure des outils individuels au sein des fonctionnalités accordées. Par exemple, vous pouvez autoriser la recherche de clients tout en excluant leur mise à jour. La plupart des installations n'ont jamais besoin de cela ; le contrôle au niveau des fonctionnalités offre généralement la granularité idéale.

Dernière mise à jour par indique la dernière personne ayant modifié l'autorisation.

Remarque concernant les actions d'écriture

À moins d'activer le commutateur en lecture seule, l'autorisation couvre tout ce que les fonctionnalités permettent, y compris les actions qui modifient les données (et pas seulement leur lecture), lorsqu'un module le propose. Pour que l'agent reste informatif, utilisez le commutateur en lecture seule, limitez-le à des fonctionnalités axées sur le reporting, ou excluez des outils spécifiques. L'agent confirme également les actions importantes au cours de la conversation avant de les exécuter.

Désactivation et révocation de l'accès

  • Désactivez l'MCP access pour que l'agent perde immédiatement sa connexion avec Performance Hub. Il continue de fonctionner en tant qu'assistant général avec ses fichiers et sa Memory, mais ne peut plus consulter vos données professionnelles. Les modifications (activation, désactivation ou modification de la portée) prennent effet quelques instants après l'enregistrement, sans nécessiter de redémarrage.
  • La suppression ou la réinitialisation de l'agent révoque entièrement ses identifiants.

Qui peut accorder quoi

Les autorisations sont limitées à la personne qui les accorde : la portée et les fonctionnalités dont vous disposez au sein de l'organisation constituent la limite maximale de ce que vous pouvez confier à l'agent. Si une option n'est pas disponible, c'est que votre propre rôle ne l'inclut pas. Un administrateur disposant des accès nécessaires peut alors la configurer. Si vous ne pouvez pas du tout modifier l'MCP access, la section indique : "You do not have permission to configure MCP access for this device."