Principal Conteúdos | Gerindo o conhecimento da ClaudIA
📖

Conteúdos | Gerindo o conhecimento da ClaudIA

Como utilizar o Cloud Hub para fazer melhorias no conteúdo para aumentar qualidade e retenção
Fabrício Rissetto Ian Kraskoff
Por Eduardo Fukumoto and 4 outros
8 artigos

Usando a tela de conteúdos (Unitário e em massa)

Conteúdos A tela de conteúdos exibe todas as seções de IDS (Improved Data Set) Busca e filtro por seções Nela é possível ordenar as seções e aplicar filtros como: - Busca exata (equivalente ao CTRL + F do navegador) - Busca semântica (uma busca inteligente utilizando a tecnologia de Vector DBs para trazer os conteúdos que mais se assemelham aos termos de pesquisa) - Tipo: Seções N1, N2 ou INTERATIVAS (Eddie) - Tag - Flow (em caso de utilização da feature de Multiprompt - que não é aplicável por padrão em todos projetos) Vendo o histórico de modificações de uma seção Nessa tela é possível ver o histórico de modificações de cada seção ao clicar no ícone de "histórico": Ao clica no botão uma janela irá abrir com todas as modificações daquele conteúdo desde data sua criação: Ao clicar em "Ver detalhes" é exibido exatamente o que foi modificado em cada versão: Criando uma nova seção Para criar uma nova sessão, basta clicar no botão "Criar Novo". Ele vai abrir uma segunda tela, que você consegue colocar o título da sessão, a resposta da sessão, definir se é uma sessão N1, N2 ou Iterativa. Lembrando que uma sessão Iterativa é uma sessão que vai acionar um Eddie e a tag relacionada àquela sessão. Por último, é só clicar no botão "Salvar". Editando uma seção existente Para editar uma sessão, basta você clicar no botão de edição ou dar um duplo clique direto no meio dela que já vai abrir a tela para editar. Na tela de editar, você consegue mudar tudo dela: o título, a resposta, o tipo e a tag. Depois que você terminou, você pode clicar no checkmark verde (✅) no topo direito se quiser salvar ou no x cinza (❌) na direita se quiser descartar as suas alterações. Desabilitando temporariamente uma seção Uma função relativamente nova é a de desabilitar temporariamente o conteúdo, desabilitar temporariamente uma sessão da IDS. Vamos supor que tenha um conteúdo que, para o momento, ele não faz sentido, mas para o futuro faz. Por exemplo, você está para lançar um produto novo e quer criar esse conteúdo bem antes do rollout desse produto. Você pode escrever essa sessão e desabilitar ela clicando no botão de olho marrom (👁️) no topo direito da sessão. Isso vai fazer com que ela não seja utilizada pela ClaudIA. Quando você quiser ligar novamente, é só clicar de novo nesse botão. Enquanto ela estiver desabilitada, vai estar marcado bem grande com escrito "Disabled" Deletando uma seção da IDS Se você quiser deletar uma sessão da IDS, basta você clicar no ícone de lixeira em vermelho (🗑️) no topo direito da tela. Isso vai abrir um pop-up pedindo para você confirmar que realmente deseja deletar. Se você clicar em confirmar, ela vai ser deletada. Se você clicar em cancelar, ele não vai deletar e vai cancelar a deleção que você iniciou. Executar ações em massa Quando você clica em "Selecionar todos", você pode Deletar, Desabilitar ou Habilitar todos os selecionados. A utilização dessa tela fica ainda mais eficiente quando você utiliza os filtros. Ao utilizar um filtro e clicar em "Selecionar Todos", serão selecionados todos somente do Filtro utilizado no momento. Isso pode ser útil principalmente quando você quer realizar uma ação em massa de: - Desabilitar todos de uma tag específica - Desabilitar todos com Origem Externa - Habilitar todos que estão Desabilitados

Última atualização em Oct 08, 2025

Segmentação de conteúdo por Tópico

