L'accès web permet à un agent de lire des pages, de rechercher sur le web et d'appeler des API publiques pendant une exécution. La microVM elle-même n'a pas accès à Internet : chaque requête passe par Ephemeral, qui la vérifie, l'envoie sous l'identité EphemeralBot et l'enregistre.
L'activer
L'accès web est désactivé tant qu'une exécution ou un workflow ne définit pas web. Le playground du tableau de bord l'active pour vous.
"web": truePour limiter une exécution à certains sites, listez-les dans allow. api.github.com ne correspond qu'à cet hôte ; *.github.com correspond à tous les sous-domaines ainsi qu'à github.com lui-même. Les redirections sont vérifiées par rapport à la même liste. Définissez search sur false pour exclure la recherche web.
"web": { "allow": ["api.github.com", "*.stripe.com"], "search": false }Dans un fichier de workflow, le même réglage s'écrit web: true, ou web: avec allow et search en dessous. Le web d'une requête d'exécution remplace celui du workflow pour cette exécution.
Ce que peut faire l'agent
| Outil | Fonction |
|---|---|
web_ | Envoie une requête avec la méthode, les en-têtes et le corps de son choix, et renvoie le statut et la réponse sous forme de texte. Les pages HTML sont converties en texte lisible, avec leurs liens. Les longues réponses arrivent par parties de 40 000 caractères ; lire la partie suivante d'une page déjà récupérée par l'exécution est gratuit. |
web_ | Recherche sur le web et renvoie jusqu'à 10 résultats, chacun avec un titre, une URL et un court extrait. L'agent lit un résultat en entier avec web_fetch. |
L'agent de chaque exécution est informé du fonctionnement de sa machine : le shell n'a pas de réseau, donc curl ou pip install échouent, et il doit utiliser ces outils pour accéder au web.
Ce qu'Ephemeral vérifie
- La destination est une adresse publique sur le port 80, 443, 8080 ou 8443, en HTTP ou HTTPS, et figure dans la liste d'autorisation de l'exécution. Chaque redirection est de nouveau vérifiée, jusqu'à cinq.
- Un classifieur de sécurité lit chaque requête avec la tâche de l'exécution et refuse celles qui ressemblent à une attaque contre un système, à du spam ou à une fraude, ou à des données envoyées vers un endroit que la tâche ne justifie pas. Si le classifieur ne peut pas répondre, les lectures passent et les requêtes susceptibles de modifier des données sont refusées jusqu'à son retour.
- Une exécution peut effectuer 50 requêtes et recherches web. Une organisation peut en effectuer 120 par minute, et l'ensemble des clients n'envoie à un même site que 60 par minute au maximum. Lorsqu'une limite est atteinte, l'agent en est informé et la requête n'est pas envoyée.
- Les corps de requête font jusqu'à 1 Mio, et jusqu'à 10 Mio de chaque réponse sont lus.
- Les requêtes respectent les règles que le fichier robots.txt d'un site définit pour EphemeralBot, par son nom. La page EphemeralBot explique comment les propriétaires de sites le reconnaissent et le bloquent.
Une requête refusée est enregistrée avec son motif, et l'agent reçoit le même motif afin de changer de stratégie. L'exécution se poursuit.
Coût
Sur le service hébergé, chaque requête coûte $0.001 et chaque recherche $0.01. Les deux sont prélevées sur le budget de l'exécution comme les appels au modèle ; une requête qui le dépasserait est refusée. Les requêtes refusées ne sont pas facturées. Voir tarifs.
Événements
| Type | Enregistré lorsque |
|---|---|
web_ | Une requête a été envoyée. Inclut la méthode, l'URL finale, le statut, la taille, la durée, le coût, les scores de sécurité et l'ID de requête qu'elle portait. |
web_ | Une recherche a été exécutée. Inclut la requête, le nombre de résultats renvoyés et son coût. |
web_ | Une requête ou une recherche a été refusée avant son envoi. Inclut le motif. |
Identifiants
web_fetch envoie les en-têtes que l'agent définit : une clé d'API utilisée par l'agent doit donc figurer dans le prompt ou dans l'entrée, où elle est stockée avec l'exécution. Pour une API que vous appelez avec un secret, une connexion est préférable : Ephemeral conserve le secret et l'agent ne le voit jamais.
Installations auto-hébergées
Le moteur envoie les requêtes web depuis son propre hôte. Définissez EPHEMERAL_WEB_SOURCE_IP sur une adresse distincte de cet hôte pour les séparer de votre autre trafic. La recherche web utilise la clé OpenRouter de INFERENCE_API_KEY ; avec un autre fournisseur, la recherche n'est pas disponible.
Le classifieur de sécurité est désactivé sur les installations auto-hébergées, car il s'exécute sur votre compte d'inférence. Pour l'activer, définissez EPHEMERAL_WEB_CLASSIFIER_MODEL=typesafe/jev-1.13 avec une clé OpenRouter. Sans lui, vos listes d'autorisation, les limites de débit et les règles réseau continuent de s'appliquer.