AUTOMATIZACIÓN

Integraciones

Ejecute los motores desde código. Los cálculos que usa en pantalla están disponibles para scripts en el navegador, para sus propios sistemas mediante una API REST y para asistentes de IA mediante MCP, a través de un único catálogo de funciones del motor.

Funciones del motor en el catálogo compartido
27
Versión de OpenAPI, generada a partir del catálogo
3.1
Herramientas expuestas mediante MCP
50
Alcances de las claves de API: lectura, escritura y ejecución
3
Editor de scripts de Converge: una lista de scripts de ejemplo a la izquierda, un editor JavaScript que calcula una tabla black-oil en el centro y, debajo, la tabla de salida con presión, RGP en solución, factor volumétrico de formación y viscosidad.
Un script de ejemplo resuelto que calcula una tabla black-oil, con su salida como tabla y gráficos.

QUÉ HACE

Los mismos motores, tres vías de acceso

Cada función del motor de Converge se describe una sola vez, en un catálogo que fija sus entradas, salidas y unidades. El editor de scripts, la API REST y el servidor MCP llaman a ese catálogo, de modo que un script, una integración y un asistente de IA obtienen exactamente los números que muestra la pantalla.

Los scripts son JavaScript y se ejecutan cada vez en un worker del navegador nuevo y restringido: sin red, sin acceso a la página, sin eval ni imports, y con un límite de tiempo. Imprimen, tabulan y grafican, se guardan con el proyecto y parten de ejemplos resueltos. La API REST ofrece una especificación OpenAPI 3.1 generada a partir del catálogo, de modo que la documentación no puede desviarse del código.

El servidor MCP permite que cualquier asistente de IA compatible con MCP liste sus proyectos, los lea y ejecute funciones del motor mediante Streamable HTTP. Las llamadas a la API se autentican con claves personales con alcances definidos y ocupan una licencia flotante de su módulo, igual que la aplicación.

De un vistazo

  • Scripts JavaScript en un worker aislado del navegador
  • Ejemplos resueltos en unidades de campo o métricas
  • Salida con print, table y plot
  • Scripts guardados con el proyecto
  • API REST con especificación OpenAPI 3.1
  • Fragmentos en curl, Python y JavaScript
  • Claves de API personales con alcances y vencimiento
  • 120 solicitudes por minuto por clave
  • Servidor MCP sobre Streamable HTTP
  • Proyectos expuestos como recursos MCP
  • Un único catálogo de 27 funciones del motor
  • Las licencias se aplican a las llamadas a la API igual que en la aplicación

CAPACIDADES CLAVE

Scripts, REST y MCP en detalle

Editor de scripts

Automatice cálculos repetitivos sin salir del navegador.

  • JavaScript en un worker nuevo y aislado para cada ejecución
  • Sin red, sin acceso a la página, sin eval, sin imports
  • Límite de tiempo de 10 segundos por defecto, 60 segundos como máximo
  • Salida de console, print, table() y plot()
  • Scripts guardados por proyecto
  • Unidades de campo por defecto; una llamada cambia a métricas

Ejemplos resueltos

Parta de un script que ya funciona.

  • Tabla black-oil
  • Sensibilidad nodal al corte de agua
  • Ajuste y pronóstico de declinación
  • Envolvente de fases de SPE5
  • Diagnóstico de balance de materiales
  • Unidades métricas y una prueba de pozo con Horner y derivada

Catálogo del motor

Una descripción por función, usada por las tres vías.

  • Funciones de PVT y de ecuación de estado
  • IPR, VLP y análisis nodal del pozo
  • Balance de materiales y declinación
  • Prueba de pozo sintética, Horner y derivada
  • Simulación, Buckley-Leverett, solución de red y pronóstico integrado
  • Indicadores económicos y flujo de caja; análisis y validación de datos

API REST

Conecte Converge a sus propios sistemas y canalizaciones de datos.

  • Especificación OpenAPI 3.1 en /v1/openapi.json, generada a partir del catálogo
  • Liste y ejecute funciones del motor
  • Listar, leer, guardar y eliminar proyectos y sus versiones
  • Fragmentos de código en curl, Python y JavaScript

