Conversational Agents

Conversational Agents é um canal que permite que seus usuários conversem com um agente de IA para concluir tarefas definidas por você. Você cria fluxos de trabalho conversacionais que descrevem o que o agente deve fazer pela sua marca. Por exemplo, um fluxo de trabalho pode ajudar um usuário a comprar itens com base nas preferências dele.

Importante

O Conversational Agents está atualmente em beta. Entre em contato com o gerente da sua conta Braze se tiver interesse em participar deste beta.

Antes de implantar em produção, consulte sua equipe jurídica sobre as implicações do uso de IA conversacional.

Como funciona

Um fluxo de trabalho conversacional é uma tarefa que você quer que um agente execute. Cada fluxo de trabalho inclui um objetivo, configurações de canal, um público-alvo e etapas em linguagem natural. Em cada etapa, adicione ferramentas para que o agente possa pesquisar catálogos, definir atributos, registrar eventos ou chamar webhooks.

Depois de criar os fluxos de trabalho, consulte Configurações para definir as diretrizes da marca e o comportamento do canal. Use Prévia de uma conversa, Criar simulações e Revisar o histórico de conversas para testar a experiência e revisar as chamadas de ferramentas.

Configurar o widget de chat na web

Para exibir o widget de chat dos Conversational Agents no seu site, conclua as etapas a seguir no Web SDK da Braze.

Etapa 1: Configurar a autenticação do SDK

Ative a autenticação do SDK para o seu app web.

Etapa 2: Instalar o Web SDK

Instale uma das opções a seguir:

Etapa 3: Inicializar com JavaScript fornecido pelo usuário ativado

Na sua chamada initialize, defina allowUserSuppliedJavascript: true:

1
2
3
4

braze.initialize("{YOUR_API_KEY}", {
  baseUrl: "{YOUR_SDK_ENDPOINT}",
  allowUserSuppliedJavascript: true
});

Substitua {YOUR_API_KEY} pela chave de API do seu Web SDK e {YOUR_SDK_ENDPOINT} pelo seu endpoint do SDK.

Etapa 4: Ativar o widget de chat

Antes de abrir uma sessão, chame braze.automaticallyManageChat():

1
2

braze.automaticallyManageChat();
braze.openSession();

Criar um fluxo de trabalho conversacional

Use um fluxo de trabalho conversacional para definir uma tarefa, escolher canais e um público e dizer ao agente o que fazer em cada etapa.

Etapa 1: Configurar os detalhes do fluxo de trabalho

Acesse Agent Console > Conversational Agents e configure os detalhes do seu fluxo de trabalho:

1. Insira um nome para o fluxo de trabalho.
2. Insira um objetivo que descreva o que esse fluxo de trabalho faz. Assim, o agente sabe quando usá-lo.
3. Selecione os canais em que esse fluxo de trabalho está ativado. Os canais compatíveis são SMS, RCS, WhatsApp e web.
   • Para web, selecione em quais apps web esse fluxo de trabalho está ativado.
   • Para SMS, RCS e WhatsApp, selecione em quais grupos de inscrições esse fluxo de trabalho está ativado.
4. Selecione os segmentos aos quais um usuário precisa pertencer para acessar esse fluxo de trabalho.

Para SMS, RCS e WhatsApp, alguns gatilhos de mensagens recebidas podem bloquear o agente. Na página Configurações, revise os gatilhos que podem bloquear agentes em cada grupo de inscrições.

Etapa 2: Escrever as etapas do fluxo de trabalho

Adicione as etapas que o agente deve seguir para concluir o fluxo de trabalho. Um fluxo de trabalho pode ter até 10 etapas. Cada etapa precisa de uma instrução, que pode ter até 5.000 caracteres.

Para etapas com um único objetivo, escreva a instrução em uma a três frases curtas. Mantenha as regras claras e termine com uma pergunta ou confirmação explícita. Assim, o agente sabe como formular a próxima resposta ao usuário.

Etapa 3: Adicionar ferramentas às etapas

As etapas podem incluir ferramentas que o agente usa enquanto trabalha. Nas Instruções de uma etapa, você insere ferramentas digitando /, e elas aparecem como tags na instrução. Uma etapa pode fazer referência a até 10 ferramentas.

Ferramentas

