---
title: Агент для коммерции
url: https://platform.claude.com/docs/ru/about-claude/use-case-guides/commerce-agents
description: Создайте агента для покупателей и агента для продавцов на базе Claude с помощью Claude for commerce — шаблона с открытым исходным кодом и рабочими реализациями на Messages API, Claude Agent SDK и Claude Managed Agents.
---
В этом руководстве показано, как создавать агентов для коммерции на базе Claude. Первый — агент для покупателей, которым клиенты пользуются внутри вашего приложения. Второй — агент для продавцов, предназначенный для тех, кто управляет магазином: это может быть операционный персонал самой компании или продавцы на её платформе. Для этого используется Claude for commerce — «blueprint» (шаблон) с открытым исходным кодом. Он включает рабочую реализацию каждого агента на [Messages API](https://platform.claude.com/docs/ru/build-with-claude/working-with-messages), [Claude Agent SDK](https://code.claude.com/docs/ru/agent-sdk/overview) и [Claude Managed Agents](https://platform.claude.com/docs/ru/managed-agents/overview), готовые к запуску примеры для розничной торговли, туризма, телекоммуникаций и индустрии развлечений, а также плагин Claude Code, который создаёт каркас агента с той же архитектурой для ваших собственных систем.
Код, инструкции по настройке и документация по безопасности находятся в [репозитории Claude for commerce на GitHub](https://github.com/anthropics/commerce-agents). Подробнее о том, как устроены агенты и почему, читайте в инженерной статье [A guide to the anatomy of effective commerce agents](https://claude.com/blog/the-anatomy-of-effective-commerce-agents). В ней рассматриваются архитектура с одним агентом и набором навыков, компоненты интерфейса в виде инструментов, безопасность на уровне «harness» (среда выполнения агента), «prompt caching» (кэширование подсказок), память и «evals» (оценки).
Шаблон — это эталонная реализация, которую можно форкнуть и адаптировать. Это не поддерживаемый продукт и не размещённый сервис.
## Агент для покупателей
Агент для покупателей работает внутри вашего приложения. Он обращается к вашим системам через единый серверный интерфейс, который вы реализуете поверх своих сервисов каталога, корзины, предпочтений, заказов, правил магазина и выполнения заказов. Ни один метод этого интерфейса не оформляет заказ и не проводит платежи. В ходе диалога агент может:
* Искать по каталогу, сравнивать финальные варианты и превращать описанную потребность в короткий список и рекомендацию.
* Планировать согласованный набор товаров под определённую цель, например поездку, мероприятие или обустройство комнаты, и укладываться в бюджет.
* Показывать товары, сравнения, планы, статус заказа и корзину в виде компонентов интерфейса прямо в диалоге.
* Наполнять корзину и передавать покупателя в ваш процесс оформления заказа.
* Отвечать на вопросы о заказах, доставке, возвратах и правилах магазина, используя ваши собственные системы заказов и правил.
* Запоминать то, что клиент просит запомнить, и учитывать это в последующих сессиях.
Пять навыков загружаются по мере необходимости. Они охватывают поиск и подбор товаров, изучение товаров перед покупкой, планирование под цель, поддержку клиентов, а также память и персонализацию. Правила, которые нужны агенту почти на каждом ходе, размещены в «system prompt» (системная подсказка). К ним относятся опора на данные, семантика корзины и оформления заказа, а также правила представления информации.
Агент сообщает сведения о товарах, ценах, наличии и условиях магазина только на основе результатов инструментов в текущем диалоге. Запись в корзину принимает только те идентификаторы товаров, которые вернул инструмент каталога или заказов в этой сессии. На этапе оформления заказа формируется сводка, которую клиент подтверждает в вашем приложении. Если вы используете размещённую страницу оформления заказа, ваш сервер возвращает её URL, и приложение отображает её, не передавая URL через модель.
## Агент для продавцов
Агент для продавцов помогает тем, кто управляет магазином. Он обращается к вашим системам аналитики, каталога, складского учёта, ценообразования и маркетинговых кампаний через собственный серверный интерфейс и может:
* Объяснять, как идут дела у бизнеса: почему изменился показатель, какой сегмент повлиял на изменение и каков темп по сравнению с сопоставимым периодом. Необязательный делегат для анализа выполняет запросы только на чтение с ограничениями по времени и объёму.
* Представлять ежедневную сводку того, что требует внимания, включая низкие остатки, медленно продающиеся товары и проблемы с заказами.
* Улучшать описания товаров и исправлять данные каталога на основе материалов, которые предоставляет оператор.
* Рекомендовать изменения цен и акции в рамках ограничений магазина с предварительным расчётом маржи.
* Готовить черновики маркетинговых кампаний с аудиториями, размещениями и бюджетом.
Пять навыков агента охватывают аналитику эффективности, складской учёт и операции, каталог и карточки товаров, ценообразование и акции, а также маркетинговые кампании.
Любая запись, которую предлагает агент для продавцов, будь то обновление карточки товара, изменение цены, складская операция, акция или кампания, оформляется как подготовленное изменение. У такого изменения есть идентификатор, сгенерированный сервером, а оператор видит его в виде карточки предварительного просмотра. Ограничения проверяются дважды: при подготовке изменения и при его применении. К ним относятся максимальное изменение цены, глубина скидки, объём пополнения запасов, бюджет кампании и защищённые поля. Изменение применяется только после того, как человек одобрит его вне диалога. На пути с Messages API это кнопка в портале продавца, в консоли Agent SDK — запрос подтверждения, а в Claude Managed Agents — [политика разрешений always-ask](https://platform.claude.com/docs/ru/managed-agents/permission-policies) для инструмента применения изменений. Одобрение, набранное в чате, ничего не одобряет.
## Отраслевые примеры
Каждый пример включает витрину для клиентов и портал продавца, работающие на вымышленных данных.
| Отрасль | Витрина | Портал продавца |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Розничная торговля | Поиск, сравнение, планы, корзина, оформление заказа и память на основе встроенных компонентов | Ежедневная сводка, подготовленные пополнения запасов и исправления карточек товаров, а также делегат для анализа поверх SQL-представления |
| Туризм | Инвентарь с привязкой к датам и компонент маршрута | Календарь загрузки и изменение тарифов в пределах диапазона дат |
| Телекоммуникации | Контекст учётной записи, матрица тарифных планов и раскрытие информации о сборах, сформированное сервером | Структура тарифных планов, изменения цен с указанием затронутых линий и защищённые регулируемые сборы |
| Развлечения | Временное бронирование, листы ожидания, передача билетов, схема площадки и раскрытие полной стоимости со всеми сборами | Темп продаж мероприятий, снятие брони с реальным увеличением доступных мест и изменения цен с сохранением сборов |
## Где это работает
Среды выполнения на Messages API и Agent SDK работают с Claude API, [Amazon Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock), [Google Cloud's Agent Platform](https://platform.claude.com/docs/ru/build-with-claude/claude-on-vertex-ai) или [Microsoft Foundry](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry), а также через ваш собственный шлюз. Вариант с Claude Managed Agents работает на Claude API. В руководстве по развёртыванию в репозитории показано, где каждый вариант выбирает платформу и какой формат идентификатора модели он ожидает.
## Создание собственного агента с помощью плагина Claude Code
В комплект шаблона входит плагин [Claude Code](https://code.claude.com/docs/ru/overview). Он использует клонированный репозиторий как эталон и создаёт агента для ваших собственных систем. Четыре команды плагина охватывают весь путь от нуля до протестированного агента:
| Команда | Что она делает |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/scaffold-commerce-agent` | Расспрашивает вас о вашем стеке и пересказывает план. Затем создаёт каркас агента для покупателей, агента для продавцов или обоих на основе эталонных пакетов |
| `/add-commerce-flow` | Добавляет один сценарий в существующего агента: копирует его навык, подключает вызываемые им инструменты и пишет первые тестовые случаи для оценки |
| `/author-commerce-evals` | Создаёт набор оценок с исполнителем, первыми тестовыми случаями на вашем собственном каталоге и проверкой воспроизведения для CI |
| `/review-commerce-agent` | Анализирует уже работающего у вас агента, сравнивает его с эталоном и преобразует выбранные вами части |
Плагин также содержит шесть навыков: по архитектуре, кэшированию подсказок, интерфейсу в виде инструментов, доверию и безопасности, оценкам и операциям продавца. Они загружаются, когда диалог в Claude Code соответствует их теме. Инструкции по установке приведены в README репозитория.
Эталон можно адаптировать и вручную. Для этого выполните следующие шаги:
1. Реализуйте серверный интерфейс агента для покупателей или для продавцов поверх своих сервисов.
2. Отключите с помощью флагов конфигурации системы, которых у вас нет. Тогда их инструменты и строки подсказки будут исключены.
3. Задайте название своего бренда, имя ассистента и стиль общения.
Руководство по серверной части в репозитории описывает идентификацию и учётные данные, упорядоченные сценарии, передачу на оформление заказа и товары с вариантами. Для пилотного проекта достаточно реализовать поиск и сведения о товарах, а остальное заменить заглушками.
## Начало работы
Клонируйте шаблон и запустите обоих агентов локально.
Узнайте, как устроены агенты и почему.