Padrões Agênticos

Os Padrões Agênticos são regras e conjuntos de regras que aplicam políticas corporativas e proteções às Campaigns e aos Canvas na Braze. O Operator pode ajudar você a rascunhar regras enquanto configura um padrão. Antes do lançamento de uma Campaign ou de um Canvas, você pode executar uma avaliação agêntica com base nos seus padrões para validar diretrizes da marca, convenções organizacionais e requisitos técnicos. Para uma introdução aos Braze Agents, consulte Braze Agents.

Os Padrões Agênticos reduzem a supervisão manual. Assim, cada mensagem enviada pela Braze fica precisa, em conformidade e pronta para o lançamento.

Níveis de plano

A disponibilidade do Agentic Standards depende do seu nível de plano: gratuito ou pago.

No nível gratuito, a Evaluation preview (Simulate response) e as ações Run evaluation ou Re-run evaluation no momento do lançamento contam para as 25 execuções. Cada padrão conta como uma execução separada. Então, se você selecionar vários padrões e executá-los ao mesmo tempo, cada um deles conta para o limite. Por exemplo, executar três padrões em uma campanha usa três execuções. Entre em contato com o representante da sua conta Braze para fazer upgrade.

No nível pago, não há limite mensal de número de execuções. Avaliações mais intensivas consomem mais do limite de uso mensal. Para ver quanto do limite cada avaliação usou, confira os registros de avaliação do padrão. A maioria dos espaços de trabalho não atinge esse limite. Se isso acontecer, entre em contato com seu gerente de sucesso do cliente.

Como funciona

Os Agentic Standards estão disponíveis em dois tipos: Campaign Standards e Canvas Standards. Ao criar um padrão, você define regras específicas agrupadas em “conjuntos de regras”, que são avaliadas antes do lançamento.

Você pode escolher conjuntos de regras prontos que cobrem necessidades comuns de marketing ou criar regras personalizadas específicas para sua equipe. Depois de configurar um padrão, você pode testá-lo no painel Prévia da avaliação com qualquer Campaign ou Canvas existente no seu espaço de trabalho. A avaliação agêntica fornece um relatório detalhado, com as descobertas organizadas em categorias.

Content Blocks e Liquid

Antes da avaliação, a Braze expande os Content Blocks em seu conteúdo. O texto de cada bloco é identificado com o nome do bloco. Os Agentic Standards também recebem uma lista dos blocos que cada campo usa, incluindo blocos aninhados e qualquer bloco que não tenha sido expandido. Isso significa que as regras podem se referir a um bloco pelo nome (por exemplo, “o rodapé usa Legal_Disclaimer”).

O Liquid não é renderizado para um usuário específico. Os Agentic Standards avaliam o Liquid como ele foi escrito e verificam erros de sintaxe, variáveis não reconhecidas e condicionais sem fallback {% else %}. As chamadas de Connected Content não são feitas durante a avaliação.

Criar um Agentic Standard

Os Campaign Standards aplicam regras a Campaigns únicas e recorrentes. Os Canvas Standards aplicam regras a jornadas do cliente com várias etapas. Os dois tipos usam o mesmo fluxo de detalhes e prévia. A diferença é que os Canvas Standards têm uma segunda etapa de regras para verificações em cada etapa.

• campaign
• canvas

Etapa 1: Escolha o tipo de standard

Para criar seu standard, acesse Agent Console > Agentic Standards. Selecione Create Agentic Standard e escolha Campaign Standards no menu suspenso.

Etapa 2: Configure os detalhes

Em seguida, configure os detalhes do seu standard:

1. Insira um nome e uma descrição para ajudar sua equipe a entender a finalidade dele.
2. (Opcional) Adicione tags para filtrar seu standard.
3. (Opcional) Atribua uma equipe para definir a quais Campaigns este standard se aplica.

Etapa 3: Configure as regras da Campaign

Na etapa Campaign Rules, defina as regras que devem ser aplicadas como parte deste standard. Você pode adicionar até 15 conjuntos de regras por standard e até 20 regras por conjunto.

