요청 한 번으로 코딩 에이전트 굴리는 API

코딩 에이전트를 자동화에 끼워 넣으려면 지금까지는 서버를 빌리고, 하네스를 설치하고, 프로세스가 죽지 않는지 지켜봐야 했다. 에포(Epho)는 이 과정을 요청 하나로 줄였다. HTTP로 프롬프트를 보내면 클라우드에 새 샌드박스가 뜨고, 지정한 에이전트가 설치된 상태에서 저장소가 복제되고, 작업 과정이 실시간으로 되돌아온다.

무슨 일인가 / 배경

에포가 내놓은 것은 사실상 엔드포인트 하나다. POST /api/v1/chat 주소로 JSON을 보내면서 harness 값에 클로드 코드(Claude Code)·코덱스(Codex)·오픈코드(OpenCode) 중 하나를 적고, model에 쓸 모델을, prompt에 시킬 일을, repos에 건드릴 저장소 주소를 넣는 식이다. 사용자 쪽에는 설치할 SDK도, 띄워 둘 데몬도, 유지할 인프라도 없다.

지난 1년 사이 코딩 에이전트는 터미널에서 사람이 붙잡고 쓰는 도구에서 다른 프로그램이 호출하는 부품 쪽으로 무게중심을 옮겨 왔다. 문제는 그 부품을 어디서 돌리느냐였다. 직접 가상머신을 잡아 쓰는 방법이 있었지만 설치와 인증, 프로세스 관리는 고스란히 사용자 몫이었다. 에포는 그 자리를 "빈 리눅스 상자"가 아니라 "이미 켜져 있는 에이전트"로 채우겠다는 제안이다.

핵심 짚어보기

요청 하나에 실리는 재료의 폭이 넓다. 저장소는 최대 32개까지 에이전트가 움직이기 전에 미리 복제되고(비공개 저장소는 토큰을 함께 넘긴다), 첨부 파일은 최대 20개까지 샌드박스의 임시 경로에 놓인 뒤 그 경로가 프롬프트 뒤에 자동으로 덧붙는다. 여기에 MCP 서버(로컬 명령 또는 원격 주소), 환경변수, 시스템 프롬프트, 추론 강도(낮음·보통·높음·매우 높음)까지 지정할 수 있다. 이 가운데 하네스·모델·MCP·환경변수는 대화가 만들어질 때 한 번 정해져 이후 모든 턴이 물려받고, 프롬프트·저장소·첨부 파일은 턴마다 바꿔 넣을 수 있다.

모델 사용료는 사용자가 직접 부담하는 구조다. 요청에 자신의 프로바이더 키를 함께 실어 보내기 때문에 모델 요금은 사용자 계정으로 청구되고, 에포는 사용자와 모델 공급자 사이에 끼지 않는다고 설명한다. 오픈코드 젠(OpenCode Zen) 모델 중 이름이 free로 끝나는 것들은 프로바이더 자격증명 없이도 동작한다.

응답은 서버 전송 이벤트 스트림으로 흘러나온다. 토큰과 도구 호출, 코드 수정 내역이 진행되는 대로 되돌아오고, 지켜보기 싫으면 비동기 엔드포인트로 보내 식별자만 먼저 받은 뒤 웹훅으로 결과를 넘겨받으면 된다. 모든 이벤트를 저장해 두었다가 재접속하면 놓친 구간을 되감아 준다는 설계는, 네트워크가 불안정한 자동화 파이프라인에 붙일 때 결정적인 차이를 만든다. 대화는 식별자로 이어지며 턴이 끝나면 샌드박스가 멈췄다가 다음 턴에 같은 파일 상태로 되살아난다. 상자가 사라져도 세션 스냅샷을 복원해 대화를 잇는다고 한다.

1인기업 실전 적용 포인트

• 매일 새벽 크론(cron)에 컬(curl) 한 줄을 걸어 "어제 쌓인 오류 로그를 읽고 원인 후보 3개를 이슈로 등록" 같은 반복 작업을 사람 없이 돌릴 수 있다. 결과는 웹훅으로 받아 텔레그램이나 슬랙에 그대로 흘리면 된다.
• 첨부 파일 필드에 정산 엑셀이나 재고 CSV를 실어 보내면 파일 경로가 프롬프트에 자동으로 붙는다. 매출 대사, 재고 이상치 확인처럼 매달 반복되는 확인 작업을 스크립트 다섯 줄로 감쌀 수 있다.
• 노트북을 닫아도 실행이 이어진다는 점은 1인 운영자에게 실질적이다. PC를 켜 둬야만 돌아가던 야간 배치를 클라우드로 옮기는 첫 단계로 쓸 만하다.
• 하네스 필드만 바꿔 같은 프롬프트를 클로드 코드와 코덱스에 각각 던져 결과를 비교하면, 어떤 작업에 어떤 에이전트가 맞는지 감이 아니라 데이터로 판단할 수 있다.

전망 / 주의점

가장 크게 따져 볼 지점은 신뢰의 범위다. 이 구조에서는 모델 키, 저장소 접근 토큰, 데이터베이스 접속 주소가 모두 요청에 실려 남의 서버로 넘어간다. 외부 서비스에 넘어간 자격증명은 회수가 어렵기 때문에, 권한을 최소로 깎은 전용 토큰을 따로 발급해 쓰는 것이 사실상 필수다. 공개된 설명만으로는 요금 체계나 데이터 보존 정책의 구체적인 조건이 확인되지 않으므로, 고객 데이터가 오가는 작업에 붙이기 전에 약관을 먼저 확인하는 편이 안전하다.

그럼에도 방향 자체는 분명해 보인다. 에이전트를 사람이 앉아서 쓰는 도구가 아니라 다른 프로그램이 호출하는 함수로 다루려는 흐름이 굳어지고 있고, 1인기업에게는 그 전환이 곧 "내가 자는 동안에도 일이 진행되는가"의 문제로 이어진다.

출처: 에포 공식 사이트 (https://epho.io)