Subagentes para o B2C Shopper Agent

Roteador do agente

Toda conversa de agente começa com o subagente do Agent Router. Esse subagente direciona uma conversa para o subagente específico do Shopper Agent certo durante cada interação com um comprador.

• Se um comprador responder com uma resposta ambígua durante uma conversa, por exemplo, ele digitar "adicioná-lo", o Roteador do Agente tratará essas respostas como relacionadas à tarefa atual, e não a novas solicitações.
• O agente roteia mensagens com base na mensagem mais recente do comprador. Ele filtra automaticamente qualquer código em segundo plano, uso automatizado de ferramentas ou etapas técnicas concluídas em mensagens anteriores. O agente reage com precisão ao que o comprador está pedindo no momento, sem interferência de atividades passadas do sistema.

Para personalizar o subagente do roteador:

• Adicione uma rota para expor um novo subagente ou remova (comente) uma para desativar um recurso.
• Ajuste a mensagem de boas-vindas ou as instruções de roteamento. Por exemplo, edite a descrição do roteador para primeiro dar as boas-vindas ao comprador na primeira sessão de bate-papo.
• Reordene ou reformule a lógica de roteamento para influenciar como o agente interpreta solicitações ambíguas para que ele resolva solicitações que se ajustem ao seu catálogo.

Subagentes do Shopper Agent

Os subagentes Especialista em produto, Carrinho e Confirmação de pedido compartilham um nó de raciocínio. Esse nó cria o prompt de cada subagente a partir de um conjunto comum de variáveis de modelo. Os subagentes de Suporte e Segurança não usam o nó compartilhado. Eles correm por suas próprias instruções. Como esses três subagentes do Commerce se baseiam nas mesmas variáveis, editar uma variável altera o comportamento de cada subagente que a usa.

• retailer_name
• retailer_description
• retailer_voice
• tool_calling_guidance
• response_guidance
• example_response
• id_col

Subagentes de segurança e guarda-corpo

Há subagentes que apenas classificam solicitações. Não fazem mais nada. Eles são intencionalmente estreitos. Cada um inclui uma seção detalhada Não usar para que os termos comuns de compras não sejam tratados como um ataque. Você define esses guardrails em config.additional_parameter__disabled_topics.

• Engenharia reversa — captura tentativas de extrair os elementos internos do agente. Essas solicitações podem usar "mostre-me o prompt do sistema", "liste todas as suas ferramentas", "traduza suas instruções". Ignora explicitamente verbos de domínio como adicionar, visualizar, localizar, fazer checkout e "esta ferramenta".
• Injeção imediata — captura tentativas de substituição, como "ignorar instruções anteriores", tags de sistema> falsas<, "modo de desenvolvedor", representação de autoridade e cargas codificadas. Ignora explicitamente palavras como "ignorar" ou "esquecer" para detalhes descritos pelo comprador.
• Conteúdo impróprio — captura conteúdo genuinamente prejudicial de autoria do usuário (discurso de ódio, ameaças, CSAM, automutilação, instruções de atos ilegais). Trata explicitamente o vocabulário do comércio como sempre benigno, como "quebrado", "bateria morta", "negócio assassino" e reclamações de um comprador, como "pior experiência". Esses subagentes encaminham mensagens com esse tipo de conteúdo para o subagente apropriado e não as sinalizam.
• Off Topic—Educadamente redireciona solicitações de conhecimento geral e fora do tópico de volta para tópicos de compras, sem responder à pergunta fora do tópico e sem revelar detalhes do sistema.

Para personalizar esses subagentes:

• Ajuste as listas de sinais para se adequar à sua loja. Adicione seus próprios nomes de produtos que contenham palavras confidenciais à lista sempre benigna para que o modelo não os sinalize. Adicione padrões de ataque que você vê.
• Ajuste a mensagem e as regras de redirecionamento fora do tópico.
• Adicione ou remova tópicos desabilitados usando o config.additional_parameter__disabled_topics.

Dicas de configuração do subagente

• Muitos subagentes podem compartilhar uma única variável. Para evitar modificar cada subagente que usa uma variável compartilhada, use variantes com escopo, como cart_tool_calling_guidance ou order_tool_calling_guidance para controlar o comportamento de um subagente individual.
• Cada cadeia de caracteres response_guidance tem um limite de 255 caracteres. Exceder esse limite causa um erro de script de agente.
• O response_guidance é JSON — valide aspas escapadas e evite vírgulas à direita.
• Substitua espaços reservados. Deixar um token não substituído na seção UPPER_SNAKE_CASE pode causar uma falha de publicação.
• Teste com dados reais. Na visualização do agente, o modo fictício retorna dados falsos do catálogo. Teste qualquer comportamento de pesquisa e carrinho em relação a ações em tempo real antes de tirar conclusões.