Anthropic открыла Claude Commerce Agents: что внутри репозитория

1 сентября Anthropic выложила репозиторий anthropics/commerce-agents под лицензией Apache 2.0. Внутри два торговых агента, четыре отраслевых примера и плагин для Claude Code. За сутки проект собрал больше тысячи звёзд.

Вещь полезная, но в пересказах она выглядит как готовый продукт для бизнеса, а это не так. Сама Anthropic формулирует иначе, и разница здесь принципиальная: вам отдают чертёж, а не построенный дом. Разберём, что именно лежит в репозитории и где проходит граница ответственности.

Что открыто

Агентов два, и роли у них разные.

Агент покупателя встраивается в приложение или на сайт. Он ищет по каталогу, сравнивает товары, планирует покупку из нескольких позиций, наполняет корзину, отвечает на вопросы по заказам и правилам магазина и запоминает то, что клиент про себя рассказал.

Агент продавца работает во внутреннем контуре, им пользуются сотрудники. Он объясняет показатели, ведёт карточки товаров, реагирует на остатки и сигналы по заказам, предлагает цены и промо, готовит черновики кампаний.

Оба описаны один раз (промпт, навыки, контракты инструментов, проверки) и запускаются тремя способами: на Messages API, на Claude Agent SDK и на Managed Agents. Один и тот же агент, три среды исполнения, и это, пожалуй, главная инженерная ценность репозитория.

Раскладка по папкам такая: общая часть для обеих ролей (конфигурация, ограничения, память, навыки, привязка к данным, представление, события), ядро и среды исполнения для каждой роли, четыре примера, плагин, документация, тесты и скрипты. Пакеты собраны так, что ставятся из директорий, а не с публичного индекса, и CI отдельно проверяет, что имена пакетов там не заняты.

Как запустить

Нужны Python 3.11 или новее, Node 22 и ключ API.

git clone https://github.com/anthropics/commerce-agents.git && cd commerce-agents
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env                  # сюда ANTHROPIC_API_KEY
(cd examples && npm ci)
python scripts/run_demo.py retail     # API на 8000, витрина на 3000

Флаг --merchant поднимает портал продавца вместо витрины, --all поднимает оба. Отраслей четыре: розница, тревел, телеком и продажа билетов, каждая на своих портах.

Отрасли отличаются не оформлением, а механикой. В тревеле инвентарь привязан к датам и добавлено представление маршрута. В телекоме есть контекст абонентского счёта, матрица тарифов и раскрытие обязательных платежей, которое пишет сервер, а не модель. В билетах таймеры удержания мест, лист ожидания, передача билета и карта зала, а в портале продавца изменения цены сохраняют обязательные сборы.

Плагин для 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 разбирает уже существующего агента. Вызывать по имени не обязательно, команды срабатывают и по совпадению с описанием запроса.

Чего оно не делает

Это самый важный раздел, и в новостях он теряется.

1) ничего не уходит в бой. Заказ не оформляется, карта не списывается, живой листинг не меняется. Оформление заказа рисует корзину и передаёт управление вашему checkout, а ссылку на оплату возвращает бэкенд, и модель её не видит
2) каждое изменение со стороны продавца сохраняется как подготовленное и ждёт, пока человек его подтвердит. Автоматической записи в боевые системы нет по устройству
3) все компании, бренды, товары и люди в примерах выдуманы
4) в демо нет аутентификации, а серверы MCP слушают только локальный адрес. Это стенд, а не заготовка для публичного развёртывания
5) бизнес-правила, авторизация и соответствие требованиям, это зона того, кто разворачивает

И главное. Лицензия Apache 2.0 разрешает делать с кодом что угодно, но в лицензионном блоке написано прямо: это эталонная реализация, она не поддерживается и вклад не принимается. То есть вы делаете форк и дальше владеете им сами, включая обновления и безопасность.

Сравнение с типовым проектом дома тут точное. Вам отдали чертежи, расчёты и фотографии четырёх готовых домов. Фундамент, подключение к сетям и приёмку делаете вы, и претензии по трещинам предъявлять некому.

Как устроена защита

Архитектурное решение, ради которого стоит смотреть репозиторий, даже если торговля вам не нужна: модель не получает ни доступов, ни ссылок на оплату.

Каждый метод бэкенда вызывает ваш сервис на стороне сервера с тем доступом, который держит хост сессии, а модель читает только результат. Если у сценария есть жёсткий порядок шагов, он задаётся в бэкенде, а не в промпте. Ограничения, проверки происхождения данных, лимиты, проверка памяти и подтверждение изменений продавцом работают внутри вызова инструмента и действуют на всех трёх средах исполнения одинаково. Перечень правил с указанием модулей лежит в docs/safety.md.

Про задержку и стоимость

В блоге Anthropic ссылается на практики инженеров Zomato: ограничение числа итераций с инструментами и кэширование промпта. Конкретных чисел там нет.

Зато в самом репозитории есть проверяемый способ убедиться, что кэш работает: читать cache_read_input_tokens из события turn_complete или из строки, которую пишет логгер среды исполнения. Ноль на втором ходу означает, что префикс изменился. С учётом того, что чтение кэша у свежих моделей Anthropic подешевело в четыре раза, эта строчка в логе стоит внимания.

Что делать, если тема ваша

1) начинайте с малого. Пилот покупателя реализует поиск и карточку товара, остальное оставляет заглушками, а заглушка возвращает "недоступно" и не меняет ни байта в промпте. Пилот продавца реализует восемь методов чтения, а запись отклоняет
2) отключайте то, чего у вас нет. Отсутствующая система, это выключатель enable_*, и вместе с ним из всех путей уходят её инструменты, строки промпта и правила привязки к данным
3) прочитайте docs/backends.md до того, как писать код. Там разобраны личность и доступы, сценарии с фиксированным порядком, оформление заказа и товары с вариантами
4) относитесь к форку как к своему коду. Ревью безопасности, аутентификация, лимиты запросов, это ваше, и делать это надо до первого публичного контура, а не после
5) если вы на Shopify, посмотрите Shopify/claude-for-commerce-examples, там та же схема положена на UCP, вход через Shop и Admin API

Разворачивать можно не только на API Anthropic: среды исполнения принимают любой клиент anthropic, поэтому Amazon Bedrock, Microsoft Foundry и Google Vertex AI тоже подходят.

Вывод

Ценность здесь не в том, что кто-то сэкономит месяц на прототипе. Ценность в том, что крупный поставщик моделей показал полный рабочий контур с проверками, разделением доступов и подтверждением изменений человеком, и показал его кодом, а не слайдами.

Ближайший шаг, если тема близка: клонируйте репозиторий, поднимите вертикаль своей отрасли одной командой и пройдите сценарии из раздела Try в её README. Час работы даст более точное представление, чем любой обзор, включая этот.