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

# Visão geral do conhecimento: dar contexto aos agentes com documentos

> Saiba como funciona o conhecimento (Knowledge) no Kolmena. Carregue documentos, organize pastas e controle que agentes, swarms e a Maya podem aceder aos seus ficheiros para dar respostas mais acertadas.

O conhecimento (Knowledge) no Kolmena é a biblioteca de documentos, ligações e texto que fornece para que os seus agentes (e a Maya) possam responder a perguntas, seguir instruções e tomar decisões com contexto real. Gere tudo na página **Knowledge**, onde pode carregar ficheiros, colar texto, adicionar ligações web, organizar pastas e escolher exatamente quem tem acesso.

[Knowledge: Full Walkthrough](https://www.youtube.com/embed/LCEAay0MjiY)

## O que pode adicionar ao conhecimento

O Kolmena aceita vários tipos de recursos para que possa trazer o contexto de que os seus agentes precisam:

| Tipo | Para que serve |
| - | - |
| **Files** | Documentos, ficheiros de código, imagens, áudio e vídeo. Arraste e largue ou procure os ficheiros para os carregar. |
| **Text** | Cole texto livre diretamente quando não tiver um ficheiro à mão. |
| **Link** | Adicione até 20 URLs de cada vez. Cada página é obtida e guardada como Markdown pesquisável. |

> [!NOTE]
>
> Existe um limite de tamanho por ficheiro. Se um ficheiro for demasiado grande, divida-o em ficheiros mais pequenos e carregue-os novamente.

## A página Knowledge e as bibliotecas

Quando abre **Knowledge** a partir da barra lateral, trabalha dentro do âmbito de uma biblioteca. Pode alternar entre bibliotecas para gerir conteúdos de diferentes contextos:

* **Conhecimento do agente ou do swarm**: recursos associados diretamente a um único agente ou swarm.
* **Shared Knowledge**: uma biblioteca central que pode partilhar com qualquer um dos seus agentes e swarms.
* **Archive**: um espaço para os documentos que retirou de uso ativo. Pode restaurar os itens arquivados ou eliminá-los definitivamente.

Use o seletor de âmbito na página Knowledge para alternar entre estas bibliotecas.

## Organizar com pastas

Mantenha o seu conhecimento arrumado criando pastas. Pode dar nomes às pastas, mover documentos entre elas e arquivar ou eliminar itens em bloco. As pastas ajudam os agentes a encontrar mais depressa o contexto certo, sobretudo quando a biblioteca cresce.

## Como os agentes obtêm acesso

Por predefinição, nada é concedido. É você que controla o acesso por documento ou para toda a biblioteca Shared Knowledge:

* **Por documento**: abra as definições de acesso de um documento e escolha que agentes e swarms o podem usar.
* **Shared Knowledge**: conceda acesso a todos os agentes e swarms de uma só vez nas definições da biblioteca.

> [!WARNING]
>
> A opção "All agents" nunca inclui a Maya. Se quiser que a Maya use um documento, conceda-lhe acesso explicitamente.

Os agentes e swarms com acesso podem recorrer ao seu conhecimento durante as conversas, as execuções de jobs e a realização de tarefas. Pode ver quanto conhecimento está a ser processado e consultado na página de [utilização e registos](https://docs.kolmena.ai/pt/account/usage-and-logs.md).

## Processamento e estado

Depois de carregar ou adicionar um recurso, o Kolmena processa-o automaticamente para que os agentes o possam pesquisar e consultar. Durante o processamento, pode ver estados como:

* **Waiting**: à espera na fila de processamento.
* **Processing**: o documento está a ser preparado para pesquisa.
* **Pronto**: o documento está disponível para os seus agentes.
* **Falhado**: algo correu mal (por exemplo, o ficheiro está danificado, é demasiado grande ou não contém texto legível). Pode voltar a tentar manualmente os documentos que falharam.

## Próximos passos

> [card] [Adicionar documentos](https://docs.kolmena.ai/pt/knowledge/add-documents.md)
>
> Carregue ficheiros, cole texto ou adicione ligações web à sua biblioteca de conhecimento.

> [card] [Criar um agente](https://docs.kolmena.ai/pt/agents/create-an-agent.md)
>
> Crie um agente personalizado e dê-lhe acesso ao conhecimento de que precisa.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.