Melhores práticasCasos de uso

Agente de comércio

Copy page



Crie um agente de compras e um agente de lojista no Claude usando o Claude for commerce, um blueprint de código aberto com implementações funcionais na Messages API, no Claude Agent SDK e no Claude Managed Agents.

Este guia mostra como criar agentes de comércio no Claude: um agente de compras que os clientes usam dentro do seu aplicativo e um agente de lojista para as pessoas que administram a loja, seja a equipe de operações da própria empresa ou os vendedores da sua plataforma. Isso é feito por meio do Claude for commerce, um "blueprint" (modelo de referência) de código aberto com uma implementação funcional de cada agente na Messages API, no Claude Agent SDK e no Claude Managed Agents, exemplos executáveis para varejo, viagens, telecomunicações e entretenimento, e um plugin do Claude Code que gera a estrutura do mesmo design sobre os seus próprios sistemas.

O código, as instruções de configuração e a documentação de segurança estão no repositório do Claude for commerce no GitHub. Para entender como os agentes são construídos e por quê, incluindo o design de agente único com "skills" (habilidades), componentes de UI como ferramentas, segurança imposta pelo "harness" (ambiente de execução do agente), "prompt caching" (cache de prompt), memória e "evals" (avaliações), leia o artigo de engenharia A guide to the anatomy of effective commerce agents.

O agente de compras

O agente de compras fica dentro do seu aplicativo e acessa os seus sistemas por meio de uma única interface de backend que você implementa sobre os seus serviços de catálogo, carrinho, preferências, pedidos, políticas e atendimento de pedidos. Nenhum método dessa interface faz um pedido ou movimenta dinheiro. Em uma conversa, o agente pode:

• Pesquisar o catálogo, comparar finalistas e transformar uma necessidade descrita em uma lista de opções e uma recomendação.
• Planejar um conjunto coordenado de itens em direção a um objetivo, como uma viagem, um evento ou um cômodo, e ajustá-lo a um orçamento.
• Exibir produtos, comparações, planos, status de pedidos e o carrinho como componentes de UI renderizados na conversa.
• Preencher o carrinho e encaminhar para o seu checkout.
• Responder a perguntas sobre pedidos, entregas, devoluções e políticas a partir dos seus próprios sistemas de pedidos e políticas.
• Lembrar o que um cliente pede para ele lembrar e aplicar isso em sessões posteriores.

Cinco skills são carregadas sob demanda para cobrir pesquisa e descoberta, pesquisa de compra, planejamento em direção a um objetivo, atendimento ao cliente, e memória e personalização. As regras de que o agente precisa na maioria dos turnos, como fundamentação, semântica de carrinho e checkout, e apresentação, ficam no "system prompt" (prompt do sistema).

O agente informa produtos, preços, disponibilidade e termos da loja somente a partir de resultados de ferramentas na conversa, e as gravações no carrinho aceitam apenas IDs de produtos que uma ferramenta de catálogo ou de pedidos retornou naquela sessão. O checkout prepara um resumo que o cliente confirma no seu aplicativo. Se você usa um checkout hospedado, o seu backend retorna a URL dele e o host a renderiza sem passá-la pelo modelo.

O agente de lojista

O agente de lojista apoia as pessoas que administram a loja. Ele acessa os seus sistemas de análise, catálogo, estoque, preços e campanhas por meio de sua própria interface de backend, e pode:

• Explicar como o negócio está indo: por que uma métrica mudou, qual segmento a impulsionou e o ritmo em comparação com um período equivalente. Um delegado de análise opcional executa consultas somente leitura dentro de um orçamento de tempo e tamanho.
• Apresentar um resumo diário do que precisa de atenção, incluindo estoque baixo, produtos de baixa saída e exceções de pedidos.
• Melhorar o conteúdo dos anúncios e corrigir dados do catálogo a partir de material fornecido pelo operador.
• Recomendar alterações de preço e promoções dentro das salvaguardas da loja, com uma prévia da margem.
• Elaborar campanhas de marketing com públicos, posicionamentos e orçamento.

Suas cinco skills cobrem insights de desempenho, estoque e operações, catálogo e anúncios, preços e promoções, e campanhas de marketing.

Toda gravação que o agente de lojista propõe, seja uma atualização de anúncio, uma alteração de preço, uma ação de estoque, uma promoção ou uma campanha, é uma alteração preparada com um ID gerado pelo servidor que o operador vê como um cartão de prévia. Salvaguardas como variação máxima de preço, profundidade da promoção, tamanho da reposição, orçamento da campanha e campos protegidos são verificadas quando a alteração é preparada e novamente quando ela é aplicada. A alteração só é aplicada depois que uma pessoa a aprova fora da conversa: um botão no portal do lojista no caminho da Messages API, um prompt de confirmação no console do Agent SDK ou uma política de permissão de sempre perguntar na ferramenta de aplicação no Claude Managed Agents. Uma aprovação digitada no chat não aprova nada.

Exemplos por setor

Cada exemplo inclui uma loja virtual para clientes e um portal do lojista sobre dados fictícios.

Onde ele é executado

Os runtimes da Messages API e do Agent SDK são executados na Claude API, no Amazon Bedrock, no Google Cloud's Agent Platform ou no Microsoft Foundry, ou por meio do seu próprio gateway. O caminho do Claude Managed Agents é executado na Claude API. O guia de implantação do repositório mostra onde cada caminho seleciona sua plataforma e qual formato de ID de modelo cada um espera.

Crie o seu próprio com o plugin do Claude Code

O blueprint inclui um plugin do Claude Code que lê o repositório clonado como referência e cria um agente sobre os seus próprios sistemas. Seus quatro comandos cobrem o caminho do zero até um agente testado:

O plugin também traz seis skills sobre a arquitetura, cache de prompt, UI como ferramentas, confiança e segurança, evals e operações de lojista, que são carregadas sempre que uma conversa do Claude Code corresponde a elas. As instruções de instalação estão no README do repositório.

Para adaptar a referência manualmente, implemente a interface de backend de compras ou de lojista sobre os seus serviços, desative os sistemas que você não tem com as flags de configuração para que suas ferramentas e linhas de prompt sejam removidas, e defina o nome da sua marca, o nome do assistente e o tom de voz. O guia de backend do repositório explica identidade e credenciais, fluxos ordenados, encaminhamento para o checkout e produtos com opções. Um piloto pode implementar a pesquisa e os detalhes do produto e usar stubs para o restante.

Primeiros passos