AUTOMAÇÃO

Integrações

Execute os motores por código. Os cálculos que você usa na tela estão disponíveis para scripts no navegador, para os seus próprios sistemas por uma API REST e para assistentes de IA por MCP, por meio de um único catálogo de funções do motor.

Funções do motor no catálogo compartilhado
27
Versão OpenAPI, gerada a partir do catálogo
3.1
Ferramentas expostas por MCP
50
Escopos das chaves de API: leitura, escrita e execução
3
Editor de scripts do Converge: uma lista de scripts de exemplo à esquerda, um editor JavaScript calculando uma tabela black-oil no centro e, abaixo, a tabela de saída com pressão, razão de solubilidade, fator volume-formação e viscosidade.
Um script de exemplo resolvido que calcula uma tabela black-oil, com a saída em tabela e gráficos.

O QUE FAZ

Os mesmos motores, três formas de acesso

Cada função do motor do Converge é descrita uma única vez, num catálogo que define suas entradas, saídas e unidades. O editor de scripts, a API REST e o servidor MCP chamam todos esse catálogo, de modo que um script, uma integração e um assistente de IA obtêm exatamente os números que a tela mostra.

Os scripts são em JavaScript e rodam a cada vez num worker de navegador novo e isolado: sem rede, sem acesso à página, sem eval e sem imports, com limite de tempo. Eles imprimem, tabulam e plotam, são salvos com o projeto e partem de exemplos resolvidos. A API REST fornece uma especificação OpenAPI 3.1 gerada a partir do catálogo, de modo que a documentação não pode se desviar do código.

O servidor MCP permite que qualquer assistente de IA compatível com MCP liste seus projetos, leia-os e execute funções do motor via Streamable HTTP. As chamadas de API são autenticadas com chaves pessoais com escopo definido e ocupam uma licença flutuante do respectivo módulo, da mesma forma que o aplicativo.

Em resumo

  • Scripts JavaScript num worker de navegador em sandbox
  • Exemplos resolvidos em unidades de campo ou métricas
  • Saída com print, table e plot
  • Scripts salvos com o projeto
  • API REST com especificação OpenAPI 3.1
  • Trechos de código em curl, Python e JavaScript
  • Chaves de API pessoais com escopo e validade
  • 120 requisições por minuto por chave
  • Servidor MCP sobre Streamable HTTP
  • Projetos expostos como recursos MCP
  • Um catálogo de 27 funções do motor
  • As licenças valem para chamadas de API como no aplicativo

PRINCIPAIS RECURSOS

Scripts, REST e MCP em detalhe

Editor de scripts

Automatize cálculos repetitivos sem sair do navegador.

  • JavaScript num worker novo e isolado a cada execução
  • Sem rede, sem acesso à página, sem eval, sem imports
  • Limite de tempo de 10 segundos por padrão, 60 segundos no máximo
  • Saída de console, print, table() e plot()
  • Scripts salvos por projeto
  • Unidades de campo por padrão; uma chamada muda para o sistema métrico

Exemplos resolvidos

Comece a partir de um script que já funciona.

  • Tabela black-oil
  • Sensibilidade nodal ao corte de água
  • Ajuste e previsão de declínio
  • Envelope de fases do SPE5
  • Diagnóstico de balanço de materiais
  • Unidades métricas e um Horner e derivada de teste de poço

Catálogo do motor

Uma descrição por função, usada pelas três vias.

  • Funções de PVT e de equação de estado
  • IPR, VLP e análise nodal do poço
  • Balanço de materiais e declínio
  • Teste de poço sintético, Horner e derivada
  • Simulação, Buckley-Leverett, solução da rede e previsão integrada
  • Indicadores econômicos e fluxo de caixa; interpretação e validação de dados

API REST

Conecte o Converge aos seus próprios sistemas e pipelines de dados.

  • Especificação OpenAPI 3.1 em /v1/openapi.json, gerada a partir do catálogo
  • Liste e execute funções do motor
  • Listar, ler, salvar e excluir projetos e suas versões
  • Trechos de código em curl, Python e JavaScript

