Агент видит только то, что вы ему дали. Передать контекст можно четырьмя способами: упомянуть файл или папку прямо в тексте через `@`, прикрепить файл кнопкой скрепки, перетащить его в поле ввода или вставить изображение из буфера обмена. Всё прикреплённое показывается над строкой ввода отдельными плашками — их видно до отправки и можно снять.

## Как упомянуть файл в чате

Наберите `@` в поле ввода — откроется список того, что можно подставить в контекст. Тот же список открывается на `#`: различается только то, что подставится в текст (`@file:имя` или `#file:имя`).

В списке доступны:

- файлы и папки проекта — поиск по имени, недавно открытые файлы идут первыми;
- текущее выделение в редакторе;
- символы кода — функции, классы, методы;
- уже прикреплённые к этому сообщению вложения.

После выбора в тексте остаётся короткая ссылка вида `@file:utils.ts`, а сам файл добавляется во вложения сообщения.

Ссылка на прошлый чат подставляется отдельно и только через `#`: наберите `#session:` — появится список предыдущих сессий.

## Чем упоминание папки отличается от файла

Файл уезжает в запрос содержимым — модель видит его текст сразу. Папка передаётся как указание на место: агент получает её путь и дальше сам решает, что внутри читать, пользуясь инструментами поиска и чтения файлов. Так папка на тысячу файлов не съедает контекст целиком.

Если вам важно, чтобы модель точно увидела конкретный файл, упоминайте файл, а не папку, в которой он лежит.

## Как прикрепить файл, изображение или PDF

Кнопка со скрепкой справа от поля ввода открывает системный диалог выбора файлов — можно выбрать сразу несколько. Кроме того, работают:

- перетаскивание из проводника или из дерева проекта — прямо в поле ввода; так же перетаскиваются папки, символы, ошибки из панели Problems и ссылки;
- вставка из буфера обмена (Ctrl/Cmd+V) — изображение превращается во вложение, скопированный фрагмент кода прикрепляется вместе с указанием строк.

Файлом прикладываются изображения PNG, JPEG, GIF, BMP и WebP; из буфера обмена вставляются PNG, JPEG, GIF, BMP и TIFF. Крупные картинки перед отправкой уменьшаются — так изображение занимает в запросе меньше места.

## Что происходит с офисными документами и PDF

Разные типы файлов доходят до модели по-разному:

| Что прикладываете | Что получает модель |
|---|---|
| Текстовый файл, код, markdown | Содержимое как есть |
| PDF | Сам документ целиком — но только у моделей с нативной поддержкой PDF |
| Word (`.docx`), Excel (`.xlsx`) | Извлечённый из документа текст |
| Изображение | Само изображение |
| Папка | Путь; содержимое агент читает сам |

Форматы `.docx` и `.xlsx` — это архивы, и отправить их байтами бессмысленно: модель увидела бы мусор. Поэтому WorkAI распаковывает документ и вытаскивает из него текст. Если извлечь текст не удалось, вместо мусора в запрос уходит объяснение человеческим языком — молчаливого «файл вроде приложен, а ответ невпопад» не будет.

Форматы `.doc`, `.xls` и презентации `.pptx` обрабатываются как обычные файлы: текст из них не извлекается, и модель увидит нечитаемое содержимое. Сохраните такой документ в PDF и приложите его.

PDF читают не все модели: если у выбранной модели нет нативной поддержки PDF, запрос не уйдёт, а вы получите понятное сообщение с предложением сменить модель.

## Что попадает в запрос из большого файла

У текстового вложения есть предел: в запрос уходит первые 256 КБ содержимого. Если файл больше, в конце обрезанного куска стоит явная пометка о том, сколько показано и что остальное нужно дочитать инструментом чтения файла — агент это видит и дочитывает сам, когда нужно.

Ограничение защищает от ситуации, когда один тяжёлый файл занимает столько места в запросе, что для самого диалога его не остаётся.

## Есть ли ограничение на размер вложения

Для бинарных вложений — PDF и изображений — есть проверка ещё до чтения файла с диска. По умолчанию порог 50 МБ; изменить его можно настройкой `workai.chat.attachments.maxBinaryFileSizeMB` (значение `0` отключает проверку).

Если файл не прошёл, вы увидите предупреждение с его именем и размером — вложение просто не отправится, вместо того чтобы упереться в отказ где-то дальше.

Это клиентская проверка, а не окончательная. Настоящий предел зависит от модели, которой вы пишете: у разных поставщиков разные ограничения на размер PDF, размер и количество изображений. Когда файл проходит клиентскую проверку, но не проходит по правилам конкретной модели, отказ приходит с понятным текстом — с именем файла и числом. Изображения к тому же принимает не каждая модель: если у выбранной модели нет работы с изображениями, WorkAI скажет об этом при попытке приложить картинку. Какие модели доступны — см. [Модели и цены](/docs/models-and-pricing).

## Нужно ли прикладывать открытый файл вручную

В чате редактора — нет. Файл, открытый в редакторе, предлагается как контекст автоматически — над полем ввода появляется соответствующая плашка, которую можно отключить одним кликом, если в этом запросе файл не нужен. Выделенный в редакторе фрагмент передаётся вместе с номерами строк. В [Окно агентов](/docs/agent/agents-window) открытый файл автоматически не подставляется — там контекст задаётся явно.

Правила проекта (`AGENTS.md`, `CLAUDE.md`, файлы в `.workai/rules` и совместимых каталогах) тоже подмешиваются сами, отдельно от ваших вложений — прикреплять их руками не нужно. Подробнее — на странице [Правила](/docs/rules).

## Что видно модели о путях к файлам

Для прикреплённых файлов и изображений действует правило: если файл лежит внутри рабочей папки, модель видит путь относительно её корня; если вне — в запрос уходит только имя — без пути к вашему домашнему каталогу и имени пользователя. Содержимое при этом передаётся полностью: скрывается расположение, а не сам файл.

Файлы из соседних рабочих папок в запрос не подмешиваются: единственное исключение — ваши личные правила, которые по своей природе лежат в домашнем каталоге.

## Что дальше

- [Агент — обзор](/docs/agent/overview) — режимы работы и инструменты агента.
- [Правила](/docs/rules) — постоянные инструкции, которые агент читает без вашего участия.
- [Поиск по проекту](/docs/agent/tools/search) — как агент находит файлы, которые вы не упоминали.