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

# File Library

> Organize shared team files in file spaces and decide which files each Agent may use.

The **File Library** is the shared home for files your team wants to keep. It
is separate from the
[Temporary workspace](/agents/work-environments) used to complete a task.

## What the File Library is

Use the File Library for source documents, shared references, and finished
work that people or [Agents](/agents/overview) will need again.

You can upload, preview, download, rename, move, and delete files. Folders help
you keep related work together.

## Organize with file spaces

A **file space** is a top-level area inside the File Library. Create one for a
project, topic, or access boundary—for example, “Brand,” “Customer Research,”
or “Finance Reports.”

Choose names that make sense to the whole team. Use folders inside a file
space for smaller sections.

<Steps>
  <Step title="Open File Library">
    Open the workspace and choose **File Library**.
  </Step>

  <Step title="Create a file space">
    Choose **New file space**, enter a clear name, and make it the default only
    if most new files should go there.
  </Step>

  <Step title="Add files or folders">
    Upload existing files or create folders before adding more material.
  </Step>
</Steps>

## Work with files

Select a file to preview it when the format is supported. Download it when you
need the original or when browser preview is not available.

Renaming and moving help keep things tidy. Deleting a file or file space is
permanent, so check the selection before confirming.

## Give an Agent access

An Agent does not need every file. Open its
[access settings](/administration/access-approvals), choose the file space
it needs, and allow only the actions required for the job:

* read files;
* create or update files;
* delete files.

For many roles, read and write access is enough. Add delete access only when
removing files is part of the Agent's responsibility.

## Know where files live

| File location            | Use it for                                            |
| ------------------------ | ----------------------------------------------------- |
| File Library             | Shared files and results the team needs again         |
| Task attachment          | Material for one conversation                         |
| Dedicated cloud computer | One Agent's ongoing working files and installed tools |
| Temporary workspace      | Short-lived work during one conversation              |

<Tip>
  **Save the result where it will be used**

  If another person or Agent will need the result later, place it in the right
  file space instead of leaving it only inside a conversation.
</Tip>