HTTP 어댑터는 외부 에이전트 서비스를 트리거하는 웹훅 메커니즘입니다. Fire-and-forget 모델로 작동하며 stdout 캡처나 실시간 실행 가시성을 제공하지 않습니다.

적합한 경우

  • 외부 서비스 배포 (클라우드 함수, 전용 서버)
  • 비동기 호출 패턴
  • 서드파티 에이전트 플랫폼 통합

부적합한 경우

  • 같은 머신에서 로컬 실행하는 에이전트
  • 출력 스트림 캡처가 필요한 시나리오

설정 파라미터

필드설명필수
URLPOST 요청을 보낼 웹훅 URL예
헤더커스텀 HTTP 헤더아니오
타임아웃초 단위 타임아웃아니오

작동 흐름

  1. Paperclip이 지정 엔드포인트에 실행 메타데이터가 담긴 POST 요청 전송
  2. 외부 에이전트가 페이로드 처리
  3. 제공된 API 자격증명으로 Paperclip에 인증된 콜백 요청

요청 구조

{
  "runId": "...",
  "agentId": "...",
  "companyId": "...",
  "context": {
    "taskId": "...",
    "wakeReason": "...",
    "commentId": "..."
  }
}