> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tartini.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Boas práticas para escrever o conhecimento da IA

> Que fonte usar para cada tipo de informação, como escrever para a IA acertar e como manter a base viva sem gastar créditos à toa.

export const Artigo = ({titulo, href, children}) => <a className="lista-artigos-item" href={href}>
    <span className="lista-artigos-texto">
      <span className="lista-artigos-nome">{titulo}</span>
      {children ? <span className="lista-artigos-desc">{children}</span> : null}
    </span>
    <svg className="lista-artigos-seta" viewBox="0 0 24 24" width="18" height="18" aria-hidden="true">
      <path d="M9 6l6 6-6 6" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
    </svg>
  </a>;

export const Lista = ({titulo, children}) => <div className="lista-artigos">
    {titulo ? <p className="lista-artigos-titulo">{titulo}</p> : null}
    <div className="lista-artigos-itens">{children}</div>
  </div>;

O Tino e o Sotto respondem com o que está nas Propriedades do Cérebro. Uma base pequena e bem escrita rende mais do que uma grande e confusa. Este guia diz o que cadastrar, em que formato, e como saber se a IA entendeu.

<Note>
  As Propriedades ficam em **Cérebro > Propriedades** e só o Administrador e o Gestor da Empresa as editam. Enviar documentos, criar perguntas e respostas e indexar sites consome créditos de IA.
</Note>

***

## Escolha a fonte certa para cada informação

| Informação                                                                                                 | Fonte                                            | Por quê                                                                           |
| ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------- |
| A resposta exata para uma pergunta que se repete: prazo de entrega, política de troca, formas de pagamento | **Perguntas e Respostas**                        | A IA usa a resposta como está. É a forma mais direta de treinar.                  |
| Manuais, catálogos, políticas internas, tabelas de preço                                                   | **Documentos** (PDF, DOCX, XLSX, CSV, TXT ou MD) | A IA lê o arquivo inteiro. Bom para conteúdo longo que já existe.                 |
| Páginas do seu site que mudam com o tempo: ajuda, produtos, blog                                           | **Sites**                                        | A IA indexa as páginas escolhidas e você adiciona ou reindexa quando o site muda. |

Comece pelas dez perguntas mais frequentes dos clientes, em Perguntas e Respostas. Depois envie os documentos que a equipe consulta para responder. Por fim, sincronize as páginas do site que valem a pena.

***

## Escreva para a IA, não para o cliente

* **Uma pergunta, uma resposta.** Um par por dúvida. "Qual o prazo de entrega para o Sul?" rende mais do que uma pergunta genérica sobre entregas.
* **Responda com o dado, não com a promessa.** "Entregamos em até 5 dias úteis no Sul e Sudeste" em vez de "entregamos rápido".
* **Escreva a pergunta como o cliente escreve.** Com as palavras que ele usa, inclusive as erradas.
* **Evite contradições entre fontes.** Se o PDF diz um prazo e a pergunta e resposta diz outro, a IA pode escolher qualquer um. Atualize os dois.
* **Um documento por assunto.** Um catálogo de 80 páginas com tudo dentro é mais difícil de consultar do que quatro documentos menores.

***

## Público ou privado

Cada fonte tem uma audiência. **Conhecimento Público** é o que o Tino usa ao falar com o cliente. **Conhecimento Privado** é o que só o Sotto usa, para apoiar o atendente. Informações internas, como margens, scripts de negociação ou orientações para a equipe, ficam privadas.

<Note>
  A opção de conhecimento público faz parte dos planos que incluem o Tino. No Essential, todas as fontes valem para o Sotto.
</Note>

***

## Sites: mapeie antes, indexe o que importa

Mapear as páginas de um site não custa créditos. Indexar custa. Ao sincronizar um site, mapeie, veja a lista de páginas e marque só as que respondem perguntas de cliente. Uma loja não precisa indexar a página de recrutamento. Acima de cinquenta páginas de uma vez, a tela pede confirmação: a indexação demora e consome mais.

Quando o site muda, use **Adicionar páginas** no site já indexado, ou **Reindexar** para substituir o conteúdo antigo.

***

## Confira se a IA entendeu

Depois de indexar, a lista mostra o card **Tino aprendeu** com um resumo do que a IA extraiu e o botão **Testar conhecimentos adquiridos**. Use-o: pergunte o que um cliente perguntaria e veja se a resposta vem certa. Veja [Teste o que a IA aprendeu](/cerebro/teste-o-conhecimento).

O Tino também gera **Descobertas** a partir das fontes: sugestões de diretrizes, esclarecimentos e candidatos a processo. Revise-as antes de aceitar. Veja [Use a inteligência da base de conhecimento](/cerebro/inteligencia-da-base).

***

## Mantenha a base viva

* Quando um preço, prazo ou política muda, mude a fonte no mesmo dia. A IA não sabe o que não foi atualizado.
* Exclua o que venceu. Uma promoção antiga na base vira uma promessa errada.
* Para o que é temporário, use o **Contexto Situacional** em vez de uma fonte: ele tem validade e some sozinho. Veja [Informe um contexto temporário](/cerebro/contexto-situacional).
* Leia as respostas erradas do Tino em **Por que ela disse isso** e corrija a fonte que ele usou, não a resposta.

***

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Quantos documentos posso enviar?">
    Até dez arquivos por envio, de até 30 MB cada. Não há limite de fontes na base; o que há é o consumo de créditos de cada indexação.
  </Accordion>

  <Accordion title="A IA lê planilhas?">
    Sim, XLSX e CSV. Prefira uma tabela limpa, com cabeçalho na primeira linha e uma informação por coluna.
  </Accordion>

  <Accordion title="Preciso reenviar um documento que mudou?">
    Sim. Exclua o antigo e envie o novo. Para sites, use **Reindexar**.
  </Accordion>
</AccordionGroup>

***

## Artigos relacionados

<Lista>
  <Artigo titulo="Ensine a IA com perguntas e respostas" href="/cerebro/perguntas-e-respostas">A forma mais direta de treinar.</Artigo>
  <Artigo titulo="Ensine a IA com o seu site" href="/cerebro/sites">Mapear, escolher e indexar páginas.</Artigo>
</Lista>


## Related topics

- [Começando com o Tartini](/primeiros-passos/guias/comecando-com-o-tartini.md)
- [Treinando o Cérebro](/primeiros-passos/guias/treinando-o-cerebro.md)
- [Boas práticas para entrar no ar](/primeiros-passos/boas-praticas/entrar-no-ar.md)