웹 액세스를 사용하면 에이전트가 실행 중에 페이지를 읽고, 웹을 검색하고, 공개 API를 호출할 수 있습니다. microVM 자체는 인터넷에 연결되어 있지 않습니다. 모든 요청은 Ephemeral을 거치며, Ephemeral이 요청을 검사하고 EphemeralBot으로 전송하고 기록합니다.
켜기
실행이나 워크플로에서 web을 설정하지 않으면 웹 액세스는 꺼져 있습니다. 대시보드의 플레이그라운드에서는 자동으로 켜집니다.
"web": true실행이 특정 사이트만 사용하도록 제한하려면 allow에 나열합니다. api.github.com은 해당 호스트만 일치하고, *.github.com은 모든 하위 도메인과 github.com 자체에 일치합니다. 리디렉션도 같은 목록으로 검사합니다. 웹 검색을 제외하려면 search를 false로 설정하세요.
"web": { "allow": ["api.github.com", "*.stripe.com"], "search": false }워크플로 파일에서는 같은 설정을 web: true로 쓰거나, web: 아래에 allow와 search를 둡니다. 실행 요청의 web은 해당 실행에 한해 워크플로의 설정을 대체합니다.
에이전트가 할 수 있는 일
| 도구 | 기능 |
|---|---|
web_ | 임의의 메서드, 헤더, 본문으로 요청을 보내고 상태와 응답을 텍스트로 반환합니다. HTML 페이지는 링크를 포함한 읽기 쉬운 텍스트로 변환됩니다. 긴 응답은 40,000자씩 나누어 전달되며, 실행이 이미 가져온 페이지의 다음 부분을 읽는 것은 무료입니다. |
web_ | 웹을 검색해 제목, URL, 짧은 발췌문이 담긴 결과를 최대 10개 반환합니다. 에이전트는 web_fetch로 결과 전문을 읽습니다. |
모든 실행의 에이전트는 자신의 머신이 어떻게 동작하는지 안내받습니다. 셸에는 네트워크가 없어 curl이나 pip install이 실패하므로, 웹에는 이 도구로 접근해야 한다는 내용입니다.
Ephemeral이 검사하는 내용
- 대상이 포트 80, 443, 8080, 8443의 공용 주소이고, HTTP 또는 HTTPS이며, 실행의 허용 목록에 있어야 합니다. 리디렉션은 최대 다섯 번까지 매번 다시 검사합니다.
- 안전 분류기가 실행의 작업 내용과 함께 각 요청을 읽고, 시스템 공격, 스팸이나 사기, 작업에 필요하지 않은 곳으로 데이터를 보내는 것처럼 보이는 요청을 거부합니다. 분류기가 응답할 수 없으면 읽기 요청은 그대로 진행하고, 데이터를 변경할 수 있는 요청은 분류기가 복구될 때까지 거부합니다.
- 한 실행은 웹 요청과 검색을 합쳐 50회까지 할 수 있습니다. 조직은 분당 120회까지 가능하며, 모든 고객을 합쳐 하나의 사이트에는 분당 최대 60회까지 보냅니다. 한도에 도달하면 에이전트에게 알리고 요청은 전송하지 않습니다.
- 요청 본문은 최대 1 MiB이고, 응답은 최대 10 MiB까지 읽습니다.
- 요청은 사이트의 robots.txt가 EphemeralBot이라는 이름으로 지정한 규칙을 따릅니다. 사이트 소유자가 EphemeralBot을 식별하고 차단하는 방법은 EphemeralBot 페이지에서 설명합니다.
거부된 요청은 사유와 함께 기록되며, 에이전트도 같은 사유를 받아 방향을 바꿀 수 있습니다. 실행은 계속됩니다.
비용
호스팅 서비스에서는 요청 한 건에 $0.001, 검색 한 건에 $0.01이 듭니다. 둘 다 모델 호출과 마찬가지로 실행 예산에서 차감되며, 예산을 넘게 되는 요청은 거부됩니다. 거부된 요청에는 비용이 청구되지 않습니다. 요금을 참고하세요.
이벤트
| 유형 | 기록되는 시점 |
|---|---|
web_ | 요청이 전송되었을 때. 메서드, 최종 URL, 상태, 크기, 소요 시간, 비용, 안전 점수, 요청에 담긴 요청 ID를 포함합니다. |
web_ | 검색이 실행되었을 때. 쿼리, 반환된 결과 수, 비용을 포함합니다. |
web_ | 요청이나 검색이 전송되기 전에 거부되었을 때. 사유를 포함합니다. |
자격 증명
web_fetch는 에이전트가 설정한 헤더를 그대로 보내므로, 에이전트가 사용하는 API 키는 실행과 함께 저장되는 프롬프트나 입력에 들어 있어야 합니다. 비밀 값으로 호출하는 API에는 연결이 더 적합합니다. Ephemeral이 비밀 값을 보관하고 에이전트는 이를 보지 못합니다.
셀프 호스팅 설치본
엔진은 자체 호스트에서 웹 요청을 보냅니다. 다른 트래픽과 분리하려면 EPHEMERAL_WEB_SOURCE_IP를 해당 호스트의 별도 주소로 설정하세요. 웹 검색은 INFERENCE_API_KEY에 있는 OpenRouter 키를 사용하며, 다른 공급자를 쓰면 검색을 사용할 수 없습니다.
안전 분류기는 사용자의 추론 계정에서 실행되기 때문에 셀프 호스팅 설치본에서는 꺼져 있습니다. 켜려면 OpenRouter 키와 함께 EPHEMERAL_WEB_CLASSIFIER_MODEL=typesafe/jev-1.13을 설정하세요. 분류기가 없어도 허용 목록, 속도 제한, 네트워크 규칙은 그대로 적용됩니다.