Qual é o meu plano?
Suite, todas as versões Team, Growth, Professional, Enterprise ou Enterprise Plus
Support Team, Professional ou Enterprise

Uma integração simulada permite adicionar funcionalidades personalizadas aos diálogos usando dados já presentes na conversa, sem fazer chamadas de API reais ou recuperar dados externos. Isso permite implementar lógica usando JSONata para manipulação de dados, comparações ou outras tarefas dentro do fluxo do diálogo.

Esse tipo de integração é útil para lidar com tarefas que não exigem dados externos em tempo real, funcionando como uma integração "auxiliar" para ampliar as capacidades de um agente de IA além dos recursos padrão.

Este artigo contém os seguintes tópicos:

  • Sobre as integrações simuladas
  • Criação de uma integração simulada
  • Adição de uma integração simulada em um diálogo

Sobre as integrações simuladas

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

  • Transformar seus dados para um formato mais apropriado.
  • Formatar e filtrar dados complexos de CRM ou API.
  • Comparar as datas para encontrar a mais recente.
  • Obter a data e a hora atuais.
  • Verificar se uma data está dentro de um determinado período.
  • Verificar se uma URL contém palavras específicas.
  • Verificar e substituir quaisquer valores nulos.
  • Substituir letras ou símbolos nos seus dados.
  • Usar um filtro que ignore maiúsculas e minúsculas para percorrer os dados e retornar o primeiro valor correspondente ou fornecer uma resposta alternativa caso não haja correspondências.

Se você consegue definir a lógica usando JSONata, então pode aprimorar suas conversas com essas integrações úteis.

Criação de uma integração simulada

Dica: antes de criar uma integração simulada, sugerimos que você se familiarize com o uso de JSONata com o criador de integrações. Consulte Uso de JSONata com agentes de IA.

Para criar uma integração simulada, crie uma integração de API normalmente. No entanto, nunca é feita nenhuma solicitação de dados.

Como criar uma integração simulada

  1. No menu principal, clique em Integrações de 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 o ajude a lembrar para que ela serve.
    3. Clique em Salvar.
  4. Na barra lateral esquerda, em Ambientes, selecione um ambiente (como Production).
  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 simuladas são hospedadas dentro da estrutura da 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. Use qualquer URL fictícia que faça sentido para você. Embora seja feita uma chamada de API para a URL especificada, nenhum dado da resposta será processado na integração simulada.

  7. Certifique-se de que o Tipo de autorização esteja definido como Sem autorização.
  8. (Opcional) Na barra lateral esquerda, em Cenários, passe o cursor sobre Falha, selecione o menu de opções () e selecione Apagar. Você não precisa de um cenário de falha para uma integração simulada.
  9. Na barra lateral esquerda, em Cenários, selecione Sucesso.
  10. Dependendo do cenário, faça um dos itens a seguir:
    • Se você tiver uma dúvida simples, insira-a no campo Consulta de cenário. Por exemplo, se você precisar apenas de uma resposta booleana, então fazer a consulta aqui é tudo o que você precisa.
    • Se você precisar definir a lógica com base nos parâmetros da solicitação (provenientes da conversa):
      1. Insira requestParameters no campo Consulta de cenário.
      2. Em Parâmetros da sessão, insira os parâmetros para sua integração simulada. A captura de tela abaixo inclui exemplos de parâmetros e expressões JSONata para retornar o dia da semana e a hora atual.
  11. Clique em Salvar.

Adição de uma integração simulada em um diálogo

No criador de diálogos, você pode adicionar um bloco de integração da API e selecionar sua integração simulada.

Como adicionar uma integração simulada dentro de um diálogo

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

Agora, quando a ramificação da integração simulada for acionada na conversa, sua integração simulada da API será chamada e os parâmetros de sessão que você definiu em seu cenário de sucesso estarão disponíveis para o diálogo. O exemplo abaixo mostra uma integração simulada alimentando um bloco condicional usando parâmetros baseados no dia da semana retornados pela integração simulada.

 

Powered by Zendesk