A ClaudIA permite segmentar conteúdos para diferentes vertentes do seu negócio por meio da funcionalidade de segmentação de IDS por "tópicos". Por exemplo, podemos ter um tópico específico para clientes do segmento "VAREJO". Através de um fluxo Eddie, podemos: - Consultar um atributo do cliente no helpdesk ou no backoffice de forma automatizada, sem necessidade de perguntar diretamente a ele (conforme demonstrado na imagem abaixo). - Perguntar ao cliente (caso a informação não esteja disponível automaticamente) sobre o segmento ao qual pertence ou sobre o assunto de interesse. Quando o Eddie detecta que o cliente pertence a um segmento específico, a conversa passa a utilizar apenas os conteúdos cadastrados para esse segmento. No exemplo abaixo, a resposta fornecida foi baseada no conteúdo do tópico "VAREJO": Ao auditar a resposta, podemos ver o tópico da seção que foi utilizada: Para filtrar, editar ou criar novos conteúdos em tópicos, pode ser usado a tela de Conteúdos: Uso do Tópico "DEFAULT" O tópico "DEFAULT" armazena conteúdos comuns a todos os segmentos. Por exemplo, perguntas genéricas como: "Quais serviços a empresa de vocês oferece?". Exemplos de Cenários - No início da conversa, antes de um tópico ser selecionado pelo Eddie, apenas os conteúdos do tópico "DEFAULT" são utilizados. - Após a seleção de um tópico específico, como "VAREJO", o sistema passa a utilizar apenas os conteúdos dos tópicos "DEFAULT" e "VAREJO" para responder ao cliente. Esse tópico pode ser configurado na seguinte tela do Eddie: Considerações Finais Atualmente, para que um tópico seja adicionado às seções da IDS, é necessário solicitar a um Clouder que cadastre previamente os tópicos no banco de dados. No futuro, pretendemos disponibilizar uma tela para que os clientes possam gerenciar seus próprios tópicos de maneira self-service.

Última atualização em Aug 09, 2025

Como salvar seções da IDS como rascunho ou agendá-las pra publicação posterior

Agora ficou muito mais fácil criar e gerenciar conteúdos temporários e rascunhos na IDS. Essa funcionalidade foi criada porque muitos clientes queriam preparar conteúdos com antecedência — seja para revisar antes da validação final, ou para deixar tudo pronto antes de mudanças em políticas ou produtos entrarem em vigor. Criando novos conteúdos: rascunho ou agendamento Para começar, acesse a seção de conteúdos no Hub. Image Primeiro, aperte em "Criar Novo" e preencha os campos: - Título - Resposta - Tipo (N1, N2 ou Interativo) - Tag - Flow (caso seja Interativo) - Topic (caso você utilize essa função) Em seguida, você pode visualizar as opções de publicação ao clicar na seta à direita do botão Publicar. Neste momento, você pode escolher entre: - Publicar imediatamente - Salvar como rascunho - Agendar uma data e hora para publicação Image Salvar como rascunho Essa opção permite que você continue editando o conteúdo depois. Enquanto estiver salvo como rascunho, a ClaudIA não terá acesso a ele. Agendar publicação Ao escolher agendar, uma janela será aberta para selecionar data e hora. Depois de clicar em "Agendar", o conteúdo será publicado automaticamente no horário definido! Image Importante: a data de publicação vem pré-preenchida. - Se for o seu primeiro agendamento, o sistema vai sugerir a data de amanhã às 9h. - Se você já agendou outro conteúdo recentemente, o sistema usará a última data e hora utilizadas. Editando conteúdos Você também pode editar um conteúdo que já foi criado e: - Salvar as alterações como rascunho - Agendar para publicar depois - Publicar imediatamente Assim que fizer alterações, as três opções aparecerão para você, funcionando da mesma forma que na criação de novos conteúdos. Image Essas novas funcionalidades da IDS trazem mais flexibilidade, organização e eficiência para quem precisa planejar, revisar e gerenciar conteúdos com antecedência.

