claudekit / updates / claude-for-commerce-agents
[ NEW · ]

Claude 커머스 에이전트 블루프린트 공개

Anthropic이 2026년 9월 2일 Claude로 커머스 에이전트를 만드는 블루프린트(동작하는 참조 구현)를 공개했습니다. 고객을 응대하는 shopping agent와 매장 운영자를 돕는 merchant agent 두 가지를 한 번 정의해 Messages API, Claude Agent SDK, Claude Managed Agents 세 가지 방식으로 배포할 수 있고, 리테일, 여행, 통신, 엔터테인먼트 네 업종의 실행 가능한 예제가 함께 들어 있습니다. Claude Code 플러그인 commerce-builder로 자기 서비스에 맞는 에이전트를 새로 만들 수도 있습니다. 코드는 anthropics/commerce-agents 저장소에 Apache 2.0으로 공개돼 있고 예제 데이터는 모두 가상이라 실제 주문이나 결제는 발생하지 않습니다.

Claude Platform에이전트
공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

핵심 요약

Anthropic이 2026년 9월 2일 커머스 에이전트 블루프린트를 공개했습니다. 상거래용 에이전트를 만들 때마다 카탈로그 검색, 장바구니, 결제 연결, 승인 절차를 처음부터 설계하지 않아도 되도록, 실제로 돌아가는 참조 구현 한 벌을 통째로 내놓은 것입니다. Anthropic은 Claude 기반 쇼핑 에이전트를 운영해 온 리테일러들이 장바구니 규모가 최대 35% 커지고 구매를 끝까지 마칠 가능성이 60% 높아지는 결과를 봤다고 밝혔습니다. 코드는 anthropics/commerce-agents 저장소에 Apache 2.0으로 공개돼 있습니다.

주요 기능

  • 쇼핑 에이전트와 머천트 에이전트

    블루프린트에는 서로 다른 두 에이전트가 들어 있습니다. 고객을 응대하는 shopping agent는 상품 카탈로그를 검색하고, 여러 상품을 묶은 요청을 정리하고, 고객 취향에 맞춰 추천을 개인화하고, 대화 화면 안에서 상품과 비교표를 보여주고, 장바구니를 만들어 결제로 넘기고, 주문과 반품 문의에 답합니다. 매장 쪽을 맡는 merchant agent는 매출 실적을 분석하고, 재고를 추적해 문제를 알리고, 가격과 프로모션을 제안하고, 마케팅 캠페인 초안을 씁니다.

  • 한 번 정의하고 세 가지 방식으로 배포

    에이전트의 도구와 프롬프트, 스킬 정의가 실행 런타임과 분리돼 있습니다. 그래서 같은 정의를 Messages API 루프, Claude Agent SDK, Claude Managed Agents 중 어디에 올려도 동작합니다. 직접 만든다면 보통 프로토타입 단계에서 고른 실행 방식에 코드가 묶여 나중에 옮기기 어려워지는데, 이 구조에서는 런타임 디렉터리만 바꿔 끼우면 됩니다. 모델 접근 경로도 Claude API, Amazon Bedrock, Microsoft Foundry, Google Cloud Vertex AI를 모두 지원합니다.

  • 바로 돌려볼 수 있는 네 업종 예제

    리테일, 여행, 통신, 엔터테인먼트 네 가지 업종 예제가 들어 있고, 각각 고객이 보는 스토어프론트와 운영자가 보는 포털이 한 쌍으로 딸려 옵니다. 업종마다 어려운 지점이 다릅니다. 여행은 날짜에 묶인 재고와 일정 연장, 통신은 계정 정보와 요금제 비교, 규제 대상 수수료 고지, 엔터테인먼트는 좌석 임시 확보와 대기자 명단, 티켓 양도, 총액 수수료 표시를 다룹니다. 각 예제 README에는 시험해 볼 프롬프트가 담긴 Try 섹션이 있습니다.

  • Claude Code 플러그인으로 직접 만들기

    예제를 고쳐 쓰는 대신 자기 서비스에 맞는 에이전트를 새로 만들 수 있도록 commerce-builder 플러그인이 함께 제공됩니다. 설치는 두 단계입니다.

    claude plugin marketplace add anthropics/commerce-agents
claude plugin install commerce-builder@claude-commerce-agents

    설치하면 새 에이전트 뼈대를 만드는 /scaffold-commerce-agent, 기존 에이전트에 흐름을 추가하는 /add-commerce-flow, 평가를 작성하는 /author-commerce-evals, 구현을 점검하는 /review-commerce-agent 명령을 쓸 수 있습니다.

  • 쓰기 작업은 사람 승인을 거친다

    머천트 에이전트가 재고 보충이나 상품 정보 수정, 가격 변경 같은 쓰기 작업을 하면 곧바로 반영되지 않고 staged changes로 쌓였다가 운영자가 승인해야 적용됩니다. 이 밖에도 도구 호출 단계의 fencing과 provenance gate(모델에 들어가는 정보의 출처를 확인하는 관문), 메모리 검증과 용량 상한, 분석 작업의 예산 제한이 기본으로 들어가 있습니다. 세부 규칙은 저장소의 docs/safety.md에 정리돼 있습니다.

  • 자기 시스템에 붙이는 지점이 명시돼 있다

    블루프린트를 실제 서비스에 연결할 때 손대야 할 곳이 정리돼 있습니다. 백엔드 메서드는 서버 쪽에서 기존 서비스를 호출하고 모델에는 결과만 전달합니다. 순서가 정해진 흐름은 백엔드가 단계 순서를 강제하고, 결제는 자체 결제 경로나 플랫폼이 제공하는 URL로 넘깁니다. 장바구니, 재고, 가격, 캠페인 기능은 설정 스위치로 각각 켜고 끌 수 있습니다.

