Вложения и артефакты
CherryPi различает вложения (файлы, которые вы даёте задаче) и артефакты (файлы, которые задача создаёт). И те и другие лежат в S3-бакете agency и отдаются через agency, поэтому бакет не должен быть публичным.
Вложения
Добавляйте файлы перетаскиванием в консоль, вставкой скриншота или скрепкой в композере. Лимиты задаёт agency:
| Настройка | По умолчанию |
|---|---|
| Максимальный размер файла | 25 МиБ (CHERRYPI_ATTACHMENT_MAX_BYTES) |
| Файлов на сообщение | 10 (CHERRYPI_ATTACHMENT_MAX_PER_MESSAGE) |
При старте задачи агент скачивает вложения в workspace в каталог attachments/. Изображения также передаются Pi как image content, поэтому модель видит их напрямую. Текстовые файлы и документы передаются путём.
Вложения остаются во вкладке Attachments панели деталей задачи.
Артефакты
Агент публикует артефакт встроенным инструментом setTaskArtifacts. У артефакта есть:
- имя и описание;
- одна или несколько частей: файл, текст или структурированные данные;
- опциональный media type.
Артефакты появляются во вкладке Artifacts задачи. Файловые части можно смотреть и скачивать. Это долговечный результат задачи: markdown-отчёты, скриншоты, сгенерированный код, логи тестов.
Артефакты привязаны к задаче, а не к сообщению, поэтому остаются видимыми после прокрутки переписки.
Ссылки
Инструмент setTaskUrls публикует ссылки отдельно от артефактов. Они появляются во вкладке Links и в списке задач, например pull request или preview деплоя.
Операции с хранилищем
- Загрузки проксирует agency с сессией или токеном пользователя.
- Агенты скачивают и загружают файлы своим personal access token.
- Удаление задачи удаляет её вложения и артефакты (с учётом lifecycle-правил бакета).
- Бэкапьте бакет вместе с базой. База хранит метаданные и ссылки на объекты, а не тела файлов.
Retention
Retention вложений и артефактов следует lifecycle-политике бакета и retention задач agency. Настройте версионирование и срок хранения для больших выходных файлов.