DOCUMENTAÇÃO PARA AGENTES E DESENVOLVEDORES

RAM: suíte MCP-native para agentes

VM para controle direto, Agent para objetivos e MicroVM efêmera em desenvolvimento: conheça os produtos do RAM.

Uma suíte. Três produtos.

RAM — Remote Agentic Machine é uma suíte MCP-native para dar capacidade de execução aos agentes. RAM VM oferece o computador completo; RAM Agent recebe objetivos e conduz o trabalho; RAM MicroVM está em desenvolvimento para tarefas curtas em ambientes efêmeros. Cada produto tem um papel próprio e pode compor o mesmo fluxo quando essa integração estiver disponível.

  • RAM MicroVM: proposta de um ambiente descartável que inicia para uma tarefa curta e pode ser destruído ao terminar. O runtime e o browser ainda precisam de prova Linux/KVM; não há backend operacional nem tempo de boot medido.
  • RAM VM: computador remoto completo com navegador, desktop, shell e arquivos persistentes conforme a política da implantação. Seu harness controla as ferramentas diretamente, sem precisar usar o RAM Agent.
  • RAM Agent: objetivos delegados ao Brain, com histórico, limites, automações, conexões e Vault. Hoje executa sobre uma VM atribuída; a composição com MicroVM é planejada. O Brain permanece fora do computador.

Use os produtos de forma independente ou em conjunto

Com RAM VM, o modelo do seu harness escolhe cada passo. Com RAM Agent, você delega um objetivo ao Brain remoto, que registra seu andamento; desconectar o cliente não cancela por si só essa execução delegada. O agente que envia o objetivo pode ser outro agente.

Você pode combinar objetivos do RAM Agent e controle direto do RAM VM na mesma conta, respeitando o computador, a geração e a concessão exclusiva de cada sessão. Uma conexão MCP não toma o controle do humano nem permite dois controladores ao mesmo tempo. A seleção de MicroVM pelo Agent ainda não está implementada.

MCP nativo, núcleo independente de protocolo

MCP é a interface principal para conectar harnesses e descobrir ferramentas por produto. O núcleo do RAM continua independente de MCP, de provedor de modelo e de nuvem; os serviços da aplicação também sustentam a API HTTP autenticada.

A API HTTP permanece disponível para objetivos, consultas, recursos de conta e integração de aplicativos. HTTP e streaming visual complementam os conectores MCP. A API pública é a do gateway; o cliente não se conecta diretamente ao executor.

Antes do primeiro pedido

Você precisa do endereço desta instalação, de acesso à sua conta e de um computador atribuído e utilizável. Criar uma chave não cria nem liga uma VM. Se nenhum computador estiver disponível, peça a atribuição ao administrador antes de executar.

Uma chave runner permite as operações existentes da própria conta. Uma chave task_observer permite somente consultar tarefas próprias e eventos por HTTP; não serve para MCP, execução, controle visual ou conexões. Administração e emissão de chaves exigem sessão por senha recente.

  • MCP: configure seu harness e deixe o seu modelo conduzir as ferramentas.
  • HTTP: envie um objetivo com runtime agent, computador explícito e limites.
  • JavaScript: integre a API HTTP com fetch, sem instalar o servidor RAM.

O que você pode esperar hoje

Esta versão oferece /agent/mcp para objetivos e /vm/mcp para controle direto. O endpoint /mcp continua válido para os clientes existentes. /microvm/mcp informa somente a indisponibilidade de execução. Confirme as capacidades da instalação autenticada antes de agir.

VM e Agent usam a capacidade atribuída à conta e os provedores configurados na instalação. A disponibilidade e o provisionamento dependem dessa configuração; não há promessa de criação instantânea, autoscaling ou disponibilidade para qualquer novo usuário. MicroVM ainda não executa tarefas; boot, browser e consumo precisam ser medidos antes de prometer desempenho.

Conexões externas precisam ser configuradas e autorizadas. Cadastrar uma senha no Vault não significa que um site esteja autenticado. As provas experimentais de preenchimento não entregam login automático útil no fluxo público.

Os exemplos descrevem capacidades gerais, não integrações prontas de compras, clínicas, viagens ou delivery. Na VM, arquivos e perfil podem persistir conforme a implantação; processos e memória não têm promessa de persistência. A MicroVM planejada tem ciclo efêmero, sem promessa de conservar estado de trabalho entre tarefas.

Perguntas frequentes

Preciso instalar um modelo dentro do computador?

Não. No MCP, o modelo permanece no seu harness. Na delegação, o provedor do Brain é configurado fora do computador.

Posso usar o RAM sem uma VM atribuída?

Você pode acessar os recursos de conta permitidos, mas tarefas que usam computador precisam de uma capacidade atribuída e disponível. Uma chave de API não provisiona uma máquina.

Posso usar RAM VM sem RAM Agent?

Sim. Seu harness pode controlar o computador pelas ferramentas existentes. RAM Agent é a opção para delegar objetivos e manter a execução no servidor; não é requisito para o controle direto da VM.

RAM Agent já pode escolher uma MicroVM?

Não. Hoje o Agent usa uma VM atribuída. A composição com MicroVM é planejada e depende do runtime, do browser e da integração do executor ainda em desenvolvimento.

Quando escolher MicroVM ou VM?

A MicroVM está sendo desenvolvida para uma tarefa curta em ambiente descartável. A VM atende trabalho contínuo num computador completo com arquivos persistentes conforme a implantação. MicroVM ainda não está disponível para executar tarefas e não tem tempo de boot medido.

MCP-native significa que a API HTTP será removida?

Não. MCP é a interface principal para harnesses; o núcleo independe do protocolo e a API HTTP permanece disponível para aplicativos e integrações.

Onde encontro os exemplos para agentes?

As páginas MCP, HTTP, JavaScript, Intervenções, Streaming nativo e Segurança também têm versões Markdown. O índice llms.txt aponta para essas mesmas fontes públicas.

Esta documentação é pública e não concede acesso à conta. Confirme capacidades e permissões na instalação autenticada. Segredos não pertencem à conversa do agente.