Лучшие практикиСценарии использования

Агент для коммерции

Copy page



Создайте агента для покупателей и агента для продавцов на базе Claude с помощью Claude for commerce — шаблона с открытым исходным кодом и рабочими реализациями на Messages API, Claude Agent SDK и Claude Managed Agents.

В этом руководстве показано, как создавать агентов для коммерции на базе Claude. Первый — агент для покупателей, которым клиенты пользуются внутри вашего приложения. Второй — агент для продавцов, предназначенный для тех, кто управляет магазином: это может быть операционный персонал самой компании или продавцы на её платформе. Для этого используется Claude for commerce — «blueprint» (шаблон) с открытым исходным кодом. Он включает рабочую реализацию каждого агента на Messages API, Claude Agent SDK и Claude Managed Agents, готовые к запуску примеры для розничной торговли, туризма, телекоммуникаций и индустрии развлечений, а также плагин Claude Code, который создаёт каркас агента с той же архитектурой для ваших собственных систем.

Код, инструкции по настройке и документация по безопасности находятся в репозитории Claude for commerce на GitHub. Подробнее о том, как устроены агенты и почему, читайте в инженерной статье A guide to the anatomy of effective commerce agents. В ней рассматриваются архитектура с одним агентом и набором навыков, компоненты интерфейса в виде инструментов, безопасность на уровне «harness» (среда выполнения агента), «prompt caching» (кэширование подсказок), память и «evals» (оценки).

Агент для покупателей

Агент для покупателей работает внутри вашего приложения. Он обращается к вашим системам через единый серверный интерфейс, который вы реализуете поверх своих сервисов каталога, корзины, предпочтений, заказов, правил магазина и выполнения заказов. Ни один метод этого интерфейса не оформляет заказ и не проводит платежи. В ходе диалога агент может:

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

Пять навыков загружаются по мере необходимости. Они охватывают поиск и подбор товаров, изучение товаров перед покупкой, планирование под цель, поддержку клиентов, а также память и персонализацию. Правила, которые нужны агенту почти на каждом ходе, размещены в «system prompt» (системная подсказка). К ним относятся опора на данные, семантика корзины и оформления заказа, а также правила представления информации.

Агент сообщает сведения о товарах, ценах, наличии и условиях магазина только на основе результатов инструментов в текущем диалоге. Запись в корзину принимает только те идентификаторы товаров, которые вернул инструмент каталога или заказов в этой сессии. На этапе оформления заказа формируется сводка, которую клиент подтверждает в вашем приложении. Если вы используете размещённую страницу оформления заказа, ваш сервер возвращает её URL, и приложение отображает её, не передавая URL через модель.

Агент для продавцов

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

• Объяснять, как идут дела у бизнеса: почему изменился показатель, какой сегмент повлиял на изменение и каков темп по сравнению с сопоставимым периодом. Необязательный делегат для анализа выполняет запросы только на чтение с ограничениями по времени и объёму.
• Представлять ежедневную сводку того, что требует внимания, включая низкие остатки, медленно продающиеся товары и проблемы с заказами.
• Улучшать описания товаров и исправлять данные каталога на основе материалов, которые предоставляет оператор.
• Рекомендовать изменения цен и акции в рамках ограничений магазина с предварительным расчётом маржи.
• Готовить черновики маркетинговых кампаний с аудиториями, размещениями и бюджетом.

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

Любая запись, которую предлагает агент для продавцов, будь то обновление карточки товара, изменение цены, складская операция, акция или кампания, оформляется как подготовленное изменение. У такого изменения есть идентификатор, сгенерированный сервером, а оператор видит его в виде карточки предварительного просмотра. Ограничения проверяются дважды: при подготовке изменения и при его применении. К ним относятся максимальное изменение цены, глубина скидки, объём пополнения запасов, бюджет кампании и защищённые поля. Изменение применяется только после того, как человек одобрит его вне диалога. На пути с Messages API это кнопка в портале продавца, в консоли Agent SDK — запрос подтверждения, а в Claude Managed Agents — политика разрешений always-ask для инструмента применения изменений. Одобрение, набранное в чате, ничего не одобряет.

Отраслевые примеры

Каждый пример включает витрину для клиентов и портал продавца, работающие на вымышленных данных.

Где это работает

Среды выполнения на Messages API и Agent SDK работают с Claude API, Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, а также через ваш собственный шлюз. Вариант с Claude Managed Agents работает на Claude API. В руководстве по развёртыванию в репозитории показано, где каждый вариант выбирает платформу и какой формат идентификатора модели он ожидает.

Создание собственного агента с помощью плагина Claude Code

В комплект шаблона входит плагин Claude Code. Он использует клонированный репозиторий как эталон и создаёт агента для ваших собственных систем. Четыре команды плагина охватывают весь путь от нуля до протестированного агента:

Плагин также содержит шесть навыков: по архитектуре, кэшированию подсказок, интерфейсу в виде инструментов, доверию и безопасности, оценкам и операциям продавца. Они загружаются, когда диалог в Claude Code соответствует их теме. Инструкции по установке приведены в README репозитория.

Эталон можно адаптировать и вручную. Для этого выполните следующие шаги:

1. Реализуйте серверный интерфейс агента для покупателей или для продавцов поверх своих сервисов.
2. Отключите с помощью флагов конфигурации системы, которых у вас нет. Тогда их инструменты и строки подсказки будут исключены.
3. Задайте название своего бренда, имя ассистента и стиль общения.

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

Начало работы