Treine o Atlas na base de conhecimento
Configure fontes, mantenha respostas corretas e ligue o Claude Code ou o Codex em segurança para pesquisar e gerir a base de conhecimento do TicketCord.
O que o Atlas pode ingerir
Você adiciona fontes na configuração da base de conhecimento do painel. São três:
- Página única. Aponte o Atlas para uma URL e ele rastreará a página (e alguns níveis mais fundo, configuráveis). Ideal para documentos de ajuda, FAQs e páginas de produto que você já mantém no seu site.
- Canal do Discord. Importe o histórico de mensagens de um canal do Discord - útil quando sua equipe de suporte já respondeu às mesmas perguntas em público e você quer que o Atlas aprenda com essas respostas.
- Repositório do GitHub. Vincule um repositório e um caminho opcional; o Atlas indexa todos os arquivos Markdown (
.md,.mdx) que encontrar lá. Bom para equipes de engenharia que mantêm a documentação no mesmo lugar que o código.
Estruturando as entradas
Fontes menores e focadas funcionam melhor do que uma página gigante. Uma central de ajuda com um artigo separado por tópico (“Política de reembolso”, “Cancelamentos”, “Disponibilidade por região”) facilita muito mais para o Atlas extrair respostas limpas do que um mega-documento único de “Tudo o que você precisa saber”. O Atlas cita na resposta a fonte que usou, então fontes granulares também tornam as citações mais úteis.
Deixando a equipe ensinar no fluxo
Quando a equipe corrige um rascunho do Atlas antes de enviar, a correção é capturada como uma entrada de perguntas e respostas e adicionada à base de conhecimento. Ela passa a competir com as suas outras fontes na próxima pergunta parecida - classificada por relevância e pelos votos da comunidade - de modo que boas correções sobem sozinhas com o tempo. Não há job de retreinamento para rodar; novas entradas ficam pesquisáveis imediatamente.
O que não colocar
- Segredos, senhas, chaves de API, dados de clientes.
- Políticas desatualizadas. O Atlas trata cada entrada como atual.
- Notas de incidentes prolongados. Use respostas prontas para isso.
Verificações de qualidade
Abra a lista da base de conhecimento no painel de vez em quando e passe os olhos em busca de entradas desatualizadas. Se uma resposta mudou (preço, política, região suportada), edite ou remova a entrada para o Atlas parar de citar a versão antiga. Rastreie de novo as entradas baseadas em URL depois de grandes mudanças na documentação, para que o índice reflita o que seus clientes vão de fato encontrar no seu site.
Gerir a base de conhecimento com ferramentas de IA
O MCP é uma ligação segura que permite ao Claude Code ou ao Codex trabalhar com a sua base de conhecimento do TicketCord depois de iniciar sessão e autorizar o acesso. Pode fazer pedidos em linguagem simples sem percorrer todos os ecrãs do painel.
Antes de estabelecer a ligação
- Tem de ser o proprietário da conta do TicketCord. Os membros da equipa com acesso ao painel não podem criar uma ligação MCP.
- O seu plano ativo tem de incluir acesso à base de conhecimento.
- Instale o Claude Code ou a CLI do Codex e confirme que consegue iniciar sessão no TicketCord.
- Uma ligação pode aceder a todos os servidores que possui agora ou adicionar no futuro. Cada pedido continua a indicar um bot e um servidor, e o TicketCord volta a verificar a propriedade e o plano em todas as ocasiões.
Ligar o Claude Code ou o Codex
- No painel, selecione um bot e um servidor. Abra Base de conhecimento > Configuração e procure Ligar ferramentas de IA.
- Para o Claude Code, execute
claude mcp add --transport http ticketcord https://ticketcord.com/api/mcp --scope usere depoisclaude mcp login ticketcord. - Para o Codex, execute
codex mcp add ticketcord --url https://ticketcord.com/api/mcpe depoiscodex mcp login ticketcord. - O TicketCord abre no navegador. Inicie sessão, leia o aviso de acesso a toda a conta e as permissões pedidas de leitura, escrita e eliminação. Depois escolha Permitir acesso ou Recusar.
- Quando vir Autenticação concluída, feche o separador e volte à ferramenta de IA. Experimente:
Lista as minhas bases de conhecimento do TicketCord.
O que pode pedir
- Listar as bases de conhecimento e consultar definições, fontes, estado da indexação e entradas.
- Pesquisar por significado e devolver pequenos excertos relevantes com nomes de fontes e nível de confiança.
- Adicionar, editar, ativar, desativar, reindexar ou eliminar páginas Web, canais do Discord e fontes do GitHub já ligadas.
- Criar e editar entradas, analisar entradas pendentes e aprová-las, rejeitá-las ou eliminá-las.
- Atualizar definições editáveis no painel para dados do produto, acionadores, apresentação, qualidade, atualizações, comportamento, comentários, aprendizagem de tickets e Auto Support.
Pedidos úteis para experimentar
Lista as minhas bases de conhecimento e mostra quais não têm fontes prontas.Pesquisa a nossa política de reembolso e resume-a com os nomes das fontes.Encontra entradas que mencionem preços antigos. Mostra-as primeiro e não alteres nada.Adiciona https://docs.example.com como fonte de documentação e inicia a indexação.Mostra as entradas pendentes e recomenda aprovar ou rejeitar antes de fazer alterações.Mostra a resposta atual para repor a palavra-passe e depois ajuda-me a atualizá-la.
Permissões, segurança e acesso
- O acesso de leitura permite consultar e pesquisar conhecimento. A escrita permite alterar definições, fontes e entradas. A eliminação permite remover fontes e entradas de forma permanente.
- Para alterações arriscadas, peça à ferramenta de IA que primeiro mostre o que encontrou e explique a ação planeada.
- A eliminação é permanente. O TicketCord verifica novamente a sua permissão em cada pedido, mesmo depois de ter aprovado a ligação.
- Se o plano expirar ou perder acesso à base de conhecimento, a ligação é suspensa. Pode voltar a funcionar depois de mudar para um plano elegível, exceto se tiver sido revogada ou o acesso de renovação tiver expirado.
- Revogue imediatamente uma ligação no cartão Ligar ferramentas de IA na configuração da base de conhecimento.
- Ligar ou desligar uma conta do GitHub continua a ser feito apenas no painel. Nunca guarde palavras-passe, chaves de API, segredos ou dados de clientes na base de conhecimento.