Sources de données disponibles
Une demande arrive dans le flux de décision, et le même problème se présente à nouveau. Un client de longue date est traité comme un inconnu, car la règle ne voit pas les informations conservées dans le système bancaire central. L’équipe concernée indique que ces données sont déjà accessibles par une API sur la passerelle. Le fournisseur propose un autre signal utile, l’analyse de l’appareil, mais sa clé se trouve encore dans le gestionnaire de mots de passe de l’équipe. Votre demande d’intégration attend dans le backlog de la plateforme, avec une question sur les champs que les règles devront lire. Les informations sont proches, mais la décision en exploite très peu.
Qu’est-ce qu’une source de données ?
Une source de données appelle une API REST ou un service web SOAP accessible sur Internet. Elle est configurée comme source de données, puis le flux de décision utilise sa réponse, que le service soit exploité par un fournisseur ou par l’entreprise.
| Méthode | Utilisation |
|---|---|
| GET | Pour une recherche simple, avec les paramètres dans l’URL |
| POST | Pour une requête plus importante, sous forme de champs de formulaire, de JSON ou de modèle de corps brut |
| PUT | Pour transmettre le résultat d’une décision à un autre système |
| SOAP | Pour un ancien service web avec un WSDL et un nom de méthode |
Les paramètres peuvent prendre des valeurs fixes ou être associés à des données de l’objet de données. En sélectionnant « Flow », le paramètre apparaît dans l’étape du flux de décision pour être associé à une valeur. Dans l’URL, un espace réservé prend la valeur du paramètre portant le même nom. La requête peut aussi inclure des en-têtes, notamment des clés d’autorisation.
Une requête POST peut envoyer des champs de formulaire, du JSON ou un modèle de corps brut. Dans ce modèle, vous indiquez le format attendu par l’API et utilisez des espaces réservés pour les valeurs issues des paramètres. L’API peut renvoyer du JSON ou du XML. Le moteur convertit une réponse XML en structure JSON et l’ajoute à l’objet de données.
Un délai d’attente peut être défini pour chaque source, jusqu’à 15 secondes. Si l’API ne répond pas à temps, le flux continue et les règles traitent l’échec de l’appel comme les autres valeurs.
Utilisation de la réponse
Le moteur écrit la réponse complète dans l’objet de données, sous $.output, puis sous le nom de l’étape et celui de la source de données. Une règle, une table de décision, un scorecard ou une fonction lit les champs renvoyés en utilisant leur chemin.
Dans un cas de démonstration, une source nommée ip_check se trouve dans une étape nommée checks. Elle renvoie une réponse d’AbuseIPDB, que la règle lit à l’emplacement $.output.checks.ip_check.abuseConfidenceScore.
Le moteur consigne aussi des informations sur l’appel avec la réponse : __http_code, __attempts et __cached. En cas d’échec de l’appel, la sortie contient __error et __error_details.
Authentification de l’appel
Choisissez la méthode d’authentification attendue par le service. L’écran de la source de données propose « HTTP Authentication » pour un nom d’utilisateur et un mot de passe, et « OAuth2 Authentication » pour une adresse de jeton, un identifiant client et un secret. OAuth2 prend en charge le flux « client credentials » ou le flux « password », avec un périmètre, une audience ou un domaine facultatifs.
Le moteur met le jeton OAuth2 en cache et en demande un autre si nécessaire. Si l’API rejette le jeton avec une réponse 401, le moteur le supprime et en demande un nouveau une fois au cours de l’appel. Une clé API peut être transmise dans un en-tête ou un paramètre.
Un champ de clé, de jeton ou de mot de passe peut utiliser un identifiant de credential stocké dans le coffre-fort. La configuration conserve une référence telle que secret:openai_main. La valeur elle-même ne figure dans aucun export ni aucune version.
Appeler les services de l’entreprise
Un flux de décision peut appeler un service de l’entreprise comme il appelle celui d’un fournisseur. Voici quelques exemples de services qu’un prêteur ou un assureur peut appeler lors d’une décision :
- Le dossier client du système central, avec les produits détenus, les impayés et l’ancienneté, pour qu’un client de dix ans ne soit plus traité comme un inconnu.
- Un service de soldes ou d’exposition, qui fournit les soldes actuels des différents produits pour plafonner une nouvelle limite.
- Le service de tarification ou de produits, qui contient la grille tarifaire ou le catalogue de produits, afin de centraliser la grille.
- Le CRM ou le système de gestion de dossiers, pour vérifier si une demande, une réclamation ou un dossier de fraude est déjà ouvert au nom de cette personne.
- Le service documentaire ou KYC de l’entreprise, pour savoir si les justificatifs d’identité ont été vérifiés et à quelle date.
- Un appel PUT vers un autre système pour lui transmettre le résultat de la décision.
Decisimo appelle des adresses accessibles sur Internet. Le service doit donc disposer d’une adresse via votre passerelle API et être sécurisé par une clé ou OAuth2. Les adresses de bouclage, les plages privées 10/8, 172.16/12 et 192.168/16, ainsi que les adresses locales au lien sont refusées avant l’appel. Pour une adresse refusée, __error_details.type prend la valeur ssrf_blocked. Les redirections ne sont pas suivies : configurez directement l’URL finale.
Les anciens systèmes centraux utilisent souvent SOAP. Indiquez l’URL du WSDL et le nom de la méthode, puis associez les paramètres imbriqués à partir de leur chemin. La version SOAP est définie par la liaison du WSDL, et la réponse est convertie en JSON comme une réponse REST.
Appels multiples, échecs et nouvelles tentatives
Une même étape peut contenir plusieurs sources de données. Le moteur les appelle ensemble et attend la réponse la plus lente. Les vérifications peu coûteuses peuvent ainsi être regroupées dans une étape, et le demandeur n’attend que la plus longue d’entre elles.
Un délai d’attente dépassé, une erreur de connexion, une adresse bloquée ou une erreur HTTP n’interrompt pas tout le flux de décision. Le résultat indique l’erreur et sa cause, puis le flux continue. Une règle peut orienter la demande vers une branche de secours ou une file de traitement manuel. Cet article explique comment maintenir une stratégie de décision en cas de défaillance d’un fournisseur.
Utilisez « Retry this call if it fails » uniquement si un second appel peut être facturé et enregistré sans risque. Pour une source configurée avec une nouvelle tentative, le moteur réessaie après un échec de connexion ou une réponse HTTP 408, 425, 429, 502, 503 ou 504. Il attend entre 200 millisecondes et 2 secondes, et ne réessaie que si le temps disponible pour l’étape le permet. __attempts indique le nombre de tentatives.
La réponse d’une source peut aussi être mise en cache pour chaque étape de décision dans une destination Data cache d’une base PostgreSQL détenue par l’entreprise. La durée de cache par défaut est de 30 jours. La correspondance peut s’appuyer sur la requête ou sur un ensemble de paramètres sélectionnés. Les credentials ne sont pas pris en compte, et les erreurs ne sont pas stockées. __cached indique si une réponse stockée a été utilisée pour l’étape.
Configurer la source avec l’assistant
Le bouton « AI Assistant » de l’écran de la source de données ouvre un échange où il suffit de décrire l’API pour que l’assistant propose une configuration. La proposition s’affiche à côté des paramètres actuels pour être examinée. « Apply Configuration » remplit le formulaire, puis l’enregistrement conserve la source de données.
Si l’API nécessite une clé, un encadré « Credential needed » permet de choisir un identifiant existant ou d’en ajouter un au coffre-fort. Le chat transmet le nom de l’identifiant. L’assistant du flux peut aussi ajouter une tâche faisant appel à une source de données pendant la création du flux de décision.
Sélectionnez « Run test » pour appeler la source et afficher sa réponse.
Exemples de fournisseurs connectés
Une réponse de Fingerprint contient un identifiant de visiteur et indique si l’appareil ressemble à un robot. MaxMind minFraud renvoie un score de risque et indique si l’adresse e-mail est jetable. Trestle indique si une adresse e-mail est valide et quel type de ligne correspond à un numéro de téléphone.
Pour vérifier les adresses e-mail, Have I Been Pwned renvoie les fuites de données dans lesquelles une adresse apparaît, avec leurs dates et les catégories de données concernées. Email Hippo évalue l’adresse elle-même. Pour vérifier une adresse IP ou un appareil, AbuseIPDB renvoie un score de confiance associé aux abus, compris entre 0 et 100. Les guides de macaddress.io et de WhatIsMyBrowser montrent comment connecter deux autres services de vérification d’appareils de la même manière.
D’autres guides présentent BINLIST pour les cartes, Companies House pour les informations sur les entreprises et Google Places pour les données géographiques et les adresses. Ces services figurent sur la page des intégrations, classés selon le type de vérification.
En plus des sources de données, un flux peut appeler un modèle LLM à l’aide d’un modèle de prompt alimenté par les données de la décision, avec un format de sortie facultatif. Il peut aussi appeler un modèle entraîné par l’entreprise comme étape du flux. Les listes de blocage, d’autorisation et de surveillance restent dans la base de données de l’entreprise, et le flux les consulte pendant son exécution.
Questions fréquentes
Decisimo peut-il appeler un service sur notre réseau privé ?
Attribuez au service une adresse accessible sur Internet par l’intermédiaire de votre passerelle API. Les adresses de réseaux privés sont refusées avant l’appel.
Que se passe-t-il si un fournisseur répond lentement ?
Vous définissez le délai d’attente, jusqu’à 15 secondes. Si le fournisseur ne répond pas à temps, le flux continue en indiquant l’erreur et sa cause. Les règles déterminent la suite à donner.
Qui détient le contrat avec le fournisseur ?
L’entreprise détient le contrat et la clé auprès du fournisseur. Decisimo ne fournit pas les données du fournisseur.
Une même étape peut-elle appeler deux fournisseurs ?
Les sources sont appelées ensemble, et l’étape attend la réponse la plus lente.