> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/criando-uma-base-de-conhecimento.md). # Criando uma base de conhecimento A **Base de Conhecimento** é responsável por centralizar e organizar os conteúdos utilizados pelos seus Agentes de IA na Fortics AI. Mais do que um conjunto de arquivos, ela funciona como uma camada de conhecimento que reúne os documentos, links e demais conteúdos adicionados à plataforma. Os Agentes de IA utilizam exclusivamente as informações presentes nas Bases de Conhecimento às quais estão vinculados. Dessa forma, as respostas são geradas com base nos conteúdos definidos pela sua operação, garantindo mais controle, consistência e segurança nas informações apresentadas ao cliente final. Organizar Bases de Conhecimento por contexto ou departamento, como Comercial, Suporte Técnico ou RH, ajuda a aumentar a precisão das respostas, manter os conteúdos centralizados e facilitar a gestão do conhecimento da empresa. ## Como criar uma base de conhecimento No painel administrativo da **Fortics AI**, navegue até o menu inicial e clique na opção **Conhecimentos**. Localize e clique no botão "**Adicionar conhecimento**". Uma barra lateral irá aparecer com as opções disponíveis para criar a sua nova base. **Nome do conhecimento**: O campo de texto padrão para identificar e rotular esta biblioteca específica dentro do sistema. **Documentos**: O componente de associação que conecta a Base aos seus dados brutos. Aqui você pode selecionar múltiplos conteúdos para montar a sua base de conhecimento. **Customizar prompt**: O campo "Customizar prompt" permite especificar o objetivo do conhecimento, sendo utilizado apenas para testes na **Sandbox**. As instruções inseridas aqui não são herdadas pelos Agentes de IA em produção. {% hint style="info" %} **## Importante** **As instruções escritas no campo “Customizar prompt” NÃO serão utilizadas ou herdadas pelos Agentes de IA na ponta.** As diretrizes definitivas de comportamento, persona e tom de voz do robô devem ser configuradas exclusivamente [*dentro do módulo de Agentes*](/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/criando-e-editando-agentes.md). Utilize este campo aqui apenas para validar se os documentos integrados estão respondendo corretamente sob uma simulação prévia de prompt. {% endhint %} ### Opções avançadas As opções avançadas permitem refinar o comportamento de resposta da Inteligência Artificial e automatizar a manutenção preventiva dos dados através de regras de sincronização periódica. Ative a opção destacada pela seta na imagem abaixo. **Criatividade**: Controla o nível de fidelidade e variação das respostas geradas pelo robô em relação aos documentos inseridos. {% hint style="info" %} **## Informação** **Como funciona a criatividade:** Um seletor deslizante (*slider*) que varia entre Mínima, Média e Muita. Ao configurar para a **Mínima** você força a IA a ser estritamente literal e objetiva com os dados fornecidos. Movendo para **Muita criatividade** (valores mais altos) deixa as respostas da IA com um tom mais "humano", fluido e variado, porém com maior risco de perder a objetividade técnica.\ \ **##Dica**\ Mantenha níveis baixos para bases corporativas e de suporte. {% endhint %} **Máximo de documentos**: Define o limite máximo de fragmentos de conteúdos ou arquivos que a IA pode ler e cruzar simultaneamente para formular uma única resposta ao cliente final. **Modelo de Particionamento**: O modelo de particionamento define como os conteúdos serão divididos internamente para facilitar a busca e melhorar a qualidade das respostas. Ele determina a estratégia de quebra de texto (divisão em blocos ou *tokens*) que o mecanismo de processamento aplicará aos arquivos enviados. Ele dita o tamanho dos pedaços de informação em que seus PDFs ou queries SQL serão recortados para armazenamento na memória da IA. As opções de particionamento são: **Com sobreposição:** A partição irá incluir partes de outras partições para ajudar no contexto. **Sem sobreposição**: A partição não incluirá partes de outras partições para o contexto. ### Aprendizagem continuada A **Aprendizagem Continuada (*****Continuous Learning*****)** permite manter a Base de Conhecimento atualizada automaticamente, sem a necessidade de realizar novos processamentos manuais sempre que houver alterações nas fontes de dados originais. Esse recurso é especialmente **indicado para conteúdos dinâmicos, como sites institucionais ou consultas SQL conectadas a sistemas externos**. Quando ativada, a plataforma verifica periodicamente essas fontes e processa as alterações encontradas, garantindo que os Agentes de IA utilizem informações mais recentes e consistentes. Para ativar a funcionalidade, clique no botão ***Continuous Learning,*** indicado pela seta na imagem abaixo. Ao habilitar a opção, serão exibidas as configurações de agendamento e processamento automático. {% hint style="info" %} **## Importante** Conforme indicado pela interface na linha "*Slots disponíveis: 2 de 2*", cada conta ou ambiente possui um limite restrito de uso: **você pode ter no máximo duas bases de conhecimento com a Aprendizagem Continuada ativada simultaneamente**. Planeje estrategicamente quais bases realmente necessitam de atualizações automáticas e periódicas antes de esgotar seus slots. {% endhint %} **Modo de Processamento:** Define o comportamento do sistema no momento em que o agendamento for disparado para ler as atualizações: * **Limpa conteúdo e processa**: Remove totalmente o cache e os dados processados anteriormente antes de iniciar uma nova leitura. Ideal para garantir uma limpeza completa de dados antigos. * **Processa novos conteúdos:** Mantém o que já foi processado intacto no banco de dados da IA e foca o processamento única e estritamente no que for detectado como novo na origem. **Seleção de Horários**: Campos para definir **Hora** e **Minutos** seguidos pelo botão azul "**Adicionar horário"**. Permite determinar o momento exato do dia em que a plataforma executará a varredura automática no seu banco de dados ou links (máximo de 1 intervalo por modelo). **Limite por Dias da Semana (Grade de Seleção Rápida)**: Se você deixar todos vazios, o sistema assumirá que a sincronização deve rodar todos os dias da semana. Caso queira executar a sincronização apenas em dias úteis, por exemplo, basta selecionar de Segunda a Sexta. **Limite por Meses**: Da mesma forma que no campo anterior, deixe vazio para indicar que a automação funcionará durante todos os meses do ano sem interrupção. Caso selecione os meses, o processamento acontecerá somente nos meses selecionados. ### Salvando a base Depois de definir todas as opções acima é só clicar no botão de salvar e sua nova base de conhecimento será criada. ## Verificando as bases com aprendizagem continuada Na lista de bases de conhecimentos, as bases com o ícone de timer indicado na imagem abaixo, são as bases com a aprendizagem contínua ativas. Isso é importante para você encontrar as com essa opção ativada, já que existe o limite de 2 para essa funcionalidade. ## Atualizando base de conhecimento Embora o ecossistema da **Fortics AI** conte com ferramentas automatizadas como a Aprendizagem Continuada, existem momentos em que você, como administrador, precisará forçar uma atualização imediata na inteligência do seu sistema. Isso acontece quando você acaba de fazer um upload crítico de novos arquivos ou quando altera regras de negócio urgentes em seus Conteúdos e não pode esperar pelo próximo ciclo de checagem automática. Para dar total controle a você, a interface disponibiliza comandos diretos na **listagem de bases de conhecimento criadas.** Esses comandos devem ser ativados manualmente, base por base, permitindo que você dite exatamente como o motor de indexação deve atualizar os conteúdos processados. ### Processamento manual Ao acessar a sua listagem de bases e disparar a atualização de uma base específica, a interface apresentará duas mecânicas distintas de processamento. A escolha entre elas depende do cenário atual dos seus dados: #### Processar novos conteúdos Aciona uma atualização incremental que foca apenas no que mudou. O motor da Fortics AI mantém intacto todo o conhecimento que já foi processado e armazenado anteriormente. Ele analisa a sua fonte de dados, identifica apenas os novos arquivos, links ou linhas de SQL que foram adicionados desde a última atualização e processa exclusivamente esse bloco inédito. É a opção ideal para o dia a dia. Por ser uma atualização incremental, o processo é extremamente rápido, economiza recursos e garante que as novidades fiquem disponíveis para o seu Agente de IA em poucos segundos. Após clicar no ícone destacado acima você deve confirmar o processamento. Tenha em mente que essa é uma ação irreversível. #### Limpar conteúdo e processar (Recriação Completa de Cache) Antes de iniciar a leitura dos documentos, o sistema limpa totalmente o cache e deleta todos os dados processados anteriores vinculados àquela base. Com o terreno 100% limpo, o motor refaz a leitura analítica de absolutamente todos os conteúdos associados do zero, gerando novos blocos de informação utilizados pela IA (*embeddings*). Utilize esta opção quando você fizer mudanças estruturais profundas (como deletar muitos arquivos antigos, alterar radicalmente o texto de um manual ou reestruturar as colunas de uma consulta SQL). Ela evita que informações desatualizadas continuem guardadas no cache da IA, garantindo uma base totalmente limpa e livre de dados defasados. Após clicar no ícone destacado acima você deve confirmar o processamento. Tenha em mente que essa é uma ação irreversível. ## Editando a base de conhecimento Para garantir que você tenha total autonomia e agilidade no gerenciamento diário, a interface permite modificar qualquer configuração de uma base que já esteja ativa. Identifique a Base de Conhecimento que deseja modificar e mova o cursor até o final da linha correspondente, onde ficam os botões de ação técnica. Clique no ícone de lápis para **Editar.** Ao clicar neste ícone o sistema abrirá exatamente a **mesma janela utilizada no momento da criação** da base, mas com os dados da Base que deseja editar. Faça as modificações necessárias e clique em **Salvar.** {% hint style="danger" %} **## Atenção** Ao editar e salvar uma base de conhecimento, lembre-se de solicitar um novo processamento para atualizar a sua base com as novas opções selecionadas. {% endhint %} ## Removendo a base de conhecimento Caso uma Base de Conhecimento não seja mais necessária, ela poderá ser removida definitivamente. Para manter o seu painel limpo e otimizado, a interface permite a exclusão dessas bibliotecas, mas exige atenção redobrada do administrador devido ao impacto direto na operação. A ação de remover uma Base de Conhecimento é **100% irreversível**. Todos os agrupamentos lógicos, índices e parâmetros avançados configurados nela serão apagados definitivamente do painel. Na tela de listagem, ao identificar a base que deseja apagar, você deve clicar no **ícone da lixeira** destacado na imagem acima. Você precisará clicar explicitamente no botão de confirmação dentro desse popup para que o sistema execute a exclusão definitiva no banco de dados. #### Mantendo uma base sem removê-la Como a plataforma **não possui um botão de "Ativar/Desativar"** para congelar temporariamente uma base, você deve avaliar a sua real necessidade antes de confirmar a exclusão no popup. Se o seu objetivo é apenas pausar o uso daquela inteligência sem perder as configurações feitas. Em vez de remover a base do sistema, **basta você entrar na tela de configuração do seu Agente de IA** **e remover a associação da base com ele.** {% hint style="danger" %} **## Importante** Lembre-se de que se uma Base de Conhecimento existir no seu painel, mas não estiver explicitamente associada a nenhum Agente ativo, ela estará completamente inativa e não será utilizada em nenhuma interação na ponta. Essa é a melhor forma de criar um "recesso" para os seus dados sem correr o risco de apagá-los por engano.
{% endhint %} #### Resultado esperado Após concluir a configuração, a Base de Conhecimento ficará pronta para ser utilizada pelos Agentes de IA. Caso a Aprendizagem Continuada esteja habilitada, os conteúdos também poderão ser atualizados automaticamente conforme os agendamentos configurados.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/criando-uma-base-de-conhecimento.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.