Autenticação e limites

Chaves que você controla, com escopo limitado ao que precisam.

  • Chaves de API pessoais enviadas como token Bearer
  • Armazenada apenas como hash e mostrada uma única vez
  • Escopos: projects:read, projects:write e engine:run
  • Validade de 1 a 730 dias, ou sem validade; até 25 chaves ativas por usuário
  • 120 requisições por minuto por chave
  • Chaves de API não podem aprovar uma revisão

Servidor MCP

Deixe um assistente de IA trabalhar com seus projetos do Converge.

  • Streamable HTTP, JSON-RPC 2.0, sem estado
  • As 27 funções do catálogo, 21 ferramentas somente leitura de modelo de fluido, e listagem e leitura de projetos
  • Projetos salvos expostos como recursos
  • Funciona com qualquer cliente compatível com MCP

FLUXO DE TRABALHO

De um script a uma integração

  1. Experimente um exemplo resolvido

    Abra o editor de scripts, rode um exemplo e leia a tabela e os gráficos.

  2. Escreva seu próprio script

    Chame qualquer função do motor, em unidades de campo ou métricas, e salve o script com o projeto.

  3. Crie uma chave de API

    Escolha os escopos e uma validade; a chave é exibida uma única vez.

  4. Chame a API REST

    Leia a especificação OpenAPI e copie um trecho em curl, Python ou JavaScript.

  5. Conecte um assistente de IA

    Aponte um cliente compatível com MCP para o endpoint MCP do Converge usando sua chave.

VALIDAÇÃO

Execute os benchmarks você mesmo

A página de benchmarks publica scripts de SPE1, PVT, teste de poço, declínio, balanço de materiais e VPL que qualquer pessoa pode executar novamente na própria conta, pelas mesmas funções do motor que a API expõe.

Ainda não implementados: outras linguagens de script (Python aparece apenas como trechos para a API REST), acesso de escrita pelo MCP, webhooks e otimização de rede pela API. A regressão e a deconvolução de testes de poço ainda não estão expostas na API.

ENTRADAS E SAÍDAS

O que entra, o que sai

Entradas

  • Scripts JavaScript no editor
  • Requisições JSON à API REST
  • Chamadas de ferramentas MCP a partir de um assistente de IA
  • Chaves de API pessoais com escopos

Saídas

  • Resultados do motor em JSON
  • Tabelas e gráficos no editor
  • Dados e versões do projeto
  • Resultados e recursos das ferramentas MCP

Exportações

  • Especificação OpenAPI 3.1
  • Scripts salvos com o projeto
  • JSON do projeto pela API

FAQ

Integrações: perguntas frequentes

Em que linguagem os scripts são escritos?

JavaScript, executado num worker isolado do navegador sem acesso à rede ou à página e com limite de tempo de 10 segundos por padrão, 60 no máximo.

Os scripts e a API usam os mesmos motores do aplicativo?

Sim. Os scripts, a API REST e o servidor MCP chamam todos um único catálogo de funções do motor, de modo que os resultados correspondem à tela.

Como me autentico na API REST?

Com uma chave de API pessoal enviada como token Bearer. As chaves têm escopo projects:read, projects:write ou engine:run, podem expirar, são armazenadas apenas como hash e são exibidas uma única vez.

Quais assistentes de IA podem usar o servidor MCP?

Qualquer cliente que suporte MCP sobre Streamable HTTP. O servidor expõe 50 ferramentas, incluindo as funções do motor e ferramentas somente leitura de modelo de fluido, e seus projetos salvos como recursos.

Existe uma especificação da API?

Sim. Uma especificação OpenAPI 3.1 em /v1/openapi.json, gerada a partir do catálogo do motor, de modo que sempre corresponde ao código.

Automatize os cálculos que você repete.