Última atualização em Aug 09, 2025

Sincronizar um conteúdo externo para a IA (Origem Externa)

Esta FAQ explica, de forma prática, como cadastrar, editar, ativar/desativar e sincronizar origens de conteúdo do seu projeto — além de interpretar os status e configurar a recorrência de coleta. O que são “Origens de conteúdo”? São configurações que dizem de onde a ClaudIA deve buscar conhecimento (ex.: seu Help Center). Cada origem tem: URL inicial, filtros de caminho, cadência/horário de sincronização e uma tag padrão. Onde encontro a tela? No projeto, acesse Conteúdos → Origens. Abaixo o exemplo da tela em um projeto sem nenhuma sincronização ativa ainda. Caso o projeto já contenha sincronizações ativas, você verá uma lista com as seguintes colunas: - URL Inicial - Status da última execução (ex.: Sincronizado, Erro, Cancelado) - Última sincronização - Estado (Ativado/Desativado) - Ações: Sincronizar, Editar, Ver URLs Você pode ordenar clicando no cabeçalho das colunas. Como adiciono ou edito uma origem? 1. Clique em Adicionar Origem (ou Editar numa existente). 2. No modal, preencha: - Agendamento (Cadência & Hora local) Selecione Diário / Semanal / Mensal e um horário. A interface mostra: - A próxima execução (relativa e com data/hora local). - O sistema converte tudo para cron em UTC automaticamente. - URL Inicial Deve ser uma URL válida com protocolo http/https. - Filtro de Caminho (obrigatório) Sincroniza apenas páginas cujo caminho começa com um destes prefixos (um por linha). → Cada valor deve começar com “/” e ter mais de 1 caractere. Ex.: /docs, /hc/pt - Excluir Filtro de Caminho (opcional) Caminhos (no mesmo formato do filtro) a serem ignorados. Ex.: /portal-interno, /privado - Tag Padrão (opcional) Tag aplicada aos conteúdos originados desta fonte (ajuda no filtro/pesquisa). 3. Salve em Atualizar Origem (Salvar). Validações importantes - URL inválida ou com protocolo diferente de http/https gera erro. - Cada item do filtro deve começar com “/”; / sozinho não é aceito. Como funciona a recorrência (agendamento)? - Você escolhe Diário / Semanal / Mensal. - O sistema calcula o agendamento considerando hora no seu fuso local e exibe a próxima execução estimada. Exemplos: - Diário às 06:00 (local) → roda todo dia neste horário. - Semanal (2ª às 07:00) → roda toda segunda no horário escolhido. - Mensal (dia 15 às 05:00) → roda todo dia 15 neste horário. Dica: você pode alterar a cadência a qualquer momento; a próxima execução já considera a nova configuração. Como ligo, desligo, inicio ou paro uma sincronização? - Ativar/Desativar: use o toggle na coluna Estado. - Ativado: a origem participa das execuções (agendadas ou manuais). - Desativado: a origem fica pausada, sem rodar nem manualmente. - Sincronizar (manual): clique em Sincronizar. O status muda para Iniciando/Em execução. - Parar: enquanto estiver Em execução, o botão Parar aparece; clique para cancelar a execução atual. Se eu desativo uma origem, a ClaudIA deixa de usar esse conteúdo? Depende do tipo de desativação: - 🔄 Desativar sincronização: a ClaudIA para de atualizar o conteúdo dessa origem, mas ainda usa o que já foi sincronizado anteriormente. - ❌ Remover origem: a ClaudIA deixa de usar completamente aquele conteúdo. Se o objetivo é controlar o que a ClaudIA usa, o ideal é remover a origem (em vez de apenas desativar a sincronização) ou usar filtros por origem na tela de conteúdo para isolar e excluir materiais de uma origem específica. Como vejo as URLs que foram extraídas? Clique em Ver URLs. Um modal lista todas as URLs coletadas para aquela origem. Você pode abrir cada uma em nova aba para conferir o conteúdo. O que significam os status? Os “badges” de status aparecem na coluna Status: - Sincronizando A coleta está em andamento. - Sincronizado A última execução terminou com sucesso. - Erro Algo falhou. Passe o mouse sobre o badge para ver detalhes do erro. Caso não apareça entre em contato com o nosso time. - Cancelado A execução foi interrompida (manualmente ou pelo sistema). - Pendente Ainda não foi executada a sincronização nenhuma vez. A página atualiza o status automaticamente: mais rápido enquanto há execuções, e em intervalos maiores quando tudo está estável. Boas práticas para filtros de caminho - Seja específico: use prefixos que representem as seções relevantes. Ex.: /hc/pt, /ajuda/, /docs/produto-x - Evite “/” genérico: isso tenta varrer o site todo. - Use “Rotas para ignorar na sincronização” para pular áreas internas ou sensíveis. Ex.: /admin, /conta, /portal-interno Erros comuns e como resolver - “URL inválida” / “Protocolo inválido” Confirme que a URL começa com http:// ou https:// e está correta. - “O caminho deve começar com ‘/’” Ajuste os itens do filtro para o formato /seu-prefixo. - Status “Erro” Passe o mouse sobre o badge para ler o motivo (ex.: etapa com falha). Revise filtros/URL e tente Sincronizar novamente. Caso o erro persista, entre em contato com o nosso time. - Nenhuma URL listada em “Ver URLs” Verifique se os filtros de caminho incluem, de fato, as páginas desejadas. Posso organizar ou pesquisar o que foi coletado depois? Sim — os conteúdos coletados aparecem na aba Conteúdos, onde você pode pesquisar pela url desejada e os conteúdos aparecerão**.** Caso precise editar em massa algo que foi colocado incorretamente, você pode ver aqui como fazer. Dentro da mesma origem há conteúdos com labels/tags diferentes. É possível sinalizar isso? Sim. Você pode preencher manualmente as tags (labels) em cada conteúdo sincronizado. Quando você faz isso manualmente, essas tags não são sobrescritas nas próximas sincronizações — apenas o conteúdo textual é atualizado. Assim, é possível organizar uma mesma origem em múltiplas categorias ou filtros de uso. Dicas finais - Comece com uma origem por área (ex.: Help Center PT/EN separados) e filtros claros. - Agende para horários de baixo tráfego do seu site. - Revise “Ver URLs” depois da primeira execução para garantir que só o que interessa está sendo captado. - Use uma Tag Padrão de fácil idêntificação para facilitar buscas e relatórios por origem. - Como você vai visualizar na Conversa Assim como na aba de "Conteúdo", na aba de Conversa você também poderá visualizar se o conteúdo é de fonte externa ou não. 📌 Lista de Tags HTML ignoradas por padrão Durante o processo de refinamento, o agente de extração descarta automaticamente diversos elementos que normalmente não são úteis para a base de conhecimento. Esses seletores foram definidos para reduzir ruído visual e estrutural (menus, anúncios, comentários, formulários, etc.), mantendo apenas o conteúdo principal. Estrutura da página #footer #header #nav nav footer Scripts e estilos script style noscript Mídia svg img audio video Navegação e menus .sidebar .menu .navigation .breadcrumb .breadcrumbs .pagination .pager .page-navigation Anúncios e banners .advertisement .ads .ad-banner .cookie-banner .cookie-notice .gdpr-notice Social e compartilhamento .social-share .social-buttons .share-buttons Formulários e assinaturas .newsletter .subscription .signup-form .search-box .search-form .search-bar Conteúdo relacionado .related-posts .recommended .suggestions Comentários e discussões .comments .comment-section .discussion Metadados e autoria .tags .tag-list .categories .author-bio .author-info .byline .meta .metadata .post-meta Widgets e sidebars .widget .widgets .sidebar-widget Popups e overlays .popup .modal .overlay .lightbox Acessibilidade e navegação oculta .skip-link .screen-reader-text .sr-only .print-only .no-print Atributos de acessibilidade [role='alert'] [role='banner'] [role='navigation'] [role='complementary'] [role='dialog'] [role='alertdialog'] [role="region"][aria-label*="skip" i] [aria-hidden='true'] [aria-modal='true'] Elementos invisíveis .hidden .invisible

