Ephemeral은 안전한 일회용 머신에서 AI 에이전트를 실행합니다. 작업을 한 번 정의해 두면 코드, CLI, 대시보드, 스케줄로 실행할 수 있습니다. 각 실행에는 새 microVM, 허용한 파일과 연결, 지출 한도가 주어집니다. 작업하는 동안 모든 단계를 스트리밍하고, 끝나면 머신을 폐기합니다. 출력, 이벤트, 비용은 남습니다.
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}'누구를 위한 서비스인가
Ephemeral은 애플리케이션에 백그라운드 AI 작업을 넣으려는 개발자를 위한 서비스입니다. 지원 티켓이나 실패한 결제 조사, 시스템 모니터링과 변경 내용 설명, 정기 보고서 작성, 운영 작업 수행 등이 대표적입니다. 코드에서 API를 호출해 실행을 시작하면 결과가 코드로 돌아옵니다.
Ephemeral이 대신 처리하는 것
모델 API만 쓸 때 직접 만들어야 하는 것들입니다.
- 작업마다 새로 만들어지는 격리된 머신. 끝나면 폐기됩니다.
- 자격 증명 브로커: 에이전트는 시크릿을 보지 않고, 허용한 메서드나 도구로만 API를 호출합니다.
- 실행마다 엄격하게 지켜지는 예산. 실행 전에 예약하고 끝난 뒤 정확한 비용으로 정산합니다.
- 모든 실행의 타임라인과 정확한 비용 기록.
- 스케줄과 서명된 콜백: 작업이 제때 시작되고, 끝나면 서버가 알림을 받습니다.
- 정해진 보존 기간, 그리고 민감한 실행을 위한 데이터 무보존. 보안과 데이터도 참고하세요.
구성 요소의 관계
실행은 에이전트 하나가 작업 하나를 수행하는 단위입니다. 프롬프트와 JSON 입력으로 작업을 설명하고, 에이전트가 읽을 수 있는 파일과 호출할 수 있는 연결을 선택합니다. 워크플로는 이름을 붙여 저장한 실행 정의이므로, 코드에서는 이름과 새 입력만 보내면 됩니다. 스케줄은 원하는 시간대의 정해진 시간표에 따라 워크플로를 시작합니다.
워커는 자체 microVM에서 실행됩니다. 워커는 공급자 키나 연결 자격 증명을 받지 않습니다. 모델 호출과 연결 요청은 수명이 짧은 실행 토큰으로 Ephemeral을 거치며, 허용한 메서드나 도구에만 전달됩니다.
다음으로 볼 내용
버전과 지원 중단
API 버전은 경로에 포함됩니다. 모든 엔드포인트는 /v1 아래에 있습니다. 한 버전 안에서는 추가만 합니다. 새 엔드포인트, 새 선택 요청 필드, 새 응답 필드, 새 이벤트 유형이 생길 수 있습니다. 기존 필드의 이름과 의미는 바뀌지 않으므로 클라이언트는 모르는 필드를 무시해야 합니다.
기존 클라이언트를 깨뜨리는 변경은 새 경로의 새 버전으로 나옵니다. 이전 버전은 새 버전이 공개된 뒤 최소 6개월 동안 계속 동작합니다. 지원 중단 기간에는 응답에 Deprecation 헤더와 중단 날짜를 알리는 Sunset 헤더가 붙고, 조직 소유자에게 이메일로 알립니다.