Qual é o meu plano?
Complemento Agentes de IA - Avançado

No Criador de integrações, os parâmetros de solicitação permitem que você extraia dados (parâmetros de conversa) de conversas de agente de IA e os transmita para pontos de extremidade externos. Em alguns casos, pode ser necessário transformar ou reformatar esses dados antes de enviá-los em uma solicitação de API como uma consulta de URL ou no corpo da solicitação. Para fazer isso, você pode usar o JSONata, uma linguagem poderosa de consulta e transformação.

Este artigo contém os seguintes tópicos:

  • Reformatação do valor de um parâmetro de solicitação
  • Exemplos de casos de uso comuns para reformatação de valores

Artigos relacionados:

  • Recursos do Criador de integrações

Reformatação do valor de um parâmetro de solicitação

Você pode reformatar o valor de um parâmetro de solicitação usando JSONata.

Como reformatar o valor de um parâmetro de solicitação

  1. Em Agentes de IA - Avançado, no canto superior direito, use a lista suspensa agente de IA para selecionar seu agente de IA.
  2. No menu principal à esquerda, clique em Integrações de API.
  3. Selecione ou crie uma integração.
  4. Na página Parâmetros da solicitação, selecione ou crie o parâmetro de solicitação cujo valor você deseja reformatar.
  5. No campo Valor de teste, selecione o ícone Reformatar valor ().
  6. Na caixa de diálogo Reformatar valor, no campo Reformatar JSONata, use JSONata para transformar ou reformatar o valor associado à chave de parâmetro da solicitação selecionada.
    Em sua consulta JSONata, use '$' para representar a chave cujo valor você está reformatando.
    O campo de visualização do valor de teste oferece uma maneira de verificar os resultados de sua consulta em tempo real.
  7. Clique em Concluído.
  8. (Opcional) Se você estiver adicionando o parâmetro de solicitação ao corpo de uma solicitação da API:
    1. No cabeçalho Ambiente à esquerda, selecione o ambiente apropriado.
    2. Selecione a aba Corpo.
    3. Adicione seu objeto JSON usando o parâmetro de solicitação como um valor entre chaves duplas.

Casos de uso comuns de reformatação de valores

No Criador de integrações, você pode definir parâmetros de solicitação atribuindo-os a chaves específicas. Embora esses valores possam funcionar como estão, há situações em que eles precisam ser transformados ou reformatados para corresponder aos requisitos do sistema externo.

Por exemplo, talvez você deseje:

  • Reformatar datas: alterar o formato de uma data de MM/DD/AAAA para AAAA-MM-DD ou ISO 8601 para atender aos requisitos da API.
  • Executar operações de cadeia de caracteres: manipular cadeias de caracteres, adicionando ou removendo caracteres, combinando vários campos ou transformando cadeias de caracteres para conter HTML.
  • Aplicar lógica condicional: aplicar condições, como verificar se um campo está vazio ou atribuir um valor padrão, se necessário.

Esta seção contém os exemplos a seguir:

  • Cenário: Formatação de datas
  • Cenário: Reformatação de URLs para tornar os links clicáveis
  • Cenário: Reformatação de uma transcrição de chat para torná-la mais legível

Cenário: Formatação de datas

Nesse cenário, seu ponto de extremidade precisa verificar uma data formatada como AAAA-MM-DD ou em um formato ISO 8601. No entanto, para sua conversa, você deseja que as datas sejam exibidas em um formato mais amigável de DD/MM/AAAA.

Esta é a consulta JSONata que você usaria neste cenário:

$substring($, 6, 10) & "-" & $substring($, 3, 2) & "-" & $substring($, 0, 2)

Cenário: Reformatação de URLs para tornar os links clicáveis

Neste cenário, você deseja converter URLs em links clicáveis pesquisando por texto (uma subcadeia) que comece com http:// ou https:// seguido por um número de caracteres que não sejam espaços em branco. Em seguida, você deseja substituir essa subcadeia usando a função JSONata $replace por uma cadeia de caracteres que envolva a URL correspondente em um HTML <a>, criando um link clicável.

Esta é a consulta JSONata que você usaria neste cenário:

(
$text := "Chat transcript unavailable. Here is a link:https://www.zendesk.com. Here is another link: https://www.w3schools.com.";

$replace($text, /(https?:\/\/[^\s]+)/, '<a href="$1">$1</a>'
)

Cenário: Reformatação de uma transcrição de chat para torná-la mais legível

Neste cenário, você deseja adicionar uma transcrição de chat a um ticket. No entanto, em seu formato padrão, a transcrição do chat não é muito legível:

  • Transcrição do chat - 2024-10-12 (13:04:10) agente de IA: Bem-vindo ao agente de IA da engenharia do cliente! (13:04:10) agente de IA: Escolha a integração a ser testada: (13:04:10) Visitante: test c.id: d501304d-da09-4485-a4c7-1c708ec0005d Todos os horários em UTC.

Você deseja transformá-lo em um formato mais amigável dividindo cada mensagem em uma nova linha. Como cada nova mensagem começa com um parêntese de abertura ( ( ), você pode usar o JSONata para substituir cada ocorrência de (por uma quebra de linha seguida por).

A conversa reformatada ficaria assim:

  • Transcrição do chat - 2024-10-12
    (13:04:10) agente de IA: Bem-vindo ao agente de IA do Criador de Integrações!
    (13:04:10) agente de IA: Escolha a integração a ser testada:
    (13:04:10) Visitante: test c.id: d501304d-da09-4485-a4c7-1c708ec0005d Todos os horários em UTC.

Esta é a consulta JSONata que você usaria neste cenário:

$replace($, “(“, “\n(“)

Além disso, você precisaria adicionar esse parâmetro à seção do corpo em seu ambiente para que ele seja enviado com a solicitação:

{
"chatTranscript": "{{chatTranscript}}"
}

Powered by Zendesk