El acceso web permite que un agente lea páginas, busque en la web y llame a API públicas durante una ejecución. La microVM en sí no tiene internet: cada solicitud pasa por Ephemeral, que la comprueba, la envía como EphemeralBot y la registra.
Activarlo
El acceso web está desactivado salvo que una ejecución o un flujo de trabajo establezca web. El playground del panel lo activa por ti.
"web": truePara limitar una ejecución a ciertos sitios, indícalos en allow. api.github.com coincide solo con ese host; *.github.com coincide con todos los subdominios y con github.com mismo. Las redirecciones se comprueban con la misma lista. Establece search en false para excluir la búsqueda web.
"web": { "allow": ["api.github.com", "*.stripe.com"], "search": false }En un archivo de flujo de trabajo, el mismo ajuste se escribe web: true, o web: con allow y search debajo. El web de una solicitud de ejecución sustituye al del flujo de trabajo para esa ejecución.
Qué puede hacer el agente
| Herramienta | Qué hace |
|---|---|
web_ | Envía una solicitud con cualquier método, cabeceras y cuerpo, y devuelve el estado y la respuesta como texto. Las páginas HTML se convierten en texto legible con sus enlaces. Las respuestas largas llegan en partes de 40000 caracteres; leer la siguiente parte de una página que la ejecución ya obtuvo es gratis. |
web_ | Busca en la web y devuelve hasta 10 resultados, cada uno con un título, una URL y un breve extracto. El agente lee un resultado completo con web_fetch. |
Al agente de cada ejecución se le explica cómo funciona su máquina: que el shell no tiene red, así que curl o pip install fallarán, y que debe llegar a la web con estas herramientas.
Qué comprueba Ephemeral
- El destino es una dirección pública en el puerto 80, 443, 8080 u 8443, por HTTP o HTTPS, y está en la lista de permitidos de la ejecución. Cada redirección se vuelve a comprobar, hasta cinco.
- Un clasificador de seguridad lee cada solicitud junto con la tarea de la ejecución y rechaza las que parecen un ataque a un sistema, spam o fraude, o datos que se envían a un lugar que la tarea no requiere. Si el clasificador no puede responder, las lecturas continúan y las solicitudes que podrían modificar datos se rechazan hasta que pueda.
- Una ejecución puede hacer 50 solicitudes y búsquedas web. Una organización puede hacer 120 por minuto, y entre todos los clientes envían a un mismo sitio como máximo 60 por minuto. Cuando se alcanza un límite, se informa al agente y la solicitud no se envía.
- Los cuerpos de las solicitudes pueden ser de hasta 1 MiB, y se leen hasta 10 MiB de cada respuesta.
- Las solicitudes siguen las reglas que el robots.txt de un sitio establece para EphemeralBot por su nombre. La página de EphemeralBot explica cómo los propietarios de sitios lo reconocen y lo bloquean.
Una solicitud rechazada se registra con su motivo, y el agente recibe el mismo motivo para poder cambiar de rumbo. La ejecución continúa.
Coste
En el servicio alojado, cada solicitud cuesta $0.001 y cada búsqueda $0.01. Ambas salen del presupuesto de la ejecución como las llamadas al modelo; una solicitud que lo superaría se rechaza. Las solicitudes rechazadas no se cobran. Consulta los precios.
Eventos
| Tipo | Se registra cuando |
|---|---|
web_ | Se envió una solicitud. Incluye el método, la URL final, el estado, el tamaño, la duración, el coste, las puntuaciones de seguridad y el ID de solicitud que llevaba. |
web_ | Se realizó una búsqueda. Incluye la consulta, cuántos resultados devolvió y su coste. |
web_ | Una solicitud o búsqueda se rechazó antes de enviarse. Incluye el motivo. |
Credenciales
web_fetch envía las cabeceras que establezca el agente, así que una clave de API que use el agente tiene que estar en el prompt o en la entrada, donde se almacena con la ejecución. Para una API a la que llamas con un secreto, es mejor una conexión: Ephemeral guarda el secreto y el agente nunca lo ve.
Instalaciones autoalojadas
El motor envía las solicitudes web desde su propio host. Establece EPHEMERAL_WEB_SOURCE_IP en una dirección independiente de ese host para mantenerlas separadas de tu otro tráfico. La búsqueda web usa la clave de OpenRouter en INFERENCE_API_KEY; con otro proveedor, la búsqueda no está disponible.
El clasificador de seguridad está desactivado en las instalaciones autoalojadas, porque se ejecuta con tu cuenta de inferencia. Para activarlo, establece EPHEMERAL_WEB_CLASSIFIER_MODEL=typesafe/jev-1.13 con una clave de OpenRouter. Sin él, siguen aplicándose tus listas de permitidos, los límites de frecuencia y las reglas de red.