Файлы агента¶

Дайте агенту файлы для работы — исходный код, файлы с данными, логи, конфигурации, медиа — и храните их там, где агент может обратиться к ним по имени. Вкладка «Файлы» в разделе знаний агента — это файловое хранилище агента: загружайте файлы, раскладывайте их по папкам, скачивайте при необходимости и при желании индексируйте их в Базу знаний для полнотекстового поиска.

Загрузки и файловое хранилище¶

На вкладке Файлы агента есть корневая папка Загрузки. Это основное файловое хранилище агента — плоское или разложенное по папкам пространство, где файлы хранятся и открываются по пути.

Загружайте файлы кнопкой Загрузить или перетаскивайте их в окно папки.
Загружайте целые папки кнопкой Загрузить папку — структура папок сохраняется, и агент видит ту же иерархию.
Загруженные файлы сразу доступны агенту: он может читать их по пути или по имени файла (в зависимости от возможностей инструмента).

На iPhone значок сетки рядом с поиском открывает меню вида Список / Таблица. Кнопки загрузки остаются в одной строке: Загрузить, значок папки для Загрузить папку и значок скачивания для Скачать как ZIP. На более широких экранах кнопки показаны с подписями.

Как агент использует ваши файлы¶

Файлы вашего агента доступны каждому его запуску только для чтения в /tmp/agent_files/: папки из «Загрузок» — в /tmp/agent_files/uploads/<path>, так же, как на вкладке «Файлы», а файлы, которые агент создал в ходе собственной настройки, — в /tmp/agent_files/generated/<filename>. Запуск может открыть их по пути, но не может изменить, — так действия одного человека не меняют агента для всех остальных. Вложения каждого человека и файлы, которые агент создал для него, хранятся отдельно: они появляются в /tmp/uploads/ и /tmp/generated/ только в запусках этого человека. Всё, что агент записывает в другие места внутри /tmp, автоматически возвращается человеку для скачивания. О том, что принадлежит агенту, а что каждому человеку, см. Опыт агента и файлы агента.

Пока вы создаёте агента, билдер работает с собственными файлами агента на чтение и запись: он может создавать там папки, просить вас загрузить фирменные материалы (логотипы, шрифты, фото продуктов) в определённую папку, а затем использовать эти файлы — например, разместить их в интерфейсе агента. В рабочем пространстве билдера файлы агента лежат в /tmp/uploads/ (собственные запуски агента видят те же файлы только для чтения в /tmp/agent_files/uploads/). Всё, что билдер там создаёт или меняет, появляется на вкладке «Файлы» сразу после запуска, в тех же лимитах хранилища, что и ваши собственные загрузки.

Файлы, прикреплённые в чате¶

Файлы и изображения, которые вы прикрепляете к сообщению в чате, сохраняются в ваши собственные файлы у этого агента, в папку с именем разговора — первыми 8 символами его идентификатора, например 8bce66d3/. Их видите только вы; на вкладку Файлы агента они не добавляются. Агент видит эту папку как /tmp/uploads/8bce66d3/, и она остаётся доступной до конца разговора: в следующем сообщении можно написать «возьми фото, которое я присылал раньше», и агент откроет его — или использует как референс для нового изображения или видео, — не требуя прикреплять его снова.

У вставленных изображений нет собственного имени файла, поэтому они сохраняются со сгенерированным, например image-1a2b3c4d.png.
Если в том же разговоре прикрепить второй файл с тем же именем, сохранятся оба: новый будет сохранён как report (2).pdf.
Файлы, которые владелец загружает на вкладке «Файлы» агента, — это файлы агента, общие для всех запусков; они остаются в выбранной им папке.
В окне «Файлы» такая папка показана под названием разговора, рядом — короткий идентификатор; сама папка сохраняет короткий идентификатор. В чате с Агентом Атом то же окно «Файлы» открывается из шапки чата — см. Чат с Агентом Атом.

Файлы запусков воркфлоу¶

Запуск воркфлоу действует от имени человека, который его вызвал, — того, кто настроил расписание или вебхук, запустивший его; для ручного запуска — того, кто нажал Запустить (см. Чей это запуск). Как и запуск в чате, он читает собственные файлы агента только для чтения в /tmp/agent_files/ и пишет в собственные файлы этого человека у агента, никогда не на вкладку Файлы агента. Файл, созданный одним запуском, доступен этому человеку в следующем запуске и в его чатах с агентом, и больше никто его не видит. Это обычный случай, потому что у триггера-вебхука воркфлоу Максимум параллельных запусков по умолчанию выключен (значение по умолчанию — 1): для каждого человека одновременно выполняется только один запуск воркфлоу.

Если поднять Максимум параллельных запусков выше 1, каждая доставка вебхука этого воркфлоу получает внутри этих файлов собственную отдельную папку — сразу, как только поднят лимит, а не только когда две доставки действительно пересекаются, — так что две одновременно выполняющиеся доставки не могут перезаписать рабочие файлы друг друга. Эти папки называются внутренними идентификаторами, а не названием воркфлоу или датой запуска, поэтому пока нельзя по одному виду папки понять, к какому запуску она относится. Внутри — ровно то, что создал этот запуск, и в следующий запуск эти файлы не переходят.

Файлы, сохранённые собственным бэкендом агента¶

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

Лимиты файлов и замена¶

