> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.basement.chat/pt-br/concepts/documents-files-and-skills/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.basement.chat/_mcp/server.

# Documentos, arquivos e skills

## Documentos

Um documento é uma página em markdown: seu perfil de cliente ideal, suas regras de preço, um processo. Os documentos pertencem à organização, e todos os membros veem.

Cada alteração em um documento cria uma nova versão. Você pode listar as versões e restaurar uma delas. O Basement registra qual versão cada agente leu, e assim você vê quando um agente está trabalhando com uma versão desatualizada.

| Para fazer isto                  | Use                                        |
| -------------------------------- | ------------------------------------------ |
| Listar e ler                     | `list_docs`, `read_doc`                    |
| Criar                            | `create_doc`                               |
| Substituir o corpo               | `update_doc`                               |
| Alterar um trecho do texto       | `edit_doc`                                 |
| Renomear, excluir                | `rename_doc`, `delete_doc`                 |
| Ver e restaurar versões          | `list_doc_versions`, `restore_doc_version` |
| Ligar ou desligar o link público | `share_doc`                                |

Um documento com link público pode ser lido por qualquer pessoa que tenha o link, sem login. O link entrega o documento como página para pessoas e como markdown para agentes.

## Arquivos

Um arquivo é qualquer coisa que você envia: um PDF, um logo, uma planilha, um arquivo de texto. Pelo Gateway, é possível gravar arquivos de até 5 MB. Substituir um arquivo cria uma nova versão.

`read_file` responde os dados do arquivo e um link temporário para baixar. Para um arquivo de texto de até 256 KB, responde também o texto.

| Para fazer isto                          | Use                       |
| ---------------------------------------- | ------------------------- |
| Listar e ler                             | `list_files`, `read_file` |
| Enviar um arquivo, ou uma nova versão    | `write_file`              |
| Alterar um trecho de um arquivo de texto | `edit_file`               |

## Skills

Uma skill é um arquivo de texto com instruções que um agente carrega quando precisa: como pesquisar uma conta, como responder um tipo de chamado. Skills são arquivos de um tipo próprio.

| Para fazer isto                  | Use           |
| -------------------------------- | ------------- |
| Listar                           | `list_skills` |
| Ler                              | `read_file`   |
| Criar, ou gravar uma nova versão | `write_skill` |
| Alterar um trecho                | `edit_skill`  |

## Pastas

Arquivos e skills ficam em pastas. Todos os membros veem a pasta **Geral**. Uma pessoa pode criar outras pastas, que são privadas até ela compartilhar com membros ou com a organização.

Uma chave alcança as pastas que a pessoa que conectou a chave alcança, e um nível de acesso pode limitar a chave a algumas delas. Um arquivo em uma pasta que a chave não pode usar aparece como não encontrado.

| Para fazer isto                                   | Use                                            |
| ------------------------------------------------- | ---------------------------------------------- |
| Listar as pastas que a chave pode usar            | `list_folders`                                 |
| Criar uma pasta privada                           | `create_folder`                                |
| Colocar um arquivo ou uma skill nova em uma pasta | `folderId` em `write_file` e `write_skill`     |
| Compartilhar uma pasta                            | `share_folder` e depois `confirm_folder_share` |

Uma chave não compartilha uma pasta sozinha. `share_folder` só faz o pedido: o Basement envia por e-mail um código de 6 dígitos para a pessoa que conectou a chave, e nada é compartilhado até `confirm_folder_share` receber esse código. Assim, uma pessoa sempre aprova o compartilhamento.

## Encontrar texto sem ler tudo

Três ferramentas evitam que um agente carregue um documento grande só para achar uma linha:

* `search` encontra documentos por título e corpo, e arquivos e skills por nome e tags.
* `find_text` encontra uma frase dentro de um documento ou arquivo de texto, e responde as linhas que batem, com os números delas.
* `read_lines` lê um intervalo de linhas.

Para alterar um documento, uma skill ou um arquivo de texto, `edit_doc`, `edit_skill` e `edit_file` substituem um trecho do texto. Informe o texto antigo exatamente como está. Ele precisa aparecer uma única vez.

> O conhecimento que sua organização guarda no Basement, e como agentes e programas usam esse conhecimento.