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 Prévia da avaliação (Simular resposta) e as opções Executar avaliação ou Executar avaliação novamente 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 conta para o limite. Por exemplo, executar três padrões em uma campanha usa três execuções. Para fazer upgrade, entre em contato com o representante da sua conta Braze.

No nível pago, não há limite mensal de número de execuções. Avaliações mais intensivas contribuem mais para o 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 com você, 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 entre conjuntos de regras predefinidos, 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 gera um relatório detalhado com as descobertas organizadas por categoria.

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 usados em cada campo, incluindo blocos aninhados e qualquer bloco que não tenha sido expandido. Assim, as regras podem fazer referência 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, mas os Canvas Standards adicionam uma segunda etapa de regras para verificações por etapa.

Para cada tipo, o menu Criar Agentic Standard oferece dois pontos de partida:

• Criar a partir do modelo da Braze: Comece com todos os conjuntos de regras predefinidos desse tipo já adicionados. Você pode editar ou remover qualquer um desses conjuntos de regras e regras antes de salvar.
• Criar do zero: Comece sem nenhum conjunto de regras. Adicione seus próprios conjuntos de regras ou gere-os a partir de um arquivo.

• campaign
• canvas

Etapa 1: Escolha o tipo de padrão

Para criar seu padrão, acesse Agent Console > Agentic Standards. Selecione Criar Agentic Standard e, em Campaign Standards, selecione Criar a partir do modelo da Braze ou Criar do zero.

Etapa 2: Configure os detalhes

Em seguida, configure os detalhes do seu padrão:

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

Etapa 3: Configure as regras da Campaign

Na etapa Regras da Campaign, defina as regras que devem ser aplicadas como parte desse padrão. Você pode adicionar até 15 conjuntos de regras por padrão e até 20 regras por conjunto de regras.

Se você começou pelo modelo da Braze, já existe um conjunto de regras adicionado para cada categoria predefinida. Revise cada um e edite ou remova as regras que não se encaixam na sua equipe.

Você pode criar suas regras selecionando uma destas opções:

• Gerar a partir de arquivo: Faça upload de um arquivo PDF, TXT, Markdown ou CSV com suas checklists ou políticas existentes. A Braze usa o modelo Braze Auto para converter o conteúdo em regras e conjuntos de regras que os Agentic Standards podem avaliar.
• Adicionar conjunto de regras: Crie regras do zero.

Ao selecionar Adicionar conjunto de regras, 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 lógica Liquid e valores de fallback.
• Conformidade e entregabilidade: Define requisitos para obrigações legais e salvaguardas de envio.
• Regras personalizadas: Selecione Criar conjunto de regras personalizado 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 formular uma regra, selecione Gerar com o Operator para que o Operator ajude você a redigir uma lógica específica com base nos seus requisitos.

Etapa 4: Teste seu padrão

Antes de usar seu padrão em Campaigns na Braze, use o painel Prévia da avaliação 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 Simular resposta.

Em seguida, revise os resultados. A avaliação é executada na Campaign e mostra os resultados nas seguintes categorias:

• Aprovado: Essas regras foram cumpridas com sucesso. Por exemplo, a avaliação pode confirmar que suas convenções de nomenclatura correspondem aos padrões esperados.
• Alerta: 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.
• Reprovado: São problemas críticos que devem ser corrigidos antes do lançamento. Alguns exemplos são datas agendadas no passado ou tags organizacionais obrigatórias ausentes.

Etapa 1: Escolha o tipo de padrão

Para criar seu padrão, acesse Agent Console > Agentic Standards. Selecione Criar Agentic Standard e, em Canvas Standards, selecione Criar a partir do modelo da Braze ou Criar do zero.

Etapa 2: Configure os detalhes

Em seguida, configure os detalhes do seu padrão:

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

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

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

Se você começou pelo modelo da Braze, as duas etapas de regras incluem conjuntos de regras predefinidos. Esta etapa inclui os conjuntos de regras Configuração do Canvas, Estrutura do Canvas e Público e direcionamento. A etapa Etapas do Canvas inclui os conjuntos de regras de etapa de mensagem e de Audience Paths. Revise cada um e edite ou remova as regras que não se aplicam à sua equipe.

Você pode criar suas regras selecionando uma destas opções:

• Gerar a partir de arquivo: Faça upload de um arquivo PDF, TXT, Markdown ou CSV com suas checklists ou políticas existentes. A Braze usa o modelo Braze Auto para converter o conteúdo em regras e conjuntos de regras que os Agentic Standards podem avaliar.
• Adicionar conjunto de regras: Crie regras do zero.

Ao selecionar Adicionar conjunto de regras, 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 Criar conjunto de regras personalizado 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 Etapas do Canvas, 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 etapa 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 Adicionar conjunto de regras 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 lógica Liquid e valores de fallback.
  • Conformidade e entregabilidade: Define requisitos para obrigações legais e salvaguardas de envio.
• Audience Paths
  • Jornada e prioridade: Valida rótulos de jornada, a ordenação do mais específico para o mais amplo e a prioridade intencional.

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

Dica

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

Etapa 5: Teste seu padrão

Antes de usar seu padrão em Canvas na Braze, use o painel Prévia da avaliação 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 Simular resposta.

Em seguida, revise os resultados. A avaliação é executada no Canvas e mostra os resultados nas seguintes categorias:

