Un connecteur permet à ONE d'accéder à un outil qui se trouve en dehors de Factorial IT. Ajoutez-en un lorsque vous souhaitez que l'assistant consulte des informations ou agisse sur un autre système que votre équipe utilise déjà.

Fonctionnalité

Aperçu

Chaque connecteur est un serveur de Modèle de Contexte de Protocole (MCP) que vous enregistrez par son URL. Lorsqu'il est connecté, ONE peut appeler les outils que ce serveur propose pendant que vous discutez avec lui. Par exemple, il peut trouver une page dans Notion ou effectuer une tâche dans un autre service.

Raisons typiques d'en ajouter un :

• Consulter des données ailleurs. Apportez des informations détenues par un outil sur lequel votre équipe compte.
• Agir ailleurs. Laissez l'assistant accomplir des tâches à l'intérieur d'un service connecté.
• Étendre ce que l'assistant peut faire. Branchez tout outil qui prend en charge le Modèle de Contexte de Protocole.

Vous n'avez pas besoin d'un connecteur si l'assistant doit uniquement travailler avec les données de Factorial IT ou les directives de votre entreprise. Pour cela, utilisez des articles de la base de connaissances.

Avant de commencer

• Pour ajouter, modifier, réauthentifier ou supprimer des connecteurs, ou pour changer leurs autorisations d'outil, vous avez besoin de la permission Gérer les agents IA. Pour les voir, Voir les agents IA suffit.
• Vous avez besoin de l'URL d'un serveur MCP qui prend en charge l'authentification OAuth.

Comment utiliser

1. Allez dans Agents IA > Paramètres et sélectionnez l'onglet Connecteurs.
2. Cliquez sur Ajouter un connecteur. Une fenêtre s'ouvre.
3. Remplissez les détails :
   • Nom : comment le connecteur est étiqueté, par exemple Notion.
   • URL du serveur : le point de terminaison MCP, par exemple https://example.com/mcp.
4. Ouvrez Paramètres avancés uniquement si votre serveur MCP ne prend pas en charge l'enregistrement dynamique de client. Dans ce cas, enregistrez Factorial IT dans la console OAuth du fournisseur et entrez le ID client et le secret client. Les clients publics qui reposent sur PKCE peuvent laisser le secret vide.
5. Cliquez sur Connecter. Vous êtes envoyé au serveur MCP pour vous connecter. Une fois que vous avez accordé l'accès, vous revenez à Factorial IT et le connecteur affiche Connecté.

Statuts des connecteurs

Voir un connecteur

