AR
Cube — Intégration des agents
Guide d'intégration des agents Self Bank
Sandbox, puis contour industriel
Ce guide décrit le modèle d'intégration « d'abord la sandbox » pour les capacités d'agents de Self Bank. Il est destiné aux architectes d'entreprise, développeurs et futurs processus d'intégration pilotés par machine. Aucune opération bancaire réelle n'est effectuée via cette interface — chaque interaction est limitée à l'environnement sandbox.
Aperçu
Self Bank fournit un modèle d'intégration contrôlé pour les capacités sélectionnées de la sandbox. L'interface d'intégration est délibérément étroite et structurée pour que le comportement de la plateforme soit prévisible et adapté à la consommation par machine.
Objectif
Comment connecter en toute sécurité un agent à Self Bank : limites, ordre des actions et résultats de l'évaluation.
D'abord la sandbox
Chaque interaction commence dans un environnement isolé. Pas d'opérations réelles ici.
Interface étroite
L'agent reçoit des compétences et des autorisations strictement définies, et non un accès direct à l'ABS.
Catalogue de compétences
L'intégration repose sur un catalogue public de compétences et des contrats OpenAPI stricts.
Résultats de l'évaluation
Résultats clairs du pilote : passage à l'évaluation, clarification du périmètre, exploration ou arrêt.
Contour industriel
Le passage en production est une solution distincte et un règlement après un passage réussi en sandbox.
Public cible
Ce modèle de public vise à soutenir l'évaluation pratique et le déploiement industriel contrôlé.
Architectes d'entreprise
Évaluation des capacités de Self Bank par rapport aux architectures de référence et aux modèles d'intégration de la banque.
Développeurs et intégrateurs
Création de prototypes basés sur des points de terminaison déterministes de la sandbox avec un contrat stable.
Équipes de plateforme
Vérification de la conformité opérationnelle, des limites des autorisations et de la topologie de déploiement.
Agents AI et orchestrateurs
Consommation de capacités structurées pour la composition autonome de flux de travail.
Service de sécurité et CISO
Vérification de l'isolation de la sandbox par rapport au noyau, contrôle des privilèges minimaux et absence d'effets réels.
Sponsors du pilote
Évaluation de l'impact commercial et détermination du résultat du pilote sans risque pour l'argent réel et les clients.
Conditions préalables
Le travail initial avec le modèle d'agents de Self Bank nécessite un ensemble limité de conditions techniques et organisationnelles pour une évaluation ciblée et contrôlée.
01. Responsable de l'intégration
Une équipe responsable ou un contact est défini pour l'évaluation en sandbox, et non « regardons tout ensemble ».
02. Scénario choisi
La compétence cible ou le processus métier est connu à l'avance, et non pas exploré dans tout le catalogue.
03. Autorisations convenues
L'ensemble minimal des portées d'accès est clair et documenté avant le démarrage.
04. Règlement de la sandbox
L'équipe comprend et accepte : le travail actuel est strictement limité à une sandbox isolée.
05. Chemin après le pilote
Il existe un parcours clair pour l'approbation du déploiement industriel en cas de succès du pilote.
06. Contrat examiné
La spécification OpenAPI et les codes d'erreur de la sandbox sont connus de l'équipe avant la réception du premier jeton.
Modèle d'intégration
L'accès aux fonctionnalités Self Bank est fourni via des portées d'autorisations. Les agents et intégrateurs demandent uniquement le minimum de droits pour un scénario spécifique.
D'abord la sandbox
Toute intégration commence et est entièrement validée dans une sandbox isolée.
Autorisation Bearer
Modèle d'accès basé sur des jetons JWT Bearer avec une durée de vie limitée, sans mots de passe dans les en-têtes.
Portées minimales
Les autorisations sont délivrées strictement pour le scénario : catalog.read, simulation.payments, simulation.onboarding.
Pas de vente directe
L'accès industriel n'est pas fourni par défaut et nécessite une approbation d'entreprise distincte.
Isolation stricte
Pas de mouvement d'argent réel, pas d'enregistrements clients réels, pas d'actions non réglementées dans le noyau.
Journal des appels
Enregistrement obligatoire des identifiants de requêtes (requestId) et des résultats des appels du côté de l'agent.
Ensemble actuel de capacités
Cinq compétences de premier niveau. L'accès aux opérations de la sandbox est strictement réglementé par les portées d'autorisations correspondantes.
Catalogue de produits
getProductCatalog · scope: catalog.read Obtention du catalogue des produits bancaires disponibles et des catégories de services Self Bank pour exploration dans la sandbox.
Onboarding client
simulateOnboarding · scope: simulation.onboarding Simulation du processus d'onboarding d'un client corporate sans créer d'enregistrement réel dans le système bancaire.
Validation de paiement
simulatePayment · scope: simulation.payments Validation et simulation d'un ordre de paiement avec vérification des limites sans mouvement réel de fonds.
Ouverture de compte
simulateAccountOpening · scope: simulation.account_opening Simulation du cycle de vie d'une demande d'ouverture de compte courant sans opérations dans le noyau bancaire.
Résumé analytique
generateAnalyticsSummary · scope: analytics.summary.read Génération d'un résumé analytique basé sur des métriques opérationnelles choisies (capacité prévue).
Isolation des services
scope: none L'accès libre aux fonctions de service internes de la plateforme et du système bancaire est fermé.
Exemple de scénario d'intégration
Simulation complète dans la sandbox. Exemple d'une chaîne d'intégration typique avec validation des contrats et des contrôles.
01. Catalogue de produits
GET /api/agent/v1/catalog/products Demande du catalogue des produits bancaires et des catégories pour vérifier le contrat et le scope catalog.read.
02. Onboarding du client
POST /api/agent/v1/ simulations/onboarding Simulation de l'onboarding d'un client corporate avec vérification des signaux de risque et du parcours des documents.
03. Validation du paiement
POST /api/agent/v1/ simulations/payments Simulation de la validation d'un ordre de paiement avec aperçu des écritures sans débit de fonds.
04. Analyse des contrôles
Inspect validationResult · workflowPreview Analyse des résultats de validation, des points de déclenchement des limites et des exigences de sécurité.
05. Analyse des limites
estimatedControls Vérification de la conformité aux limites, évaluation de la suffisance des droits et documentation des points de défaillance de la sandbox.
06. Résultat de la vérification
Conclusion sur le scénario Formation d'une conclusion déterministe : passage à l'évaluation, clarification du scope ou arrêt.
Principes de sécurité et de contrôle
Des frontières strictes d'isolation entre les surfaces d'agent et les systèmes clés de la banque.
Isolation de la sandbox
Isolation complète de l'environnement de test des services industriels et du cœur bancaire.
Sans mouvement d'argent
Interdiction catégorique d'effectuer des transactions financières réelles et des débits.
Sans création de clients
Tous les profils et entités d'onboarding sont isolés et ne figurent pas dans la base de données clients réelle.
Droits minimaux
Attribution des scopes selon le principe du moindre privilège strictement pour les tâches du scénario.
Audit et traçabilité
Journalisation complète des identifiants de requêtes (requestId) et des décisions prises par l'agent.
Homme dans le circuit
Le passage à l'exploitation industrielle n'est possible que par un règlement d'accord entre les personnes.
Modèle d'environnement

