에이전트 런타임과 Paperclip을 통합하는 커스텀 어댑터를 빌드하는 가이드입니다.

패키지 구조

packages/adapters/<name>/
├── src/
│   ├── index.ts        # 루트 메타데이터
│   ├── server.ts       # 실행 로직
│   ├── ui.ts           # 트랜스크립트 파싱
│   └── cli.ts          # 터미널 포맷팅

구현 단계

단계 1: 루트 메타데이터

src/index.ts에서 어댑터 정보를 내보냅니다: 타입, 라벨, 지원 모델, 설정 문서. 이 파일은 의존성이 없어야 합니다.

단계 2: 서버 실행

실행 모듈은 컨텍스트를 받아 결과를 반환합니다:

  1. 설정을 안전하게 읽기
  2. 환경 빌드
  3. 세션 상태 해결
  4. 프롬프트 렌더링
  5. 프로세스 생성
  6. 사용량 메트릭 및 오류 처리를 위한 출력 파싱

단계 3: 환경 테스트

error, warn, info 카테고리를 사용한 구조화된 진단으로 설정을 검증합니다.

단계 4-5: UI 및 CLI

UI 모듈은 트랜스크립트 변환, CLI 모듈은 터미널 포맷팅을 처리합니다.

단계 6: 등록

어댑터를 서버, UI, CLI 패키지의 3개 레지스트리에 등록해야 합니다.

스킬 통합 방법

4가지 접근법 (우선순위 순):

  1. 플래그가 있는 임시 디렉토리
  2. 글로벌 스킬 디렉토리
  3. 직접 프롬프트 주입
  4. 기타

보안 고려사항

  • 에이전트 출력을 신뢰하지 않는 것으로 취급
  • 환경 변수를 통한 시크릿 관리
  • 타임아웃 강제