Criar agentes personalizados

Saiba como criar agentes personalizados, o que preparar antes de começar e como colocá-los para trabalhar no envio de mensagens, na tomada de decisões e no gerenciamento de dados. Para saber mais sobre informações gerais, consulte Braze Agents.

Pré-requisitos

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

• Acesso ao Console do agente em seu espaço de trabalho. Verifique com seus administradores do Braze se você não vê essa opção.
• Permissão para criar e editar agentes de IA personalizados.
• Uma ideia do que você deseja que o agente realize. Os agentes Braze podem suportar as seguintes ações:
  • Envio de mensagens: Gere linhas de assunto, manchetes, textos no produto ou outros conteúdos.
  • Tomada de decisões: Direcione os usuários no Canva com base no comportamento, nas preferências ou em atributos personalizados.
  • Gerenciamento de dados: Calcular valores, enriquecer entradas de catálogo ou atualizar campos de perfil.

Como funciona?

Ao criar um agente, você define a sua finalidade e estabelece as diretrizes de como ele deve se comportar. Depois de estar ativo, o agente pode ser implantado no Braze para gerar cópias personalizadas, tomar decisões em tempo real ou atualizar os campos do catálogo. Você pode pausar ou atualizar um agente a qualquer momento no dashboard.

Os casos de uso a seguir mostram algumas maneiras de aproveitar os agentes personalizados.

Criar um agente

Etapa 1: Detalhes da configuração

Para criar seu agente personalizado:

1. Acesse Console do agente > Gerenciamento do agente no dashboard do Braze.
2. Selecione Criar agente.
3. Digite um nome e uma descrição para ajudar a sua equipe a entender a finalidade.
4. (opcional) Adicione tags para filtrar seu agente.
5. Selecione o site de interação, que é o local onde o agente está implantado. Note que o site de interação não pode ser atualizado depois que um agente é criado.
6. Escolha o modelo que seu agente usará.

Etapa 2: Escreva as instruções

Dê instruções ao agente. Consulte a referência dos agentes para obter orientação.

Etapa 2.1: Adicionar contexto

Selecione Adicionar contexto para escolher o que seu agente pode referenciar. Isso inclui:

• Campos do catálogo: Forneça campos de catálogo para o agente fazer referência.
• Participação no segmento: Considere a participação de um usuário em um segmento ao personalizar mensagens. Você pode selecionar até três segmentos.
• Diretrizes da marca: Faça referência à voz da marca e às diretrizes de estilo a serem seguidas pelo agente. Por exemplo, se quiser que seu agente gere uma cópia de SMS para incentivar os usuários a inscreverem-se em uma academia, poderá usar esse campo para fazer referência à sua diretriz motivacional e em negrito predefinida.
• Variáveis de contexto da tela: Analise todas as variáveis do Canvas Context para um usuário quando esse agente for chamado.

Etapa 2.2: Adicionar configurações opcionais

Nas 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 para ser mais criativo.

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

Etapa 3: Selecione a saída

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

Esquemas básicos

Os esquemas básicos são uma saída simples que um agente retorna. Pode ser uma string, um número, um booleano, uma matriz de strings ou uma matriz de números.

Digamos que você queira coletar pontuações de sentimento do usuário de uma simples pesquisa de feedback para determinar o grau de satisfação dos clientes após receberem um produto. Você pode selecionar Número como um esquema básico para estruturar o formato de saída.

Esquemas avançados

As opções avançadas de esquema incluem a estruturação manual de campos ou o uso de 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, em que você pode aninhar variáveis e objetos no esquema JSON.

• 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 4: Teste e crie o agente

O painel Prévia é uma instância do agente que aparece como um painel lado a lado na experiência de configuração. Você pode usá-lo para testar o agente enquanto cria ou atualiza o agente para experimentá-lo de forma semelhante à dos usuários finais. Essa etapa o ajuda a confirmar se o comportamento está sendo o esperado e lhe dá a chance de fazer ajustes finos antes de acessar o site.

1. No campo Teste seu agente, insira dados de clientes de exemplo ou respostas de clientes - qualquer coisa que reflita cenários reais com os quais seu agente lidará.
2. Pré-visualize a resposta do agente para um usuário aleatório, usuário existente ou usuário personalizado.
3. Selecione Simular resposta. O agente será executado com base em sua configuração e exibirá sua resposta. As execuções de teste contam para seu limite diário de execução.

Analise o resultado com um olhar crítico. Considere as seguintes perguntas:

• O texto está de acordo com a marca?
• A lógica da decisão encaminha os clientes como pretendido?
• Os valores calculados sã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 aos cenários, especialmente em casos extremos, como ausência de dados ou respostas inválidas.

Etapa 5: Use e monitore seu agente

Seu agente agora está pronto para ser usado! Para obter detalhes, consulte Implantar agentes.

Na guia Registros do seu agente, é possível monitorar as chamadas de agente reais que ocorrem em suas telas e catálogos. Você pode filtrar por informações como o intervalo de datas, o resultado (sucesso ou falha) ou o local da chamada.

Selecione Exibir para uma chamada de agente específica para ver a entrada, a saída e a ID do usuário.