Skip to main content
Uma variável normal procura um valor. Uma variável de IA calcula um. Onde {{ candidate.first_name }} lê um campo e o insere, uma variável de IA executa uma instrução curta sobre o registo e insere o que ela produz. É a ferramenta para a linha que tem de ser diferente de cada vez — uma abertura que liga o percurso de alguém a uma vaga, ou uma mensagem de aniversário que não se lê como um mail merge. Utiliza-a exatamente como qualquer outra variável:
No editor aparece como um chip, marcado com o brilho de IA para que a distinga de uma variável normal num relance: Chip de variável de IA no conteúdo

Onde pode adicionar uma

Pode criar variáveis de IA em templates de email, formulários e automações. O construtor de automações também oferece presets, para que uma variável que utiliza com frequência não tenha de ser reconstruída manualmente. Os templates de mensagens de WhatsApp podem referenciar variáveis, mas a lista de variáveis aí é só de leitura — não pode criar uma variável de IA a partir do construtor de mensagens. Defina-a antes na automação que envia a mensagem.

Quando utilizar uma

Recorra a uma variável de IA quando as três condições forem verdadeiras:
  • o resultado tem de ser derivado, não procurado;
  • uma linha fixa com um fallback leria mal, porque o valor tem genuinamente de mudar por pessoa;
  • estar ligeiramente errado é sobrevivível — ninguém toma uma decisão com base nisso.
Bons candidatos: uma abertura personalizada, um gancho de reativação para um candidato inativo, uma linha de aniversário não genérica, ou uma reescrita de tom de um parágrafo fixo.

Quando utilizar outra coisa

A maior parte da personalização não é um problema de IA. Antes de adicionar uma variável de IA, verifique se uma variável simples ou um modificador já faz o trabalho — são mais rápidos, mais baratos e não podem estar errados.
Nunca deixe uma variável de IA inventar um facto. Datas, tarifas, salários, termos contratuais, datas de início, estado legal ou de RGPD, e qualquer coisa que se leia como um compromisso têm de vir de um campo. Se o campo está vazio, a resposta honesta é omiti-lo ou usar um fallback — não deixar um modelo preencher a lacuna. Uma frase gerada que inventa uma data de início é uma afirmação falsa enviada a um candidato em seu nome.

Configurar uma

Abra o painel de variáveis com o controlo {} na barra de ferramentas do construtor. As variáveis existentes são listadas com a sua chave e tipo, por isso uma de IA é fácil de identificar: Painel de variáveis com variável de IA Clique em Add e depois selecione AI variable no grupo Intelligent: Seletor de tipo de variável de IA

Escolher o que a IA deve fazer

Antes de mais, o editor pergunta que tipo de trabalho esta variável está a fazer. Há sete modos, cada um mostrado como um mosaico com uma descrição de uma linha: Seletor de modo da variável de IA
O modo não fica bloqueado. Assim que escolhe um, os mosaicos colapsam num dropdown compacto, e pode mudá-lo quando quiser. Reabra a variável e selecione um modo diferente em What should the AI do?. O resto do formulário ajusta-se em conformidade.

O resto do editor

Editor da variável de IA
Uma variável de IA não tem de produzir prosa. Como escolhe o tipo de retorno, uma pode igualmente resolver-se num Yes / No, num Number ou num valor de uma List — que é para isso que os modos Classify e Extract servem. O aviso acima continua a aplicar-se: derivar um valor de dados no registo é aceitável, inventar um não é.

Dar-lhe algo com que trabalhar

A instrução por si só raramente chega — o modelo precisa do registo. Há duas formas de lho entregar, e podem ser combinadas.

Inline no prompt

