Copilot File Tool
Flux Copilot includes a powerful file tool that allows you to extract specific information from datasheets and project files directly from the chat interface. This tool helps you quickly find the information you need without having to manually search through lengthy technical documents.
Overview
The file tool enables you to:
- Search within datasheets and project files using natural language queries
- Extract specific information such as pin configurations, electrical characteristics, or mechanical dimensions
- Access information from both text content and tables within documents
- Get relevant excerpts without leaving your design workflow

How to Use the File Tool
To search within datasheets or project files using Copilot, use the @file
tool in your query:
When you use the @file
tool, Copilot will:
- Process your query to understand what information you're looking for
- Search through the relevant datasheet or file
- Extract the most relevant information, including from tables if applicable
- Present the information in a clear, readable format
Attaching Files
To use the file tool with your own files, you need to attach them to the chat:
- Click the paperclip icon in the chat input area
- Select the file you want to attach (PDF, CSV, TXT, etc.)
- Once uploaded, you can reference the file in your queries
For example, after attaching a datasheet:
Search Technology
The file tool uses two complementary search methods to ensure you get the most relevant information:
Vector Search
For files that have been previously processed, Copilot uses vector search technology to find semantically relevant content. This allows it to understand the meaning behind your query and find information even when your query doesn't contain the exact words used in the document.
Direct File Processing
For newly attached files or files hosted on Flux's CDN, Copilot can download and process them directly, extracting both text content and table data to provide comprehensive answers to your queries.
Example Queries
Here are some examples of how you can use the file tool:
Finding Electrical Specifications
Extracting Pin Information
Finding Mechanical Specifications
Tips for Effective File Searches
To get the most out of the file tool:
Be specific in your queries - Clearly state what information you're looking for and from which document.
Reference specific sections - If you know the section of the document, mention it in your query (e.g., "in the electrical characteristics section").
Ask about tables directly - If you're looking for tabular data, explicitly mention it (e.g., "show me the truth table for this logic gate").
Use technical terminology - Using the correct technical terms will help Copilot find the most relevant information.
Limitations
While the file tool is powerful, it has some limitations to be aware of:
- The tool may have difficulty with very complex tables or diagrams in PDFs
- Very large files may take longer to process
- Some file formats may not be fully supported
- The tool works best with text-based content and structured tables
- For scanned PDFs with poor OCR quality, information extraction may be limited
Related Features
The file tool works well with other Copilot capabilities:
- Copilot Documentation Search - Search Flux documentation for guidance
- Copilot Library Tool - Search the Flux component library
- Copilot Calculator Tool - Extract and evaluate equations
- Getting Started With Copilot - Learn the basics of using Copilot