Ferramentas de perfil do Customer Agent

O que você vai aprender

O que são ferramentas de perfil do Customer Agent, o que cada uma faz e como usá-las em habilidades. Essas ferramentas permitem que seu agente leia e escreva para o perfil da Klaviyo de um comprador durante uma conversa, para que ele possa personalizar respostas, responder às perguntas do tipo "o que é meu..." e capturar novos dados de volta para o perfil.

As cinco ferramentas de perfil

O Customer Agent vem com cinco ferramentas integradas que leem ou gravam dados no perfil do comprador autenticado. Você não os configura, eles estão disponíveis para anexar a qualquer habilidade.

Todos os cinco resolvem o comprador automaticamente a partir do contexto da conversa (e-mail, telefone ou ID do perfil). Eles só funcionam para compradores identificados.

Você pode encontrar todos os cinco na página Ferramentas no Customer Agent e anexá-los a qualquer habilidade do editor.

Observação: essas ferramentas estão em versão beta. Eles estão disponíveis para todas as marcas no Customer Agent, sem necessidade de inscrição separada, mas o recurso ainda está sendo expandido e pode mudar.

Quando usar cada um

Obter perfil

Use quando o agente precisa saber com quem está falando — propriedades como nome, preferências de e-mail, último endereço de envio ou qualquer propriedade personalizada que você armazene.

Exemplo: “Olá, Sarah! Vejo que seu último pedido foi enviado para o endereço terminando em 1234. Devemos usar essa novamente?”

Obter eventos de perfil

Use quando o agente precisa saber o que o comprador fez. Pedidos, aberturas de e-mail, envios de formulários, visualizações de páginas, inscrições — qualquer coisa rastreada como um evento no perfil.

Exemplos:

• Um comprador pergunta: "Quando foi meu último pedido?" A habilidade anexa Get perfil Events com Event type = Placed Order e responde com a data.
• Um cliente pergunta "O que estava no meu carrinho?" A habilidade anexa Obter eventos de perfil com Tipo de evento = Added to Cart e lista os itens de volta.

Você escolhe o tipo de evento e outras configurações na barra lateral da ferramenta ao anexar a ferramenta. Consulte Configuração de uma ferramenta ao anexá-la abaixo.

Obter Listas e Segmentos de Perfil

Use quando o comportamento do agente deve depender do público em que o comprador está. Cliente VIP? Já está na lista de reposição de estoque? Excluído dos e-mails promocionais?

Exemplo: Se o comprador estiver no segmento VIP, o agente oferece um upgrade gratuito em uma devolução.

Obter Resumo Preditivo do Perfil

Use quando o comprador ou a habilidade precisar dos insights preditivos da Klaviyo — valor da vida útil do cliente, risco de desistência, expectativa de próxima compra ou pontuação de integridade do cliente.

Exemplo: Uma habilidade de retenção verifica o risco de desistência antes de oferecer um desconto para salvar — os compradores de alto risco recebem uma oferta mais forte.

Atualizar propriedade do perfil

Use quando o agente deve escrever algo de volta ao perfil do comprador durante uma conversa — respostas de questionários, preferências, feedback, qualquer coisa que você possa capturar em um formulário.

Exemplos:

• Um cliente responde a um quiz: "Eu prefiro fragrâncias terrosas." → O agente escreve scent_preference: earthy.
• Um comprador dá feedback durante uma devolução: "Não serviu, ficou pequeno." → O agente salva last_return_reason: sizing.

Quando uma propriedade estiver no perfil, todas as outras partes da Klaviyo poderão usá-la: fluxos, segmentos, campanhas e futuras conversas do Customer Agent.

Como usar essas ferramentas em uma habilidade

1. Abra a habilidade que deseja atualizar (ou crie uma nova).
2. No editor de habilidades, anexe as ferramentas de perfil necessárias.
3. Se a ferramenta tiver entradas de configuração, preencha-as (veja abaixo).
4. Na seção Como responder, informe a habilidade quando e como usar cada ferramenta. Seja específico:
   • Quando o agente deve chamar a ferramenta
   • O que deve fazer com o resultado
   • Para Atualizar Propriedade de Perfil: qual propriedade escrever, em que formato o valor deve estar e quando não escrever

Configurando uma ferramenta quando você a anexa

Algumas ferramentas de perfil têm inputs que você pode preencher no nível de habilidade. O preenchimento prévio bloqueia o valor de cada chamada que a habilidade faz, o que lhe dá um controle mais apertado e salva o agente de ter que descobrir em tempo de execução.

Obter eventos de perfil é o exemplo principal. Ao anexá-lo a uma habilidade, você pode configurar:

• Tipo de evento (obrigatório) — qual métrica buscar (por exemplo, Placed Order, Checkout Started, Added to Cart, Opened Email, Viewed Product).
• Limite — número de eventos recentes a serem retornados. Use 1 se precisar apenas do mais recente.
• Ordem de classificação — o mais novo primeiro ou o mais antigo primeiro.
• Janela de lookback — a que distância voltar para pesquisar. Padrão 90 dias.

