> 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/como-adicionar-conteudos-na-fortics-ia.md).

# Como Adicionar Conteúdos na Fortics IA

## Criando o "Recipiente" da Fonte de Dados

A Fonte de Dados é o espaço responsável por organizar os conteúdos que alimentarão a IA. Uma boa organização garante mais precisão nas respostas e facilita a manutenção do conhecimento. 

Antes de fazer o upload de qualquer arquivo ou link, a interface exige a criação de um container organizador. Nesta etapa você cria uma fonte de dados, responsável por organizar os conteúdos que serão utilizados pela IA. Pense nesta etapa como o ato de criar e etiquetar uma pasta vazia no seu computador.

No painel administrativo da **Fortics AI**, navegue até o menu inicial e clique na opção **Meus Conteúdos.**

<img src="/files/cdvzExVXcbytyONW1d4P" alt="" height="303" width="602">

Localize e clique no botão **"+ Nova Fonte de Dados"**.

Dê um nome claro e focado em um único assunto para este conteúdo (Ex: Manual de Garantia de Produtos) e clique em **Salvar.**

<img src="/files/zUJ5zMGT5cLIqnJCskdf" alt="" height="927" width="332">

Assim que você clica em salvar, o sistema abre automaticamente a tela de gerenciamento desta nova fonte de dados, exibindo a barra de navegação por abas para que você possa iniciar a subir os documentos.

## Adicionando conteúdos à fonte de dados &#x20;

Dentro da tela da fonte de dados criada, a interface disponibiliza **cinco abas especializadas**. Cada aba foi projetada para receber formatos específicos de mídia. Veja abaixo como funciona cada uma delas e quais arquivos são aceitos.

### Arquivos (Upload de documentos)&#x20;

Esta aba é destinada ao carregamento de documentos locais armazenados diretamente no seu computador ou servidor. É o repositório ideal para manuais, catálogos e imagens da marca.

<img src="/files/E8R0M80dfGx7PrMH5nc9" alt="" height="301" width="602">

Clicando em adicionar conteúdos irão aparecer três opções para você:

* Arquivos de texto, PDF, imagens, Documentos do MS Office e mídias;
* Digitar texto online;
* Editar texto na hora.

#### Arquivos de texto, PDF, imagens, Documentos do MS Office e mídias

Selecionando a opção “Arquivos de texto, PDF, imagens, Documentos do MS Office e mídias” abrirá uma barra lateral como na imagem abaixo. Selecione ou arraste os arquivos que deseja carregar e clique em **Salvar.**

<img src="/files/fLP3ZXi9SQy9YIyLNnaU" alt="" height="926" width="359">

**Formatos Suportados:**

* **Documentos e Textos:** .txt, .pdf, .doc, .docx
* **Planilhas e Apresentações**: .xls, .xlsx, .ppt, .pptx
* **Imagens:** .png, .jpg, .jpeg
* **Áudios Locais:** .mp3, .m4a, .flac, .wav, .ogg
* **Vídeos Locais:** .mp4, .mov, .webm

#### Digitar texto online

Ao selecionar essa opção, você verá a barra lateral onde você pode ditar o conteúdo utilizando o botão de gravar ou digitar o texto que deseja adicionar.\
\
Ao ditar o texto, ele será transcrito no campo de texto para você poder validar e editar antes de salvar.

<img src="/files/uzkCYSGKNL7gOx8jqpNl" alt="" height="871" width="602">

Após concluir, é só salvar e o conteúdo será adicionado.

#### <mark style="color:$danger;">Editar texto na hora</mark>

### Estruturado

Utilizada para injetar dados que seguem um padrão rígido de colunas e linhas. Esta estrutura limpa permite que a IA realize cruzamentos de dados exatos e consultas analíticas precisas. Recomendado para bases de produtos, tabelas, catálogos ou informações que precisam ser consultadas de forma precisa pela IA.&#x20;

Os arquivos que podem ser carregados aqui são:

* Estruturados separados por vírgula (.csv).
* Consultas e dumps de banco de dados (.sql).

Para adicionar estruturados, selecione a aba **“Estruturados”** e depois clique em “**Adicionar conteúdo”.** Selecione entre as opções disponíveis (CSV e SQL).

<img src="/files/MJavT5o95W6JEQJNTI9b" alt="" height="301" width="602">

#### Estruturados CSV

Ao selecionar a opção CSV, uma barra lateral irá aparecer para você poder arrastar ou selecionar o arquivo CSV que deseja adicionar.

<img src="/files/o2erI0sIPFpwvAz6nV1C" alt="" height="927" width="365">

**Caractere separador de campos**

É importante selecionar o separador correto para os arquivos CSV. Isso garante que a plataforma interprete o arquivo corretamente, separando os dados pelas colunas.

{% hint style="info" %}
**##Importante**

Utilize a primeira linha do arquivo CSV para definir os títulos das colunas. Isso melhora a interpretação dos dados e aumenta a precisão das respostas da IA.&#x20;
{% endhint %}

#### Consulta SQL

Ao selecionar a opção SQL não vamos selecionar um arquivo SQL e sim conectar a uma base de dados externa.

<img src="/files/QrmEcsyqRBBq7z0PCFZW" alt="" height="787" width="602">

Na barra lateral que aparece você deve definir:

**Nome da consulta:** Defina um label para a consulta que está criando.

**Credencial do Banco de dados:** Selecione uma[ <mark style="color:$primary;">credencial cadastrada na plataforma</mark>](/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/gerenciando-credenciais.md).

