AUTOMATISATION

Intégrations

Exécutez les moteurs depuis du code. Les calculs que vous utilisez à l’écran sont accessibles aux scripts dans le navigateur, à vos propres systèmes via une API REST et aux assistants IA via MCP, à travers un catalogue unique de fonctions de moteur.

Fonctions de calcul du catalogue partagé
27
Version OpenAPI, générée à partir du catalogue
3.1
Outils exposés via MCP
50
Portées des clés API : lecture, écriture et exécution
3
Éditeur de scripts de Converge : une liste d’exemples de scripts à gauche, un éditeur JavaScript calculant une table black-oil au centre, et en dessous le tableau de sortie avec la pression, le GOR de dissolution, le facteur volumétrique de fond et la viscosité.
Un exemple de script résolu calculant une table black-oil, avec sa sortie sous forme de tableau et de graphiques.

CE QU’IL FAIT

Les mêmes moteurs, trois points d’accès

Chaque fonction de moteur de Converge est décrite une seule fois, dans un catalogue qui fixe ses entrées, ses sorties et ses unités. L’éditeur de scripts, l’API REST et le serveur MCP appellent tous ce catalogue : un script, une intégration et un assistant IA obtiennent donc exactement les chiffres affichés à l’écran.

Les scripts sont en JavaScript et s’exécutent à chaque fois dans un worker de navigateur neuf et verrouillé : pas de réseau, pas d’accès à la page, pas d’eval ni d’imports, avec une limite de temps. Ils affichent du texte, des tableaux et des graphiques, sont enregistrés avec le projet et partent d’exemples résolus. L’API REST fournit une spécification OpenAPI 3.1 générée à partir du catalogue, de sorte que la documentation ne peut pas s’écarter du code.

Le serveur MCP permet à tout assistant IA compatible MCP de lister vos projets, de les lire et d’exécuter des fonctions de moteur via Streamable HTTP. Les appels API s’authentifient avec des clés personnelles à portée limitée et prennent un poste flottant pour leur module, comme le fait l’application.

En bref

  • Scripts JavaScript dans un worker de navigateur isolé
  • Exemples résolus en unités de champ ou métriques
  • Sorties print, table et plot
  • Scripts enregistrés avec le projet
  • API REST avec une spécification OpenAPI 3.1
  • Exemples curl, Python et JavaScript
  • Clés API personnelles à portée limitée, avec expiration
  • 120 requêtes par minute et par clé
  • Serveur MCP sur Streamable HTTP
  • Projets exposés comme ressources MCP
  • Un catalogue unique de 27 fonctions de moteur
  • Les postes s’appliquent aux appels API comme dans l’application

CAPACITÉS CLÉS

Scripts, REST et MCP en détail

Éditeur de scripts

Automatisez les calculs répétitifs sans quitter le navigateur.

  • JavaScript dans un worker neuf et verrouillé pour chaque exécution
  • Pas de réseau, pas d’accès à la page, pas d’eval, pas d’imports
  • Limite de temps de 10 secondes par défaut, 60 secondes au maximum
  • Sorties console, print, table() et plot()
  • Scripts enregistrés par projet
  • Unités de champ par défaut ; un seul appel bascule en métrique

Exemples résolus

Partez d’un script qui fonctionne déjà.

  • Table black-oil
  • Sensibilité nodale au water-cut
  • Calage et prévision de déclin
  • Enveloppe de phase SPE5
  • Diagnostics de bilan matière
  • Unités métriques et un essai de puits avec Horner et dérivée

Catalogue de calcul

Une description par fonction, utilisée par les trois voies d’accès.

  • Fonctions PVT et d’équation d’état
  • IPR, VLP et analyse nodale du puits
  • Bilan matière et déclin
  • Essai de puits synthétique, Horner et dérivée
  • Simulation, Buckley-Leverett, résolution du réseau et prévision intégrée
  • Indicateurs économiques et cash-flow ; analyse et validation des données

API REST

Connectez Converge à vos propres systèmes et chaînes de données.

  • Spécification OpenAPI 3.1 à /v1/openapi.json, générée à partir du catalogue
  • Lister et exécuter les fonctions de moteur
  • Lister, lire, enregistrer et supprimer des projets, ainsi que leurs versions
  • Exemples de code en curl, Python et JavaScript