Autenticación y límites

Claves que usted controla, con el alcance justo que necesitan.

  • Claves de API personales enviadas como token Bearer
  • Almacenada solo como hash y mostrada una sola vez
  • Alcances: projects:read, projects:write y engine:run
  • Vencimiento de 1 a 730 días, o ninguno; hasta 25 claves activas por usuario
  • 120 solicitudes por minuto por clave
  • Las claves de API no pueden aprobar una revisión

Servidor MCP

Deje que un asistente de IA trabaje con sus proyectos de Converge.

  • Streamable HTTP, JSON-RPC 2.0, sin estado
  • Las 27 funciones del catálogo, 21 herramientas de solo lectura del modelo de fluido, y la lista y lectura de proyectos
  • Proyectos guardados expuestos como recursos
  • Funciona con cualquier cliente compatible con MCP

FLUJO DE TRABAJO

De un script a una integración

  1. Pruebe un ejemplo resuelto

    Abra el editor de scripts, ejecute un ejemplo y lea la tabla y los gráficos.

  2. Escriba su propio script

    Llame a cualquier función del motor, en unidades de campo o métricas, y guarde el script con el proyecto.

  3. Cree una clave de API

    Elija los alcances y un vencimiento; la clave se muestra una sola vez.

  4. Llame a la API REST

    Lea la especificación OpenAPI y copie un fragmento en curl, Python o JavaScript.

  5. Conecte un asistente de IA

    Apunte un cliente compatible con MCP al endpoint MCP de Converge con su clave.

VALIDACIÓN

Vuelva a ejecutar los benchmarks usted mismo

La página de benchmarks publica scripts de SPE1, PVT, prueba de pozo, declinación, balance de materiales y VPN que cualquiera puede volver a ejecutar en su propia cuenta, mediante las mismas funciones del motor que expone la API.

Aún no disponible: otros lenguajes de scripting (Python aparece solo en los fragmentos REST), acceso de escritura por MCP, webhooks y optimización de redes a través de la API. La regresión y la deconvolución de pruebas de pozo aún no están expuestas en la API.

ENTRADAS Y SALIDAS

Qué entra y qué sale

Entradas

  • Scripts JavaScript en el editor
  • Solicitudes JSON a la API REST
  • Llamadas a herramientas MCP desde un asistente de IA
  • Claves de API personales con alcances

Salidas

  • Resultados del motor en JSON
  • Tablas y gráficos en el editor
  • Datos y versiones del proyecto
  • Resultados y recursos de herramientas MCP

Exportaciones

  • Especificación OpenAPI 3.1
  • Scripts guardados con el proyecto
  • JSON del proyecto a través de la API

PREGUNTAS FRECUENTES

Integraciones: preguntas frecuentes

¿En qué lenguaje se escriben los scripts?

JavaScript, ejecutado en un worker aislado del navegador sin acceso a la red ni a la página y con un límite de tiempo de 10 segundos por defecto, 60 como máximo.

¿Los scripts y la API usan los mismos motores que la aplicación?

Sí. Los scripts, la API REST y el servidor MCP llaman a un único catálogo de funciones del motor, así que los resultados coinciden con la pantalla.

¿Cómo me autentico en la API REST?

Con una clave de API personal enviada como token Bearer. Las claves tienen alcance projects:read, projects:write o engine:run, pueden vencer, se almacenan solo como hash y se muestran una sola vez.

¿Qué asistentes de IA pueden usar el servidor MCP?

Cualquier cliente que admita MCP sobre Streamable HTTP. El servidor expone 50 herramientas, incluidas las funciones del motor y las herramientas de solo lectura del modelo de fluido, y sus proyectos guardados como recursos.

¿Existe una especificación de la API?

Sí. Una especificación OpenAPI 3.1 en /v1/openapi.json, generada a partir del catálogo del motor, por lo que siempre coincide con el código.

Automatice los cálculos que repite.