**Consulta SQL:** Cole a SQL Query que deseja usar na consulta.

{% hint style="info" %}
**## Atenção**

A plataforma **não realiza uma busca varrendo o banco de dados de forma geral ou automática**. A inteligência artificial consome, aprende e se limita **estritamente às linhas e colunas que são retornadas pela consulta SQL exata que você estrutura e cola neste campo**.

Se a sua consulta (Query) traz dados incompletos, o robô não tem insumos para responder ao usuário final. Se a consulta traz dados excessivos ou desnecessários, há desperdício de processamento.
{% endhint %}

**Aprendizagem Continuada**

Como essa fonte de dados alimenta diretamente o motor de **Aprendizagem Continuada (quando ativada**), a plataforma passará a consultar periodicamente o seu banco de dados de forma automatizada para verificar e trazer novas atualizações para os seus arquivos e conteúdos. Por conta dessa rotina de checagem periódica, qualquer erro de sintaxe ou consulta incompleta que você deixar passar vai quebrar as sincronizações automáticas do robô. Isso fará com que ele pare de aprender com as atualizações e entregue respostas erradas ou baseadas em dados antigos para o cliente final. Clique em salvar apenas quando você tiver certeza de que a sua query está 100% funcional.

### Web

<img src="/files/JX2Fch2kdeeqgs5Mlj5f" alt="" height="301" width="602">

Aba voltada para a indexação de páginas da internet. Ao inserir um endereço eletrônico aqui, a inteligência mapeia o conteúdo textual visível daquela página.

Faça o cadastro das URLs de páginas institucionais, posts de blog com tutoriais, páginas de FAQ públicas ou centrais de ajuda online.

Existem duas formas de cadastrar URLs:

#### Cadastro Manual de URLs

Esta alternativa é ideal quando você quer ser cirúrgico e adicionar poucas páginas específicas, mantendo o controle total de cada endereço inserido.&#x20;

<img src="/files/ahqNQ22rvqtuSUQ3QYJm" alt="" height="924" width="547">

No campo Endereço de web, digite as urls exatas que deseja utilizar, sempre mantendo uma url por linha para o cadastro de múltiplas URLs.

#### Captura Automatizada via Discovery

Esta ferramenta foi desenhada para poupar tempo quando você precisa mapear um site inteiro ou selecionar várias páginas de uma vez só, eliminando o trabalho de copiar e colar dezenas de links manualmente.

Em vez de inserir link por link, **você digita apenas a URL da página inicial (*****Home*****)** do site no campo URL para ***Discovery*** e então clica no botão **Descobrir**.

<img src="/files/tswo1GmTSEM9tYTyDa5z" alt="" height="920" width="550">

A Fortics AI analisa o endereço informado e identifica automaticamente as páginas disponíveis no endereço fornecido e, em segundos, exibe uma lista com todas as páginas encontradas  dentro daquele domínio.

Com a lista gerada na tela, basta você marcar as caixas de seleção (*checkboxes*) ao lado de cada página que deseja adicionar à sua fonte de dados e descartar aquelas que não fazem sentido para o cérebro da IA. Depois clique em **salvar**.

Você então será redirecionado para o modo Manual com todas as URLs selecionadas.

<img src="/files/CyMqwYJ3AwJKwWS2cufa" alt="" height="926" width="554">

Agora basta confirmar as URLs e clicar em **Salvar** novamente para adicionar as páginas à sua base de conteúdos.

<img src="/files/EXxg0UT9cUDYwfuA8xjf" alt="" height="301" width="602">

Ao voltar para a lista, você verá todas as URLs salvas.

### YouTube (Integração de Vídeos)

Uma área exclusiva para conectar conteúdos audiovisuais hospedados na plataforma do YouTube. A inteligência consome a transcrição e os metadados do vídeo para transformá-los em conhecimento consultável. Recomendado para treinamentos, webinars e conteúdos em vídeo que já possuem transcrição.&#x20;

<img src="/files/XoOru48VTV1RyX7n7gMI" alt="" height="300" width="602">

**O que inserir:** Links diretos de vídeos de treinamentos internos, canais de tutoriais de produtos ou webinars públicos da empresa.

<img src="/files/Oaa7YwzrQXyukVx7GkNb" alt="" height="836" width="602">

### Áudio e Vídeo (URLs externas)

Diferente da aba "Arquivos" (onde você faz o upload do arquivo físico do seu computador), esta aba serve para apontar para mídias hospedadas em servidores externos, portais de streaming ou nuvens públicas via URL direta.

<img src="/files/SGtyfLQzcmZkxIs6Eq0G" alt="" height="299" width="602">

⚠️ **Regra Estrita de Interface (Atrito de Formato)**: Ao inserir os endereços de transmissão, é obrigatório incluir o protocolo de segurança completo **http\:// ou https\://.**

*Exemplo correto de preenchimento:* \[<https://www.conteudo.com/audio.mp3]\\(https://www.conteudo.com/audio.mp3)>

<img src="/files/OJw8Wn7zu4PlQWAAAjcz" alt="" height="931" width="370">

### Resultado esperado

Após adicionar os conteúdos, a Fonte de Dados ficará pronta para alimentar a Fortics AI com documentos, páginas web, vídeos e informações estruturadas, permitindo respostas mais precisas e uma gestão mais eficiente do conhecimento.

<br>


---

# 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/como-adicionar-conteudos-na-fortics-ia.md?ask=<question>&goal=<endgoal>
```

`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.