Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.circuit.ai/llms.txt

Use this file to discover all available pages before exploring further.

Documents are the foundation of your Circuit indexes. This page covers supported file types, the upload process, folder structure, and document lifecycle management.

​
Supported file types

Circuit can process a wide range of document formats:
FormatExtensionsNotes
PDF.pdfFull text extraction including tables, images, and forms
Microsoft Word.docxParagraph-level processing with formatting preserved
Microsoft PowerPoint.pptxSlide-by-slide processing with speaker notes
Microsoft Excel.xlsxSheet-by-sheet processing with table structure preserved
CSV.csvRow-based processing for structured data
EPUB.epubChapter-based processing for e-books and long documents
HTML.htmlWeb page content extraction
Markdown.mdSection-based processing
Email.msgEmail body and metadata extraction
Images.png, .jpg, .jpegVisual content extraction (OCR and image analysis)
CAD.dwg, .dxf, .step, .stpEngineering drawing and 3D model extraction
Circuit continues to add support for additional formats. If you have documents in a format not listed here, try uploading them to see if they are supported.

​
Uploading documents

1

Open the target index

Navigate to the index where you want to add documents.
2

Upload files

Drag and drop files or use the upload button. You can upload multiple files at once.
3

Monitor processing

Each document goes through Circuit’s processing pipeline. Status indicators show:
  • Processing: the document is being analyzed and indexed
  • Completed: the document is fully indexed and searchable
  • Failed: processing encountered an error (check the document format and try again)
Processing time depends on document size and complexity. Most documents complete within seconds to a few minutes.

​
Folder organization

Within an index, you can organize documents into folders to keep things manageable. Folders are organizational only and do not affect how agents search the content.
Use folders to mirror how your team already structures its documents. For example: by product line, by document type (manuals, datasheets, procedures), or by date.

​
Updating documents

When a document is updated externally:
  1. Upload the new version to the same index
  2. Circuit reprocesses the document, replacing the previous indexed content
  3. Agents immediately start using the updated content
For documents synced through feeds, updates happen automatically when the source changes.

​
Removing documents

When you delete a document from an index:
  • The document’s indexed content is removed
  • Agents can no longer find or cite that document
  • Existing chat histories that referenced the document retain their citations, but the source is marked as unavailable
Document deletion is permanent. Make sure you have the original file elsewhere before removing it from Circuit.

​
Document best practices

  • Keep documents current: outdated documents lead to outdated answers. Remove or replace documents when new versions are available.
  • Use descriptive file names: agents can reference file names in citations, so “XYZ-500 Installation Guide Rev3.pdf” is more helpful than “doc_final_v2.pdf.”
  • Upload documents as-is: Circuit is designed to process large, complex documents. There is no need to break them up before uploading.
  • Check processing status: if a document stays in “Processing” for an extended time or fails, try re-uploading it.