Para criar suas regras, selecione uma destas opções:

• Generate from file: Faça upload de um arquivo PDF, TXT, Markdown ou CSV com suas listas de verificação ou políticas existentes. A Braze usa o modelo Braze Auto para converter o conteúdo em regras e conjuntos de regras que o Agentic Standards consegue avaliar.
• Add ruleset: Crie regras do zero.

Quando você seleciona Add ruleset, estas categorias aparecem:

• Configuração da Campaign: Valida convenções de nomenclatura, tags e rastreamento de conversões.
• Público e direcionamento: Verifica Segments, exclusões e tamanho do público.
• Conteúdo e texto: Define requisitos de qualidade do texto, limites de caracteres e completude da mensagem.
• Links e rastreamento: Verifica URLs, CTAs, deep links e parâmetros UTM.
• Personalização e conteúdo dinâmico: Define verificações para a lógica Liquid e valores de fallback.
• Conformidade e entregabilidade: Define requisitos para obrigações legais e proteções de envio.
• Regras personalizadas: Selecione Create custom ruleset para definir requisitos específicos que não se encaixam bem em nenhuma das categorias pré-configuradas.

Dica

Se não tiver certeza de como escrever uma regra, selecione Generate with Operator para que o Operator ajude você a criar uma lógica específica com base nos seus requisitos.

Etapa 4: Teste seu standard

Antes de usar seu standard em Campaigns na Braze, use o painel Evaluation preview para simular uma avaliação agêntica.

1. Escolha uma Campaign existente no menu suspenso para usar como caso de teste.
2. Escolha se quer testar todos os conjuntos de regras ou um específico.
3. Selecione Simulate response.

Depois, analise os resultados. A avaliação é executada na Campaign e exibe os resultados nas seguintes categorias:

• Pass: Essas regras foram atendidas. Por exemplo, a avaliação pode confirmar que suas convenções de nomenclatura seguem os padrões esperados.
• Warning: São problemas não críticos que podem exigir atenção. Por exemplo, se você testar um conjunto de regras de e-mail em uma Campaign de webhook, a avaliação agêntica pode emitir um alerta de que os nomes de remetente não se aplicam.
• Fail: São problemas críticos que devem ser corrigidos antes do lançamento. Alguns exemplos são datas agendadas que já passaram ou tags organizacionais obrigatórias ausentes.

Etapa 1: Escolha o tipo de standard

Para criar seu standard, acesse Agent Console > Agentic Standards. Selecione Create Agentic Standard e escolha Canvas Standards no menu suspenso.

Etapa 2: Configure os detalhes

Em seguida, configure os detalhes do seu standard:

1. Insira um nome e uma descrição para ajudar sua equipe a entender a finalidade dele.
2. (Opcional) Adicione tags para filtrar seu standard.
3. (Opcional) Atribua uma equipe para definir a quais Canvas este standard se aplica.

Etapa 3: Configure as regras de configuração do Canvas

Na etapa Canvas configuration, defina regras que são avaliadas uma única vez para o Canvas inteiro. Você pode adicionar até 15 conjuntos de regras por standard, somando as duas etapas de regras, e até 20 regras por conjunto.

Para criar suas regras, selecione uma destas opções:

• Generate from file: Faça upload de um arquivo PDF, TXT, Markdown ou CSV com suas listas de verificação ou políticas existentes. A Braze usa o modelo Braze Auto para converter o conteúdo em regras e conjuntos de regras que o Agentic Standards consegue avaliar.
• Add ruleset: Crie regras do zero.

Quando você seleciona Add ruleset, estas categorias aparecem:

• Configuração do Canvas: Valida convenções de nomenclatura, tags, eventos de conversão, cronograma de entrada e configurações de reentrada.
• Estrutura do Canvas: Valida a conectividade do fluxo, ramificações, postergações e critérios de saída.
• Público e direcionamento: Verifica Segments, exclusões, limites de entrada e tamanho do público.
• Regras personalizadas: Selecione Create custom ruleset para definir requisitos específicos que não se encaixam bem em nenhuma das categorias pré-configuradas.

