Ephemeral exécute des agents IA dans des machines sécurisées et jetables. Décrivez une tâche une fois, puis lancez-la depuis votre code, la CLI, le tableau de bord ou selon une planification. Chaque exécution dispose d'une microVM neuve, des fichiers et des connexions que vous autorisez, et d'une limite de dépense. Elle diffuse chaque étape en direct pendant que l'agent travaille, puis la machine est détruite. La sortie, les événements et le coût sont conservés.
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}'À qui s'adresse Ephemeral
Ephemeral s'adresse aux développeurs qui ajoutent des tâches d'IA en arrière-plan à leurs applications : enquêter sur un ticket de support ou un paiement échoué, surveiller un système et expliquer ce qui a changé, rédiger un rapport planifié ou accomplir une tâche d'exploitation. Votre code lance une exécution par un appel d'API, et le résultat revient à votre code.
Ce qu'Ephemeral gère à votre place
Autour d'une API de modèle, vous devriez sinon construire :
- Une machine neuve et isolée pour chaque tâche, détruite à la fin.
- Un relais d'identifiants : l'agent appelle vos API sans voir de secret, et seulement avec les méthodes ou outils que vous autorisez.
- Des budgets stricts par exécution, réservés avant le départ et réglés au coût exact ensuite.
- Une chronologie enregistrée et le coût exact de chaque exécution.
- Des planifications et des callbacks signés : le travail démarre à l'heure et votre serveur sait quand il se termine.
- Une durée de conservation fixe et la rétention zéro des données pour les exécutions sensibles. Voir aussi sécurité et données.
Comment tout s'articule
Une exécution est un agent qui travaille sur une tâche. Vous la décrivez avec un prompt et une entrée JSON, et vous choisissez les fichiers qu'elle peut lire et les connexions qu'elle peut appeler. Un workflow est une définition d'exécution enregistrée sous un nom : votre code n'envoie que ce nom et la nouvelle entrée. Une planification lance un workflow selon un calendrier, dans n'importe quel fuseau horaire.
Le worker s'exécute dans sa propre microVM. Il ne reçoit jamais vos clés de fournisseur ni les identifiants de vos connexions : les appels au modèle et les requêtes de connexion passent par Ephemeral avec un jeton d'exécution de courte durée, et uniquement vers les méthodes ou les outils que vous avez autorisés.
Pour aller plus loin
Versions et dépréciation
L'API est versionnée dans son chemin : tous les endpoints sont sous /v1. Au sein d'une version, les changements ne font qu'ajouter : nouveaux endpoints, nouveaux champs de requête facultatifs, nouveaux champs de réponse et nouveaux types d'événements. Les champs existants gardent leur nom et leur sens ; les clients doivent ignorer les champs qu'ils ne connaissent pas.
Un changement qui casserait les clients existants est publié comme une nouvelle version sous un nouveau chemin. La version précédente continue de fonctionner au moins six mois après la publication de la nouvelle. Pendant sa dépréciation, ses réponses portent un en-tête Deprecation et un en-tête Sunset indiquant la date d'arrêt, et les propriétaires d'organisation sont prévenus par e-mail.