Como configurar a etapa Editar lista?

Para que serve?

“Editar lista” edita uma lista e grava o resultado em uma nova variável. A lista costuma vir da resposta de uma Chamada de ferramenta ou de uma Ação de integração; uma resposta de múltipla escolha também é uma lista.

Os visitantes não veem esta etapa e o avatar não diz nada; o agente continua sem esperar o visitante.

Para adicioná-la, clique em “Adicionar etapa” na aba “Editor” e depois em “Editar lista” na categoria “Lógica”; a etapa é adicionada no meio da tela. As configurações ficam na aba “Conteúdo” do painel que abre à direita quando você clica na etapa.

Esta etapa não tem “Texto na tela”; em vez disso, há uma “Nota da etapa” no fim do painel. A nota é só para você: os visitantes não a veem, e ela não é falada nem traduzida.

Nos valores, você usa variáveis de etapas anteriores, como {city}. Para um campo dentro de uma resposta, adicione o nome do campo depois de um ponto: {order.status}. O botão “Inserir variável” nas caixas lista as variáveis que você pode usar naquele ponto. Uma variável ainda não preenchida conta como texto vazio.

Configurar a etapa

1. Em “Lista”, escreva o caminho para a própria lista, como {answer.items}; a resposta inteira não é uma lista. Se a lista estiver na resposta de uma Chamada de ferramenta, clique em “Buscar dados de exemplo” para chamar a ferramenta uma vez: você escolhe uma das “Listas na resposta” e vê os “Campos da primeira linha”.
2. Ative as operações desejadas (veja abaixo).
3. Informe o “Nome da variável” onde o resultado é gravado. {list} dá a lista inteira, {list.1.field} um campo do primeiro item.

Operações

As operações sempre rodam nesta ordem, para que resultados como “os 5 mais baratos” saiam certos:

• “Filtrar”: só ficam os itens que atendem às regras. As regras funcionam como na etapa Condição; escreva o campo do item como {item.field} ({item} se o item for um valor simples). Sem regras, nada é filtrado.
• “Ordenar”: digite na caixa que abre o campo pelo qual ordenar (por exemplo, price) e escolha “Crescente” ou “Decrescente”. Números são ordenados como números, datas como datas e o resto em ordem alfabética; itens com valor vazio vão para o fim.
• “Remover duplicados”: digite na caixa que abre o campo a comparar; dos itens com o mesmo valor, só o primeiro fica. Como isso roda depois de ordenar, o de cima fica. Sem campo, o item inteiro é comparado.
• “Manter os primeiros N itens”: só ficam tantos itens quanto o número informado, a partir do topo da lista.

Usar o resultado

Você pode usar o resultado nas etapas seguintes: mostrá-lo como opções em uma etapa Seleção com “Origem das opções” › “De uma variável”, executar as mesmas etapas para cada item com uma etapa Loop, ou contar ou somar com o “Resumo de lista” de Definir variáveis. Se o resultado for muito longo (cerca de 16.000 caracteres), itens são removidos do fim.

Exemplo

Uma Chamada de ferramenta grava os horários disponíveis em {answer}. Em Editar lista: “Lista” {answer.slots}; “Filtrar” {item.seats} · “Número” · “é maior que” · 0; “Ordenar” pelo campo start, “Crescente”; “Manter os primeiros N itens” 5; “Nome da variável” next_slots. Uma etapa Seleção com a origem “De uma variável” oferece então os cinco horários mais próximos como opções.

Pontos de atenção

O editor avisa quando: nenhuma lista foi escolhida, o nome da variável é inválido ou uma regra de filtro não olha o campo do item (essa regra dá o mesmo resultado para todos os itens). Se o caminho escrito não apontar para uma lista, os dados de exemplo mostram “Este caminho não aponta para uma lista; o resultado fica vazio.” Para a etapa Chamada de ferramenta, veja Etapas Ação de integração e Chamada de ferramenta.

Nomes de variáveis só podem usar as letras a–z, dígitos e sublinhados (_); letras acentuadas e espaços são descartados ao digitar. “system” é reservado para variáveis do sistema, então escolha outro nome.

Problemas não impedem de salvar: o agente é salvo, mas a etapa incompleta não funcionará como esperado na conversa. Corrija as etapas marcadas e teste o agente com “Prévia”. Para encontrar as etapas marcadas, veja o editor de fluxos.