# Usar a API HTTP A API HTTP permanece na suíte MCP-native: crie objetivos, consulte tarefas e trate intervenções e resultados desconhecidos. Página canônica: https://remote-agent-machine.carneiro.ai/docs/http ## Autenticação e seleção A API HTTP autenticada permanece disponível para aplicativos e integrações da suíte. MCP é a interface principal para harnesses; os dois caminhos usam serviços do mesmo núcleo independente de protocolo. Os objetivos do Agent usam uma VM atribuída hoje; a composição com MicroVM ainda é planejada. A origem desta instalação é https://remote-agent-machine.carneiro.ai. Forneça Authorization: Bearer com uma chave da sua conta nas chamadas da API. Fora de desenvolvimento em loopback, use HTTPS. Para executar, use uma chave runner, selecione computer_id e confirme que o Brain está configurado. Uma task_observer acessa somente GET /api/runs, GET /api/runs/{id} e GET /api/runs/{id}/events. Consultar status do computador não faz parte desse propósito. ## Descubra seu computador Antes de enviar a tarefa, consulte GET /api/computers com a chave runner. A resposta contém computers, uma lista de computadores próprios. Use o campo id do computador escolhido como computer_id; não use o nome label como identificador. Confira state e availability: state ready é cadastro persistido, enquanto availability available indica disponibilidade atual. in_use significa ocupado e unavailable ou not_ready não comprova computador utilizável. Uma lista vazia exige atribuição pelo administrador. GET /api/status?computer_id=ID confere as capacidades da seleção; a execução agent ainda depende de provedor configurado. ## Enviar um objetivo POST /api/runs recebe o mesmo objeto ilustrado na página MCP, com runtime agent explícito. Guarde a idempotency_key e os parâmetros do pedido antes de enviar. A resposta contém run; queued não significa que o navegador já esteja pronto. allow_mutations false limita alterações pelas ferramentas; true amplia o alcance existente e não substitui autorização específica para compras ou efeitos sensíveis. Um texto de prompt não é uma política independente de segurança. ## Consultar sem executar O exemplo lê tarefas. Defina RAM_API_KEY por um mecanismo privado do seu host. O heredoc fornece a configuração ao curl por stdin, sem inserir a chave literalmente no exemplo. Não execute com tracing de shell nem registre headers. - GET /api/runs — tarefas próprias; limit (1–100, padrão 30), before, status e computer_id. Use next_before para continuar. - GET /api/runs/{id} — estado e resultado da tarefa própria. - GET /api/runs/{id}/events?after=0 — eventos após o cursor; conserve o último id recebido. - GET /api/runs/{id}/viewer — link opcional para a tela web limpa do computador; usuário ainda precisa entrar na conta. - POST /api/runs/{id}/cancel com {} — solicitar cancelamento. - POST /api/runs/{id}/continue com idempotency_key — continuação explícita ligada à tarefa anterior. ```sh curl --silent --show-error --fail-with-body --config - <