Skip to main content

xAgent Workspace Files: Materials, Results, and Downloads

Workspace Files supports the full path from uploading and referencing materials to checking, downloading, or reusing results. Confirm that a file belongs to the current task before checking its contents and delivery format.

From Materials to Delivery​

  1. Upload a File, wait for completion, and describe the required scope.
  2. Reference a File using its visible name or readable path.
  3. View Results and confirm the file mentioned in the Session was saved.
  4. Preview and Download, checking content, charts, text, and sensitive information.
  5. To make further changes, reuse the existing output and specify the new goal.

Upload acceptance, model reading, and UI preview have different boundaries. Office text extraction is not original-layout rendering, and a scanned PDF preview does not establish extractable text. See Supported Agent Capabilities for formats and limits.

Who This Is For​

This page is for users who need to upload files, view outputs, preview reports, or reuse task materials.

What It Is​

The workspace is where xAgent saves task materials and results. Files you upload, generated Markdown, CSV files, HTML reports, and intermediate results will usually appear in Workspace Files.

xAgent isolates files by user and task scope. When an external command runs, an Execution Lease creates the minimum file view and ProcessSandbox mounts only paths authorized for that task. In everyday use, focus on the files visible on the page.

In v0.0.20.beta, files created by process Tools are committed to the Workspace correctly and Session drafts remain visible inside the sandbox. Access remains limited to the task's authorized scope.

When to Use It​

Use the workspace when you need to:

  • Let a task read files, spreadsheets, PDFs, documents, or images.
  • Generate a downloadable file.
  • Preview an HTML report or another output.
  • Reuse existing materials in a later session.
  • Confirm whether a result has been saved.

Basic Usage​

Upload a File​

  1. Upload the file from Agent Session or a workspace-related entry point.
  2. Wait for the upload to finish.
  3. State which file should be processed in the task.
  4. When there are many files, state the scope and priority.

Example:

Please read the three PDFs I just uploaded. Only organize content related to the procurement process, then output a summary and original evidence.

Reference a File​

When referencing a file, use the file name or path visible on the page. For example:

Please process customer_feedback.xlsx in the workspace and identify the five problem categories that appear most often.

Do not use a local desktop path or an internal server path. xAgent can only process files in the current workspace and authorized scope.

View Results​

When a task is complete, read the session reply first. If it says a file was generated, open Workspace Files to find it.

Common result types include:

File typeCommon use
MarkdownSummaries, checklists, meeting notes, and lightweight reports
CSV / ExcelTable results, structured data, and statistical details
HTMLFully formatted reports with styling or charts
PDFReports that need a fixed layout or external delivery
ImagesCharts, screenshots, and visual outputs

Preview and Download​

Preview HTML, Markdown, or image results first to confirm their content. Download them only when they need to be forwarded, archived, or processed further.

When an administrator enables public file links, you can create an expiring share from previews, Session files, or Workspace file menus. Sharing is disabled by default; visitors see a dynamically watermarked preview and original downloads require separate permission.

When previewing, check:

  • Whether the title and content are correct.
  • Whether tables and charts are complete.
  • Whether Chinese text renders correctly.
  • Whether it contains sensitive information that should not be public.
  • Whether the file belongs to the current task rather than an older result.

Reuse Existing Outputs​

Workspace files can be used as material for the next task. For example:

Based on the summary.md file that was just generated, create a five-minute briefing outline for management.

When filenames are similar, state the name clearly to avoid using the wrong material.

File Safety​

Keep the following in mind:

  • Do not upload sensitive files that should not enter the system.
  • Before external delivery, check whether a report contains personal information, keys, internal addresses, or customer data.
  • Deletion, overwriting, and sending may require approval.
  • Use stable filenames and directories for materials that need long-term use.
  • Temporary files may not be suitable as formal deliverables.

Continue Reading​

Next Steps​

Last updated on