Trois états du circuit de la plateforme : du test accessible aux capacités planifiées.

Sandbox
Disponible maintenant
Strictement isolé de la production
Simulation d'onboarding et de paiements
Réponses API déterministes
Circuit industriel (Production)
Déploiement d'entreprise
Solution distincte du comité
Règlement strict d'admission
Homme dans les circuits critiques
Métadonnées
Capacité planifiée
Manifestes lisibles par machine
Détection autonome des compétences
Typage étendu des contrats
Ce qui n'est pas inclus dans le périmètre
Le modèle actuel de la sandbox Self Bank est délibérément limité à une recherche contrôlée et à des simulations.
Mouvement des fonds
Aucune opération réelle, transfert de fonds ou débit de comptes.
Création de clients
L'onboarding et l'ouverture de comptes fonctionnent uniquement en mode simulation.
Actions administratives
L'accès libre et non réglementé aux interfaces de service internes de la plateforme est fermé.
MCP complet en production
L'accès direct non contrôlé au MCP dans le circuit opérationnel de la banque n'est pas accordé.
Contournement des autorisations
Les demandes d'octroi de droits non sélectifs contournant la matrice des scopes sont rejetées.
Remplacement du noyau bancaire
La couche d'intégration des agents ne remplace pas l'ABS et les systèmes de comptabilité de base de la banque.
Critères de préparation
Le passage de la recherche dans le bac à sable à un déploiement d'entreprise contrôlé nécessite une confirmation de la préparation technique et réglementaire.
01. Limites de compétence
La compétence cible ou l'endpoint est clairement décrite, isolée et documentée dans la spécification.
02. Scopes approuvés
Les scopes d'accès requis sont documentés et approuvés par l'architecture de la banque.
03. Bac à sable validé
Le scénario cible est entièrement testé et reproductible dans l'environnement du bac à sable.
04. Propriétaire défini
L'équipe d'exploitation, le propriétaire du processus et le chemin d'approbation sont définis.
05. Restrictions de production
Les exigences de sécurité, la topologie d'isolation et les règlements de déploiement ont été analysés.
06. Erreurs traitées
L'équipe a testé le traitement des statuts 400, 401, 403 et le traçage complet requestId.
Résultats de l'évaluation
L'évaluation du modèle d'agence Self Bank doit se terminer par un résultat clair, et non par un abstrait « nous avons aimé ».
Passer à l'évaluation
PROCEED TO INTEGRATION ASSESSMENT La possibilité est reconnue comme techniquement pertinente, sécurisée et opérationnellement réalisable pour la banque.
Affiner le scénario
REFINE THE TARGET USE CASE Le scénario est prometteur, mais nécessite une clarification des limites du processus, des contrats ou des scopes d'accès.
Rester dans le bac à sable
REMAIN IN SANDBOX EXPLORATION Des tests supplémentaires à faible risque et une validation sont nécessaires avant de prendre une décision sur le déploiement.
Arrêter l'évaluation
STOP CURRENT EVALUATION La possibilité évaluée dans sa forme actuelle ne correspond pas au scénario d'entreprise cible.
Fixation de la décision
Discipline du pilote Le résultat de chaque pilote est documenté par écrit : la recherche ne peut pas rester infinie.
Production — pas automatique
Contrôle de la transition Une simulation réussie dans le bac à sable n'ouvre pas un accès automatique au circuit opérationnel.
Modèle d'engagement
Le modèle « d'abord le bac à sable » suppose un parcours étape par étape pour l'interaction d'entreprise au lieu d'un accès direct immédiat.
01. Revue initiale
Étude de l'architecture, du catalogue des compétences, de la matrice des scopes et du positionnement du bac à sable.
02. Évaluation du bac à sable
Test pratique des possibilités à faible risque sélectionnées dans un environnement contrôlé.
03. Vérification architecturale
Accord du scénario, des périmètres, du règlement de sécurité et des restrictions du contour industriel.
04. Plan de déploiement
Détermination de la préparation de l'ensemble choisi de fonctionnalités pour le déploiement en entreprise.
05. Règlement d'admission
Passage des vérifications de conformité, audit de la matrice des autorisations et accord sur le SLA.
06. Lancement industriel
Connexion au contour industriel avec surveillance et participation obligatoire d'un humain dans les processus critiques.
Questions Fréquemment Posées
Intégration des agents AI : OpenAPI, bac à sable, MCP, propriétaire du pilote et ce qui ne peut pas être mis en production.
Peut-on connecter immédiatement un agent AI au circuit industriel de la banque ?
Non. Par défaut, il n'y a pas d'accès opérationnel. D'abord le bac à sable, autorisations explicites, propriétaire de l'intégration et décision de déploiement. La production est un modèle d'environnement distinct, pas « le même stand avec un jeton opérationnel ». Il est logique de couper immédiatement le scénario « juste pour voir des clients en direct ». Self Cube sépare spécialement ces environnements pour que l'erreur de prompt ne devienne pas une erreur de paiement.
Qu'est-ce que l'Open API de la banque pour les agents ?
C'est un contrat lisible par machine des capacités : l'agent trouve une compétence selon la spécification OpenAPI, au lieu de parser l'écran de la banque en ligne. L'accès est accordé par autorisations, les erreurs et types de réponse sont décrits, et ne vivent pas dans le chat de l'équipe. Ce n'est pas un « open banking de détail pour un particulier dans une application tierce ». Il est logique de vérifier que le contrat correspond au bac à sable et qu'il n'y a pas de méthodes de paiement opérationnelles. Sans OpenAPI, l'intégration contrôlée de l'agent devient un scraping fragile. La spécification fait ici partie de la sécurité, pas de la documentation « pour les développeurs plus tard ».
Qu'est-ce que le MCP et doit-on le connecter immédiatement ?
MCP — Model Context Protocol, un moyen de donner à la modèle un ensemble d'outils. Le MCP complet dans le circuit industriel « tel quel », sans réduction des droits, délibérément en dehors du périmètre d'intégration de Self Bank. D'abord le bac à sable et autorisations explicites sur des compétences spécifiques. Il est logique de ne pas confondre « le modèle peut appeler des outils » avec « le modèle a reçu la clé de la banque ». Si le client MCP voit des services internes sans passerelle, c'est déjà un incident, pas une innovation. Le protocole peut être discuté après avoir fermé le minimum d'actions sécurisées.
Qu'est-ce qui n'entre pas délibérément dans le périmètre de l'intégration de l'agent ?
Mouvement d'argent, création de clients, actions administratives libres, accès ouvert aux services internes et MCP complet en production sans déploiement. Ce ne sont pas des lacunes temporaires du backlog, mais une liste de refus. Il est logique de vérifier toute petite demande du pilote avec cela. Si le scénario nécessite l'une de ces choses, l'issue de l'évaluation est d'arrêter ou de rester dans le bac à sable, pas de « légèrement élargir l'autorisation ». La limite doit être claire pour le client avant la première démo, sinon les attentes divergeront au bout de deux semaines.
Quels résultats d'évaluation du pilote sont considérés comme normaux ?
Aller vers une évaluation formelle, clarifier le scénario, rester dans le bac à sable ou arrêter. « Juste curieux de voir » n'est pas un résultat. Il est logique de convenir à l'avance quel résultat clôt le pilote : un parcours de compétence confirmé, une liste de failles, une décision de ne pas aller en production. Si le pilote ne peut pas échouer, il ne peut pas non plus être évalué honnêtement. Self Cube intègre ces résultats dans le modèle d'interaction pour que l'intégration ne reste pas un PoC éternel. L'arrêt est un résultat professionnel valide, pas un échec de l'équipe.
Pourquoi un propriétaire d'intégration est-il nécessaire du côté de la banque ?
Sans une personne responsable des autorisations, du scénario et de la décision d'arrêter, le pilote n'a personne pour le clôturer. Le propriétaire n'est pas « le sponsor sur la diapositive », mais le propriétaire du circuit : qui a donné l'autorisation, qui regarde le journal, qui dit « nous n'allons pas en production ». Il est logique de le nommer avant de connecter le modèle, pas quand un appel étrange s'est déjà produit. S'il n'y a pas de propriétaire, l'intégration se disperse dans l'IT, le business numérique et le risque. Le modèle d'interaction de Self Bank ne le permet pas comme mode normal.
Dans quel ordre connecter l'agent aux capacités bancaires ?
D'abord l'environnement de la sandbox et le contrat OpenAPI, puis un ensemble minimal de compétences — généralement un catalogue, ensuite des simulations. Le résumé analytique n'est pas inclus dans ce flux tant que la compétence est en statut prévu. Ensuite — un parcours transversal, un journal, une évaluation des résultats. Les méthodes de combat ne font pas partie de cet ordre. Il est logique de ne pas commencer par le MCP et de ne pas commencer par le paiement. Si l'équipe ne peut pas passer la simulation d'onboarding sans erreur, il est trop tôt pour élargir les droits. Le flux recommandé va à l'encontre de la tentation de « tout de suite le meilleur ».
Quelle est la différence entre l'intégration d'agent d'entreprise et la démo dans le chat ?
La démo dans le chat montre que le modèle sait parler. L'intégration d'entreprise montre que l'appel se fait selon le contrat, avec permission, journal, propriétaire et possibilité de s'arrêter. Sans cela, la banque obtient un accès incontrôlé sous couvert d'innovation. Il est logique d'exiger le même ensemble d'artefacts que pour tout système externe : environnement, comptes, limites, rollback. Self Cube décrit ce contour comme un modèle d'environnement, et non comme un prompt. S'il n'y a pas d'artefacts, c'est toujours un chat, même avec un bon modèle.
Discuter de l'intégration d'entreprise
Si vous évaluez des plateformes bancaires modernes ou prévoyez de connecter des agents AI, une session ciblée aidera à aligner l'architecture, les périmètres et l'ordre de pilotage.
Intégration des agents AI dans la banque | guide Self Cube — sandbox | Self_