Última atualização em Oct 10, 2025

Boas práticas na criação e manutenção de conteúdos

Vídeo com overview de boas práticas: https://www.loom.com/share/68b85f7810b6451bbdd83f2bcc404157 Mantenha a base de conteúdos com menos de 20% de seções N2 Entenda a composição da base de conteúdo A base de conteúdo é composta por seções N1, N2 e Interactive (quando Eddies estão sendo utilizados). A base de conteúdo ideal em termos de retenção é aquela que contém apenas seções N1 e/ou Interactive, e que não escalem os atendimentos para humanos, fazendo a ClaudIA ser mais resolutiva e dando respostas mais rápidas para os clientes (em comparação com humanos). Considere a qualidade do atendimento No entanto, a qualidade do atendimento pode ser afetada se tentarmos automatizar 100% dos atendimentos. Há situações em que um agente humano precisa intervir. Para esses casos, criamos seções de N2. Evite a criação de uma fila de atendimentos Se todas as seções fossem N2, não teríamos nenhum nível de atendimento automatizado. Isso deixaria o nível de retenção em 0% e poderia gerar uma fila de atendimentos, também afetando a qualidade do atendimento. Busque o equilíbrio entre as seções N1 e N2 Para manter bons níveis de retenção e qualidade, é essencial equilibrar as seções que automatizam o atendimento (N1) e as que escalam para atendimento humano (N2). Siga a recomendação de percentual máximo de seções N2 Recomendamos que o percentual máximo de seções de N2 numa base de conhecimento seja de 20% sobre o total. Por exemplo, numa base de conhecimento com 1000 seções, o ideal é que até 200 sejam N2. Escreva o título da sessão de maneira clara e sem erros ortográficos Imagine que o usuário enviou uma mensagem que a ClaudIA não conseguiu responder corretamente porque não havia conteúdo em sua base. Você sabe a resposta para a pergunta do cliente, o que o leva a criar uma nova seção na base de conteúdo. Em situações como essa, ou quando surge a necessidade de criar ou alterar algum conteúdo, é crucial que os textos estejam claros e sem erros ortográficos. Isso aumenta a probabilidade de a ClaudIA entender a pergunta do usuário e localizar a seção correta para respondê-lo. Dica: Não insira a mensagem do cliente na seção exatamente como ele escreveu. Corrija a ortografia e, se necessário, torne a pergunta mais clara. Veja um exemplo de seção com título inadequado: Agora, observe um exemplo com sessão com o título adequado: Remova seções desnecessárias Após identificar que uma seção está sendo utilizada com frequência de maneira incorreta (neste vídeo, ensinamos a mapear estes casos), exclua-a. Em muitos casos, essas seções foram criadas fugindo das boas práticas, e não há problema em excluí-las, especialmente se forem N2. Fazer a manutenção constante do conteúdo é uma alavanca para melhorar drasticamente a qualidade e capacidade de retenção de tickets pela ClaudIA. Vídeo sobre como mapear ofensores de retenção. Template para mapear oportunidades de n1 com base nas seções de n2 e para análise de tickets (seção foi utilizada/seção foi utilizada corretamente). Exclua seções duplicadas Seções Duplicadas: O que são e por que evitá-las? Seções duplicadas são aquelas que possuem titles idênticos, mas apresentam respostas ou encaminhamentos diferentes. Além disso, também são consideradas duplicadas as seções com titles semelhantes que deveriam ser acionadas nas mesmas situações, mas contêm respostas distintas. Por que evitar conteúdos duplicados? NUNCA crie conteúdos duplicados, especialmente com diferentes tipos (N1, N2 ou INTERACTIVE). Essa prática pode causar diversos problemas, como: - Dificuldade na manutenção de conteúdo: conteúdos repetidos geram retrabalho constante. - Risco de respostas incorretas: aumenta a chance de a ClaudIA selecionar a seção errada para responder à dúvida do usuário. Exemplo de Seções Duplicadas Nos exemplos acima, além de as seções terem a resposta diferentes, elas também implicam num direcionamento distinto: a primeira é um caso N1, enquanto a segunda, N2. Note que nesses casos a ClaudIA tende a dar preferência para escalar o ticket para N2. Exemplo de Impacto das Seções Duplicadas Como identificar seções duplicadas? Há duas ferramentas no Hub que podem ser utilizadas para identificar conteúdos duplicados: - Tela de "Conteúdos", utilizando filtro "semântico": - Playground Em ambos os casos, o passo a passo sugerido é: 1. Acessar a ferramenta; 2. Adicionar uma pergunta com conteúdo possivelmente duplicado; 3. Na tela de conteúdos: verificar se existe duas ou mais seções com titles semelhantes - e, principalmente, responses diferentes; 4. No Playground: verificar se a resposta foi correta e clicar no "i" para verificar se outra seção semelhante estava presente no topK; Ambas as ferramentas funcionam como um mecanismo de busca semântica, ou seja, buscam conteúdos semelhantes à pergunta adicionada. Não inclua saudações em seções da IDS Evite usar saudações como 'Olá! Como você está?' junto de respostas nas seções. A ClaudIA já cumprimenta o usuário no início da conversa ou quando necessário. Entenda que essa prática pode intensificar a sensação de "robotização" do atendimento para o cliente. Também pode aumentar a chance de ClaudIA acionar uma seção incorreta quando o usuário saudar. Isso também prejudica o resultado da ferramenta de tagueamento da Claudia, o Tagger. Veja abaixo um exemplo de uma seção inadequada: Não crie seções de "não conteúdo" na IDS Similar ao item acima, evite criar seções que não possuam conteúdo. Como seções que tentam adaptar o tom de voz da claudia: - Título: "Ok, obrigado" - Resposta: "De nada, estou aqui pra te ajudar!" Seções como essa atrapalham o desempenho da ClaudIA, adicionando ruídos na sua base de conhecimento.

