Ephemeral ejecuta agentes de IA en máquinas seguras y desechables. Describe una tarea una vez y ejecútala desde tu código, la CLI, el panel o con una programación. Cada ejecución recibe una microVM nueva, los archivos y las conexiones que permitas, y un límite de gasto. Transmite cada paso mientras trabaja y después la máquina se destruye. Se conservan el resultado, los eventos y el coste.
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 quién es
Ephemeral es para desarrolladores que añaden tareas de IA en segundo plano a sus aplicaciones: investigar un ticket de soporte o un pago fallido, vigilar un sistema y explicar qué cambió, redactar un informe programado o encargarse de una tarea operativa. Tu código inicia una ejecución con una llamada a la API y el resultado vuelve a tu código.
Lo que Ephemeral resuelve por ti
Alrededor de una API de modelos, tendrías que construir:
- Una máquina nueva y aislada para cada tarea, que se destruye al terminar.
- Un intermediario de credenciales: el agente llama a tus API sin ver ningún secreto y solo con los métodos o herramientas que permitas.
- Presupuestos estrictos por ejecución, reservados antes de empezar y liquidados al coste exacto después.
- Una cronología registrada y el coste exacto de cada ejecución.
- Programaciones y callbacks firmados: el trabajo empieza a su hora y tu servidor se entera de cuándo termina.
- Un periodo de retención fijo y retención cero de datos para ejecuciones sensibles. Consulta también seguridad y datos.
Cómo encajan las piezas
Una ejecución es un agente que trabaja en una tarea. La describes con un prompt y una entrada JSON, y eliges qué archivos puede leer y a qué conexiones puede llamar. Un flujo de trabajo es una definición de ejecución guardada con un nombre, de modo que tu código solo envía el nombre y la nueva entrada. Una programación inicia un flujo de trabajo según un calendario, en cualquier zona horaria.
El worker se ejecuta en su propia microVM. Nunca recibe las claves de tu proveedor ni las credenciales de tus conexiones: las llamadas al modelo y las solicitudes de conexión pasan por Ephemeral con un token de ejecución de corta duración, y solo hacia los métodos o herramientas que hayas permitido.
Siguientes pasos
Versiones y retirada
La API se versiona en la ruta: todos los endpoints están bajo /v1. Dentro de una versión los cambios solo añaden: endpoints nuevos, campos opcionales nuevos en las solicitudes, campos nuevos en las respuestas y tipos de evento nuevos. Los campos existentes conservan su nombre y su significado, así que los clientes deben ignorar los campos que no conozcan.
Un cambio que rompería a los clientes existentes se publica como una versión nueva con una ruta nueva. La versión anterior sigue funcionando al menos seis meses después de publicarse la nueva. Mientras está en retirada, sus respuestas llevan una cabecera Deprecation y una cabecera Sunset con la fecha en que dejará de funcionar, y avisamos por correo a los propietarios de las organizaciones.