Контекст

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

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

Наберите @ в поле ввода — откроется список того, что можно подставить в контекст. Тот же список открывается на #: различается только то, что подставится в текст (@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 скажет об этом при попытке приложить картинку. Какие модели доступны — см. Модели и цены.

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

В чате редактора — нет. Файл, открытый в редакторе, предлагается как контекст автоматически — над полем ввода появляется соответствующая плашка, которую можно отключить одним кликом, если в этом запросе файл не нужен. Выделенный в редакторе фрагмент передаётся вместе с номерами строк. В Agents Window открытый файл автоматически не подставляется — там контекст задаётся явно.

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

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

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

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

Что дальше #

• Agent — обзор — режимы работы и инструменты агента.
• Rules — постоянные инструкции, которые агент читает без вашего участия.
• Поиск по проекту — как агент находит файлы, которые вы не упоминали.