Studio de connecteurs

L'écran Studio de connecteurs vous permet d'écrire un manifeste Connector, de le vérifier en direct et sur le serveur selon le contrat connector-manifest, de l'enregistrer comme nouvelle version et de tester la connexion à travers le garde de sortie réseau. Chemin dans le portail : /studio/connectors. Il sert aux développeurs et aux administrateurs du tenant qui relient les agents à un système métier.

Ce que montre l'écran

• À gauche, la liste des connecteurs (GET /v1/connectors), paginée, avec Nouveau en haut. Une liste vide affiche Aucun connecteur pour l'instant : les identifiants sont des références (openbao:// ou env://), jamais des valeurs.
• Onglet Éditeur : Manifeste (JSON) vérifié en direct selon le schéma JSON connector-manifest (schémas lus avec GET /v1/contracts/{name}), les problèmes de l'éditeur, JSON invalide : ... quand le texte ne s'analyse pas, les boutons Valider sur le serveur et Créer ou Enregistrer comme nouvelle version, le résultat de validation et la réponse de l'enregistrement.
• Onglet Test, une fois un connecteur enregistré ouvert : Test de connexion avec le bouton Tester la connexion et sa réponse JSON.
• Le manifeste de départ new-connector décrit un système REST avec base_url, une authentification oauth2 dont le credential_ref est une référence OpenBao, des scopes et une ressource records en lecture.
• Ouvrir un connecteur lit son manifeste enregistré avec GET /v1/manifests/{kind}/{name} (type Connector).

Actions

Bouton ou action	Ce qu'il fait	Appel API	Rôles
Nouveau	Charge le manifeste de départ new-connector.	Aucun	Tout le monde
Clic sur un connecteur de la liste	Charge son manifeste enregistré.	GET /v1/manifests/{kind}/{name}	Tout utilisateur connecté
Valider sur le serveur	Valide le manifeste selon connector-manifest.	POST /v1/contracts/{name}/validate	Tout utilisateur connecté
Créer	Applique le nouveau manifeste.	POST /v1/manifests/apply	tenant_admin, developer
Enregistrer comme nouvelle version	Applique le manifeste en augmentant de un le dernier numéro de metadata.version.	POST /v1/manifests/apply	tenant_admin, developer
Tester la connexion (onglet Test)	Appelle le système à travers le garde de sortie réseau avec les identifiants enregistrés.	POST /v1/connectors/{name}/test	tenant_admin, developer, application_owner
Réessayer (état d'erreur)	Relit la liste ou les schémas.	GET /v1/connectors ou GET /v1/contracts/{name}	Tout utilisateur connecté

Rôles

Le portail active les boutons d'enregistrement pour STUDIO_WRITERS (tenant_admin, developer). POST /v1/manifests/apply demande les mêmes rôles. POST /v1/connectors/{name}/test demande tenant_admin, developer ou application_owner (WRITE_ROLES, services/control-plane/src/eai/domains/connectors/routes.py).

Tâches courantes

Créer un connecteur

1. Partir du modèle de départ. Cliquez sur Nouveau. Résultat attendu : le manifeste new-connector. En cas d'échec : rechargez la page.
2. Décrire le système. Renseignez metadata.name, spec.base_url, spec.auth et spec.resources. Placez le secret dans OpenBao et n'écrivez que sa référence dans credential_ref. Résultat attendu : Aucun problème détecté par l'éditeur. En cas d'échec : corrigez la ligne citée par le problème.
3. Valider sur le serveur. Cliquez sur Valider sur le serveur. Résultat attendu : Valide selon contracts/v1. En cas d'échec : lisez la liste des erreurs.
4. Créer. Cliquez sur Créer. Résultat attendu : le message Enregistré en version 0.1.0. En cas d'échec : voir Dépannage.

Tester la connexion

1. Ouvrir le connecteur. Cliquez dessus dans la liste. Résultat attendu : l'onglet Test apparaît. En cas d'échec : enregistrez d'abord le connecteur.
2. Tester. Ouvrez Test et cliquez sur Tester la connexion. Résultat attendu : la réponse JSON du test. En cas d'échec : vérifiez la référence d'identifiants et la politique de sortie réseau.

attention

Ne collez jamais un mot de passe ou un jeton dans le manifeste. Le manifeste est enregistré et versionné : utilisez une référence openbao:// ou env://.

Dépannage

Symptôme	Cause	Correction
Erreur invalid_manifest (422)	Le manifeste ne respecte pas le contrat.	Corrigez les champs listés dans errors.
Erreur connector_not_found (404) au test	Le connecteur n'est pas enregistré.	Créez-le d'abord.
Erreur connector_disabled (409)	Le connecteur est désactivé.	Activez-le sur la page Connecteurs.
Erreur credential_unavailable (409)	La référence d'identifiants ne peut pas être lue.	Vérifiez le secret derrière credential_ref.
Erreur upstream_error (502)	Le système métier a répondu par une erreur.	Vérifiez base_url et le système lui-même.
Erreur forbidden (403)	Un rôle requis manque.	Demandez le rôle developer.

Pages liées

• Développement de connecteurs
• Connecteurs (capacités)
• Secrets
• Contrats