O Ephemeral executa agentes de IA em máquinas seguras e descartáveis. Descreva uma tarefa uma vez e execute-a pelo seu código, pela CLI, pelo painel ou em um agendamento. Cada execução recebe uma microVM nova, os arquivos e as conexões que você permitir e um limite de gastos. Ele transmite cada etapa enquanto trabalha e, depois, a máquina é destruída. A saída, os eventos e o custo permanecem.
curl $EPHEMERAL_URL/v1/runs \
-H "Authorization: Bearer $EPHEMERAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"Summarize the input in one sentence","input":{"text":"…"},"max_cost_micros":500000}'Para quem é
O Ephemeral é para desenvolvedores que adicionam tarefas de IA em segundo plano às suas aplicações: investigar um ticket de suporte ou um pagamento que falhou, vigiar um sistema e explicar o que mudou, escrever um relatório agendado ou cuidar de uma rotina operacional. Seu código inicia uma execução com uma chamada de API e o resultado volta para o seu código.
O que o Ephemeral resolve para você
Em torno de uma API de modelo, você precisaria construir:
- Uma máquina nova e isolada para cada tarefa, destruída ao terminar.
- Um broker de credenciais: o agente chama suas APIs sem ver nenhum segredo e apenas com os métodos ou ferramentas que você permitir.
- Orçamentos rígidos por execução, reservados antes de começar e liquidados pelo custo exato depois.
- Uma linha do tempo registrada e o custo exato de cada execução.
- Agendamentos e callbacks assinados: o trabalho começa na hora e seu servidor sabe quando termina.
- Um período de retenção fixo e retenção zero de dados para execuções sensíveis. Veja também segurança e dados.
Como as peças se encaixam
Uma execução é um agente trabalhando em uma tarefa. Você a descreve com um prompt e uma entrada em JSON e escolhe quais arquivos ela pode ler e quais conexões pode chamar. Um fluxo de trabalho é a definição de uma execução salva com um nome, de modo que seu código envia apenas o nome e a nova entrada. Um agendamento inicia um fluxo de trabalho em um horário definido, em qualquer fuso horário.
O worker roda na própria microVM. Ele nunca recebe as chaves do seu provedor nem as credenciais das conexões: as chamadas ao modelo e as requisições das conexões passam pelo Ephemeral com um token de execução de curta duração e apenas pelos métodos ou ferramentas que você permitiu.
Para onde ir em seguida
Versões e descontinuação
A API é versionada no caminho: todos os endpoints ficam em /v1. Dentro de uma versão, as mudanças só acrescentam: novos endpoints, novos campos opcionais de requisição, novos campos de resposta e novos tipos de evento. Os campos existentes mantêm nome e significado, então os clientes devem ignorar campos que não conhecem.
Uma mudança que quebraria clientes existentes sai como uma nova versão em um novo caminho. A versão anterior continua funcionando por pelo menos seis meses depois da publicação da nova. Enquanto estiver descontinuada, as respostas trazem um cabeçalho Deprecation e um cabeçalho Sunset com a data em que ela para de funcionar, e os donos das organizações são avisados por e-mail.