Criar agentes personalizados

Aprenda como criar agentes personalizados, o que preparar antes de começar e como colocá-los para trabalhar em envio de mensagens, tomada de decisões e gerenciamento de dados. Para mais informações gerais, veja Braze Agents.

Pré-requisitos

Antes de começar, você precisará do seguinte:

• Permissão para acessar o Console do Agente no seu espaço de trabalho. Verifique com seus administradores do Braze se você não vê esta opção.
• Permissão para criar e editar Agentes de IA personalizados.
• Uma ideia do que você quer que o agente realize. Os Agentes do Braze podem suportar as seguintes ações:
  • Envio de mensagens: Gerar linhas de assunto, manchetes, cópias dentro do produto ou outros conteúdos.
  • Tomada de decisões: Roteirizar usuários no Canva com base em comportamento, preferências ou atributos personalizados.
  • Gerenciamento de dados: Calcular valores, enriquecer entradas de catálogo ou atualizar campos de perfil.

Como funciona?

Quando você cria um agente, define seu propósito e estabelece diretrizes sobre como ele deve se comportar. Depois que estiver ativo, o agente pode ser implantado no Braze para gerar cópias personalizadas, tomar decisões em tempo real ou atualizar campos de catálogo. Você pode pausar ou atualizar um agente a qualquer momento a partir do dashboard.

Os seguintes casos de uso mostram algumas maneiras de aproveitar agentes personalizados.

Criar um agente

Etapa 1: Escolher um tipo de agente

Para criar seu agente personalizado:

1. Acessar Console do Agente > Gerenciamento de Agentes no dashboard da Braze.
2. Selecionar Criar agente.
3. Escolher criar um agente Canvas ou um agente de catálogo.

Etapa 2: Configurar detalhes

Em seguida, configure os detalhes do seu agente:

1. Digite um nome e uma descrição para ajudar sua equipe a entender seu propósito.
2. (opcional) Adicione tags para filtrar seu agente.
3. Escolha o modelo que seu agente deve usar.
4. Selecione o nível de pensamento do modelo. Você pode escolher entre mínimo, baixo, médio ou alto. Recomendamos começar com Minimal e testar as respostas do seu agente, ajustando conforme necessário.

Etapa 3: Escreva as instruções

Dê instruções ao agente. Recomendamos incluir instruções sobre o que o agente deve fazer em cenários inesperados ou ambíguos. Isso minimiza o risco de que a confusão do agente leve a erros. Por exemplo, em vez de pedir ao agente apenas valores de sentimento “positivo” ou “negativo”, peça para retornar “incerto” se ele não conseguir decidir.

Consulte o Writing instructions para melhores práticas e Examples para inspiração sobre como orientar seu agente.

Etapa 3.1: Adicionar contexto

Selecione Add context para escolher o que seu agente pode referenciar. Isso inclui:

• Catalog fields: Dê ao agente acesso aos dados do seu catálogo para respostas mais precisas.
• Segment membership: Deixe o agente personalizar respostas com base nos segmentos aos quais um usuário pertence. Você pode selecionar até cinco segmentos.
• Brand guidelines: Referencie a voz da marca e as diretrizes de estilo para o agente seguir. Por exemplo, se você quiser que seu agente gere cópias de SMS para incentivar os usuários a se inscreverem em uma associação de academia, você pode usar este campo para referenciar sua diretriz motivacional em negrito pré-definida.
• Todo o Contexto do Canva: Analise todos os dados de contexto do Canva para um usuário quando este agente for invocado, incluindo quaisquer variáveis que não estão referenciadas na seção Instruções.

Etapa 3.2: Adicione configurações opcionais

Na Configurações Opcionais, você pode ajustar a temperatura da cópia gerada pelo agente. Uma temperatura mais alta permite que o agente use as informações fornecidas de forma mais criativa.

