> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapti/capabilities/reports-and-files.md).

# Reports & Files

Ask Dapti for a shareable report on your data, share it with your workspace or with a link, turn any table into a CSV, and work with the spreadsheets, PDFs and documents you attach.

Dapti can hand you back more than a chat answer. Ask for a **report** and it builds a page with charts and tables from the data it just pulled, which you can open, share and come back to. Ask for a **CSV** and a download card appears. Attach your own **files** and Dapti reads them, answers from them and exports from them.

{% hint style="info" %}
Everything on this page stays inside your workspace. A report leaves it only when you choose **Anyone with the link**, and a file is visible only in the conversation you attached it to.
{% endhint %}

***

## Ask for a Shareable Report

Ask for the report in the same message as the data, or right after Dapti has fetched it. There is no save button: the report is the thing you ask for.

**Try this prompt:**

> *Pull Lia's calls from the last 30 days and make a report I can share with my team: calls per day, connection rate and the top call outcomes.*

Dapti answers in the chat as usual and adds a card: **Shareable report · v1** with a **View report** button. Click it and the report opens in a panel on the right, with its charts, tables and a **Sources** list showing the data it was built from.

A report is built only from data Dapti fetched in that same turn. If a number in it cannot be traced back to that data, the card reads **Couldn't save the report** with the reason, and you can ask again with the data in the same message.

Other report prompts:

* *"Turn that comparison into a shareable report."*
* *"Make a one-page report of this month's text agent conversations by channel."*
* *"Build a report on credits used per agent this quarter."*

### Update a report

Ask for a change ("add last month as a comparison", "group by weekday instead") and Dapti produces **v2** of the same report, not a new one. In the panel, the version picker lists every version by date, with the newest marked **latest**; pick an older one to reopen it, and the viewer labels it **Older version**.

### Open a report on its own page

Every report also has a full-page view at `/dapti/artifacts/<id>` for members of the workspace, after signing in. That is the link you copy while **Workspace members** is selected.

***

## Share a Report

Click **Share** in the report panel. The **Share report** dialog has one setting, **General access**:

| Option                          | Who can open it                                          |
| ------------------------------- | -------------------------------------------------------- |
| **Workspace members** (default) | Only members of this workspace, after signing in.        |
| **Anyone with the link**        | Anyone on the internet with the link, no sign-in needed. |

Choosing **Anyone with the link** asks **Make this report public?**. Confirm with **Make public**, then **Copy link**.

A public link always shows the **latest** version of the report, so updating the report updates what the link shows. The public page carries no trackers and tells search engines not to index it.

To take a link back, open **Share report** and switch to **Workspace members**. The link stops working at once (it shows **Report not available**); someone who already has the page open keeps what they loaded. Choosing **Anyone with the link** again restores the same link.

{% hint style="warning" %}
A public link needs no sign-in. Before you share one, open the report and check it holds nothing you would not send outside the company: phone numbers, names, transcripts.
{% endhint %}

***

## Turn a Table Into a CSV

Any table Dapti has already shown in the conversation can come back as a file.

**Try this prompt:**

> *Export that table as a CSV.*

A download card appears with the **CSV** badge, the file's title, **N rows · M columns** and a **Download CSV** button, the same card you get for PDF and DOCX documents.

* A CSV holds up to **20,000 rows** (or 5 MB). Over that, Dapti tells you the file was not generated and asks you to narrow the data.
* The file opens correctly in Excel, accents included.
* Dapti exports to CSV only; it does not produce `.xlsx` files. Open the CSV in Excel or Google Sheets and save it from there if you need a workbook.

Other CSV prompts:

* *"Give me the calls where sentiment was negative as a CSV."*
* *"Export the contacts in that table with their phone numbers and outcome."*

***

## Work With Your Own Files

Attach a file with **Attach file** (the paperclip), by pasting it, or by dragging it into the chat. Then ask.

| You attach                                          | Ask Dapti to                                                                                                          |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| A spreadsheet (CSV, TSV, XLSX)                      | Summarize it, find rows, compute totals and averages, compare columns, or export a filtered part of it as a CSV       |
| A PDF or Word document (DOCX)                       | Summarize it, extract names, dates, figures or clauses, compare it with another, or turn it into a list of follow-ups |
| An image (PNG, JPEG, WebP, GIF)                     | Read a screenshot, a chart or a dashboard, explain an error message, transcribe handwritten notes                     |
| Text, Markdown, JSON, YAML, XML, HTML, logs or code | Read it, explain it, find what matters, convert it                                                                    |

**Try this prompt:**

> *Here is our leads spreadsheet. Which cities have the most leads? Give me the ones from Bogotá as a CSV.*

A file belongs to the conversation you attached it in. To use it in another conversation, attach it again. The accepted formats, sizes and limits per message are in the [Interface Guide](https://docs.dapta.ai/dapti/interface-guide.md#attachments).

{% hint style="info" %}
If your Dapti shows a **Lite** / **Max** selector, querying and exporting an attached spreadsheet needs **Max**. Reading documents, images and text works in both.
{% endhint %}

***

## Best practices

* **Ask for the report together with the data.** A report is built only from what Dapti fetched in that turn, so "pull X and make a report" works, while a report of something Dapti looked at earlier can end in **Couldn't save the report**. Ask for the data again, then the report.
* **Keep reports on Workspace members unless they really have to travel.** A public link needs no sign-in and always shows the latest version, so whoever holds it also sees every update you make afterwards.
* **Revoke instead of deleting.** Switching back to **Workspace members** turns the link off at once and keeps the report for your team; switching it on again restores the same link, so you can pause access without resending anything.
* **Update, do not recreate.** Asking for a change produces v2 of the same report and the version picker keeps v1. Start a new report only when the subject changes.
* **For tables, attach the spreadsheet, not a PDF of it.** A CSV, TSV or XLSX can be filtered row by row and exported; a PDF of a table is read as text. Attach the file in the conversation where you will work with it (up to 10 files per message); it is not visible from other conversations.
* **Ask for CSV, not Excel.** Dapti exports CSV of up to 20,000 rows and never `.xlsx`. If a table is bigger, ask for a filtered or grouped version instead of the whole thing.

***

## Next Steps

{% content-ref url="/pages/ITt1P6qAQhK8f6FgbVFk" %}
[Call Analytics](https://docs.dapta.ai/dapti/capabilities/call-analytics.md)
{% endcontent-ref %}

{% content-ref url="/pages/t9cOTETVuHh9eobmhtII" %}
[Web Research](https://docs.dapta.ai/dapti/capabilities/web-research.md)
{% endcontent-ref %}

{% content-ref url="/pages/WlLQa9OkMJ9pDvj852NH" %}
[Privacy & Scope](https://docs.dapta.ai/dapti/privacy-and-scope.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dapti/capabilities/reports-and-files.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
