# 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

1. No painel, selecione um bot e um servidor. Abra **Base de conhecimento > Configuração** e procure **Ligar ferramentas de IA**.
2. Para o Claude Code, execute `claude mcp add --transport http ticketcord https://ticketcord.com/api/mcp --scope user` e depois `claude mcp login ticketcord`.
3. Para o Codex, execute `codex mcp add ticketcord --url https://ticketcord.com/api/mcp` e depois `codex mcp login ticketcord`.
4. 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**.
5. 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.

## Recursos legíveis por máquina

- [HTML canônico](https://ticketcord.com/pt/help/ai/knowledge-base)
- [TicketCord llms.txt](https://ticketcord.com/llms.txt)
- [AI índice de páginas](https://ticketcord.com/api/ai/pages)