Você pode adicionar qualquer uma destas ferramentas a uma etapa:

Pesquisar fontes de conhecimento

Use esta ferramenta para ajudar o agente a consultar e entender um catálogo da Braze. Crie fontes de conhecimento para catálogos como:

• Catálogo de produtos
• Perguntas frequentes
• Tabelas de tamanhos

Primeiro, crie a fonte de conhecimento na página Fontes de conhecimento. Depois, na caixa de texto de instruções, digite / e selecione Pesquisar fontes de conhecimento. Selecione uma ferramenta de fonte de conhecimento conversacional existente ou selecione Criar nova ferramenta de pesquisa.

Ao criar uma nova ferramenta, insira um nome e uma descrição e selecione uma fonte de conhecimento. Depois de selecionar a fonte de conhecimento, escolha quais campos o agente pode acessar.

Definir um atributo do fluxo de trabalho

Use esta ferramenta para definir um atributo que o agente pode reutilizar mais adiante no mesmo fluxo de trabalho. Os atributos do fluxo de trabalho ficam restritos ao fluxo de trabalho em que são definidos. Use-os como propriedades de eventos personalizados, valores de atributos personalizados e parâmetros de webhook.

Ao criar o atributo, você pode adicionar Valores permitidos, se quiser:

• Deixe os valores permitidos em branco para que o agente possa definir qualquer valor desse tipo com base na conversa.
• Adicione valores permitidos para limitar o agente a um subconjunto definido por você. Use essa opção quando ferramentas posteriores (como Chamar webhook, Registrar evento personalizado ou Definir atributo personalizado) precisarem reutilizar um valor controlado em vez de uma escolha livre do agente.

Em Instrução, digite / e selecione Definir atributo do fluxo de trabalho. Selecione um atributo do fluxo de trabalho existente ou selecione Criar novo atributo.

Ao criar um novo atributo, insira um nome e uma descrição e selecione o tipo. Depois de selecionar o tipo, adicione valores permitidos, se quiser.

Obter um atributo do fluxo de trabalho

Use esta ferramenta para recuperar o valor de um atributo do fluxo de trabalho definido em uma etapa anterior.

Registrar um evento personalizado

Use esta ferramenta para registrar um evento personalizado da Braze. Na caixa de texto de instruções, digite / e selecione Registrar evento personalizado. Selecione uma ferramenta de registro de evento personalizado existente ou selecione Criar nova ferramenta de evento personalizado.

Ao criar uma nova ferramenta, selecione o evento personalizado e insira um nome e uma descrição. Escolha as propriedades do evento que serão enviadas com o evento personalizado. Cada propriedade de evento personalizado pode usar uma das seguintes fontes:

Não é preciso definir um valor para todas as propriedades. Alguns tipos de propriedade não são compatíveis.

Selecione Obrigatório se a ferramenta precisar falhar quando o valor da propriedade estiver em branco.

Para enviar um usuário para um Canvas, registre um evento personalizado que o Canvas usa como propriedade de entrada.

Definir um atributo personalizado

Use esta ferramenta para definir um atributo personalizado no usuário. Na caixa de texto de instruções, digite / e selecione Definir atributo personalizado. Selecione uma ferramenta de definição de atributo personalizado existente ou selecione Criar nova ferramenta de atributo personalizado.

Ao criar uma nova ferramenta, insira um nome e uma descrição e selecione o atributo personalizado que a ferramenta deve definir. Um atributo personalizado pode usar uma das seguintes fontes:

Nota

Os atributos personalizados são definidos de forma assíncrona. Se o agente ler um atributo personalizado logo depois de defini-lo, o valor ainda pode estar desatualizado.

Obter um atributo personalizado

Use esta ferramenta para recuperar um atributo personalizado.

Obter um atributo do usuário

Use esta ferramenta para recuperar um campo padrão do perfil de usuário. Na caixa de texto de instruções, digite uma barra (/) e selecione Obter atributo do usuário. Escolha um dos seguintes campos:

• ID externo
• ID da Braze
• E-mail
• Nome
• Sobrenome
• Telefone

Chamar um webhook

Use esta ferramenta para chamar um webhook. Na caixa de texto de instruções, digite / e selecione Chamar webhook. Selecione uma ferramenta de webhook existente ou selecione Criar novo webhook.