Authentification et limites

Des clés que vous contrôlez, limitées à ce dont elles ont besoin.

  • Clés API personnelles envoyées comme jeton Bearer
  • Stockée uniquement sous forme de hachage et affichée une seule fois
  • Portées : projects:read, projects:write et engine:run
  • Expiration de 1 à 730 jours, ou aucune ; jusqu’à 25 clés actives par utilisateur
  • 120 requêtes par minute et par clé
  • Les clés API ne peuvent pas valider une revue

Serveur MCP

Laissez un assistant IA travailler sur vos projets Converge.

  • HTTP en streaming, JSON-RPC 2.0, sans état
  • Les 27 fonctions du catalogue, 21 outils de modèle de fluide en lecture seule, ainsi que la liste et la lecture des projets
  • Projets enregistrés exposés comme ressources
  • Fonctionne avec tout client compatible MCP

DÉROULEMENT

D’un script à une intégration

  1. Essayer un exemple résolu

    Ouvrez l’éditeur de scripts, exécutez un exemple et lisez le tableau et les graphiques.

  2. Écrire votre propre script

    Appelez n’importe quelle fonction de moteur, en unités de champ ou métriques, et enregistrez le script avec le projet.

  3. Créez une clé API

    Choisissez les portées et une expiration ; la clé n’est affichée qu’une fois.

  4. Appelez l’API REST

    Consultez la spécification OpenAPI et copiez un extrait curl, Python ou JavaScript.

  5. Connectez un assistant IA

    Pointez un client compatible MCP vers le point de terminaison MCP de Converge avec votre clé.

VALIDATION

Relancez vous-même les benchmarks

La page des benchmarks publie des scripts pour SPE1, PVT, essai de puits, déclin, bilan matière et VAN que chacun peut relancer dans son propre compte, via les mêmes fonctions de moteur que celles exposées par l’API.

Pas encore développés : d’autres langages de script (Python n’apparaît que dans les exemples REST), l’accès en écriture via MCP, les webhooks et l’optimisation de réseau via l’API. La régression et la déconvolution des essais de puits ne sont pas encore exposées via l’API.

DONNÉES D’ENTRÉE ET RÉSULTATS

Ce qui entre, ce qui sort

Données d’entrée

  • Scripts JavaScript dans l’éditeur
  • Requêtes JSON vers l’API REST
  • Appels d’outils MCP depuis un assistant IA
  • Clés API personnelles avec portées

Résultats

  • Résultats du moteur en JSON
  • Tableaux et graphiques dans l’éditeur
  • Données et versions du projet
  • Résultats des outils et ressources MCP

Exports

  • Spécification OpenAPI 3.1
  • Scripts enregistrés avec le projet
  • JSON du projet via l’API

FAQ

Intégrations : questions fréquentes

En quel langage les scripts sont-ils écrits ?

JavaScript, exécuté dans un worker de navigateur isolé, sans accès au réseau ni à la page, avec une limite de temps de 10 secondes par défaut, 60 au maximum.

Les scripts et l’API utilisent-ils les mêmes moteurs que l’application ?

Oui. Les scripts, l’API REST et le serveur MCP appellent tous un catalogue unique de fonctions de moteur : les résultats correspondent donc à l’écran.

Comment m’authentifier auprès de l’API REST ?

Avec une clé API personnelle envoyée comme jeton Bearer. Les clés ont pour portée projects:read, projects:write ou engine:run, peuvent expirer, ne sont stockées que sous forme de hachage et ne sont affichées qu’une fois.

Quels assistants IA peuvent utiliser le serveur MCP ?

Tout client prenant en charge MCP sur Streamable HTTP. Le serveur expose 50 outils, dont les fonctions de calcul et les outils de modèle de fluide en lecture seule, ainsi que vos projets enregistrés comme ressources.

Existe-t-il une spécification de l’API ?

Oui. Une spécification OpenAPI 3.1 à /v1/openapi.json, générée à partir du catalogue des moteurs, de sorte qu’elle correspond toujours au code.

Automatisez les calculs que vous répétez.