APICK 서브에이전트로 기획 문서 비교하기: 접수·근거 검수·비용 관리

10월 11, 2026

두 기획 문서를 서브에이전트로 비교하고 차이점과 근거를 검토하는 개념도 — 이해를 돕기 위한 AI 생성 개념 이미지입니다. 실제 API 응답 화면이 아닙니다.

확인일: 2026-10-11 · 공식 공개 문서 기반 · 아래 코드는 실행하지 않은 연동 예제입니다. 실제 키·고객 데이터는 포함하지 않았습니다.

변경 전후 기획 문서에서 충돌을 찾는 작업 위임

기능을 바꿀 때 예전 기획서와 새 요구사항의 충돌을 놓치기 쉽습니다. “모든 문서를 요약”이라고 요청하기보다, 비교할 파일과 찾을 조건을 정하면 결과 검수도 쉬워집니다. APICK 서브에이전트는 이처럼 자료 조사·추출·요약·비교를 위임하고 원문 근거를 검토하는 흐름으로 도입할 수 있습니다.

설치형 로컬 수집과 원격 API 구분

공식 설치 패키지는 apick-subagent이며 Node.js 22.17 이상을 요구합니다. 원격 MCP 주소는 /mcp/subagent, REST 기본 경로는 /rest/subagent/v1입니다. 로컬 파일 수집은 설치된 브리지가 담당하고 원격 쪽은 업로드한 파일 ID를 처리합니다. 설치만으로 모든 대화가 자동 위임되는 것은 아닙니다. 공식 설치 저장소

# 설치를 승인한 자신의 프로젝트 환경에서 실행할 명령 예시
npm install -g apick-subagent
apick-subagent install
# 안전한 환경변수 설정으로 APICK_API_KEY를 준비한 뒤 클라이언트를 재시작
apick-subagent doctor

# REST 상태 확인 예제
curl --fail-with-body https://apick.app/rest/subagent/v1/status \
  --header "Authorization: Bearer $APICK_API_KEY"

파일 업로드가 끝난 뒤 비교 작업 접수

다음 예제의 APICK_BEFORE_FILE_ID와 APICK_AFTER_FILE_ID에는 권한을 확인해 업로드·검증을 완료한 변경 전후 문서의 파일 ID가 필요합니다. 실제 파일이나 키를 포함하지 않았습니다. 대량 자료를 처음 붙일 때는 비교 대상·보관 정책·예산을 정하고 작은 문서 두 개로 결과 형식을 확인하세요.

// Node.js 22+ 서버. 파일 업로드 절차는 별도 공식 명세를 따릅니다.
// 새 작업마다 새 멱등 키를 정하고, 동일 입력의 재접수 복구에만 재사용합니다.
const request = {
  kind: 'compare',
  goal: '변경 전후 요구사항에서 서로 충돌하는 조건을 비교하세요.',
  file_ids: [process.env.APICK_BEFORE_FILE_ID, process.env.APICK_AFTER_FILE_ID],
  focus: ['접근 권한', '보관 기간'],
  acceptance: ['각 지적에 원문 근거를 연결할 것'],
  retention: 'none'
};
const r = await fetch('https://apick.app/rest/subagent/v1/jobs', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.APICK_API_KEY}`,
    'Idempotency-Key': 'spec-compare-20261011-001',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(request),
  signal: AbortSignal.timeout(120000)
});
const accepted = await r.json();
if (!r.ok || accepted.error) throw new Error(`접수 확인 필요: HTTP ${r.status}`);
console.log(accepted); // 반환된 작업 ID를 저장하고 같은 ID로 상태를 조회합니다.

이 JSON 예제는 공식 서브에이전트 문서에 있는 별도 접수 예시를 기준으로 했습니다. 같은 페이지의 자동 생성 폼 예제와 혼합하지 마세요. 상태는 GET /jobs/{job_id}로 확인하고 결과가 여러 페이지라면 cursor를 따라갑니다. 근거 조회와 검수 기록은 각각 /evidence와 /review로 구분됩니다. 접수·상태·검수 계약

근거 검수를 종료 조건으로 삼기

파일 경로를 프로젝트 내 승인된 문서로 제한합니다. 비밀 파일·개인정보가 있는 자료는 별도로 판단합니다.
결과가 지적한 충돌 문장을 원문 줄 번호와 대조합니다. 두 문서의 적용 날짜가 다른지 확인합니다.
해시 일치는 인용한 자료가 같은지 검사하는 신호입니다. 문장의 의미나 제품 정책이 타당하다는 보장은 아닙니다.
검수한 결과에 대해서만 최종 결론을 채택합니다. 조사를 위임했다고 설계 결정까지 자동 승인하지 않습니다.

2026-10-11 기준 비용과 보관

공식 안내는 성공 작업의 확인된 모델 원가에 40%를 더하고 작업별 소수점을 올림하며 최소 1P를 적용한다고 설명합니다. 승인된 동일 결과 캐시는 1P입니다. 2026-11-06부터 분석 원가의 기준·가산율과 AI 작업 최소 5P가 변경될 예정이므로 그 이후에는 새 조건을 확인하세요. 작업 접수 때 최대 예상 비용을 예약하고 실제 정산 차액을 해제합니다. 요금·정산 안내

기본 보관은 7일, retention=none은 검수 후 삭제하며 임시 보관은 최대 1시간으로 안내됩니다. 비밀정보 자동 탐지가 모든 경우를 막아 준다고 가정하지 말고 필요한 파일만 선택하세요. “몇 퍼센트 절감”은 기존 업무의 실제 비용과 검수 시간을 비교하기 전에는 확정할 수 없습니다. 보관·로컬 수집 주의사항

FAQ

접수 응답을 잃어버리면 새 작업을 만들까요? 같은 멱등 키와 같은 입력으로 기존 작업을 확인합니다. 입력을 바꾸면 충돌 오류가 날 수 있습니다. 상태 조회를 얼마나 반복하나요? 공식 상태·페이지 규칙을 기준으로 제한된 간격과 앱의 대기 한도를 두고, 미완료일 때 작업 ID를 보존합니다. 이 글은 확인되지 않은 종료 상태 이름을 추정해서 사용하지 않습니다.

공식 문서에서 다음 단계 확인하기

구현 전 현재 옵션·요금을 다시 확인하세요. 설치 패키지 · REST·MCP 개발가이드 · 프로젝트별 연동 지침

#APICK #서브에이전트 #문서비교 #업무자동화

이 블로그 검색

apick