--- title: Agente de comércio url: https://platform.claude.com/docs/pt-BR/about-claude/use-case-guides/commerce-agents description: 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](https://platform.claude.com/docs/pt-BR/build-with-claude/working-with-messages), no [Claude Agent SDK](https://code.claude.com/docs/en/agent-sdk/overview) e no [Claude Managed Agents](https://platform.claude.com/docs/pt-BR/managed-agents/overview), 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](https://github.com/anthropics/commerce-agents). 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](https://claude.com/blog/the-anatomy-of-effective-commerce-agents). O blueprint é uma implementação de referência para você bifurcar e adaptar, não um produto com suporte nem um serviço hospedado. ## 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](https://platform.claude.com/docs/pt-BR/managed-agents/permission-policies) 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. | Setor | Loja virtual | Portal do lojista | | ---------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | Varejo | Pesquisa, comparação, planos, carrinho, checkout e memória sobre os componentes integrados | Resumo diário, reposições e correções de anúncios preparadas, e o delegado de análise sobre uma view SQL | | Viagens | Estoque vinculado a datas e um componente de itinerário | Calendário de ocupação e alterações de tarifa por janela de datas | | Telecomunicações | Contexto da conta, uma matriz de planos e divulgações de tarifas redigidas pelo servidor | Composição de planos, alterações de preço que informam as linhas afetadas e tarifas regulamentadas protegidas | | Entretenimento | Reservas temporárias, listas de espera, transferências, um mapa do local e divulgações de tarifas com tudo incluído | Ritmo de vendas de eventos, liberações de reservas que adicionam capacidade real e alterações de preço que preservam as tarifas | ## Onde ele é executado Os runtimes da Messages API e do Agent SDK são executados na Claude API, no [Amazon Bedrock](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-amazon-bedrock), no [Google Cloud's Agent Platform](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-on-vertex-ai) ou no [Microsoft Foundry](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-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](https://code.claude.com/docs/en/overview) 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: | Comando | O que ele faz | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/scaffold-commerce-agent` | Entrevista você sobre a sua stack, repassa o plano com você e gera a estrutura de um agente de compras, um agente de lojista ou ambos sobre os pacotes de referência | | `/add-commerce-flow` | Adiciona um fluxo a um agente existente copiando sua skill, conectando as ferramentas que ele chama e escrevendo seus primeiros casos de eval | | `/author-commerce-evals` | Cria uma suíte de evals com um executor, os primeiros casos sobre o seu próprio catálogo e uma verificação de replay para CI | | `/review-commerce-agent` | Mapeia um agente que você já executa, compara-o com a referência e converte as partes que você escolher | 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 Clone o blueprint e execute os dois agentes localmente. Leia como os agentes são construídos e por quê.