---
title: Library
description: Um navegador estilo Drive para o filesystem compartilhado da sua organização
icon: Folder
---

import Callout from "../../../../components/ui/Callout.astro";

## O que é a Library?

A **Library** é um navegador de arquivos para o filesystem compartilhado da sua organização — acessível pela aba **Library** no topo do painel principal. É a janela voltada para pessoas sobre os mesmos arquivos que seus agents leem e escrevem: tudo o que um agent salva no filesystem da org aparece aqui, e tudo o que você solta aqui fica disponível para seus agents.

Pense nela como o drive compartilhado da sua organização, com algumas áreas bem conhecidas.

## Sua pasta home

A Library abre na pasta da sua própria organização, com o nome da sua org. Ela é compartilhada e de formato livre: é aqui que os agents registram conhecimento durável e onde você guarda o contexto que quer deixar ao alcance de todos os agents. Todo mundo na org pode editar.

### Pastas de sistema

Três pastas dentro dela são preenchidas pelo produto, não à mão. Elas têm um ícone de pasta cinza distinto, fácil de diferenciar das pastas que seu time criou:

- **uploads** — arquivos anexados a conversas caem aqui automaticamente. Quando você solta um arquivo num chat, ele fica disponível para o agent sem nenhum passo de cópia.
- **outputs** — arquivos que um agent produz durante uma execução aparecem aqui, agrupados por execução.
- **skills** — conjuntos de skills curados e somente leitura, sincronizados a partir de repositórios versionados, expostos para os agents consultarem. Somente leitura: eles são atualizados a partir da fonte no GitHub, não editados aqui.

Por baixo dos panos são volumes separados (veja a tabela de mounts abaixo), mas você navega por eles como uma única árvore.

### Navegação

Navegue pelos breadcrumbs — a trilha sempre começa na pasta da sua org e é o único lugar em que a pasta atual é nomeada. A localização atual é refletida na URL da página, então você pode mandar para um colega o link direto de uma pasta.

A busca acompanha você: na tela inicial ela busca todos os arquivos da org, e dentro de uma pasta ela busca só aquela pasta e tudo abaixo dela (o placeholder diz qual dos dois). Um feed de **Recently added** que cruza todos os volumes fica no final da tela inicial, para você voltar rapidamente a qualquer coisa que você (ou seus agents) tocou por último.

Você pode arrastar e soltar arquivos diretamente em qualquer pasta editável para fazer upload.

## Brands

A Library tem suporte nativo para **org brands** — uma pasta de identidade estruturada que seus agents e a skill de slides usam para produzir outputs on-brand.

Uma brand fica em `org/home/brands/<nome>/` e contém quatro arquivos:

| Arquivo | Propósito |
|---|---|
| `tokens.css` | Variáveis CSS para cores, tipografia, espaçamento, raio e sombra |
| `brand.md` | Diretrizes escritas da marca: voz, tom e notas de identidade visual |
| `logo` | Arquivo de logo (SVG, PNG ou similar) |
| `slides-theme.html` | Um deck de exemplo que também serve como shell de geração para a skill de slides |

### Criando e editando uma brand

Brands aparecem como cards diretamente na Library. Clique em um card de brand para abrir o **editor no painel lateral**, que permite:

- Editar paletas de cores (primária, secundária, neutros) com preview em bandas em tempo real
- Ajustar tipografia, espaçamento, raio e sombra
- Escrever ou refinar as diretrizes de voz e tom da marca
- Visualizar a brand aplicada a um deck de exemplo e componentes de UI em tempo real

Para criar uma brand do zero, peça para qualquer agent: *"Crie uma brand para [nome]"* — agents com acesso à skill `core/brand` vão montar toda a estrutura de pastas e populá-la com valores iniciais sensatos.

<Callout type="tip">
  O arquivo `slides-theme.html` dentro de uma pasta de brand funciona ao mesmo tempo como shell de geração e deck de exemplo editável. Modificá-lo diretamente muda o ponto de partida de todos os decks que a skill de slides gera com essa brand.
</Callout>

## Sharing

Arquivos e pastas no volume Home podem ser compartilhados fora da sua organização. Cada nó tem um **modo de compartilhamento**, definido pelo menu de contexto ou pelo ícone de compartilhamento no seu card:

| Modo | Quem pode acessar |
|---|---|
| **Org only** | Apenas membros da organização (padrão) |
| **Public** | Qualquer pessoa com o link — sem necessidade de login |
| **Password** | Qualquer pessoa com o link que inserir a senha correta |

Um badge no card reflete o modo de compartilhamento atual. Para nós protegidos por senha, o link compartilhado abre um formulário de senha antes de servir o conteúdo; um desbloqueio bem-sucedido cobre o nó e toda a sua subárvore (para pastas) durante a sessão do navegador.

<Callout type="tip">
  Uma senha é definida no nível da pasta e cobre tudo dentro dela. Arquivos dentro de uma pasta protegida por senha herdam a senha da pasta pai — não é possível sobrescrever com uma senha diferente em um nó filho.
</Callout>

<Callout type="warning">
  Arquivos que herdam o compartilhamento de um pai mostram um indicador somente leitura "shared via a parent folder" em vez dos controles de compartilhamento. Altere o modo de compartilhamento do pai para afetá-los.
</Callout>

## Como ela mapeia para o sandbox

A Library e o sandbox do agent são duas visões do mesmo filesystem. A Library nomeia sua pasta home com o nome da sua org e aninha as pastas de sistema dentro dela, mas os caminhos que os agents usam nunca mudam — eles são montados em `org/`:

| Pasta na Library | Caminho no sandbox |
|---|---|
| `<sua-org>` (home) | `org/home/` |
| `<sua-org>/uploads` | `org/upload` |
| `<sua-org>/outputs` | `org/output` |
| `<sua-org>/skills/<set>` | `org/public/<set>` |

Arquivos escritos na sua pasta home e em outputs sincronizam com o cloud storage da sua organização e ficam visíveis para todos os membros e agents. Mudanças externas aparecem dentro de um sandbox em execução em cerca de um segundo.

<Callout type="info">
  Para entender como os agents usam essas pastas em runtime — registrando conhecimento durável, lendo anexos de chat, escrevendo o output de uma execução — veja [Decopilot → Visão geral](/pt-br/studio/decopilot/overview#built-in-tools).
</Callout>
