> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zas.red/llms.txt
> Use this file to discover all available pages before exploring further.

# From a conversation to your Zas channel

> Practical prompts for research handoffs, notes, and original files.

## Hand off a research document

First select Zas in your AI app. Replace **Research** with the exact name of an approved channel:

> Consolidate this conversation into a single Markdown file named research-handoff.md. Include the findings, assumptions, experiments to run, and open questions. Send the file to my “Research” private channel in Zas. Keep it as a .md file and confirm the saved filename and item ID.

The AI can only consolidate material available in the conversation or through authorized tools. Ask it to mark missing evidence instead of filling gaps with invented findings.

> [!TIP]
>
> “Private channel” describes the destination; it is not necessarily the channel's name. If more than one channel matches, choose the destination before sending.

## Save a quick note

> Save these decisions as a note titled “Next experiment” in my “Research” Zas channel: compare the baseline and candidate on the same dataset, report latency and recall, and preserve the raw results.

Notes need **Send** permission. The app can write the result without reading existing channel content.

## Read before you continue

> In my “Research” Zas channel, list the latest items. Read the note called “Next experiment” and summarize the decisions and open questions.

Reading needs **Read** permission. Ask for a title or filename, or open the Zas channel browser and use **Search**. Results start with the newest items. A search matches titles and filenames, not note bodies or file contents. Ask the assistant to keep looking through older items, or choose **Load older items**, even if one page has no matches. Each result has an `open` link to the item in signed-in Zas.

## Reading files

> [!NOTE]
>
> These prompts describe the hosted connector’s current capabilities. Your AI app must expose the corresponding tools. The published ChatGPT plugin currently has an older catalog; check [current tool availability](https://docs.zas.red/en/ai/troubleshooting.md) if a file reader or search input is missing.

`zas_get_item` reads notes and UTF-8 text files up to **64 KiB (65,536 UTF-8 bytes)**. For a larger text file up to **4 MiB (4,194,304 original bytes)**, ask the assistant to use `zas_get_file` with the same channel and item, then decode the base64 resource as UTF-8. Base64 makes the response larger; the limit counts the original bytes. Notes cannot use file tools. DOCX body text supports pagination from files up to 4 MiB, subject to extraction safety limits.

The assistant can look at a file in a channel you may read:

* "Show me the photo in “Research”." It sees images (PNG, JPEG, GIF, WebP) up to 4 MiB.
* "Read pages 3 to 5 of the contract in “Research”." It sees and reads PDF pages, up to 10 pages per request, from PDFs up to 20 MiB.
* "Give me a download link for the video in “Research”." It gets a link for any file up to 50 MiB, including video. The link needs no sign-in, lasts 10 minutes and allows 3 downloads.

Audio files up to 4 MiB can be returned inline. If the assistant cannot listen inline, ask for a download link. Transcription requires a host that can fetch and process the file.

## Send an original file

> Send the attached report.pdf to my “Research” channel in Zas. Preserve the original file bytes. Confirm completion with the saved item ID.

Original-file transfers need **Read and Send**. The AI provider must make the file available to the connector or its code environment. A local filename alone does not grant access to a file.

> [!NOTE]
>
> Sending a PDF and reading its contents are different capabilities. Hosted text reading supports notes, UTF-8 text files, and DOCX body text within the connector's limits; images, PDF pages and audio are read as described in [Reading files](#reading-files). Do not assume every other uploaded format can be interpreted in chat.

## Check that it arrived

1. Wait for a completed send with a saved item ID.
2. Open the named channel in [Zas](https://zas.red).
3. Confirm the title or filename and open the item. For an important original file, download it and compare it with the original.

If the assistant reports a host policy or network block, the task is incomplete. It should explain the failure and keep the original available, rather than silently replacing it with a shortened note.

## Keep what matters

Saved items follow Zas expiration and storage limits. Pin an item in Zas when you need to keep it, within your plan's allowance. Disconnecting the AI app does not delete items it already saved.

[Fix a failed transfer](https://docs.zas.red/en/ai/troubleshooting.md) · [Manage permissions](https://docs.zas.red/en/ai/privacy.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.