Skip to main content

xAgent Workspace Files: Materials, Results, and Downloads

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.

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 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