Add knowledge

Knowledge helps an agent reason over material that is specific to your work. It does not replace clear instructions, and more files are not automatically better.

Choose the right location

Open Knowledge in the sidebar. Use My Library for private working material, and Workspace Library for material that workspace members should discover and reuse. The library tab is available in shared workspaces, even before you invite another member. Personal workspaces show only My Library.

Publishing a file to the workspace library is an intentional sharing action. Review the file for sensitive or irrelevant content first.

Upload and check processing

Upload files into the location and folder where you want to keep them. Queued uploads continue when you navigate to another page in Guest Machines and keep their original workspace and destination. Keep the browser tab open until the queue finishes.

An upload or saved edit can still be processing after the request is accepted. Check its progress before relying on the updated content. If a save is still processing, keep your draft until completion is confirmed; submitting the same edit again can create unnecessary work. A failure to refresh processing status does not mean the file itself failed to upload. Retry the status refresh and inspect any reported file error before uploading another copy.

Publish and maintain shared material

When you have permission to publish, use Publish to Library in a file's details panel or its right-click menu. Publishing an individual file from a private folder places it at the top level of the workspace library; its private parent folder stays private. Publishing a folder shares its files and subfolders too.

Shared material must be unpublished before it can be edited, renamed, moved, or deleted. If you manage the item, choose Unpublish to return it to the owner's private files. Other members lose access, including agents that depended on that shared material. Publish it again when the changes are ready.

Copy a file

To work on a Workspace Library file without changing the shared one, right-click it and choose Copy to My Library. To duplicate one of your own files, right-click it in My Library and choose Make a Copy: the copy appears in the same folder as "name (copy)". Either way the copy is private to you, and you can edit, rename, move, or delete it like any of your files.

A copy carries the file's content and details and is ready to use at once. Comments and sharing stay with the original, and so does agents' knowledge access: an agent narrowed to selected files doesn't read the copy until you add it. A copy counts toward your Knowledge storage. A file that is still processing can be copied once it's ready.

Understand storage limits

Every workspace has a shared Knowledge storage limit. Files in My Library and Workspace Library both count toward it, and an upload starts using space as soon as it begins. You can see the workspace total, available storage, file count, and uploads still being processed on Usage. The Usage menu in the sidebar and the bottom bar in Knowledge also show a quick storage summary.

In a shared workspace, admins and owners can open Settings → Members to see how much Knowledge storage each active member is using. They can also set a personal limit for a member. A personal limit controls how much of the shared storage that person can use; it does not add storage or reserve that amount for them.

When either the workspace limit or your personal limit is reached, you cannot start another upload. Remove Knowledge files you no longer need, or ask a workspace admin for help. During the free beta, you are not charged, but storage limits still apply.

Reuse a run file

Open Run Files, or open the run that created a run output. Preview it first when that option is available, then choose Add to Knowledge. Select My Library or Workspace Library, then browse to the folder where the copy should live.

You do not need to download and upload the file yourself. Knowledge keeps an independent copy, so removing the original file later does not remove the Knowledge file. When the source was created by a run, the Knowledge file also links back to that run.

Adding a file is always an explicit action. Review agent-created material first: incorrect, stale, or adversarial content can make later answers less reliable.

Use a file in a chat

In a chat, choose +, then Add From Knowledge, and select files from My Library or Workspace Library. Each file is attached to your message as a copy, just like a file you upload: the agent reads that copy in this chat whatever its knowledge access, and later changes to the file in Knowledge don't change it. Choose Upload Files from the same menu to attach a file from your device instead.

Once a message is sent, select one of its files to open it in a new tab: an image or PDF opens there, and any other file downloads. Images show a thumbnail, and hovering a file shows its full name. If the file was deleted, or the chat is no longer yours to read, the file says it is no longer available.

Organize for retrieval

Group files by stable subject rather than by temporary project activity. Prefer descriptive filenames and remove duplicate or superseded versions.

Supported files can be previewed directly in the knowledge workspace. Use folders to keep related sources together and make ownership obvious.

The files you have open in each library come back open the next time you visit, separately for each workspace. If one doesn't load, for example while you're offline, its tab stays, says so and offers Try Again. A tab closes by itself only when its file was deleted or you can no longer open it, and Knowledge tells you when that happens.

Right-click a file and choose View Details to inspect that file's metadata, including its size, location, and sharing state.

To move private files or folders, drag them onto a folder, or into empty space in the file tree to move them to the top level. Or right-click and choose Move to…, then pick a folder in My Library and choose Move. A folder moves with everything in it, and a move that would put two items with the same name side by side is stopped so you can rename one first.

Everything in the file tree also works from the keyboard. The arrow keys move through it, Right and Left open and close folders, and Shift with an arrow selects a range. To add a row that isn't next to the others, move to it with Ctrl or Cmd and an arrow, then press Ctrl or Cmd and Enter. Press Shift+F10, or the Menu key, for the same menu a right-click opens. In Move to…, the arrow keys choose a folder, Enter moves the selection there, and Escape cancels.

Agents can narrow Knowledge by file type, category, dates and tags, and by place. A photo that carries a GPS position gets its city and country when it's added, so an agent can look for files from a city or country, or near a point: within 10 km unless it asks for another radius, up to 20,000 km. A radius an agent sends with a city or country but no point is dropped, because the place already narrows the search. A radius with no place and no point is refused rather than quietly ignored, since nothing would narrow the search at all.

An agent reads Knowledge only when its knowledge access is on; it is off for a new agent. A private agent can read your My Library and the Workspace Library. An agent shared with the workspace, or restricted to people you add, reads only the Workspace Library, so publish what it needs. See choose the agent's knowledge access to turn it on or narrow it to selected files and folders.

Validate with source-specific questions

Ask the agent questions whose answers are present in the uploaded material, then test a question the material does not answer. A reliable agent should distinguish retrieved facts from assumptions.

When an answer is wrong, inspect the source material before adding more instructions. Contradictory or stale files often cause the problem.

Discuss a file and mention people

Open a file's details panel to read or add comments. The file's owner receives an in-app notification when another person or an agent adds a comment. Type @ to choose someone who already has access to the file; arrow keys move through the list, Enter selects a person, and Escape closes the picker. Mentioning someone never grants access. Mentions in quotes, code, or agent-authored comments are inert.

An owner who is also mentioned receives one notification for the comment. Choose Mute Discussion in the comments panel to stop this file's notifications, including mentions. Unmute Discussion restores notifications for future activity. Open the notification center from the bell to see activity across your workspaces and jump directly to the relevant comment.