Артефакты
Артефакты обеспечивают хостинг статического HTML для результатов workflow. Загружайте HTML-контент (отчёты, дашборды, визуализации) и получайте публичные URL. JavaScript выполняется в sandbox-фрейме с панелью брендинга Moira. Размещение origin зависит от deployment; используйте возвращённый URL. Публичный артефакт не должен содержать credentials или конфиденциальные данные.
Применение
- Отчёты: Генерация аналитических отчётов с доступом по URL
- Дашборды: Создание интерактивных HTML-дашбордов (JavaScript работает в странице)
- Визуализации: Хостинг графиков и визуализаций данных со встроенными в HTML данными (вызовы application API заблокированы)
- Документация: Публикация сгенерированной документации
- Превью: Демонстрация промежуточных результатов
MCP Tool
Для готового HTML-файла используйте загрузку по токену: получите URL загрузки,
отправьте локальный файл по HTTP в multipart-поле file и сохраните возвращённый URL артефакта.
Действие upload принимает HTML прямо в аргументе, когда HTTP-загрузка файла недоступна.
MCP tool artifacts предоставляет следующие действия:
artifacts({ action: "token", ttlMinutes: 60 })artifacts({ action: "upload", name: "report.html", content: "<html>...</html>" })artifacts({ action: "update", uuid: "abc-123", content: "<html>...</html>" })artifacts({ action: "delete", uuid: "abc-123" })artifacts({ action: "list", limit: 10 })artifacts({ action: "stats" })| Действие | Назначение |
|---|---|
token | Получить URL для HTTP-загрузки файла |
upload | Резервная inline-загрузка, получить URL |
update | Обновить содержимое артефакта |
delete | Удалить артефакт |
list | Список артефактов с пагинацией |
stats | Статистика использования квоты |
Резервная inline-загрузка
Если HTTP-загрузка файла недоступна, создайте артефакт из HTML в аргументе. Используйте возвращённый URL; его origin задаётся конфигурацией deployment.
artifacts({ action: "upload", name: "analysis-report.html", content: "<html><body><h1>Отчёт</h1></body></html>"})→ { uuid: "d0a925d6-7dd8-49ba-b90c-d03b43062d20", url: "https://d0a925d6-7dd8-49ba-b90c-d03b43062d20.static.moira-mcp.com/", name: "analysis-report.html", size: 52, expiresAt: "2024-03-01T10:00:00Z" }Опциональный executionId связывает артефакт с выполнением workflow.
Update
Замена содержимого существующего артефакта:
artifacts({ action: "update", uuid: "d0a925d6-7dd8-49ba-b90c-d03b43062d20", content: "<html><body><h1>Обновлённый отчёт</h1></body></html>"})List
Получение списка артефактов с пагинацией:
artifacts({ action: "list", limit: 10, offset: 0 })→ { artifacts: [{ uuid: "d0a925d6-...", url: "https://d0a925d6-....static.moira-mcp.com/", name: "report.html", size: 1024, createdAt: "2024-01-15T10:00:00Z" }], total: 5 }Квоты и срок хранения
Действующие квоты хранилища, количества артефактов и maxFileSizeBytes возвращает stats.
Размер файла измеряется в байтах декодированного HTML в UTF-8, а не его JSON-представления.
Администратор может задать размер для пользователя; пустое переопределение наследует глобальную
настройку artifacts.max_file_size_mb, затем значение по умолчанию 5 МиБ. Один МиБ — 1 048 576 байт.
Квоты хранилища и количества независимы. Возвращённое expiresAt определяет срок конкретного
артефакта; страница отсутствующего артефакта не устанавливает общий срок хранения.
artifacts({ action: "stats" })→ { totalArtifacts: 5, totalSize: 51200, storageLimit: 104857600, countLimit: 50, maxFileSizeBytes: 5242880, storageUsedPercent: 0.05, countUsedPercent: 10 }Токены загрузки
Получите одноразовый токен для публикации локального HTML-файла без копирования его содержимого в аргумент MCP. Выдача токена сама по себе не публикует файл.
artifacts({ action: "token", ttlMinutes: 30 })→ { token: "xyz-789", expiresAt: "2024-01-15T10:30:00Z", uploadUrl: "https://{MOIRA_HOST}/api/public/artifacts/upload/xyz-789" }Загрузка через HTTP:
curl -X POST "$UPLOAD_URL" \ -F 'file=@/absolute/path/report.html;type=text/html'Задайте UPLOAD_URL равным точному uploadUrl из ответа выдачи токена. Для связи с выполнением
добавьте -F "executionId=$EXECUTION_ID", где EXECUTION_ID — настоящий ID существующего
выполнения, принадлежащего пользователю, из ответа start. Опустите поле, если связь не нужна. Имя файла
задаёт имя артефакта. Также принимается JSON {name, content, executionId?}. Проверьте HTTP 201
и сохраните настоящий url из ответа; URL загрузки даёт доступ, а не является публичным URL артефакта.
Токен истекает через указанный TTL и отмечается использованным после успешного создания. Отказ содержимому не расходует действительный токен. Этот последовательный контракт не гарантирует атомарное создание ровно один раз при одновременных загрузках. Перед повтором потерянного ответа установите фактический исход.
Безопасность
Артефакты могут содержать JavaScript, поэтому каждый изолируется на нескольких уровнях:
- Настроенный URL артефакта — используйте
urlиз результата upload или list. В deployment с отдельными поддоменами для каждого артефакта браузер изолирует storage, cookies и Service Workers между origin; точные host и path определяются конфигурацией deployment. - Песочница (sandbox) — контент артефакта работает внутри
<iframe sandbox="allow-scripts">(безallow-same-origin, без форм, без навигации верхнего уровня, без popup) на странице-обёртке под контролем Moira. Скрипты выполняются, но не могут добраться до обёртки. - Ограниченные соединения —
connect-src 'none'блокирует fetch/XHR/WebSocket/beacon; формы тоже заблокированы. При этом HTTPS-изображения и явно разрешённые script/style/font ресурсы могут загружаться. Это не гарантия отсутствия любых исходящих запросов или раскрытия данных: встраивайте данные визуализации и не публикуйте секреты. - Предупреждение при первом визите — зрители видят промежуточный экран о том, что контент создан пользователем и не одобрен Moira, перед показом артефакта.
| Защита | Значение |
|---|---|
| CSP фрейма | скрипты разрешены; connect-src 'none', form-action 'none', base-uri 'none' |
| Sandbox фрейма | только allow-scripts |
| X-Content-Type-Options | nosniff |
| Изоляция origin | URL артефакта из конфигурации deployment |
JavaScript выполняется, но соединения приложения ограничены — fetch, XHR и WebSocket заблокированы.
Используйте артефакты для самодостаточного интерактивного контента (дашборды, калькуляторы,
визуализации со встроенными данными), а не для того, что должно обращаться к серверу.
Брендинг и жалобы
Каждый артефакт показывается на странице-обёртке с фиксированной нижней панелью:
- Атрибуция — ссылка «Created with Moira». Поскольку футер находится в обёртке (отдельный документ от артефакта), контент артефакта не может его перекрыть или удалить.
- Жалоба — ссылка «Report» позволяет зрителям пожаловаться на вредоносный контент для проверки. Уведомление администраторам использует их включённые и настроенные каналы связи. Оно выполняется best effort: отсутствие или отказ доставки не отменяют подачу жалобы.
Обёртка (предупреждение при первом открытии и футер) отображается на английском или русском языке в зависимости от языка браузера зрителя, с переключателем EN/RU в правом нижнем углу. Это касается только обёртки Moira, но не самого контента артефакта.
Вредоносные артефакты могут быть заблокированы администраторами, после чего они немедленно перестают обслуживаться.
Интеграция с Workflow
Паттерн Workspace
Используйте артефакты с паттерном workspace для организации результатов workflow:
./project-analysis/├── step-1/│ └── data-collection.md├── step-2/│ └── analysis.md└── artifacts/ ├── dashboard.html # → загрузить как артефакт └── summary-report.html # → загрузить как артефактСвязь с Execution
Передайте executionId в multipart- или JSON-теле загрузки по токену для связи с выполнением.
При inline-загрузке через MCP используйте аргумент действия:
artifacts({ action: "upload", name: "execution-report.html", content: "...", executionId: "exec-abc-123"})Связанные артефакты отображаются в UI инспектора выполнений.
Web UI
Артефакты управляются через веб-интерфейс на странице /app/artifacts:
- Просмотр артефактов с именем, размером, URL и датой истечения
- Загрузка новых артефактов с HTML-редактором
- Редактирование содержимого существующих артефактов
- Копирование публичного URL в буфер обмена
- Открытие артефактов в новой вкладке
- Удаление артефактов
- Мониторинг использования квоты с визуальным индикатором
Связанные темы
- Справочник MCP Tools — действия и схемы tool
artifacts - Создание Workflow — паттерн Workspace для организации результатов