Skip to main content
In Cloosphere Chat you can attach files for the AI to analyze, or connect a Knowledge Base for document-grounded answers.

​
Attaching Files

You can attach files in several ways.
Input area with attached files
Drag files into the chat area to upload them automatically. You can drag multiple files at once.

​
Supported File Formats

CategoryFormats
DocumentsPDF, DOCX, PPTX, TXT, MD, HTML
SpreadsheetsXLSX, CSV
ImagesPNG, JPG, GIF, WebP, AVIF
CodePY, JS, TS, Java, C++, etc.
AudioWAV, MP3, etc.
DataJSON, XML, YAML
When you upload audio (WAV, MP3, etc.), STT (Speech-to-Text) is run automatically to produce a transcription.

​
File Size Limits

The maximum file size depends on the value the admin sets in Settings > Documents. Files exceeding the limit are rejected with a “File size should not exceed X MB” error.

​
Image Analysis

When you attach an image (PNG, JPG, GIF, WebP, AVIF), a Vision model analyzes its content.
Image analysis response
  • Charts/graphs: Extract and analyze data points
  • Document images: OCR-based text extraction
  • UI design: Design feedback and code conversion
  • Error screens: Analyze error messages and suggest fixes
  • Photos: Object recognition, scene description
If the selected model doesn’t support Vision, attaching an image triggers a “Selected model(s) do not support image inputs” error.
Enable Settings > Interface > Files > Image Compression to auto-compress high-resolution images to a target size, improving upload speed and token efficiency.

​
Document File Processing

For non-image files (PDF, DOCX, code files, etc.), text is extracted automatically at upload time.
1

Upload the file

Attach a file using one of the methods above. During upload it shows an “uploading” state.
2

Text extraction

The server extracts the file contents automatically. Once complete, the state changes to “uploaded”.
3

Use the context

The extracted text is included as context in the AI conversation, enabling questions about the file content.

​
Knowledge Base Integration (RAG)

​
Reference a Knowledge Base with #

Type # in the input box to see available Knowledge Base collections and individual files. The AI searches documents from the selected Knowledge Base or file and uses them in its answer.
Knowledge Base autocomplete dropdown
#hr-policy What is the leave application process?

​
How RAG Works

1

Query analysis

A search query is generated from the user’s question.
2

Vector search

Vector similarity search runs against document chunks stored in the Knowledge Base.
3

Build the context

The retrieved relevant chunks are inserted into the AI prompt as context.
4

Generate the response

The AI generates an answer that references the retrieved documents and provides citations.

​
Agent-based RAG

When an agent has Knowledge Bases attached, it searches them automatically — no # command required. Attach Knowledge Bases in Workspace > Agent settings.

​
Citation Display

Responses that referenced Knowledge Base or web search results show citations.
Citation display

​
Citation List

A list of referenced documents appears below the response.
ItemDescription
Index numberThe citation order number
Source nameOriginal filename or URL
Source count toggleShows the total source count in “N Sources” format — click to expand the list
Relevance (similarity score) is not shown in the citation list — view it inside the source modal opened by clicking a citation.

​
Reviewing the Source

Click a citation to open the source modal with the full retrieved chunk content.
1

Click the citation badge

Click a source item in the citation area below the response.
2

Review the source

The modal shows the retrieved chunk’s full text and metadata.
3

Verify trustworthiness

Use the source to directly verify the accuracy of the AI response.
URL-based sources (web search results) take you directly to the original page when clicked.

​
Files in Chat Controls

The Files section of the Chat Controls panel lists files attached to the current conversation.
  • Each item shows filename, type, and size
  • The trash icon removes individual files
  • Clicking a file shows its details