Como adicionar e gerenciar conteúdo
O que você vai aprender
Qual conteúdo está no Customer Agent, por que a maior parte da sua base de conhecimento já vem carregada, como adicionar mais conteúdo e como escrever conteúdo que o Customer Agent realmente consiga usar para responder às perguntas dos clientes.
Antes de começar
Você vai precisar de:
- Uma função de Proprietário, Administrador ou Gerente
Você já tem conteúdo
O Customer Agent faz automaticamente a varredura da sua vitrine durante a configuração usando o crawler KlaviyoAIBot. A maioria das marcas tem centenas de páginas indexadas — páginas de produtos, artigos de ajuda, páginas de políticas, FAQ — antes mesmo de adicionar qualquer coisa manualmente.
Antes de começar a adicionar mais, revise o que já existe. Abra a guia Conteúdo e navegue pelo que o Customer Agent indexou. Se você notar lacunas, adicione as fontes que faltam. Se você vir conteúdo desatualizado, atualize-o ou remova-o.
Para indexação automática contínua do seu site, consulte Como sincronizar automaticamente o conteúdo do site.
Conteúdo vs. habilidades
É fácil confundir estes dois ao configurar o Customer Agent:
- Conteúdo é o que o Customer Agent sabe — fatos, políticas, detalhes do produto. Informações estáticas que você pode anotar.
- As habilidades são o que o Customer Agent faz — lidando com tipos específicos de solicitações, muitas vezes envolvendo ferramentas ou fluxos de trabalho em várias etapas.
Um bom teste: se a resposta for a mesma para todos os clientes e você puder escrevê-la como um fato, ela pertence ao conteúdo. Se o Customer Agent precisar fazer algo — consultar dados, realizar uma ação, executar um processo de várias etapas — isso é uma habilidade.
Por exemplo, sua política de devolução é conteúdo. De fato, iniciar uma devolução para um cliente é a habilidade Devoluções e trocas.
Adicionar mais conteúdo
Três maneiras de adicionar à base de conhecimento do Customer Agent:
Faça o upload de um documento
Use isso para políticas, perguntas frequentes, materiais de treinamento — qualquer coisa que você tenha como arquivo, mas não tenha no seu site.
- Navegue até Customer Agent > Conteúdo.
- Clique em Add source > Upload file.
- Selecione o arquivo (PDF, .docx, .txt, etc.).
- Confirmar e salvar.
Adicionar página da web
Use isso para URLs que você quer que o Customer Agent indexe — uma landing page específica, um artigo da central de ajuda, o Help Center ou toda a sua loja virtual.
- Navegue até Customer Agent > Conteúdo.
- Clique em Adicionar origem > Adicionar página da web.
- Cole a URL.
- Escolha qualquer uma destas opções:
- Definir como URL da minha loja — Conecte esta URL como a sua loja. O Customer Agent usa a conexão com a vitrine para extrair dados de e-commerce mais avançados junto com o conteúdo da página.
- Ative a sincronização automática — Ressincronize automaticamente a página quando forem detectadas alterações. Deixe desativado se você quiser uma importação única.
- Quais páginas o AI Agent deve importar?
- Importar todas as páginas deste URL — Importa esta página e todas as páginas filhas abaixo dela. Use isso para Help Centers, blogs ou raízes de seção.
- Importe apenas esta página — Somente esta página. Use isso para URLs pontuais.
- Clique em Save.
Adicionar snippet
Use isso para informações curtas que não justificam um documento completo — uma única resposta de FAQ, um esclarecimento rápido de política, uma especificação do produto.
- Navegue até Customer Agent > Conteúdo.
- Clique em Adicionar fonte > Adicionar snippet.
- Escreva uma pergunta clara e uma resposta clara. Salvar.
Para scraping automático e contínuo de todo o seu site, configure a sincronização automática — consulte Como sincronizar automaticamente o conteúdo do site.
Escrever conteúdo que o Customer Agent possa usar bem
Nem toda página bem escrita é boa para o Customer Agent. Alguns princípios:
- Use uma linguagem clara e simples. Evite jargões e textos de marketing. O Customer Agent usa a sua linguagem, então tudo o que você não gostaria que um cliente lesse não deve estar no seu conteúdo.
- Use a estrutura H1/H2/H3. Os títulos ajudam o Customer Agent a encontrar o trecho certo para responder a uma pergunta específica.
- Seja objetivo, não promocional. O tom deve estar em Orientações, não no conteúdo. O conteúdo deve responder a perguntas, não vender.
- Reformule a pergunta na resposta. "Nossa janela de devolução é de 30 dias a partir da entrega" é melhor do que "30 dias." A frase completa é mais fácil de recuperar e ler.
- Use listas com marcadores para processos. Instruções passo a passo são mais fáceis para o Customer Agent formatar em uma resposta clara.
- Não esconda a resposta em blocos de texto. Comece pela resposta; adicione detalhes depois.
- Remova conflitos. Se duas páginas se contradisserem, o Customer Agent não consegue escolher a correta. Audite e consolide.
- Mantenha os documentos focados. Uma única página focada em um tópico é melhor do que um mega documento de 20 páginas que abrange tudo.
- Conteúdo de imagem e vídeo precisa de texto. O Customer Agent não consegue ler imagens nem transcrever vídeo. Certifique-se de que as principais informações estejam em formato de texto.
Exemplos
Bom — política de envio:
Elegibilidade de envio
Enviamos para todos os 50 estados dos EUA. Não enviamos para caixas postais, endereços APO/FPO nem destinos internacionais.
Custos de frete
O frete Standard é grátis em pedidos acima de $ 50. Pedidos abaixo de $ 50 são cobrados com frete de tarifa fixa de $ 7.
Bom — requisitos de devolução:
O que pode ser devolvido
Os itens podem ser devolvidos em até 30 dias após a entrega se não tiverem sido usados, estiverem na embalagem original e acompanhados do recibo original.
O que não pode ser devolvido
Itens de venda final, produtos personalizados e cartões-presente não são elegíveis para devolução.
Ambos os exemplos usam títulos claros, frases curtas e factuais e informações positivas e negativas explícitas.
Gerenciar conteúdo
Na guia Conteúdo, você pode:
- Edite o conteúdo diretamente — o Customer Agent coleta as alterações após uma reindexação.
- Excluir conteúdo desatualizado ou que não seja mais relevante.
- Ressincronize uma página da web para atualizá-la a partir da origem.
- Inspecione o que foi ingerido — abra uma fonte para ver exatamente como o Customer Agent a armazenou.
Para cada fonte, o menu de três pontos oferece estas opções.
Solução de problemas
Sintoma: o Customer Agent não está usando um documento que eu adicionei.
Causa provável: o documento é longo demais, não tem títulos claros ou repete o mesmo conteúdo de uma fonte de maior qualidade.
Correção: divida o documento em páginas menores e mais focadas. Adicione títulos claros. Teste no playground com a pergunta que o documento deve responder.
Sintoma: A sincronização automática deixou de sincronizar uma página.
Causa provável: A página é restrita, está atrás de um login ou não está vinculada à navegação principal do seu site.
Correção: Adicione a página manualmente como uma fonte de página da web.
Sintoma: o Customer Agent está usando conteúdo desatualizado.
Causa provável: a fonte não foi sincronizada novamente desde que você a atualizou.
Correção: abra a fonte, clique no menu de três pontos e escolha Sincronizar novamente. Confirme no playground que o novo conteúdo está sendo usado.
Perguntas frequentes
Quais tipos de arquivo posso fazer upload?
PDF, DOCX, TXT e Markdown. O Customer Agent extrai apenas texto — a formatação e as imagens não são preservadas.
Com que frequência a sincronização automática é executada?
A sincronização automática é executada em uma cadência regular. Consulte Como sincronizar automaticamente o conteúdo do site para ver detalhes.
E quanto a páginas bloqueadas ou protegidas por login?
A sincronização automática não consegue acessar páginas protegidas por login. Adicione essas páginas manualmente como documentos ou snippets.
Próximas etapas
- Configure a sincronização automática para cobertura contínua do site
- Teste no playground para ver como o Customer Agent usa seu conteúdo
- Configure a orientação para controlar como o Customer Agent comunica esse conteúdo