Você também pode definir o limite diário de execução para seu agente. Por padrão, esse valor é definido como 250.000, mas pode ser aumentado para 1.000.000. Se você estiver interessado em aumentar o limite acima de 1.000.000, entre em contato com seu gerente de sucesso do cliente para saber mais.

Etapa 4: Selecione a saída

Na seção Saída, você pode organizar e definir a saída do agente por esquemas básicos ou esquemas avançados.

Para melhores resultados, certifique-se de que o que você especifica na seção Saída corresponda a quaisquer instruções do agente que você inseriu em Etapa 3. Por exemplo, se você mencionou nas instruções do agente que deseja um objeto com duas strings, certifique-se de especificar um objeto com duas strings na seção Saída. Se as instruções do seu agente não estiverem alinhadas com a saída especificada, o agente pode ficar confuso, expirar ou gerar saídas indesejadas.

Esquemas básicos

Esquemas básicos são uma saída simples que um agente retorna. Isso pode ser uma string, um número, um booleano, um array de strings ou um array de números.

Por exemplo, se você quiser coletar pontuações de sentimento dos usuários de uma pesquisa de feedback simples para determinar quão satisfeitos seus clientes estão após receber um produto, você pode selecionar Número como um esquema básico para estruturar o formato da saída.

Esquemas avançados

As opções de esquema avançado incluem estruturar campos manualmente ou usar JSON.

• Campos: Uma maneira sem código de impor uma saída de agente que você pode usar de forma consistente.
• JSON: Uma abordagem de código para criar um formato de saída preciso, onde você pode aninhar variáveis e objetos dentro do esquema JSON. Disponível apenas para agentes Canvas, não para agentes de catálogo.

Recomendamos usar esquemas avançados quando você deseja que o agente retorne uma estrutura de dados com múltiplos valores definidos de maneira estruturada, em vez de uma saída de valor único. Isso permite que a saída seja melhor formatada como uma variável de contexto consistente.

Por exemplo, você pode usar um formato de saída dentro de um agente que tem a intenção de criar um itinerário de viagem de amostra para um usuário com base em um formulário que eles enviaram. O formato de saída permite que você defina que cada resposta do agente deve retornar com valores para tripStartDate, tripEndDate e destination. Cada um desses valores pode ser extraído de variáveis de contexto e colocado em um passo de Mensagem para personalização usando Liquid.

• fields
• json schema

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "type": "object",
  "properties": {
    "sentiment": {
      "type": "string"
    },
    "reasoning": {
      "type": "string"
    }
  },
  "required": [
    "sentiment",
    "reasoning"
  ]
}

Etapa 5: Teste e crie o agente

O painel Prévia é uma instância do agente que aparece como um painel lado a lado dentro da experiência de configuração. Você pode usá-lo para testar o agente enquanto está criando ou fazendo atualizações nele para vivenciá-lo de maneira semelhante aos usuários finais. Este passo ajuda você a confirmar que ele está se comportando da maneira que você espera e lhe dá a chance de ajustar antes de entrar ao vivo.

1. No campo Teste seu agente, insira dados de cliente de exemplo ou respostas de clientes—qualquer coisa que reflita cenários reais que seu agente lidará.
2. Visualize a resposta do agente para um usuário aleatório, usuário existente ou usuário personalizado.
3. Selecione Simular resposta. O agente executará com base na sua configuração e exibirá sua resposta. Os testes contam para o seu limite diário de execução.

Revise a saída com um olhar crítico. Considere as seguintes perguntas:

• A cópia parece estar alinhada com a marca?
• A lógica de decisão direciona os clientes conforme o esperado?
• Os valores calculados estão precisos?

Se algo parecer errado, atualize a configuração do agente e teste novamente. Execute algumas entradas diferentes para ver como o agente se adapta a diferentes cenários, especialmente casos extremos como sem dados ou respostas inválidas.

Etapa 6: Use seu agente

Seu agente está agora pronto para uso! Para detalhes, consulte Implantar agentes.

Artigos relacionados

• Referência para agentes