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

# Importar conteúdo web

> Treine seu agente com sites da internet

## Token de Acesso

<ParamField header="Authorization" type="string">
  Token de acesso ("Bearer" deve estar antes do token)
</ParamField>

## Descrição da requisição

<Warning> Alguns sites poderão ser bloqueados e a não poderão ser usados para treinamento.</Warning>

<ParamField body="unityId" type="uuid" required>
  Identificador único da unidade associada à base de conhecimento.
</ParamField>

<ParamField body="datasetId" type="uuid" required>
  Identificador do dataset onde o conteúdo será armazenado.
</ParamField>

<ParamField body="folderId" type="uuid" required>
  Identificador da pasta do dataset onde o conteúdo será armazenado.
</ParamField>

<ParamField body="url" type="string" required>
  URL da página que será processada e importada para o dataset.
</ParamField>

<ParamField body="limit" type="number">
  Limite máximo de páginas ou conteúdos que serão processados a partir da URL informada.
</ParamField>

## Descrição da Resposta

Abaixo você verá a descrição da resposta da requisição após a importação de conteúdo web

<ResponseField name="message" type="string" required>
  Mensagem de confirmação do status da operação.
</ResponseField>

<ResponseField name="folder" type="object">
  Informações sobre a pasta onde o conteúdo foi armazenado.

  <Expandable title="Propriedades de folder">
    <ResponseField name="id" type="string">
      Identificador único da pasta.
    </ResponseField>

    <ResponseField name="name" type="string">
      Nome da pasta de destino.
    </ResponseField>

    <ResponseField name="isRoot" type="boolean">
      Indica se a pasta é o diretório raiz.
    </ResponseField>

    <ResponseField name="knowLedgeBaseId" type="string">
      ID da base de conhecimento vinculada.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="urls" type="array">
  Lista das URLs que foram processadas para extração de conteúdo.
</ResponseField>

<ResponseField name="files" type="array">
  Lista de objetos representando os arquivos gerados a partir do conteúdo web.

  <Expandable title="Propriedades de cada item em files">
    <ResponseField name="id" type="string">
      Identificador único do arquivo gerado.
    </ResponseField>

    <ResponseField name="status" type="string">
      Estado atual do processamento (ex: PENDING, SUCCESS).
    </ResponseField>

    <ResponseField name="fileName" type="string">
      Nome técnico do arquivo no armazenamento interno.
    </ResponseField>

    <ResponseField name="maskName" type="string">
      Nome amigável ou exibido para o usuário, geralmente contendo a URL de origem.
    </ResponseField>

    <ResponseField name="url" type="string">
      Link público para acessar o conteúdo extraído.
    </ResponseField>

    <ResponseField name="size" type="number">
      Tamanho do arquivo em bytes.
    </ResponseField>

    <ResponseField name="extension" type="string">
      Extensão do arquivo gerado (ex: txt).
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Data e hora da criação do registro.
    </ResponseField>

    <ResponseField name="kbFolder" type="object">
      Detalhes da pasta associada ao arquivo específico.

      <Expandable title="Detalhes de kbFolder">
        <ResponseField name="name" type="string">
          Nome da pasta associada.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Segurança

Para acessar este endpoint, é necessário enviar um **token de acesso** válido através do cabeçalho de autorização (Authorization) da requisição. Além disso, a API é protegida por outras medidas de segurança para proteger os dados dos usuários.