Agentes Hospedados | EmpirioLabs AI Docs

Os Agentes Hospedados oferecem um runtime de agente privado que se conecta às suas ferramentas e roda com modelos do EmpirioLabs. Cada agente é isolado, mantém seu próprio armazenamento persistente e é acessível via a API do EmpirioLabs ou pelos seus canais conectados.

Por que Agentes Hospedados

Vive em seus aplicativos

Conecte-se ao Telegram, Discord, Slack, Matrix, Teams, WhatsApp e muito mais.

Usa ferramentas conectadas

Adicione Gmail, Drive, GitHub, Notion, Slack, conectores MCP personalizados e mais.

Executa código com segurança

Execute Python, pacotes, comandos e arquivos gerados em sandboxes isolados.

Navega visualmente

Abra páginas da web, clique, digite, role a tela e salve capturas de tela.

Gera mídia

Crie imagens, vídeos, falas, música, recursos 3D, transcrição e muito mais.

Modelos, geridos

Use modelos EmpirioLabs, Poe ou seu próprio provedor compatível.

OpenClaw e Hermes

OpenClaw

Um assistente popular que faz tudo. Um padrão forte quando você quer um agente geral capaz logo de cara.

Hermes

Um agente que aprende e lembra com o tempo, então isso fica mais útil para sua equipe quanto mais você o utiliza.

Planos

Básico

Um tempo inicial de execução para um único agente a 15 USD por mês.

Prós

Mais recursos de execução e margem de manobra a 30 USD por mês.

Início rápido

Implante um agente

Escolha um tempo de execução (openclaw ou hermes) e um plano, e então faça o deploy. A resposta inclui um agente id e um status.

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "name": "My Assistant",
>     "agent_type": "openclaw",
>     "plan_slug": "hosted-agent-basic"
>   }'

Espera até estar a correr

Consulte o agente até que sua status esteja running.

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Conectar e usá-lo

Envie uma mensagem para o agente pela API, ou conecte um canal e converse com ele a partir daí.

Implante e gerencie com a API

Todas as requisições usam sua chave API do EmpirioLabs como token de portador. A URL base é https://api.empiriolabs.ai, e todo endpoint de agente está sob /v1/hosted-agents.

Implante um agente

agent_type é openclaw ou hermes; plan_slug é hosted-agent-basic ou hosted-agent-pro. Por padrão, o agente roda em modelos EmpirioLabs; Defina default_model para escolher um específico, ou default_provider para poe ou custom apontar para seu próprio provedor.

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "name": "My Assistant",
>     "agent_type": "openclaw",
>     "plan_slug": "hosted-agent-basic",
>     "default_model": "qwen3-7-plus"
>   }'

Liste seus agentes

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Arrume um agente

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Envie uma mensagem

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/message \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "messages": [{ "role": "user", "content": "What is on my calendar today?" }]
>   }'

Começar, parar, reiniciar

A ação é o último segmento do caminho: start, stop, restart ou refresh.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/restart \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Renomear um agente

$ curl -X PATCH https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "name": "Renamed Assistant" }'

Exclua um agente

$ curl -X DELETE https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Configure todas as configurações da API

Tudo que você pode mudar no painel também é controlável pela API, então você pode gerenciar os agentes inteiramente de forma programática.

Altere o modelo ou provedor

Mude o modelo do agente no lugar (sem redeploy). provider é empirio, poe ou custom.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/model \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "provider": "empirio", "model": "qwen3-7-plus" }'

Habilidades

As habilidades são playbooks reutilizáveis que o agente segue. Pesquise no registro oficial (OpenClaw usa ClawHub, Hermes usa skills.sh) e adicione uma habilidade pela referência, ou cole a sua própria.

$ # List installed skills
$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
$ 
$ # Add an official skill (OpenClaw: clawhub:<slug>, Hermes: hermes:<id>)
$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "slug": "hermes:openai/skills/pdf" }'
$ 
$ # Add your own pasted skill
$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "custom": { "name": "House Style", "body": "Always answer in a concise, friendly tone." } }'
$ 
$ # Remove a skill
$ curl -X DELETE "https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills?slug=hermes:openai/skills/pdf" \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Conectores (MCP)

Conecte um servidor MCP remoto para fornecer ferramentas e dados ao agente.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/mcp \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "name": "my-tools", "url": "https://example.com/mcp" }'

Canais

Conecte um canal de mensagens baseado em token (por exemplo, telegram, discord ou slack) para que as pessoas possam conversar com o agente lá. Telegram, Discord, Slack e Matrix funcionam com agentes OpenClaw e Hermes. Mattermost e Microsoft Teams são exclusivos para OpenClaw. O WhatsApp é pareado no painel com um código QR em vez desse endpoint token.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/integrations \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "kind": "telegram", "secret": "YOUR_BOT_TOKEN" }'

O comportamento do canal controla pequenos sinais de chat em cada conector. Por padrão, indicadores de digitação e reações mínimas de processamento estão ativados, os recibos de leitura estão desativados e a prévia de resposta ao vivo está desativada. A prévia de resposta ao vivo utiliza suporte nativo de edição ou pré-visualização de rascunhos quando disponível; ele é separado do streaming de API de modelos.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/integrations/telegram/behavior \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "behavior": {
>       "reaction_level": "minimal",
>       "typing": true,
>       "read_receipts": false,
>       "streaming": false
>     }
>   }'

Quem pode enviar mensagem para o bot

mode é open (qualquer um) ou restricted (apenas os IDs de mensagem que você permite). Com restricted e sem documentos, a primeira pessoa a enviar mensagem se torna o dono. Inclua kind para definir a regra para um canal conectado.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/access \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "kind": "telegram", "mode": "restricted", "allow": { "telegram": ["123456789"] } }'

Precificação

Os Agentes Hospedados são cobrados mensalmente por agente, dependendo do plano que você escolher. O básico custa 15 USD por mês e o Pro é 30 USD por mês. O plano cobre o tempo de execução do agente. Os modelos usados pelo agente são faturados separadamente com tarifas padrão de modelo.

Limites

Cada conta pode rodar um número limitado de agentes implantados ao mesmo tempo. As configurações do seu painel mostram seu limite efetivo. Contato us para aumentar seu limite.

Etiqueta branca

Você pode construir agentes hospedados no seu próprio produto e operá-los totalmente sob sua própria marca. A API não tem marca: você chama /v1/hosted-agents/* com sua chave API do EmpirioLabs e exibe o agente como quiser, para que seus usuários finais interajam com seu produto, não com o nosso. Não há a marca EmpirioLabs nas respostas da API ou nas respostas do agente. Para limites maiores de agentes, capacidade dedicada ou um acordo comercial personalizado, envie um e-mail para support@empiriolabs.ai.

Próximos passos

Referência da API dos agentes hospedados

Esquemas completos de solicitação e resposta para cada endpoint de agente hospedado.

Modelos e preços

Veja os modelos que seu agente pode usar.