Connecteur IA sur mesure : clé API ou OAuth

Quelle expérience utilisez-vous ?

Cette documentation couvre les deux expériences. Si Settings → Personal → My Okou est disponible, suivez les étapes My Okou. Si vous utilisez une page Agents avec New agent, suivez les étapes Legacy Agents. La disponibilité peut varier selon les membres ; cette documentation ne modifie pas votre expérience.

Dans l’une ou l’autre expérience, vous pouvez exécuter plusieurs chats ou tâches en même temps, réutiliser des workflows et partager avec votre équipe le travail relu. Un sous-agent d’exécution est un outil d’exécution, pas un profil de produit distinct que vous devez créer.

Différences de configuration : My Okou utilise des Instructions personnelles dans Settings → Personal → My Okou et des Workflows de l’espace de travail. Toute étape ci-dessous qui vous demande de choisir, créer ou autoriser un Agent nommé s’applique uniquement à Legacy Agents. Dans My Okou, utilisez votre propre Chat et suivez l’invite de compte et d’autorisation nommée affichée. Les Workflows partagés ne partagent pas les identifiants ; les Automations utilisent le contexte et l’accès de leur propriétaire.

Un connecteur personnalisé permet à un administrateur d’organisation d’enregistrer une API HTTPS ou, lorsque c’est activé, un serveur MCP Streamable HTTP qui ne figure pas dans le catalogue intégré. Il définit la frontière réseau et la méthode d’authentification. Il ne génère pas automatiquement une référence API complète pour l’agent.

Qui configure quoi

Les administrateurs d’organisation créent, modifient et suppriment la définition du connecteur.
Les membres connectent leur propre secret ou terminent le flux OAuth du connecteur.
L’autorisation et les permissions contrôlent les actions nommées qu’Okou peut demander via la connexion. Legacy Agents utilisent également une autorisation spécifique à l’Agent.

La définition est partagée dans l’organisation. Les identifiants des membres restent limités au membre et à l’organisation.

Connecteur d’API HTTP

Ouvrez Connectors → Custom et choisissez New connector.
Sélectionnez HTTP API et saisissez un nom d’affichage.
Ajoutez un ou plusieurs Prefixes HTTPS, un par ligne. Une requête doit correspondre à un préfixe configuré avant que le connecteur puisse l’autoriser.
Ajoutez l’authentification si l’API en a besoin :
- Authentification API : saisissez le nom de l’en-tête et un modèle d’en-tête contenant {{secret}}, par exemple Authorization et Bearer {{secret}}.
- OAuth 2.0 : saisissez l’URL d’autorisation, l’URL du jeton, l’ID client, le secret client, les portées et la méthode d’authentification du point de terminaison des jetons. Enregistrez chez le fournisseur l’URL de redirection exacte affichée dans le formulaire.
Créez le connecteur. Chaque membre qui en a besoin sélectionne ensuite Connect et fournit son secret ou termine OAuth.
Examinez et autorisez les permissions nommées requises. Dans Legacy Agents, sélectionnez aussi l’Agent prévu.

Modifier une définition OAuth existante ou ses identifiants client déconnecte les connexions OAuth en cours. Les membres doivent se reconnecter après la modification.

Connecteur MCP

Si MCP apparaît comme type de connecteur dans votre espace de travail, saisissez un point de terminaison MCP Streamable HTTP HTTPS et configurez l’authentification API ou OAuth dans le même formulaire. Si MCP n’est pas proposé dans le sélecteur, il n’est pas activé pour cet espace de travail.

Apprendre à l’agent la procédure API

Un connecteur personnalisé fournit un accès réseau sécurisé et l’injection des identifiants. Le formulaire de création ne téléverse pas et ne découvre pas automatiquement un document OpenAPI. Indiquez à l’agent le point de terminaison, la méthode, les paramètres et la réponse attendue dans la requête, ou consignez cette procédure dans un workflow avec une référence API attachée sous forme de fichier.

Validez un nouveau connecteur avec une requête étroite en lecture seule vers un point de terminaison connu. Il n’existe pas de requête générique Test connection, car de nombreuses API n’exposent pas de point de terminaison racine significatif.

Périmètres de sécurité

Seuls les préfixes HTTPS et les points de terminaison MCP sont acceptés.
Le pare-feu injecte les identifiants enregistrés uniquement dans les requêtes correspondantes.
Le secret enregistré est chiffré au repos et n’est pas exposé à l’agent en tant que variable d’environnement.
N’insérez pas de clés, de jetons ni de secrets client dans les messages de chat, les instructions de workflow ou les fichiers joints.
Utilisez un identifiant de service avec les portées amont minimales nécessaires au workflow.

Dépannage

Problème	Vérification
New connector n’est pas disponible	Seul un administrateur d’organisation peut créer ou modifier des définitions de connecteur.
L’agent ne voit pas le connecteur	Connectez-le pour le membre actuel et vérifiez les permissions requises. Dans Legacy Agents, autorisez également l’Agent prévu.
La requête est bloquée avant d’atteindre l’API	Confirmez que l’URL de la requête commence par l’un des préfixes HTTPS configurés.
L’API renvoie 401 ou 403	Reconnectez les identifiants du membre et vérifiez la clé amont ou les portées OAuth.
OAuth renvoie une erreur de redirection	Enregistrez l’URL de redirection exacte affichée dans le formulaire du connecteur et vérifiez les URL d’autorisation et du jeton.
L’agent devine le mauvais point de terminaison ou la mauvaise charge utile	Placez la procédure API dans un workflow et joignez la référence pertinente au lieu de vous fier uniquement au nom du connecteur.

Et ensuite ?

Consultez Flux de travail pour capturer les tâches répétées liées à un connecteur personnalisé.
Consultez Autorisations pour savoir comment les identifiants de connecteur personnalisé sont gérés.
Consultez le Catalog avant de créer un connecteur personnalisé — votre service est peut-être déjà pris en charge.