Como formatar os dados retornados pelas integrações nas tarefas automatizadas?

Se você chegou aqui, já sabe o que é uma Tarefa Automatizada e quer entender como configurar os "motores" que fazem ela funcionar. Vamos mergulhar nos detalhes dos componentes: Formate informações com a IA.

Componente: Formate informações com a IA

Um desafio comum quando integramos sistemas é que as respostas retornam em formatos técnicos. Um ERP, por exemplo, pode retornar algo como:

{

   "status_pedido" : "ENVIADO",

    "previsao_entrega" :  "2026-03-10",

     "codigo_rastreio" :   "BR123456789"

}

Essas informações não estão prontas para serem enviadas diretamente ao cliente. É nesse ponto que entra o componente “Formate informações com IA”, que utiliza a IA da Octadesk (WOZ) para interpretar dados retornados por sistemas e transformá-los em respostas compreensíveis para o cliente - por isso deve ser utilizado logo após um componente “Conecte a outro sistema”.

Ou seja, em vez de enviar dados técnicos, a IA pode gerar uma resposta natural como:

“Seu pedido já foi enviado e está a caminho. A previsão de entrega é dia 10 de março. Você pode acompanhar o envio usando o código BR123456789.”

Essa etapa resolve um problema muito comum em integrações: transformar dados técnicos em comunicação clara para o usuário final.

Além disso, através deste componente, o WOZ pode:

Resumir informações longas e complexas;

Reorganizar e formatar dados;

Criar mensagens mais naturais;

Adaptar a resposta ao contexto da conversa;

É aqui que a "mágica" da tradução acontece, o tratamento dos casos depende da instrução que você escrever dentro deste componente.

Melhores Práticas de Formatação:

Para que a IA entregue um resultado perfeito, siga estas dicas no campo Instrução de retorno:

  -> Seja Estruturado: Indique exatamente quais variáveis devem ser usadas.

       Exemplo:

       "Retorne ao cliente o status do pedido {{status}} e a data de entrega {{previsao}}."

  -> Evite Comandos de Comportamento: Não tente ensinar a IA como se comportar aqui (ex: "seja educado"). Foque apenas em como estruturar a informação. O comportamento já vem do perfil do WOZ Agente;

  -> Use a Pré-visualização: Sempre clique em "Testar retorno". Isso simula como a IA lerá os dados e evita que o cliente receba mensagens confusas.

  -> DICA: Você não precisa decorar os nomes das variáveis que retornam na resposta da API externa, clicando no botão “+” apontado na imagem abaixo, todas as variáveis que a API retorna serão exibidos em uma lista.

Exemplo Prático:

 -> Resposta da API externa (Formato JSON):

{

   "id" : 123,

   "status" :  "separacao",

   "prazo" :  "2 dias"

}

 -> Sugestão de instrução:

"Informe que o pedido {id} está em {status} e chegará em {prazo}."

-> Resultado para o Cliente:

"Legal! Seu pedido 123 já está em separação e chegará em 2 dias."