Etapa 4: Configure as regras das etapas do Canvas

Na etapa Canvas steps, defina regras que são avaliadas em etapas individuais da jornada. Esses conjuntos de regras são executados em todas as etapas correspondentes de um Canvas. Por exemplo, os conjuntos de regras de etapas de mensagem são executados em cada etapa de mensagem, e os conjuntos de regras de Audience Paths são executados em cada etapa de Audience Paths.

Selecione Add ruleset e escolha um tipo de etapa para ver as seguintes categorias:

• Etapas de Mensagem e Otimizador de Conteúdo
  • Conteúdo e texto: Define requisitos de qualidade do texto, limites de caracteres e completude da mensagem.
  • Links e rastreamento: Verifica URLs, CTAs, deep links e parâmetros UTM.
  • Personalização e conteúdo dinâmico: Define verificações para a lógica Liquid e valores de fallback.
  • Conformidade e entregabilidade: Define requisitos para obrigações legais e proteções de envio.
• Audience Paths
  • Jornada e prioridade: Valida os rótulos das jornadas, a ordenação do mais específico para o mais amplo e a prioridade intencional.
  • Cobertura e lacunas das jornadas: Verifica jornadas de fallback, becos sem saída e ramificações inacessíveis.
  • Tempo de avaliação e postergações: Valida janelas de retrospectiva, tempo de postergação e comportamento de reentrada.
  • Qualidade dos dados de direcionamento: Verifica valores de atributos, formatos e o tratamento de valores ausentes.
  • Preparação para a entrega posterior: Valida a adequação do canal, os requisitos de consentimento e os efeitos do limite de frequência.

Você também pode criar regras personalizadas para qualquer um dos tipos de etapa.

Dica

Se não tiver certeza de como escrever uma regra, selecione Generate with Operator para que o Operator ajude você a criar uma lógica específica com base nos seus requisitos.

Etapa 5: Teste seu standard

Antes de usar seu standard em Canvas na Braze, use o painel Evaluation preview para simular uma avaliação agêntica.

1. Escolha um Canvas existente no menu suspenso para usar como caso de teste.
2. Escolha se quer testar todos os conjuntos de regras ou um específico.
3. Selecione Simulate response.

Depois, analise os resultados. A avaliação é executada no Canvas e exibe os resultados nas seguintes categorias:

• Pass: Essas regras foram atendidas. Por exemplo, a avaliação pode confirmar que suas convenções de nomenclatura seguem os padrões esperados.
• Warning: São problemas não críticos que podem exigir atenção. Por exemplo, se você testar um conjunto de regras de e-mail em um Canvas que contém apenas etapas de mensagem com notificações por push, a avaliação agêntica pode emitir um alerta de que os nomes de remetente não se aplicam.
• Fail: São problemas críticos que devem ser corrigidos antes do lançamento. Alguns exemplos são cronogramas de entrada que já passaram, tags organizacionais obrigatórias ausentes ou critérios de saída não configurados.

Usar Agentic Standards

Depois de configurar um Campaign Standard ou Canvas Standard, você pode usá-lo para avaliar uma Campaign ou um Canvas durante a revisão final. Assim, você confirma que suas mensagens atendem a todos os requisitos antes de serem enviadas aos usuários ou antes que eles entrem na jornada.

Executar uma avaliação

• campaign
• canvas

Revisar os resultados da avaliação

Quando a avaliação termina, um resumo mostra as descobertas nestas categorias: Aprovado, Reprovado, Alerta e Ignorado.

Se uma avaliação falhar por causa de um erro de limite de frequência, selecione Tentar novamente.

A guia Reprovado lista as regras que não foram atendidas. Para cada falha, o padrão informa:

• Regra: O critério específico verificado, como “Verificação de ortografia e gramática”.
• Motivo: Uma explicação de por que a verificação falhou. Por exemplo, a avaliação pode identificar que “personalized” foi usado em vez da grafia do inglês australiano “personalised”, ou que uma etapa de postergação é menor que o tempo mínimo de espera definido pela sua equipe.

