Inclusão de funcionalidade personalizada em fluxos de conversa com agente avançado de IA usando integrações fictícias

Qual é o meu plano?

Complemento

Agentes de IA - Avançado

Uma integração fictícia permite que uma funcionalidade personalizada seja adicionada aos diálogos usando dados já presentes na conversa, sem fazer chamadas reais da API ou recuperar dados externos. Isso permite implementar a lógica usando JSONata para manipulação de dados, comparações ou outras tarefas no fluxo de diálogo.

Esse tipo de integração é útil para gerenciar tarefas que não exigem dados externos em tempo real, atuando como uma integração “auxiliar” para estender os recursos de um agente de IA além dos recursos padrão.

Este artigo contém os seguintes tópicos:

• Sobre integrações fictícias
• Criação de uma integração fictícia
• Adição de uma integração fictícia em um diálogo

Sobre integrações fictícias

Uma integração fictícia é útil quando você deseja processar ou manipular dados já disponíveis na conversa. Por exemplo, é possível realizar as seguintes tarefas usando uma integração fictícia:

• Transformar seus dados em um formato mais adequado.
• Formatar e filtrar dados complexos de CRM ou API.
• Comparar datas para localizar a mais recente.
• Recuperar o dia e hora atuais.
• Verificar se uma data está dentro de um determinado período de tempo.
• Verificar se uma URL contém palavras específicas.
• Verificar e substituir valores nulos.
• Substituir letras ou símbolos em seus dados.
• Usar um filtro que não diferencie maiúsculas de minúsculas para analisar os dados e retornar o primeiro valor correspondente, ou fornecer uma resposta de fallback se não houver correspondências.

Se você puder definir a lógica usando JSONata, é possível aprimorar suas conversas com essas integrações úteis.

Criação de uma integração fictícia

Dica: antes de criar uma integração fictícia, sugerimos que você se familiarize com o uso do JSONata com o Criador de integração. Consulte Ativação de JSONata.

Para elaborar uma integração fictícia, basta criar uma integração de API seguindo o processo habitual. No entanto, nenhuma solicitação de dados é feita.

Como criar uma integração fictícia

1. No menu principal, clique em Integrações da API.
2. No canto superior direito, clique em Adicionar integração.
3. Na janela Adicionar integração:
   
   1. No campo Nome da integração, dê um nome descritivo à sua integração.
   2. (Opcional) No campo Descrição, insira uma descrição da integração que ajude você a lembrar para que serve.
   3. Clique em Salvar.
4. Na barra lateral esquerda, em Ambientes, selecione um ambiente (como Produção).
5. Defina o Tipo de método como GET.
6. No campo URL, insira uma URL fictícia (por exemplo, https://dummyjson.com/http/200).
   

   • Observação: como as integrações fictícias são hospedadas na estrutura de integração, elas devem apontar para uma URL válida. O exemplo acima usa https://dummyjson.com/http/200, mas sua disponibilidade não pode ser garantida. É possível usar qualquer URL fictícia que faça sentido para você. Embora uma chamada da API seja feita para a URL especificada, nenhum dado da resposta será processado na integração fictícia.

7. Certifique-se de que Tipo de autorização esteja definido como Sem autorização.
8. (Opcional) Na barra lateral esquerda, em Cenários, passe o mouse sobre Falha, selecione o menu de opções () e Apagar. Você não precisa de um cenário de falha para uma integração fictícia.
9. Na barra lateral esquerda, em Cenários, selecione Sucesso.
10. Dependendo do seu cenário, siga um dos procedimentos a seguir:
    
    • Se tiver uma consulta simples, insira-a no campo Consulta de cenário. Por exemplo, caso precise apenas de uma resposta booleana, ter a consulta aqui já basta.
    • Caso precise definir a lógica com base nos parâmetros da solicitação (vindos da conversa):
      
      1. Insira requestParameters no campo Consulta de cenário.
      2. Em Parâmetros de sessão, insira os parâmetros para sua integração fictícia. A captura de tela abaixo inclui parâmetros de exemplo e expressões JSONata para retornar o dia da semana e a hora atual.
         
11. Clique em Salvar.

Adição de uma integração fictícia em um diálogo

No criador de diálogos, é possível adicionar um nó de integração da API e selecionar sua integração fictícia.

Como adicionar uma integração fictícia em um diálogo

1. No canto superior direito, use o campo de lista suspensa Agente de IA para selecionar o agente de IA que você deseja atualizar o diálogo.
2. No menu principal à esquerda, selecione Conteúdo > Intenções.
3. Selecione a intenção em que deseja atualizar o diálogo.
4. Selecione a aba Respostas.
5. Selecione a resposta em que deseja atualizar o diálogo e clique em Editar diálogo.
6. Clique no ícone de adição (+) no ponto apropriado da caixa de diálogo e adicione um bloco de integração da API.
   
7. Selecione a integração fictícia criada acima.
   

Agora, quando a ramificação da integração fictícia for encontrada na conversa, sua integração da API fictícia será chamada e os parâmetros de sessão definidos em seu cenário de sucesso estarão disponíveis para o diálogo. O exemplo abaixo mostra uma integração fictícia sendo alimentada em um bloco condicional com parâmetros baseados em dias da semana, obtidos da integração fictícia.