Escreva {{ em qualquer sítio na caixa Input e aparece um seletor, a listar todas as variáveis disponíveis para este template com a sua chave e o seu tipo. Continue a escrever para filtrar, e depois selecione uma para a inserir. Aparece como um badge com o nome do campo, e passar o cursor sobre ele mostra o valor.
Seletor de variáveis no prompt da variável de IA 1
Assim, uma mensagem de aniversário que cumprimenta o destinatário pelo nome lê-se:
Cada badge é substituído pelo valor desse destinatário antes de a instrução chegar ao modelo, por isso para a Sofia o modelo é convidado a escrever uma mensagem para a Sofia e não para {{recipient.first_name}}. Um badge laranja é uma chave que a HireData não reconhece. Chega ao modelo como a chave em bruto, por isso corrija-o antes de guardar.

O separador Variables

Mude para o separador Variables e selecione Add Field para anexar campos em vez de os nomear no prompt. Cada linha é um seletor pesquisável sobre a mesma lista de variáveis, e o botão remove uma.
Seletor de campos da variável de IA
Anexar um campo entrega o seu valor ao modelo sem que tenha de o mencionar na instrução. Também torna os inputs da variável óbvios para quem a abrir a seguir, o que vale a pena fazer quando o prompt fica longo.

Porque é que os inputs importam

Os campos que referencia, por qualquer dos métodos, são os inputs da variável — e os inputs são o que decide quando ela é calculada de novo. Dê-lhe os campos de que ela genuinamente depende em vez de os descrever em prosa. Veja Limitações.

Escrever a instrução

Uma instrução utilizável nomeia a sua forma e os seus limites. Deixe os controlos dedicados fazer o trabalho para que existem — defina o idioma do resultado no controlo Language em vez de o descrever no prompt, e defina o tipo de retorno em vez de pedir um:
Escreve uma mensagem de aniversário amigável, de uma só frase, com um máximo de 20 palavras. Varia a formulação para que não soe a template. Sem emojis. Não comeces com “Feliz aniversário”. Se faltar o nome do destinatário, escreve uma mensagem geral sem nome.
Essa última frase é a que mais importa. Diga o que fazer quando os dados faltam, ou o modelo inventará algo para preencher o espaço. Instruções mais longas não são instruções melhores. As restrições fazem mais trabalho do que a descrição. Indique o comprimento máximo, o tom, o que não deve fazer, e o que produzir quando os dados de origem são escassos.

Limitações

Resolve-se uma vez por envio, e depois repete-se. O valor é gerado na primeira vez que a variável é referenciada e reutilizado em todas as outras menções na mesma mensagem — por isso {{ celebration }} duas vezes num email dá-lhe a mesma frase duas vezes, não duas tentativas. É calculado de novo quando os seus inputs mudam, que é o que o torna por destinatário. Uma variável sem inputs anexados não tem nada sobre o qual variar. Um valor por defeito armazenado não é uma rede de segurança. Para uma variável de IA, o valor por defeito é o espaço em que o valor gerado é escrito, não um fallback que possa definir. Se o modelo não devolver nada, a variável resolve-se em nada. Para garantir que algo chega à página, use o modificador default onde a referencia:
Um template válido ainda pode ser enviado com um buraco. A validação verifica que um placeholder é conhecido, não que terá um valor quando a mensagem sair. Portanto, este template:
pode validar na perfeição e ainda assim chegar como um email que abre com uma linha em branco, seguida de “We hope you take some time today to celebrate.” O template não está partido. A variável não produziu nada. Os envios de teste comportam-se de forma diferente dos reais. Num envio de teste, cada variável personalizada referenciada no corpo precisa de um valor explícito e não vazio fornecido por si — os valores armazenados não são deliberadamente substituídos. Um teste limpo prova, portanto, que o texto funciona; não prova que a variável se resolverá em produção. Se um destinatário reportar uma mensagem com uma frase em falta, uma saudação vazia ou um fragmento solto, verifique quais das variáveis são variáveis de IA antes de assumir que o texto está errado.

Antes de enviar

1

Teste com dados completos

Confirme que o valor se lê bem e fica dentro do seu limite de comprimento.
2

Teste com dados em falta e vazios

É aqui que as variáveis de IA falham. Verifique que um registo escasso produz algo aceitável em vez de um detalhe alucinado ou de uma linha vazia.
3

Teste em todos os idiomas em que envia

O tom e a formalidade não se transferem entre idiomas. Uma linha que soa calorosa em inglês pode soar demasiado familiar em neerlandês.
4

Leia-a como o destinatário

Pergunte se um candidato ficaria embaraçado, confuso ou enganado por esta frase. Se a resposta for talvez, aperte as restrições ou use uma linha fixa.

Relacionados

Tópicos relacionados

VariablesModifiers