У каждого агента есть лимиты хранилища:

Лимит на файл: 200 МБ на файл.
Квота на агента: по умолчанию 2 ГБ загруженных файлов (администратор может её изменить). В неё засчитываются загруженные вами файлы и вложения из чата; сгенерированные файлы не засчитываются.

Файлы, прикреплённые в чате, используют то же хранилище и засчитываются в ту же квоту. Если файл превышает лимит на файл или хранилище агента заполнено, вложение отклоняется. На его плашке указана причина: превышен лимит размера загрузки или хранилище заполнено.

Отклонённый файл остаётся в списке на вкладке Файлы с указанием причины: превышен лимит размера загрузки или хранилище агента было заполнено. За ним ничего не сохранено, поэтому его нельзя скачать и нельзя добавить в Базу знаний. Удалите его, чтобы убрать запись, или освободите место и загрузите файл снова.

Если загрузить файл с тем же путём, что и у существующего, появится диалог Заменить:

Заменить — существующий файл перезаписывается новой версией.
Пропустить — новый файл не загружается, существующий остаётся без изменений.

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

Как освободить место¶

Если загрузка или вложение в чате отклонены из-за заполненного хранилища, освободите место, удалив загруженные файлы или папки на вкладке Файлы. Квота освобождается сразу.

Сгенерированные файлы в квоту не засчитываются. Удаление такого файла через меню строки в папке Сгенерированные удаляет файл, но индикатор хранилища не меняется, поэтому отказ «хранилище заполнено» это не снимет.

Индексация в Базу знаний¶

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

Добавить в Базу знаний — проиндексировать файл поддерживаемого типа (полный список см. в разделе Документы и RAG), чтобы агент мог искать по его содержимому. Это кнопка + в строке файла или пункт в меню строки.
После индексации файл появляется в Базе знаний агента и даёт фрагменты для результатов поиска, когда агент отвечает на вопросы.
Убрать из Базы знаний — прекратить индексацию файла, не удаляя его. Файл остаётся на вкладке «Файлы», но по нему больше нельзя искать. Уберите файл из Базы знаний, если хотите оставить его доступным, но не включать в поисковый индекс агента (например, справочный файл, который засоряет результаты, но удалять который не нужно).

Индексация необязательна: агент может читать файл с вкладки «Файлы» напрямую, без индексации.

Файл, созданный агентом, тоже можно добавить в Базу знаний — через меню его строки в папке Сгенерированные или попросив агента. База знаний индексирует загруженные файлы, поэтому сначала файл копируется в Загрузки, в папку с именем из первых восьми символов идентификатора файла, и индексируется уже копия. Копия — отдельный файл: она засчитывается в квоту загрузок и не меняется, когда меняется сгенерированный файл. Чтобы проиндексировать более новую версию, снова добавьте сгенерированный файл в Базу знаний.

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

Открытие файлов¶

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

Остальные файлы открываются в окне предпросмотра поверх окна «Файлы»; на телефоне предпросмотр занимает весь экран. Он использует просмотрщики канваса: HTML-страница запускается, PDF показывается там, где браузер умеет его отображать, видео и аудио воспроизводятся, а CSV, Markdown, код или обычный текст показываются как таблица или как текст. Над файлом кнопка Открыть в новой вкладке открывает его в отдельной вкладке браузера, а Скачать сохраняет. Файл, который предпросмотр не может показать, — документ Word или PowerPoint, архив, книга Excel, — отображается карточкой с именем и кнопкой Скачать.

Папка	Что показывает предпросмотр
Рабочая область	Все типы из списка выше. Презентация или страница шире окна предпросмотра уменьшается так же, как на канвасе
Сгенерированные	Все типы из списка выше. Страница сохраняет ширину, под которую она свёрстана, поэтому широкая презентация прокручивается вбок
Загрузки	Изображения, видео, аудио и PDF. Остальные файлы, включая текстовые, показываются карточкой

В приложениях для Android, iPhone, iPad и Mac файл открывается внутри приложения, в тех же просмотрщиках, что и канвас. HTML-страница, открытая из Файлов, сохраняет ширину, под которую она свёрстана, поэтому широкая презентация прокручивается вбок; на канвасе та же презентация уменьшается до размера экрана. Файл, который приложение не может показать, открывается карточкой с кнопками Скачать, Поделиться и Открыть в другом приложении. Книга Excel (.xlsx), открытая из Файлов, показывает эту карточку на Android и открывается в системном предпросмотре на iPhone, iPad и Mac.

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

Скачивание файлов¶

Файлы можно скачать на компьютер:

Скачать отдельный файл — из строки файла или из предпросмотра. Файл из рабочей области агента или созданный им сохраняется сразу на компьютер; загруженный файл открывается в новой вкладке браузера, где его можно сохранить.
Скачать как ZIP — для папки или всего корня «Загрузки»: все файлы и вложенные папки упаковываются в ZIP-архив.

ZIP-архив сохраняет структуру папок, так что после распаковки вы увидите ту же структуру у себя.

В приложении для Android скачанный файл или ZIP-архив попадает в папку «Загрузки» устройства. На iPhone, iPad и Mac приложение спрашивает, куда его сохранить.

Удаление файлов¶

Удаляйте файлы или папки на вкладке «Файлы»:

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

Удаление необратимо, поэтому будьте внимательны, удаляя файлы или папки.