> For the complete documentation index, see [llms.txt](https://docs.lumi-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lumi-ai.com/product-features/chat/file-upload.md).

# File Upload

File Upload lets you attach files directly into a chat so the assistant can use them as additional context when responding to user's queries.

This is especially useful for technical users who want to move quickly by leveraging existing work artifacts (e.g. PDFs, CSV, or text file) to accelerate analysis and decision-making.

## Benefits for Utilizing File Upload

* **Speed to outcome** by providing net-new, high signal context so the assistant can quickly assess impact and generate actionable insights.
* **Leverage existing work** by reusing validated, previously aligned-upon artifacts (e.g., reports, specs, definitions) that are already trusted by technical and management teams.
* **Unlock multi-source synthesis** by combining multiple artifacts to support richer, more complete analysis of real-world technical questions.

## How to Upload a File in Chat

**Step 1:** Open the chat. In the message input area, click **“+ Attach a file”** to upload a file for LumiAI to provide the incremental analysis and insights.

<figure><img src="/files/T6U77xGrsmStu4iqetIw" alt=""><figcaption></figcaption></figure>

**Step 2:** Confirm that the uploaded file (e.g., Service Level Agreement Acacia Foods Co.pdf) is included in the assistant’s analysis.

<figure><img src="/files/i9tegyePiQ357ZDCTPtd" alt=""><figcaption></figcaption></figure>

**Step 3:** Reference the uploaded document in your prompt to guide the results.

<figure><img src="/files/3Minu7FhIwZr9seTlQyZ" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.lumi-ai.com/product-features/chat/file-upload.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