Última atualização em Oct 08, 2025

Classificando Erros na finalização da Auditoria

Qual a importância de classificar os erros na conclusão da auditoria? Neste arquivo, explicamos que, após classificar as mensagens na conversa como corretas ou incorretas, o próximo passo na auditoria é indicar se o atendimento realizado pela ClaudIA foi adequado ou não. - Se o atendimento for correto, basta marcar a opção com um check. - Caso o atendimento seja incorreto, será necessário selecionar uma das três reações em emoji, que indicam a criticidade do erro. Os erros são classificados da seguinte forma: - Erro Tipo 1 (Leve): A informação fornecida é correta, mas falta algum detalhe que poderia enriquecer ou complementar a resposta. - Erro Tipo 2 (Moderado): A resposta contém informações parcialmente corretas, mas há omissões ou adições que podem causar confusão para o cliente. - Erro Tipo 3 (Grave): A resposta está completamente errada ou apresenta falhas significativas, como a falha em transferir corretamente o atendimento, prejudicando a experiência do cliente. Sugestão de melhoria: Neste arquivo, sugerimos a criação de uma documentação interna detalhada sobre a classificação dos erros, para garantir que todos os membros da equipe apliquem os critérios de forma consistente, evitando erros de interpretação nas auditorias. Possibilidades de uso / impacto prático: - Neste arquivo, destacamos que a correta classificação dos erros permite identificar rapidamente a criticidade de cada problema e priorizar as correções necessárias. - Facilita o trabalho de quem realiza a auditoria, proporcionando um processo mais organizado e eficiente. - Ajuda a melhorar a qualidade do atendimento, possibilitando ajustes contínuos na ClaudIA para garantir uma experiência mais precisa e satisfatória para os clientes.

Última atualização em Nov 26, 2025