A guia Aprovado lista todas as regras que foram seguidas com sucesso. Isso confirma que verificações como Detecção de linguagem ofensiva ou Validação de convenção de nomenclatura foram aprovadas.

A guia Alerta lista problemas não críticos que podem exigir atenção. Por exemplo, se você estiver testando um conjunto de regras de e-mail em uma Campaign de webhook ou em um Canvas com apenas etapas de mensagem no app, a avaliação pode gerar um alerta de que os nomes de remetente não se aplicam.

A guia Ignorado lista os problemas que você optou por pular na execução atual da avaliação.

O indicador Última execução mostra quando um padrão foi avaliado pela última vez em relação à sua Campaign ou ao seu Canvas. Ele fica visível por 90 dias após a execução mais recente, mesmo que a Campaign ou o Canvas seja interrompido ou arquivado.

Resultados com base no julgamento do agente

Um resultado em qualquer guia pode exibir Com base no julgamento do agente abaixo do motivo. Esse marcador se aplica apenas àquela regra, não ao padrão inteiro. Ele indica que o resultado reflete a avaliação do próprio agente, e não um fato diretamente verificável, como o valor de uma configuração, uma tag ou a presença de um link. Por exemplo, decidir se um texto está bem escrito, com a grafia correta, claro ou alinhado à marca é um julgamento, mesmo que o agente consiga ler o texto.

Quando o agente pressupõe algo que não encontrou declarado na sua Campaign ou no seu Canvas, o marcador vem acompanhado de uma nota curta explicando o que foi pressuposto e por quê. Por exemplo: Com base no julgamento do agente: O nome e o texto da Campaign sugerem que se trata de uma Campaign da Home.

Se você quiser que uma regra seja verificada com base em fatos concretos, revise-a para fazer referência a configurações, tags ou conteúdos específicos. Por exemplo, use “O rodapé do e-mail inclui um link de cancelamento de inscrição” em vez de “O e-mail facilita o cancelamento da inscrição”.

Resolver ou ignorar problemas

Para cada falha ou alerta identificado, você pode decidir como prosseguir antes do lançamento. Selecione Resolver ao lado de um problema e escolha uma das seguintes opções:

• Marcar como corrigido: Selecione esta opção depois de atualizar a configuração da sua Campaign ou do seu Canvas, a estrutura da jornada ou o texto com base na sugestão da avaliação.
• Ignorar este problema: Selecione esta opção para pular o problema apenas nesta execução. Isso é útil para desvios intencionais ou casos excepcionais em que a sugestão da avaliação pode não se aplicar.
• Perguntar ao BrazeAI Operator: Selecione esta opção para corrigir o problema usando o Operator.

Depois que todos os problemas críticos forem resolvidos ou ignorados, você poderá lançar sua Campaign ou seu Canvas.

Revisar os logs de avaliação

Para revisar avaliações anteriores de um padrão, acesse Agent Console > Agentic Standards, selecione o padrão e depois selecione a guia Logs de avaliação. Cada linha corresponde a uma execução de avaliação. Use a coluna Detalhes para expandir uma execução e ver as avaliações de cada regra, ou para abrir os detalhes de uma avaliação. Para exportar os logs, selecione Exportar CSV.

Ver quem executou uma avaliação

A coluna Executado por mostra o nome do usuário da Braze que executou cada avaliação. Se não houver um nome cadastrado, ela mostra o endereço de e-mail do usuário. As avaliações de regras dentro de uma execução foram feitas pelo mesmo usuário, então essa coluna fica em branco nas linhas delas. As avaliações que não foram executadas por um usuário mostram N/A. A exportação em CSV também inclui uma coluna Executado por.

Para mostrar apenas as avaliações executadas por um usuário específico, selecione Filtros e escolha o usuário em Executado por. Os usuários que executaram o padrão no intervalo de datas selecionado aparecem primeiro na lista. Os outros usuários da sua empresa também aparecem, mas não podem ser selecionados.

