Артефакты
Что такое артефакт
Артефакт — это единица работы команды в ArtiRoute.
Это может быть документ, таблица, схема, файл или папка. Любой артефакт имеет тип, название и историю версий.
Артефакты и файлы
В ArtiRoute файлы не живут отдельно от документов: загруженный файл — это такой же артефакт типа Файл.
Поэтому команде проще работать в одном дереве и не переключаться между разными разделами.
Типы артефактов
Тип определяет, как материал открывается, редактируется и проверяется в процессе.
- Документ — текст с форматированием;
- Таблица — строки и колонки с типами полей;
- Файл — просмотр и скачивание (PDF, изображения и др.);
- Office-документ / таблица — через расширение OnlyOffice;
- BPMN-схема — через расширение BPMN.
Подробнее: Типы артефактов.
Версионирование
Каждое сохранение фиксирует новую версию. Это ваша «страховка» и прозрачная история изменений:
- сохраняются автор и время;
- можно оставить комментарий к версии;
- в Истории версий просматриваются прошлые состояния;
- переключение версии в редакторе показывает содержимое на выбранный момент.
Черновые правки отделены от сохранённых версий, поэтому вы всегда понимаете, что уже зафиксировано, а что ещё нет.

Доработка с ИИ
ИИ в ArtiRoute лучше всего работает как соавтор: вы задаёте задачу, система предлагает вариант, вы подтверждаете итог.
- Сгенерировать с ИИ — при создании из шаблона с включённой генерацией;
- Доработать с ИИ / панель агента в редакторе — описать, что изменить;
- @упоминания — подключить другие артефакты пространства в контекст запроса;
- Команды генерации — готовые сценарии (например, «Генерация по шаблону»), если они доступны для данного артефакта.
Подробнее о работе в редакторе: Редактор артефакта.

Шаблоны
Шаблон нужен, когда команда хочет единый формат материалов: одинаковую структуру, обязательные блоки и, при необходимости, стартовую инструкцию для ИИ.
- Пустой артефакт — без шаблона, только выбранный тип;
- Из шаблона — копия структуры шаблона;
- Сгенерировать с ИИ — создать и сразу открыть редактор с автоматическим запросом к ИИ (если у шаблона включена генерация).
Управление библиотекой шаблонов — у администратора. Использование: Шаблоны.
Статусы артефактов
В базовой поставке вы не ограничены жёстким процессом согласования.
Если в организации установлен модуль статусов или review-процесса, у артефактов появятся дополнительные состояния и действия.
→ См. документацию соответствующего расширения в Расширения.
Валидация артефактов
Валидация проверяет материал по правилам команды: обязательные поля, формат, логическую целостность.
Часть проверок доступна сразу, расширенные сценарии обычно приходят через расширения.
→ См. Расширения.
Поиск и индекс знаний
Поиск по названию помогает быстро найти материал в дереве.
Индекс знаний отвечает за то, чтобы ИИ и поиск «понимали» содержимое артефактов.
Индексация идёт в фоне, поэтому после крупных обновлений данных результат может появиться не мгновенно.
Подробнее о том, как ИИ использует индекс в чате: AI-чат пространства.

Совместная работа
ArtiRoute рассчитан на одновременную работу нескольких участников:
- в шапке пространства видно, кто сейчас online;
- если кто-то редактирует артефакт, другим при открытии того же артефакта показывается предупреждение — редактирование может быть недоступно до освобождения;
- каждый может работать со своим артефактом и со своим запросом к ИИ параллельно.
