A Resposta Breve
Um acervo de conhecimento organizacional é frequentemente construído para seres humanos que sabem preencher lacunas, identificar documentos desatualizados e consultar colegas. Um agente não é capaz de fazer nenhuma dessas três coisas. Por isso, o treinamento não se concentra em adicionar conteúdo, mas principalmente em remover, decidir e categorizar.
O processo prático envolve cinco etapas: auditoria de cobertura e validade, arquivamento de conteúdo obsoleto e conflitante, reorganização da estrutura do artigo, categorização para recuperação e atribuição de responsabilidade com um SLA para atualização. A quinta etapa é a que determina se o investimento será sustentável por mais de seis meses.
Como a camada de recuperação consome esse conteúdo é explicado em Grounding e RAG no Agentforce.
Etapa 1: Auditoria Focada
Não audite o acervo inteiro. Pegue a lista de cenários que o agente irá lidar e gere uma lista de perguntas reais – a partir de consultas recebidas na prática, não da imaginação. Para cada pergunta, verifique: existe um artigo, quando foi atualizado, quem é o proprietário e se a resposta está correta hoje.
O resultado são quatro categorias: coberto e válido, coberto mas desatualizado, coberto em várias versões conflitantes, e não coberto de forma alguma. A terceira categoria é a mais perigosa, pois é a que faz com que o agente forneça respostas diferentes para a mesma pergunta.
A lacuna encontrada na quarta categoria não é necessariamente um problema – ela se torna uma lista de redação e, por enquanto, uma lista de tópicos que são encaminhados a um humano.
Etapa 2: Arquivar Antes de Escrever
A instrução mais difícil de aceitar em organizações é a de excluir. No entanto, um artigo desatualizado que permanece no acervo causa mais danos do que um artigo ausente: a falta leva à escalada, enquanto a desatualização leva a uma resposta incorreta com confiança.
Uma regra de trabalho simples: qualquer artigo que não tenha um proprietário e não tenha sido atualizado além do período definido para sua área – é removido do índice. Ele pode permanecer no arquivo para fins de documentação, mas não é acessível ao agente.
Em caso de conflito entre duas versões, a decisão é do proprietário do conteúdo e não da equipe técnica. Este é um ponto que requer uma decisão de negócio, e ignorá-lo fará com que o problema retorne na fase de testes.
Etapa 3: Estrutura do Artigo
Uma boa estrutura para um agente também é uma boa estrutura para um leitor, portanto não é um trabalho redundante. O título é formulado como uma pergunta ou cenário na linguagem que os usuários utilizam, não em uma linguagem interna. O primeiro parágrafo fornece uma resposta curta e independente. Os detalhes vêm em seções com subtítulos.
Duas regras que afetam diretamente a qualidade da recuperação: condições de elegibilidade e exceções são colocadas em uma seção separada e marcada, não inseridas em uma frase; e tabelas permanecem pequenas e independentes, pois uma tabela cortada no meio gera uma resposta parcial.
O que se deve evitar: artigos longos que cobrem cinco tópicos. É preferível dividir em cinco artigos focados – a recuperação é mais precisa e a manutenção é mais fácil.
Os princípios mais amplos de gerenciamento de conhecimento no Service Cloud são detalhados em Gerenciamento de Conhecimento no Salesforce.
Etapa 4: Categorização e Separação de Públicos
Categorização mínima necessária em quase todas as organizações: produto ou linha de serviço, mercado ou país, idioma, público-alvo, status de aprovação e data de validade. Em uma organização global, a falta de categorização por mercado e idioma é a principal causa de respostas incorretas – o agente recuperará uma política de outro país com total confiança.
A separação de públicos é uma decisão de segurança e não apenas de classificação. O conteúdo escrito para agentes às vezes inclui margens de desconto, formulações de objeções e informações competitivas. No canal do cliente, a regra padrão deve ser uma lista de permissão: apenas o conteúdo explicitamente marcado como aprovado para o cliente é incluído.
Um documento em que a maior parte é permitida e um parágrafo é sensível não é um caso extremo – é comum. A solução é dividir o documento e não marcá-lo todo como interno.
Etapa 5: Propriedade e Manutenção
Esta é a etapa que determina a sustentabilidade do resultado. Para cada área de conhecimento, um proprietário é designado pelo nome, a frequência de revisão é definida e o que acontece quando um artigo expira é estabelecido – remoção automática do índice, em vez de um alerta que ninguém lê.
O mecanismo de feedback é o que torna a manutenção eficaz. Cada conversa que resultou em escalonamento devido à falta de uma fonte entra na lista de lacunas de conteúdo, e esta é a melhor lista de prioridades para novas redações. É melhor escrever cinco artigos que foram realmente necessários do que cinquenta que pareciam importantes.
Orçamento: a manutenção de conteúdo é um item permanente, não um projeto. Organizações que a tratam como uma tarefa única veem uma diminuição na precisão em dois trimestres.
Limiares de Entrada no Índice
| Critério | Limite Mínimo | Porquê |
|---|---|---|
| Propriedade | Proprietário nomeado para cada artigo | Sem proprietário, ninguém para atualizar |
| Validade | Dentro do período de revisão definido para a área | Impede a citação de políticas canceladas |
| Unicidade | Fonte única para cada tópico | Evita respostas contraditórias |
| Público | Marcado como interno ou aprovado para cliente | Impede a exposição de conteúdo sensível |
| Estrutura | Título com pergunta e resposta curta na introdução | Melhora a precisão da recuperação |
Cenário: 1.400 Documentos Reduzidos para 190
Uma provedora de serviços de TI queria conectar um agente a uma pasta do SharePoint com 1.400 documentos. A auditoria inicial mostrou que apenas cerca de 30% deles haviam sido atualizados nos últimos três anos, e que aproximadamente 200 eram rascunhos ou versões de trabalho.
Em vez de um projeto de limpeza abrangente, a equipe mapeou os 25 cenários que o agente deveria cobrir. Do acervo, foram encontrados 190 documentos relevantes; destes, 40 eram contraditórios e exigiram uma decisão de três proprietários de área. Os documentos selecionados foram divididos em artigos focados e categorizados por produto e público.
O projeto piloto foi lançado com 190 itens, em vez de 1.400, e a precisão das respostas foi significativamente maior do que na primeira tentativa. O restante do acervo permaneceu arquivado e foi gradualmente inserido conforme a lista de lacunas acumuladas pelas escaladas reais.
Riscos e Ações Preventivas
| Risco | Como se manifesta | Ação Preventiva |
|---|---|---|
| Inclusão de todo o acervo | Baixa precisão e dificuldade em identificar a causa | Inclusão com base em cenários, não em todo o acervo |
| Artigos sem proprietário | Obsolescência silenciosa | Propriedade como condição de entrada no índice |
| Versões contraditórias | Respostas diferentes para a mesma pergunta | Decisão de negócio e arquivamento |
| Mistura de conteúdo interno e externo | Exposição de informações sensíveis ao cliente | Lista de permissões no canal externo |
| Manutenção como projeto único | Queda de precisão em dois trimestres | Orçamento regular e SLA para atualização |
Métricas de Preparação de Conteúdo
| Métrica | Definição | Frequência |
|---|---|---|
| Cobertura de Cenários | Percentual de cenários com artigo aprovado | Mensal |
| Validade | Percentual de artigos no índice dentro da data de validade | Mensal |
| Duplicidade de Tópicos | Número de tópicos com mais de uma fonte | Trimestral |
| Lacunas de Escalonamento | Número de novos tópicos necessários e ausentes | Semanal |
| Tempo Médio de Atualização | Quanto tempo leva para corrigir um artigo incorreto | Mensal |
Quando é necessário suporte na preparação do acervo e na configuração do modelo de manutenção, o Serviço Agentforce e IA é a abordagem prática para prosseguir.
Checklist para Preparação do Conhecimento
- ☐ Lista de perguntas reais construída a partir de solicitações práticas
- ☐ Cada pergunta classificada: válida, desatualizada, contraditória ou ausente
- ☐ Artigos sem proprietário arquivados ou com proprietário atribuído
- ☐ Conflitos resolvidos pelo proprietário do conteúdo
- ☐ Artigos estruturados: título com pergunta, resposta curta, seções
- ☐ Condições de elegibilidade e exceções em seção separada
- ☐ Tagging de produto, mercado, idioma, público e validade existente
- ☐ Conteúdo interno separado do conteúdo aprovado para o cliente
- ☐ Frequência de revisão e remoção automática na expiração definida
- ☐ Mecanismo estabelecido para converter escalonamentos em lista de redação