Add knowledge
Give agents focused source material without creating an unmanageable file dump.
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 Files 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 Files.
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 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.
Understand storage limits
Every workspace has a shared Knowledge storage limit. Files in My Files 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 Files 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.
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.
Right-click a file and choose View Details to inspect that file's metadata, including its size, location, and sharing state. To move a private file or folder to the top level, drag it into empty space in the file tree.
An agent can use a selected set of files and folders from both My Files and the Workspace Library. See choose the agent's knowledge access to configure that selection.
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.