• Aprovado: Essas regras foram cumpridas com sucesso. Por exemplo, a avaliação pode confirmar que suas convenções de nomenclatura correspondem aos padrões esperados.
• Alerta: 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ção por push, a avaliação agêntica pode emitir um alerta de que os nomes de remetente não se aplicam.
• Reprovado: São problemas críticos que devem ser corrigidos antes do lançamento. Alguns exemplos são cronogramas de entrada no passado, tags organizacionais obrigatórias ausentes ou critérios de saída não configurados.

Use 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

Analisar 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 standard 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 é mais curta do que o tempo mínimo de espera definido pela sua equipe.

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

A guia Alerta lista 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 ou em um Canvas que tenha apenas etapas de mensagem no app, a avaliação pode gerar um alerta informando que os nomes de remetente não se aplicam.

A guia Ignorado lista os problemas que você decidiu ignorar na execução atual da avaliação.

O indicador Última execução mostra quando um standard foi avaliado pela última vez na sua Campaign ou no 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 mostrar Com base no julgamento do agente abaixo do motivo. Essa marcação vale apenas para aquela regra, não para o standard inteiro. Ela indica que o resultado reflete a avaliação do próprio agente, e não um fato verificável diretamente, 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 ortografia 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 explicitamente na sua Campaign ou no seu Canvas, a marcação vem acompanhada 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 Home.

Se 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, a estrutura da jornada ou o texto da sua Campaign ou do seu Canvas com base na sugestão da avaliação.
• Ignorar este problema: Selecione esta opção para ignorar 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ê pode lançar sua Campaign ou seu Canvas.

Revisar logs de avaliação

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

Ver quem executou uma avaliação

A coluna Run by mostra o nome do usuário da Braze que executou cada avaliação ou o endereço de e-mail dele, caso não haja um nome cadastrado. As avaliações de regras dentro de uma execução foram feitas pelo mesmo usuário, então essa coluna fica em branco nessas linhas. Avaliações que não foram executadas por um usuário mostram N/A. A exportação em CSV também inclui uma coluna Run by.

Para mostrar apenas as avaliações executadas por um usuário específico, selecione Filters e escolha o usuário em Run by. Os usuários que executaram o padrão no intervalo de datas selecionado aparecem primeiro na lista. Os demais 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 Limit used mostra a porcentagem do limite de uso mensal do seu espaço de trabalho consumida por cada execução e avaliação de regra, 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 você espera, como execuções de padrões com muitos conjuntos de regras.

• Cached significa que o resultado foi reaproveitado de uma avaliação anterior idêntica e não foi contabilizado no seu limite.
• A mesma porcentagem aparece como Limit used no painel de detalhes e como Limit used (%) na exportação em CSV.

Para mais detalhes, consulte Planos.

Limitações

O Agentic Standards avalia a configuração e o conteúdo da sua Campaign ou do seu Canvas 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.

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

• Sem envios de teste nem 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 muitos usuários de uma vez. Regras que dependem do que um determinado usuário recebe não são compatíveis. Use envios de teste e prévias para essas verificações.
• Liquid e Connected Content não são renderizados: O Agentic Standards avalia o Liquid como ele está escrito, e não como é renderizado para um usuário. Ele também não faz chamadas de Connected Content. Para saber mais, consulte Content Blocks e Liquid.
• Os 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 não os abre. Ele não detecta links quebrados, como links que retornam um erro 404, nem confirma se o destino de um link corresponde ao que a mensagem diz.
• Sem consultas de usuários ou Segments: O Agentic Standards não consulta perfis de usuário individuais nem verifica se um usuário específico está em um Segment. Ele avalia apenas as configurações de direcionamento da própria Campaign ou do próprio 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.
• Limite de imagens: O Agentic Standards consegue ver o conteúdo de até 32 imagens únicas por Campaign ou por etapa de Mensagem em um Canvas. Uma imagem usada em mais de uma variante conta apenas uma vez. Isso inclui imagens adicionadas por Content Blocks e pelo rodapé do e-mail, sendo que as imagens do rodapé são contadas por último. Como também existe um limite de tamanho total, uma Campaign ou um Canvas com muitas imagens grandes pode ter menos imagens verificadas. Imagens com URL criada com Liquid não são verificadas. Regras sobre a aparência de uma imagem se aplicam apenas às imagens dentro desse limite.
• Mensagens muito grandes: Se uma Campaign ou um Canvas tiver mais conteúdo do que o Agentic Standards consegue avaliar de uma vez, como um e-mail multivariante com muitas variantes grandes, o conteúdo é reduzido antes da avaliação. Nesse caso, os resultados mostram um alerta, e as regras podem ter sido verificadas com base em um conteúdo incompleto.

Melhores práticas

• Comece com modelos: Use primeiro os conjuntos de regras prontos para configuração e para 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, dê exemplos claros de como é o resultado “correto”. Por exemplo, em vez de escrever “Verifique a convenção de nomenclatura”, experimente “O nome da Campaign ou do Canvas começa com o ano atual (por exemplo, 2026_)”.
• Teste com resultados conhecidos: Em Prévia da avaliação, teste uma Campaign ou um Canvas que deve passar em todas as regras e outro que deve falhar em regras específicas. Assim, você confirma que suas regras são avaliadas com precisão antes de depender delas no lançamento.
• Itere com frequência: Quando as diretrizes da marca ou os processos internos mudarem, atualize os conjuntos de regras Campaign Standard e Canvas Standard para manter suas verificações automatizadas relevantes.