L'onglet Connecteurs affiche d'abord les connecteurs intégrés (Factorial IT et le connecteur du centre d'aide), suivi de ceux que vous avez ajoutés. Les connecteurs intégrés sont toujours Connectés. Cliquez sur n'importe quel connecteur pour ouvrir sa page.

Sur la page d'un connecteur que vous avez ajouté, vous trouverez :

• Paramètres : le Nom, l'URL du serveur et, si vous en avez saisi un, le ID client. Le secret client n'est jamais affiché. Utilisez Modifier la connexion pour changer ces valeurs. Changer l'URL du serveur ou les informations d'identification OAuth signifie que vous devez vous authentifier à nouveau.
• Autorisations de chat et Autorisations d'agent : chaque outil que le serveur MCP propose, chacun avec sa politique. Voir "Définir les autorisations d'outil" ci-dessous.

La liste des outils est récupérée depuis le serveur MCP chaque fois que vous ouvrez la page, donc elle correspond toujours à ce que le serveur propose actuellement. Les outils ne s'affichent que lorsque le connecteur est Connecté. Si le serveur ne répond pas, vous voyez un avertissement au lieu des outils, et Paramètres reste utilisable.

Les connecteurs intégrés n'ont pas de Paramètres et pas de menu Actions. Vous ne pouvez pas les modifier ou les supprimer, mais vous pouvez changer leurs autorisations d'outil.

Gérer un connecteur

Sur la page d'un connecteur que vous avez ajouté, utilisez le menu Actions dans le coin supérieur droit :

• Réauthentifier : connectez-vous à nouveau au serveur MCP. Cette option n'apparaît que lorsque le connecteur n'est pas Connecté.
• Supprimer : retirez le connecteur ainsi que ses informations d'identification enregistrées, une fois que vous avez confirmé. Si un agent utilise le connecteur, vous ne pouvez pas le supprimer tant que vous ne l'avez pas désactivé dans cet agent.

Définir les autorisations d'outil

La page du connecteur contrôle comment ONE peut utiliser chaque outil. Lorsque le connecteur est Connecté, ses outils sont listés en deux sections :

• Autorisations de chat couvrent vos propres conversations avec ONE.
• Autorisations d'agent couvrent ONE lorsqu'il fonctionne sans surveillance, par exemple sur un ticket où vous l'avez ajouté en tant qu'agent. Lorsque vous activez le connecteur pour un agent personnalisé, cet agent prend une copie de ces paramètres et la conserve. Les modifications apportées ici par la suite n'atteignent pas cet agent.

Les deux sections regroupent les outils en Outils en lecture seule et Outils en lecture-écriture. Un outil est considéré comme en lecture seule uniquement si le serveur MCP le signale avec l'annotation readOnlyHint. Tout autre outil est traité comme en lecture-écriture.

Pour définir une politique pour un groupe entier, utilisez le menu à droite de ce groupe. Le choix s'applique également aux outils que le serveur ajoutera à l'avenir, et il remplace les paramètres de chaque outil dans le groupe. Pour définir un outil, développez le groupe et choisissez une politique avec les icônes à côté du nom de l'outil. Lorsque les outils d'un groupe ont des politiques mixtes, le groupe affiche Personnalisé.

Politiques par défaut, jusqu'à ce que vous les changiez :

Cela signifie que les agents peuvent utiliser les outils en lecture-écriture immédiatement. Pour limiter les agents à la lecture sur un connecteur, définissez les Outils en lecture-écriture sur Toujours refuser sous Autorisations d'agent. Tout agent personnalisé utilisant déjà le connecteur a sa propre copie, donc mettez-le à jour dans cet agent également.

Comment ONE utilise les connecteurs

Lors d'une conversation, ONE a accès aux outils de chaque connecteur connecté et choisit le bon pour chaque demande. Pour l'orienter vers un connecteur particulier, tapez @ dans la zone de message et choisissez le connecteur. ONE vérifie les Autorisations de chat du connecteur avant d'exécuter un outil. Par défaut, il vous demande avant d'utiliser un outil qui écrit ou modifie des données.

Dépannage et FAQ

Dépannage

• Le connecteur affiche une erreur. La connexion a échoué. Ouvrez sa page et utilisez Actions > Réauthentifier.
• Le connecteur reste en attente d'authentification. L'authentification n'est pas terminée. Réauthentifiez-vous et complétez la connexion sur le serveur MCP.
• Aucun outil n'apparaît sur la page du connecteur. Les outils ne s'affichent que lorsque le connecteur est Connecté, et le serveur doit répondre. Si vous voyez un avertissement, le serveur n'a pas répondu.
• Vous ne pouvez pas supprimer un connecteur. Un agent l'utilise encore. Désactivez-le d'abord dans cet agent.
• La connexion échoue sur un serveur sans enregistrement dynamique de client. Enregistrez Factorial IT dans la console OAuth du fournisseur et entrez le ID client et le secret client sous Paramètres avancés.
• Un changement de permission n'a pas atteint un agent. L'agent conserve sa propre copie. Changez la politique à l'intérieur de l'agent.

FAQ

1. Quelle permission ai-je besoin pour ajouter un connecteur ?
   Gérer les agents IA. Voir les agents IA ne vous permet que de voir les connecteurs.
    
2. Puis-je modifier ou supprimer les connecteurs intégrés ?
   Non. Vous ne pouvez changer que leurs autorisations d'outil.
    
3. Comment Factorial IT décide-t-il si un outil est en lecture seule ?
   Seuls les outils que le serveur MCP marque avec readOnlyHint sont en lecture seule. Tous les autres outils sont en lecture-écriture.
    
4. Pourquoi n'y a-t-il pas d'exigence d'approbation pour les agents ?
   Un agent fonctionne de manière autonome, donc personne n'est là pour approuver l'outil.
    
5. Puis-je voir le secret client après l'avoir enregistré ?
   Non. Il n'est jamais affiché à nouveau.