Ao criar uma nova ferramenta, insira um nome e uma descrição e adicione variáveis. As variáveis permitem incluir valores personalizados na URL, no corpo ou nos cabeçalhos do webhook.

Uma variável pode usar uma das seguintes fontes:

Depois de definir as variáveis, escolha o método da solicitação. Os seguintes métodos são compatíveis:

• GET
• POST
• PUT
• PATCH
• DELETE

Em seguida, insira a URL. Para usar variáveis na URL, faça referência a elas com a sintaxe {{variable_name}}. Por exemplo:

1

https://myurl.com/create/{{user_id}}

Depois, defina o corpo da solicitação. Deixe o corpo em branco ou insira uma string que pode incluir placeholders {{variable_name}}. Para a maioria das APIs, envie um corpo em JSON. Por exemplo:

1
2
3
4
5
6
7

{
  "user": {
    "id": "{{external_id}}",
    "favorite_color": "{{favorite_color}}",
    "is_called_by_agent": true
  }
}

Você também pode definir cabeçalhos usando variáveis. Para credenciais, crie credenciais de Connected Content no dashboard e faça referência a elas nesta ferramenta.

As respostas de webhook podem ser grandes, então você pode extrair apenas os campos de que o fluxo de trabalho precisa. Crie campos de resposta com uma expressão JMESPath que aponte para um valor no corpo da resposta. O corpo da resposta precisa ser um JSON válido para que esses campos sejam extraídos com sucesso. Depois, faça referência a esses campos com a ferramenta Obter resposta do webhook.

Obter uma resposta do webhook

Use esta ferramenta para fazer referência a um campo de resposta do webhook extraído de uma etapa anterior de Chamar webhook.

Configurações

Configure as diretrizes da marca e o comportamento dos canais para os agentes conversacionais. Acesse Console do agente > Agentes conversacionais e selecione Configurações.

Diretrizes da marca

Selecione as diretrizes da marca que o agente deve seguir nas respostas. Crie e gerencie diretrizes em Conteúdo > Diretrizes da marca e depois escolha uma aqui.

Configurações da web

Defina uma Mensagem de abertura. Essa é a primeira mensagem que os usuários veem ao iniciar uma conversa na web.

Configurações de SMS, RCS e WhatsApp

Configure o seguinte:

Os gatilhos que podem ter prioridade incluem:

• Gatilhos de palavras-chave
• Campaigns baseadas em ação
• Entrada no Canvas baseada em ação
• Jornada de ação do Canvas
• Saída do Canvas

Prévia de uma conversa

Existem duas formas de visualizar a prévia:

• Ao editar um fluxo de trabalho salvo, visualize a prévia apenas desse fluxo de trabalho. A prévia não fica disponível até você salvar um novo fluxo de trabalho.
• Na página Configurações, visualize a prévia da experiência para um app web ou grupo de inscrições. Se quiser, selecione Incluir fluxos de trabalho em rascunho para testar fluxos de trabalho em rascunho antes de ativá-los.

Em ambos os casos, visualize a prévia como um usuário específico.

Nota

O modo de prévia não registra atributos personalizados nem eventos personalizados.

Criar simulações

Acesse Agent Console > Conversational Agents e selecione Simulations.

Crie casos de simulação que descrevam um cenário de usuário e os resultados esperados. Execute uma simulação para testar esses casos nos fluxos de trabalho conversacionais do seu espaço de trabalho. Você pode simular respostas de webhook para que os casos continuem previsíveis enquanto avalia o comportamento do agente.

Revisar histórico de conversas

Na página Agentes conversacionais, selecione Histórico de conversas. Esta página exibe conversas com usuários reais e conversas da prévia.

Use o histórico de conversas para revisar chamadas de ferramentas e confirmar que o agente se comporta como esperado.

Exemplo

A Flash & Thread, uma marca fictícia de varejo de roupas, pode usar este fluxo de compras em duas etapas.

• Etapa 1: Pergunta ao usuário qual categoria de produto ele está procurando.
• Etapa 2: Usa a ferramenta Definir atributo de fluxo de trabalho para capturar um atributo product_category como string. Esse atributo registra a categoria de produto que o usuário informou na Etapa 1 como a que está procurando hoje.