Канвас¶
Когда агент что-то делает — отчёт, таблицу, график, страницу, изображение, — результат не обязан помещаться в пузырь сообщения. Канвас — это панель рядом с чатом, где живут такие результаты: слева чат, справа то, о чём вы просили.
Что туда попадает¶
Файл появляется на канвасе в нескольких случаях:
- Всё, что агент создаёт, работая над вашим запросом, автоматически попадает в список на вкладке Артефакты. Ничто вас не отвлекает — файл просто лежит там, когда он вам понадобится.
- Изображения и видео, которые генерирует агент, попадают в список так же, под коротким названием, которое даёт им агент, — поэтому картинку из начала переписки легко найти снова, а попросить её можно по названию. Видео появляется в списке, как только агент начинает его создавать, с пометкой о генерации, и превращается в ролик, когда он готов, — даже если это происходит после окончания хода. Если генерация не удалась, запись сообщит об этом. См. Генерация медиа.
- Когда результат готов, агент сам открывает его в отдельной вкладке. Можно и просто попросить — «покажи мне этот файл», — и агент его покажет.
- Файлы, которые создал скилл во время работы, попадают сюда так же: скилл, который генерирует документ, выгрузку или изображение, кладёт их прямо на канвас той переписки, где его вызвали.
- Работа, которую для вас сделал другой агент, тоже приходит сюда. Когда ваш агент передаёт задачу одному из ваших других агентов, вернувшиеся файлы появляются на вашем канвасе. Каждый остаётся привязан к задаче, которая его создала, поэтому две передачи, каждая из которых вернула
report.html, дадут вам два отдельных файла, а не один, перезаписавший другой.
У каждого открытого файла есть вкладка, которую можно закрыть, а вкладка Артефакты всегда хранит полный список с типом и размером файлов. Над открытым файлом расположены кнопки Открыть в новой вкладке, Скачать, а для HTML-дизайна — ещё меню Экспорт с пунктами Экспорт PPT, Экспорт PDF и Экспорт PNG. Открыть в новой вкладке показывает файл в отдельной вкладке браузера; Скачать сохраняет его. Экспорт PDF печатает через тот же путь Chromium, что и Designer Studio (векторный текст, размеры страниц по артборду). Экспорт PPT и Экспорт PNG снимают артборды в браузере. Скачанная HTML-страница самодостаточна: её картинки, скрипты и стили встроены в файл, поэтому вне канваса она выглядит так же. Такое же меню Экспорт есть в канвасе приложения для Mac. Экспорт PNG даёт по одной картинке на страницу; дизайн из нескольких страниц приходит ZIP-архивом картинок. Экспорт PPT создаёт файл PowerPoint, а Экспорт PDF — PDF. Ассистент не кладёт PDF или PPT рядом с HTML, если вы об этом не попросите. Видео и картинки больше 10 МБ остаются ссылками.
В приложениях для Android, iPhone и iPad, а также в отдельном окне канваса в приложении для Mac кнопка Скачать находится на панели над открытым файлом, а в меню рядом с ней есть Поделиться и Открыть в другом приложении. В канвасе рядом с чатом в приложении для Mac эти действия и Перезагрузить находятся в меню, которое открывается по нажатию правой кнопкой мыши на вкладку файла; в списке Артефакты у каждого файла в конце строки есть кнопка Скачать, а правый клик по строке предлагает Скачать, Поделиться и Открыть в другом приложении. На iPhone, iPad и Mac Скачать спрашивает, куда сохранить файл; на Android файл попадает в «Загрузки». Поделиться отправляет файл через системное меню «Поделиться», и HTML-страница при этом — тот же самодостаточный файл, что даёт Скачать. Открыть в другом приложении передаёт файл приложению, которое умеет открывать такой тип файлов; на iPhone и iPad он открывается в системном просмотре, откуда его можно передать в другое приложение.
Когда ассистент передаёт часть работы помощнику или одному из ваших агентов, всё, что создаст этот агент, тоже появляется в списке с пометкой — именем агента, который это сделал.
Файл, который только попал в список, сам по себе экран не делит. На компьютере панель открывается, когда агент показывает вам результат, — в остальных случаях она ждёт за переключателем Канвас в шапке чата, на который можно нажать, как только там появится что посмотреть. На телефоне панель никогда не открывается сама, чтобы переписка и поле сообщения оставались на экране, пока приходит ответ: когда агент создаёт или показывает файл, на переключателе Канвас вверху появляется точка. Нажмите на него, чтобы открыть канвас вместо переписки, и нажмите ещё раз, чтобы вернуться.
Предпросмотр¶
Большинство файлов канвас показывает прямо на месте:
| Тип | Что вы видите |
|---|---|
| HTML-страницы | Саму страницу в работе — в том числе интерактивную (см. ниже). Презентация шире панели уменьшается до ширины панели, и любая другая страница, которая сильно выходит за край панели, тоже уменьшается, но не меньше чем вдвое. Страница, которая и так помещается, сохраняет свой размер |
| Изображения, включая SVG-рисунки | Показываются в панели |
| Видео | Воспроизводится в панели |
Аудио, например файлы .mp3, .m4a, .wav и .ogg |
Воспроизводится в панели |
| Таблицы (CSV) | Таблица с первыми строками, полный файл — в один клик |
| Книги Excel | Каждый лист в виде таблицы, с переключателем между листами (см. ниже) |
| Документы (Markdown) | Отформатированный текст |
| Код | Исходный код с подсветкой синтаксиса |
Простой текст, например файлы .txt и .log и файлы без расширения |
Показывается как текст |
| Показываются в панели, если браузер умеет отображать PDF внутри страницы, как настольные браузеры. На iPhone и iPad, в Chrome на Android и в любом другом браузере, который этого не умеет, — карточка с кнопками Открыть и Скачать. Открыть открывает PDF в новой вкладке или скачивает его, если в браузере нет собственного просмотрщика PDF | |
| Word, PowerPoint, архивы и всё остальное | Карточка с названием файла и кнопкой Скачать |
Такая же карточка — со строкой, объясняющей причину, — заменяет изображение, которое не удаётся показать, видео- или аудиофайл, который браузер не может воспроизвести, и книгу Excel, которую не удаётся прочитать как таблицу. Текстовый файл, внутри которого оказались двоичные данные, тоже показывается карточкой с общей строкой «Для этого типа файла нет превью.» Кнопка Скачать на карточке всегда сохраняет файл под его собственным именем.
В браузере на телефоне или планшете канвас показывает те же превью. От браузера зависит лишь, умеет ли он отображать PDF внутри страницы и какие форматы видео и аудио воспроизводит.
Файлы появляются и открываются, пока ход ещё идёт, а открытое превью обновляется, когда агент перезаписывает файл. Если перезагрузить страницу или открыть чат на другом компьютере посреди хода, вы увидите тот же список. Если файл удалили из рабочей среды агента, канвас сообщит об этом, а не покажет сломанную рамку.
Книги Excel¶
Когда ответ — файл Excel (.xlsx, .xlsm) — модель, выгрузка, сведённые вместе источники, — канвас показывает его таблицей, а не карточкой для скачивания. Названия листов расположены над таблицей: выберите лист, и его строки появятся ниже. Кнопка Скачать на своём обычном месте и даёт саму книгу, чтобы открыть её в Excel или где угодно ещё.
Панель показывает представление файла, а не сам файл:
- Показываются первые 24 листа, а в каждом — первые 500 строк и 64 столбца. Длинный текст в ячейке сокращается, чтобы таблица оставалась читаемой.
- Числа, проценты и даты показываются так, как их форматирует сама книга, поэтому итог читается как
84 317.62, а не как длинное хранящееся за ним значение. Ячейка, которую книга не форматирует, показывается так, как хранится, с сокращением до десяти цифр. - Ячейка с формулой показывает значение, которое вычислила формула. Некоторые программы сохраняют книгу без пересчёта, оставляя его тому, кто откроет файл следующим; такая ячейка показывает саму формулу, а число появится, когда вы откроете скачанный файл в программе для работы с таблицами.
- Над таблицей точно указано, что осталось за кадром — листы, строки, столбцы или сокращённый текст, — и ничего не указано, если вся книга поместилась.
Ничто из того, что не показал предпросмотр, не теряется. Скачанный файл — тот самый, который записал агент: все листы, все строки, все формулы.
В приложениях¶
Приложения для Android, iPhone, iPad и Mac тоже открывают файлы в канвасе. Файл, который приложение не может показать — из-за типа или потому что он повреждён или слишком велик для превью, — открывается карточкой: название файла, строка с причиной и кнопки Скачать, Поделиться и Открыть в другом приложении — те же действия, что и у открытого файла.
| Тип | Android | iPhone, iPad и Mac |
|---|---|---|
| HTML-страницы | Сама страница в работе; презентация шире экрана или другая страница, которая сильно выходит за его край, уменьшается так же, как в веб-версии. Масштабировать страницу щипком нельзя | Сама страница в работе; презентация шире экрана или другая страница, которая сильно выходит за его край, уменьшается так же, как в веб-версии |
| Изображения, включая SVG-рисунки | Показываются в панели; масштаб — щипком | Показываются в панели; масштаб — щипком |
| Видео | Воспроизводится в панели; видео, которое устройство не может воспроизвести, показывается карточкой | Воспроизводится в панели; видео, которое устройство не может воспроизвести, например большинство файлов .webm и .mkv, показывается карточкой |
| Все страницы; масштаб — щипком или двойным касанием | Все страницы; масштаб — щипком | |
| Markdown, CSV и код | Отформатированный текст, таблица с первыми строками и исходный код как текст | Отформатированный текст, таблица с первыми строками и исходный код как текст |
Простой текст, например файлы .txt и .log |
Показывается как текст | Показывается как текст |
Книги Excel (.xlsx, .xlsm) |
Каждый лист в виде таблицы, как в веб-версии (см. Книги Excel); нажмите на ячейку, чтобы прочитать её целиком | Открываются в системном просмотре |
Документы Word, PowerPoint, старого Excel (.xls), RTF, Pages, Numbers и Keynote, а также аудио |
Карточка | Открываются в системном просмотре |
Всё остальное, например архивы .zip |
Карточка | Карточка |
Приложения показывают файл в списке, как только агент его сохранит, — пока ответ ещё пишется и на всех устройствах, где вы вошли в аккаунт, — а книга Excel сразу показывается таблицей. Картинка или видео, которые ещё генерируются, показывают Генерируется… и открываются, как только будут готовы, даже если это произойдёт после того, как ответ завершился. Очень длинный файл с кодом или простым текстом показывается с начала, с пометкой о том, сколько строк показано. На iPhone и iPad файл, который системный просмотр не может отрисовать, показывается карточкой. Скачать всегда даёт файл целиком.
Это часть переписки¶
Какие вкладки открыты, относится к чату, а не к вашему браузеру: откройте переписку завтра или на другом компьютере, и вас будут ждать те же вкладки. На компьютере для каждого браузера запоминаются только ширина панели и то, показана ли она вообще, — чтобы скрыть или показать её, используйте переключатель Канвас в шапке чата. Телефон не запоминает ни того, ни другого: каждый чат, включая открытый по ссылке, начинается с переписки, а канвас закрыт, пока вы не нажмёте на переключатель.
Канвас есть не только в чате рабочего пространства с Агентом Атом — он входит в тот же чат, который работает на опубликованной странице любого агента, на странице команды и на странице использования, поэтому файлы, которые агент создаёт для посетителя, тоже попадают туда, а не только в ответ. См. Опубликовать агента. Агент, опубликованный до этого изменения, сохраняет старый встроенный чат без канваса, пока его не опубликуют заново.
Удаление файла¶
Если закрыть вкладку, файл просто убирается: он остаётся в списке Артефакты, и его можно снова открыть. Если удалить один из сгенерированных агентом файлов, он исчезнет и из списка — кроме случая, когда тот же файл хранится и в рабочей среде агента: тогда запись остаётся и продолжает показывать копию из рабочей среды.
Интерактивные панели¶
HTML-страница, которую показывает агент, может быть не просто картинкой. Страницы на канвасе умеют:
- возвращать вас в чат — кнопка или форма в панели становится вашим следующим сообщением, поэтому на дашборде может быть кнопка «Разобрать эту строку подробнее»;
- заполнять поле сообщения предложенным запросом, который вы можете отредактировать и отправить.
Панель показывает данные, которые агент встроил в неё; чтобы увидеть свежие цифры, попросите агента обновить панель.
Когда панель впервые хочет что-то написать в чат, Агент Атом показывает, что именно она собирается отправить, и просит Разрешить или Закрыть. В остальном панели изолированы: они работают в песочнице, без доступа к интернету и к чему-либо в вашем аккаунте, кроме того, что агент поместил на страницу. Страница, открытая через Открыть в новой вкладке, работает так же изолированно, и там её кнопки не могут обратиться к чату.
Кредиты
Действие панели — обычное сообщение в чате, и кредиты за него списываются так же. Панель не может тратить кредиты в цикле — Атом ограничивает, как часто и сколько может отправлять одна панель.
Общий документ¶
Один файл на канвасе можете редактировать и вы: документ чата, canvas/notes.md. Откройте его и нажмите Изменить, чтобы поправить текст, а затем Сохранить — агент увидит вашу версию и будет работать с ней. Если агент обновит этот документ, пока вы его редактируете, панель сообщит об этом и предложит Перезагрузить его копию; перезагрузка сбрасывает несохранённый черновик, поэтому сначала скопируйте всё, что хотите сохранить.