Por exemplo, uma skill que precisa olhar o carrinho mais recente do comprador pode anexar Obter eventos do perfil com Tipo de evento = Checkout Started, Limite = 1, Ordem de classificação = Newest first, Janela de lookback = 30 days. Assim, o agente não precisa pensar nessas escolhas — elas já estão incorporadas.

Exemplo de snippet “Como responder” (Atualizar propriedade do perfil):

Quando o cliente informar a preferência de fragrância, chame Atualizar propriedades do perfil para salvá-la na propriedade scent_preference usando uma destas opções: floral, earthy, citrus, fresh. Escreva apenas se o cliente confirmar explicitamente. Confirme o salvamento para o cliente em uma única frase.

Exemplo de snippet “Como responder” (Obter perfil + Obter eventos de perfil):

Quando o comprador perguntar sobre seus pedidos recentes, chame Get Profile Events para recuperar seu histórico de pedidos. Resuma os resultados com data, contagem de itens e status atual. Se o comprador perguntar quem ele é ou o que está registrado, use Obter perfil.

(Anexar eventos de obtenção de perfil com Tipo de evento = Placed Order, Limite = 3, Ordem de classificação.)

Dicas

• Leia antes de escrever. Se estiver personalizando uma resposta, anexe primeiro a opção Obter perfil ou Obter eventos de perfil. O agente não pode fazer referência a dados que não extraiu.
• A propriedade tem que existir primeiro, e tem que ser uma propriedade personalizada. Atualizar Propriedade de Perfil só grava em propriedades de perfil personalizadas que já existem nos perfis da sua empresa. Os campos do sistema (e-mail, nome, número de telefone, subcampos de localização) e os campos derivados (Criado, Ativo pela primeira vez, $id) não podem ser gravados. Primeiro, crie a propriedade personalizada na Klaviyo e aponte a habilidade para ela pelo nome exato.
• Restringir o valor definido ao escrever. Explique os valores permitidos nas instruções de habilidade ("um de: floral, terroso, cítrico, fresco"). Caso contrário, o agente escreverá um texto livre e seus segmentos não corresponderão.
• Diga ao agente quando não escrever. "Somente escrever se o comprador confirmar explicitamente" evita substituições acidentais.
• Confirme as gravações no comprador. Um pequeno "Entendi, salvei isso como sua preferência" fecha o ciclo.
• Corresponda a ferramenta à pergunta. "O que eu comprei?" → Eventos de perfil. "Sou VIP?" → Listas e segmentos. "Qual é a probabilidade de eu desisti?" → Resumo preditivo.
• Use o gerador de agentes para conectá-los. Descreva o que você quer em inglês simples e o Agent Builder anexará as ferramentas certas e escreverá as instruções de habilidade para você. Por exemplo: "Quero que minhas recomendações de habilidade vejam o que estava no carrinho do comprador para recomendar algo semelhante."

O que essas ferramentas não fazem

• Eles não trabalham diretamente em conversas anônimas. Se o agente quiser chamar uma dessas ferramentas e o comprador não for identificado, ele receberá uma solicitação para fazer login primeiro. Uma vez identificados, a ferramenta é executada.
• A Atualização da Propriedade de Perfil não cria novos compradores. O perfil já deve existir.
• A propriedade Update Profile não grava eventos. A redação de eventos será uma ferramenta separada — em breve.
• Nenhuma das ferramentas lidas modifica os dados. Eles só buscam.

Perguntas frequentes

Posso escrever em qualquer propriedade com Atualizar propriedade de perfil?

Somente as Propriedades do perfil personalizadas (aquelas que você define nos perfis, como scent_preference ou isMom). No momento, não é possível editar campos do sistema — Email, First Name, $phone_number, subcampos de local, como $locale_country, e campos de patch de lista, como Viewed Items. Os campos derivados que o sistema calcula para você (Created, First Active, $id) são permanentemente somente leitura.

E se a propriedade ainda não existir?

A ferramenta lê e grava apenas as propriedades que já existem nos perfis. Primeiro, crie a propriedade na Klaviyo (por exemplo, defina-a em um perfil de teste ou por meio de um fluxo) e, em seguida, aponte a habilidade para ela por nome.

Uma habilidade pode chamar várias ferramentas de perfil em um turno?

Sim. Uma habilidade pode chamar qualquer combinação de ferramentas de perfil em uma única resposta, por exemplo, "Obter perfil" e "Reunir eventos de perfil" para criar uma imagem mais completa antes de responder.

O que acontece com compradores anônimos?

Se o agente tentar usar uma dessas ferramentas e o comprador não for identificado, ele receberá uma solicitação para fazer login. Uma vez identificados, a ferramenta é executada e a conversa continua.

Essas ferramentas estão sujeitas às mesmas regras de consentimento do restante da Klaviyo?

Sim. Fluxos de dados por meio do perfil padrão e do modelo de consentimento da Klaviyo.

Próximas etapas

• Como funcionam as ferramentas do Customer Agent
• Compreensão de habilidades
• Como criar uma habilidade totalmente personalizada

Artigos relacionados