Uso por avaliação

No plano gratuito, os logs de avaliação não mostram o uso, porque o seu limite é o número de execuções de avaliação por mês, e não o uso.

No plano pago, a coluna Limite usado mostra a porcentagem do limite de uso mensal do seu espaço de trabalho que cada execução e avaliação de regra consumiu, como “0.2%”. Uma parcela pequena demais para aparecer com duas casas decimais é exibida como “< 0.01%”. Use essa coluna para identificar avaliações que consomem mais do seu limite do que o esperado, como execuções de padrões com muitos conjuntos de regras.

• Em cache significa que o resultado foi reaproveitado de uma avaliação anterior idêntica e não contou para o seu limite.
• A mesma porcentagem aparece como Limite usado no painel de detalhes e como Limite usado (%) na exportação em CSV.

Para mais detalhes, consulte Níveis de plano.

Limitações

O Agentic Standards avalia a configuração e o conteúdo da sua Campaign ou Canvas da forma como estão salvos na Braze. Ele não envia mensagens, não as renderiza para usuários individuais e não acessa páginas externas.

Tenha em mente as limitações a seguir ao escrever regras e mantenha suas verificações manuais atuais para essas áreas.

• Sem envios de teste ou prévias por usuário: O Agentic Standards não envia mensagens de teste, não mostra a prévia de uma mensagem como um usuário específico e não renderiza prévias para vários usuários ao mesmo tempo. Regras que dependem do que um determinado usuário recebe não são compatíveis. Para essas verificações, use envios de teste e prévias.
• Liquid e Connected Content não são renderizados: O Agentic Standards avalia o Liquid da forma como está escrito, e não como ele é renderizado para um usuário. Ele também não faz chamadas de Connected Content. Para mais detalhes, consulte Content Blocks e Liquid.
• Links não são acessados: O Agentic Standards pode verificar se os links estão presentes e formatados corretamente, como URLs, deep links e parâmetros UTM. Mas ele não abre esses links. Portanto, não consegue detectar links quebrados, como os que retornam um erro 404, nem confirmar se o destino de um link corresponde ao que a mensagem diz.
• Sem consultas de usuários ou Segments: O Agentic Standards não consegue consultar perfis de usuário individuais nem verificar se um usuário específico está em um Segment. Ele só avalia as configurações de direcionamento da própria Campaign ou Canvas.
• Cobertura de etapas do Canvas: Os conjuntos de regras de etapas são executados apenas nas etapas de Mensagem, Otimizador de Conteúdo e Jornadas do público. Outros tipos de etapa não podem ser avaliados.
• Mensagens muito grandes: Se uma Campaign ou Canvas tiver mais conteúdo do que o Agentic Standards consegue avaliar de uma só vez, como um e-mail multivariante com muitas variantes grandes, o conteúdo é encurtado antes da avaliação. Nesse caso, os resultados mostram um alerta, e as regras podem ter sido verificadas com base em conteúdo incompleto.

Melhores práticas

• Comece com modelos: Use primeiro os conjuntos de regras predefinidos de configuração e de links e rastreamento. Eles cobrem os erros manuais mais comuns e dão à avaliação agêntica o contexto certo.
• Seja específico: Ao escrever regras personalizadas, forneça exemplos claros do que é considerado “correto”. Por exemplo, em vez de escrever “Verifique a convenção de nomenclatura”, tente “O nome da campanha ou do Canvas começa com o ano atual (por exemplo, 2026_)”.
• Teste com resultados conhecidos: Na Prévia da avaliação, faça testes com uma campanha ou um Canvas que deve passar em todas as regras e com outro que deve falhar em regras específicas. Assim, você confirma que suas regras são avaliadas corretamente antes de confiar nelas no lançamento.
• Itere com frequência: À medida que suas diretrizes da marca ou seus processos internos mudam, atualize seus conjuntos de regras do Campaign Standard e do Canvas Standard para manter suas verificações automatizadas relevantes.