함께 안내된 자료

발표는 “It’s available today, with live demos for each vertical and an engineering deep-dive on how it was built”라는 한 문장으로 세 가지 자료를 함께 안내했습니다.

  • 코드 저장소 — 원문의 “available today”가 가리키는 곳입니다. 블루프린트 전체가 Apache 2.0으로 공개된 anthropics/commerce-agents 저장소로, 두 에이전트의 도구와 프롬프트, 스킬 정의, 네 업종 예제, commerce-builder 플러그인, 안전장치 문서 docs/safety.md가 모두 여기에 있습니다.
  • 업종별 라이브 데모 — 원문의 “live demos”입니다. 저장소를 내려받고 환경을 갖추기 전에, 리테일과 여행, 통신, 엔터테인먼트 예제가 어떤 화면과 흐름으로 동작하는지 브라우저에서 먼저 확인할 수 있는 소개 페이지입니다.
  • 구현 해설 글 — 원문의 “engineering deep-dive”로, 같은 날 공개된 “A guide to the anatomy of effective commerce agents”입니다. 서브에이전트를 여러 개 두는 대신 스킬을 붙인 단일 모델 구조를 고른 이유, 프롬프트 캐싱으로 지연과 비용을 줄이는 방법, 메모리와 안전장치, 평가 운영까지 엔지니어 관점에서 다룹니다. 블루프린트를 그대로 쓰지 않더라도 설계 판단의 근거를 읽을 수 있습니다.

알아두면 좋은 점

  • 실행 요구 사항 — Python 3.11 이상과 Node 22가 필요합니다. 저장소를 받아 의존성을 설치하고 .env에 ANTHROPIC_API_KEY를 넣은 뒤 python scripts/run_demo.py retail을 실행하면 API가 8000 포트, 스토어프론트가 3000 포트로 뜹니다. --merchant를 붙이면 운영자 포털이, --all을 붙이면 둘 다 실행됩니다.
  • 데이터는 전부 가상 — 예제는 ACME라는 가상 회사의 데이터로 동작하며 실제 주문이나 결제는 발생하지 않습니다.
  • MCP 커넥터는 포함되지 않는다 — 블루프린트 자체에 딸려 오는 커넥터는 없습니다. 직접 만든 커넥터를 쓰거나 Snowflake, BigQuery, Stripe, PayPal, Slack, Gmail 등 공식 커넥터를 연결해야 합니다.
  • 참조 구현이라 유지보수되지 않는다 — Apache 2.0으로 공개돼 있지만 Anthropic이 계속 관리하는 제품이 아니고 외부 기여도 받지 않습니다.
  • 파트너를 통한 도입 경로 — Anthropic은 Accenture, Mastercard, Visa를 이 블루프린트 활용을 함께 지원하는 솔루션 및 생태계 파트너로 소개했습니다. 발표에서는 Shopify, Priceline 등이 Claude로 소비자용 커머스 에이전트를 운영하는 사례로 언급됐습니다.
  • 35%, 60% 수치의 출처 — 이 수치는 Claude로 쇼핑 에이전트를 운영한 리테일러들이 보고한 결과로 발표에 제시된 것이며, 블루프린트를 도입하면 같은 결과가 나온다는 뜻은 아닙니다.
§ 5

자주 묻는 질문

자주 묻는 질문
§ 5.1
커머스 에이전트 블루프린트는 무엇인가요?
Claude로 쇼핑 에이전트와 머천트 에이전트를 만들 때 참고할 수 있도록 Anthropic이 공개한 동작하는 참조 구현입니다. 두 에이전트의 도구, 프롬프트, 스킬 정의와 리테일, 여행, 통신, 엔터테인먼트 네 업종의 실행 가능한 예제가 들어 있습니다.
§ 5.2
어디에 배포할 수 있나요?
에이전트 정의는 한 번만 작성하고 Messages API 루프, Claude Agent SDK, Claude Managed Agents 세 가지 런타임 중에 골라 올릴 수 있습니다. 모델 접근 경로는 Claude API, Amazon Bedrock, Microsoft Foundry, Google Cloud Vertex AI를 지원합니다.
§ 5.3
Claude Code 플러그인은 어떻게 설치하나요?
`claude plugin marketplace add anthropics/commerce-agents`로 마켓플레이스를 추가한 뒤 `claude plugin install commerce-builder@claude-commerce-agents`로 설치합니다. 설치 후 `/scaffold-commerce-agent`, `/add-commerce-flow`, `/author-commerce-evals`, `/review-commerce-agent` 명령을 쓸 수 있습니다.
§ 5.4
예제를 실행하면 실제 주문이나 결제가 발생하나요?
아니요. 예제에 들어 있는 데이터는 모두 ACME라는 가상 회사의 것이고, 실제 주문이나 결제는 일어나지 않습니다. 머천트 에이전트의 쓰기 작업도 staged changes로 쌓였다가 사람이 승인해야 적용됩니다.
§ 5.5
라이선스는 무엇이고 코드는 어디서 볼 수 있나요?
Apache License 2.0으로 `anthropics/commerce-agents` 저장소에 공개돼 있습니다. 다만 유지보수되는 제품이 아니라 참조 구현이라서 외부 기여는 받지 않습니다. 소개 페이지는 claude.com/solutions/commerce에 있습니다.