Документация/Агент
Сообщения и вложения
Как писать агенту, направлять его во время работы, прикладывать файлы, картинки и документы, цитировать ответы и переходить по ссылкам на файлы.
Поле ввода — белая карточка под лентой чата. Здесь вы ставите задачу, уточняете её на ходу, прикладываете файлы и цитируете ответы агента. На этой странице — всё, что можно отправить агенту, и как устроены ссылки в его ответах.
Как отправить сообщение
- Enter — отправить, Shift Enter — новая строка. Пока вы набираете текст через систему ввода иероглифов, Enter ничего не отправляет.
- Кнопка «Отправить» справа в поле делает то же, что Enter. Рядом — микрофон для голосового ввода.
- У каждого чата свой черновик. Набранный текст и вложения сохранятся, если уйти в Git или в другой раздел и вернуться.
- «/» в начале поля открывает список команд — о них на странице Команды «/».
Сообщение во время работы агента
Пока агент работает, в поле написано «Направить агента — учтёт на следующем шаге…», а рядом стоят две кнопки: «Отправить» и «Остановить».
Новое сообщение не встаёт в очередь отдельной задачей. Оно дополняет текущую: агент учтёт ваши слова на следующем шаге, продолжит свой план и доведёт задачу до конца. Модель «Авто» сама подбирает модель под каждый шаг (Модели). Если она выбрана, а задача стала сложнее, может включиться более сильная модель и продолжить с того же места.
Чтобы прервать агента, нажмите «Остановить». Подробнее — на странице Как работает агент.
Вложения
Как прикрепить
- Нажмите «+» в поле ввода → «Файлы или фото» (можно выбрать несколько) или «Папка».
- Вставьте из буфера: ⌘ V (Windows и Linux: Ctrl V). Так можно приложить скриншот или файлы, скопированные в Finder или Проводнике. Если в буфере обычный текст, он вставится как текст.
- Перетащите файлы на поле ввода. Появится надпись «Отпустите, чтобы прикрепить».
Если бросить файл мимо поля ввода, приложение его не откроет. Исключение — дерево файлов проекта: что бросите туда, скопируется в проект.
Что можно прикрепить
| Что | Как агент это получает |
|---|---|
| Картинки PNG, JPEG, GIF, WebP, BMP | Модель видит их как картинки. Большую картинку приложение само уменьшит до размера, который примет модель. |
Текст и код в любом текстовом формате, включая .jsonl | Как текст. |
PDF, Word (.docx, .docm, .dotx), Excel (.xlsx, .xlsm, .xltx), PowerPoint (.pptx, .pptm, .ppsx), OpenDocument (.odt, .ods, .odp), RTF, EPUB | Текст документа и картинки из него. |
| Zip-архив до 10 МБ | Путь к архиву. Агент распакует его сам, в любом режиме и без вопросов. Так удобно присылать навыки. |
| Папка | Путь к папке. Если в ней навык, агент поставит его прямо оттуда. |
Пределы
- Не больше 10 вложений в одном сообщении.
- Zip-архив — не больше 10 МБ. У остальных файлов предела по размеру нет.
- Из длинного текста или документа в запрос сразу попадают первые 50 КБ или первые 2000 строк, смотря какой предел наступит раньше. Остальное агент дочитывает сам, по частям. Для этого полная копия файла лежит там, где работает агент: на вашем компьютере, а в проекте на сервере — на сервере. Через 7 дней копия удаляется, поэтому в старом чате агент может уже не дочитать конец файла.
Если файл не подошёл, приложение скажет почему:
- «старый формат Office — сохраните как .docx / .xlsx / .pptx и прикрепите снова» — для
.doc,.xls,.ppt; - «такой тип файла не отправить…» — для прочих двоичных файлов;
- «архив больше 10 МБ»;
- «больше 10 вложений в одном сообщении».
Как выглядят вложения
Вложения стоят плитками над полем ввода. Если их больше шести, лишние сворачиваются в «+N», а рядом появляются «Показать все», «Свернуть» и «Убрать все».
В ленте картинки из сообщения видны миниатюрами. Наведите курсор, чтобы увеличить картинку, или щёлкните, чтобы открыть её в полный размер. Стрелки ← → листают картинки сообщения, Esc закрывает просмотр.
Если выбранная модель не видит картинок, этот шаг выполнит другая модель, которая их видит. Модель сменится сама, настраивать ничего не нужно. Под шагом будет написано, какая модель разобрала картинку, а дальше в разговоре останется текстовое описание картинки.
Просмотр документов
Щёлкните по плитке документа в поле ввода или по файлу в сообщении — откроется окно просмотра с двумя вкладками:
- «Документ» — сам файл. PDF открывается со страницами, поиском «Найти в документе» и кнопками «Уменьшить», «Увеличить», «По ширине», «Скачать». Файлы Word, Excel и PowerPoint тоже открываются здесь.
- «Как прочитал агент» — текст и картинки, которые получила модель. Для OpenDocument, RTF и EPUB есть только эта вкладка.
Если показать файл не получилось, окно само переключится на «Как прочитал агент». На macOS есть кнопка «Быстрый просмотр». Если файл лежит на этом компьютере, есть ещё «Открыть в приложении»: файл откроется в программе по умолчанию.
Как показать агенту файл проекта
Файл проекта указывают в сообщении упоминанием @путь/от/корня. Автодополнения по «@» в поле ввода нет, но набирать
путь не обязательно: приложение само вставит упоминание или скопирует его. Для этого:
- в дереве файлов щёлкните правой кнопкой по файлу или папке → «Добавить в чат». Можно выделить несколько — каждый
станет отдельным
@путь. Упоминание допишется в конец черновика; - или щёлкните правой кнопкой → «Копировать путь» → «Упоминанием для чата» и вставьте упоминание, куда нужно.
Путь можно вписать и вручную — это обычный текст.
Чтобы спросить про кусок кода, выделите его в редакторе, щёлкните правой кнопкой и выберите «Спросить в новом чате» или «Спросить в текущем чате». Код окажется в поле ввода, останется дописать вопрос.
Цитаты
Часть ответа агента можно приложить к следующему сообщению, чтобы агент понял, о каком месте речь.
- Выделите текст в ответе агента.
- Нажмите «Цитировать» над выделением, или ⌥ ⌘ Q (Windows и Linux: Ctrl Shift Q), или выберите команду в меню по правому клику.
- Цитата встанет плашкой над полем ввода. У неё есть «Показать ответ» и «Убрать цитату».
Под ответом агента есть кнопка «Цитировать ответ целиком». Сообщение можно отправить и из одних цитат, без текста.
Ссылки в ответах агента
- Файл проекта. Путь или имя файла в ответе — ссылка. Щелчок открывает файл во встроенном просмотрщике, а если в ссылке указана строка, она будет выделена. Если файлов с таким именем несколько, откроется поиск, где можно выбрать нужный. Если такого файла нет, увидите «Такого файла в проекте нет: …».
- Файл вне проекта. Абсолютный путь,
file://…,~/…или путь через../за пределы проекта тоже ссылка. Щелчок показывает файл в Finder, Проводнике или файловом менеджере Linux. Подсказка у такой ссылки — «Показать … в папке». Приложение такой файл не открывает и не читает. ~/…всегда считается от домашней папки, внутри проекта такой путь не ищут.- Веб-адреса и пути, написанные простым текстом, — тоже ссылки.
Ограничения
- В проекте на сервере файлы и картинки прикладываются как обычно, а папку — нет: прикрепите её zip-архивом. Ссылки на файлы вне проекта там не работают, потому что эти файлы лежат на сервере.
- Если отменить запрос, в поле ввода вернётся только текст, а вложения придётся прикрепить снова. Чтобы отменить,
наведите курсор на своё сообщение и нажмите значок «Отменить запрос и вернуть его в поле ввода»; последнее сообщение
можно отменить и командой
/undo(Изменения сессии и откат). - Содержимое вложений уходит модели вместе с сообщением через сервер DevMachine и хранится в истории чата. Что и куда уходит с компьютера — на странице Данные и приватность.
Что дальше
- Команды «/» — быстрые действия из поля ввода.
- Разрешения и вопросы — как отвечать на карточки агента.
- Навыки — как поставить навык через агента.
- Голосовой ввод — как диктовать вместо набора.
Обновлено · Нашли неточность? Напишите на support@devmachine.ai или в Telegram.
