Documentação do RAM

Produtos e formas de uso

RAM — Remote Agentic Machine dá ao agente do seu harness acesso a uma máquina por MCP. RAM MicroVM oferece ambientes efêmeros nos hosts configurados; RAM Android controla dispositivos móveis atribuídos à conta; RAM VM oferece um computador com arquivos persistentes. RAM Agent é uma opção para delegar objetivos ao serviço. Cada produto tem um papel próprio e pode compor o mesmo fluxo quando essa integração estiver disponível.

• RAM MicroVM: ambiente descartável com criação por API/MCP, browser, shell, arquivos e visual na mesma geração. A implantação qualificada possui capacidade limitada; cota e fila não garantem início imediato. Não há promessa de boot em milissegundos.
• RAM Android: dispositivos privados da conta, com apps, observação e entrada pelo conector Android; dependem de capacidade e configuração próprias.
• 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 e de uma conta liberada pelo administrador. Entre com seu acesso e, em Meu acesso, escolha Executar no RAM para emitir uma chave runner; mantenha a chave fora de conversas, URLs e logs. A configuração do header está no guia Conectar MCP. Criar uma chave não cria nem liga uma VM.

Para navegar ou controlar, selecione um computador ou dispositivo autorizado e pronto. Objetivos do Agent usam uma VM atribuída e utilizável. Quando as ferramentas de criação estiverem disponíveis e o custo autorizado, VM, MicroVM e Android podem criar o primeiro recurso sem atribuição anterior; siga os schemas, perfis e recibos do produto. Para MicroVM dinâmica, faça a descoberta de ferramentas e consulte ram_status para verificar dynamic_resources; use microvm_list, quando anunciada, para inspecionar recursos existentes. Envie microvm_create uma vez; acompanhe a operação com microvm_operation_status usando o mesmo action_id e confirme o recurso running com microvm_get antes de operar. Uma recusa por limite ou espera por capacidade não autoriza nova criação. Essas leituras não garantem vaga física nem antecipam toda recusa de cota.

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

Os quatro conectores são /microvm/mcp para computadores efêmeros, /vm/mcp para VMs, /android/mcp para Android e /agent/mcp para objetivos delegados. Confirme as capacidades e a disponibilidade da conta 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 dinâmica usa capacidade de hosts configurados e cota própria da conta; uma sessão queued ainda não está pronta. O tempo de criação inclui preparo do disco, navegador e readiness; não há promessa de boot instantâneo.

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 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 da integração dos objetivos com o ciclo de vida efêmero.

Quando escolher MicroVM ou VM?

MicroVM atende execuções isoladas em ambiente descartável, sujeito à cota e à capacidade dos hosts. VM atende trabalho contínuo com arquivos persistentes conforme a implantação. Criação, descarte e limites são distintos; não há promessa de início instantâneo.

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.