Anthropic, 상거래 에이전트 참조 구현 공개

Anthropic이 대화형 에이전트 운영 시 권한(장바구니, 재고, 가격 등)과 승인 경계를 코드로 강제하는 참조 구현 **'Claude Commerce Agents'**를 공개했다. 기존 예제들이 프롬프트 지시에 의존해 권한 문제를 해결하지 못했던 것과 달리, 이 저장소는 규칙 중 코드로 강제할 부분과 모델 판단에 맡길 부분을 명확히 분리한다.

핵심 아키텍처 및 실행 방식

저장소는 고객용 쇼핑 에이전트와 직원용 판매자 에이전트 두 가지 역할을 포함하며, 프롬프트, 스킬, 도구 계약, 게이트를 한 번만 정의해 세 가지 실행 경로(Messages API, Claude Agent SDK, Managed Agents)에서 동일하게 실행된다. 각 경로는 규칙 적용 범위가 다르지만, 도구 호출 내부에서 강제되는 규칙은 경로와 무관하게 일관되게 적용된다.

안전장치 및 권한 관리

안정성을 위해 규칙을 세 층으로 분리했다.

• 코드로 강제: 외부 텍스트 격리, 출처 검증(세션 내 도구 반환 식별자만 허용), 결제 코드 부재, 사람 승인 필수(staged change), 기억 쓰기 제한 등
• 프롬프트로 요청: 격리 텍스트를 지시가 아닌 보고 대상으로 취급, 수치 인용 제한 등
• 배포자 몫: 인증, 권한, 요청량 제한, 사기 판정 등

특히 판매자 에이전트의 모든 쓰기 작업은 즉시 반영되지 않고 사람이 승인해야 하는 **대기 상태(staged change)**로 쌓이도록 설계되어 오작동 위험을 줄인다.

활용 및 제한 사항

소매, 여행, 통신, 엔터테인먼트 4개 업종의 가상 데이터를 기반으로 데모를 실행할 수 있으며, Claude Code 플러그인을 통해 기존 에이전트 검토나 신규 에이전트 생성을 지원한다. 다만, 이는 완제품이 아닌 참조 구현이므로 인증 및 결제 로직은 직접 구현해야 하며, 프로젝트는 장기 유지보수나 기여를 받지 않는다.