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 2 outros
6 artigos

Usando a tela de conteúdos

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.

Última atualização em Aug 09, 2025

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

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 Aug 09, 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

Conteúdos sincronizados de FAQ ou página de produto

Como funciona A partir de uma URL, nós podemos usar nosso agente que extrai as informações do seu site e deixa pronto para a ClaudIA utilizá-la. O conteúdo vem otimizado para que a Claudia consiga manter a performance. O que pode e o que evitar O que pode: - URLs que começam com "ajuda" ou "suporte" - URLs que possuem o site base como início www.exemplo.com.br E possuem um endereço '/products/' que queremos extrair O que evitar: - URLs que possuem o site base como início www.exemplo.com.br E NÃO possuem um endereço '/products/' que queremos extrair: Isso reduzirá a capacidade de criar filtros na extração e vamos puxar todos os dados da página. Posteriormente é possível desativar conteúdos indesejados Como você pode visualizar na página de Conteúdo Como manusear esse conteúdo Você poderá visualizar e acessar o Conteúdo Externo que foi utilizado como base para gerar essa sessão específica Além disso, é possível fazer um filtro para visualizar todas as que foram extraídas de fontes externas Por fim, a partir de certos filtros é possível desabilitar / deletar as sessões de IDS em massa, caso tenha interesse Esse conteúdo externo não será editável dado que será sempre sobrescrito quando executar outra sincronização na base de conteúdo. Qual tag fica preenchida A princípio iremos preencher com uma tag padrão arbitrária a ser definida (exemplo: 'faq' ou 'produto' ⮕⮕⮕ Planejamos evoluir para realizar a categorização dos conteúdos de forma automatizada, porém para próximas versões 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. Como você pode executar a sincronização IMPORTANTE: Caso opte por puxar conteúdos de fonte externa utilizando nosso agente, é ESSENCIAL que desabilite sessões que são iguais ou duplicadas. Nosso time consegue analisar duplicatas para apoiar. ⮕⮕⮕ Por enquanto é necessário entrar em contato com o time de atendimento para utilizar essa funcionalidade, estamos em Beta

Última atualização em Aug 12, 2025