Готовые интерфейсы для приложения
Соберите приложение из готовых блоков и настройте его под свой дизайн.
Что это
Agent использует готовые блоки и рецепты приложения: таблицы, карточки, формы, поиск, фильтры, календарь, переписку, уведомления, загрузку файлов и состояния ошибок. Вы можете изменить цвета, плотность, поля и расположение блоков, сохранив общий механизм работы.
Чекбоксы в готовых таблицах и формах используют общий компонент Agnostic. У него есть выбор всей строки подписи, состояние частичного выбора, отключённое состояние и работа с клавиатуры. Сообщение ошибки связано с полем и доступно программам чтения экрана. Переключатели настроек сохраняют свой отдельный вид.
Технический рецепт показывает серверные состояния операций и отдельные права на действия. Неподтверждённый запуск можно явно продолжить; отменённый шаг отличается от ошибки. Для подключения используйте контекст и адаптер операций из App Kit, затем собирайте собственный экран, поля запуска и навигацию. Без проверенного серверного подключения этот раздел остаётся недоступным.
Как сделать
- Опишите сценарий: кто работает с приложением, какие данные видит и какие
действия выполняет. Например: «CRM заявок с ответственными и вложениями».
- Укажите свой дизайн или попросите использовать дизайн Agnostic. Пришлите
требования к цветам, шрифтам и расположению, если они уже определены.
- Проверьте выбранные данные, доступ пользователей и необходимые серверные
возможности. Готовый экран сам по себе не подключает оплату, бронирование или потоковый AI-ответ.
- После генерации проверьте пустое приложение, создание записи, сохранение,
повторное открытие и работу с другой ролью. Тестовые данные включайте явно.
- Настраивайте блоки в коде приложения. При обновлении рецепта просмотрите
изменения: пересекающиеся правки требуют разрешения конфликта.
Какие приложения можно собрать
| Сценарий | Что уже есть в интерфейсе |
|---|---|
| CRM и бэк-офис | Реестр, фильтры, сортировка, карточка, ответственные, воронка и выбор нескольких записей |
| Дашборд и кабинет | Показатели по загруженным данным, мои заявки, профиль и комментарии |
| Согласования и документы | Очередь решений, история, вложения, загрузки и просмотр доступных файлов |
| Планирование и поддержка | Канбан, календарь, исполнители, входящие обращения и переписка |
| Заказы, магазин и запись | Позиции, остатки, корзина, доступные слоты и подтверждение бронирования |
| Контент, консоль и AI | Дерево материалов, версии, операции и журналы, разговоры и подтверждения действий |
Для каталога услуг и сообщества есть отдельные исходники блоков карточек, участников, событий, заявок и отзывов. Агент может сочетать их с кабинетом, магазином или другими экранами. Подключите проверенный серверный адаптер и обновляйте контекст после изменения прав или участия. Черновики и решения модератора доступны по текущим правам; свободные места и сроки определяет сервер. Формы редактирования и итоговую структуру приложения создавайте под свой сценарий.
Для загрузок доступны выбор и перетаскивание нескольких файлов, проверка ограничений, очередь, отмена и повтор. Отправленный файл может оставаться на обработке: скачивание доступно после подтверждения готовности сервером. При потере связи загрузки приостанавливаются; после подключения продолжите их явно.
Формы сохраняют введённые данные при ошибке. Если запись изменил другой пользователь, сравните версии перед сохранением. При переходе с несохранённым черновиком можно продолжить редактирование или отказаться от изменений.
В примерах настройки темы и плотности открываются кнопкой «Настройки примера». Выход находится в меню аккаунта. На телефоне подробности выбранной записи заменяют список; широкие таблицы прокручиваются внутри своей области. Базовый шрифт Inter поставляется с библиотекой и не требует внешнего подключения.
В разделе «Комбинации интерфейсов» доступны 42 варианта для 14 типов приложений. Выберите тип, компоновку и состояние, затем сравните обычную и компактную плотность, ширину 390 или 768 пикселей, доступ для чтения и редактирования. Каждый вариант открывается внутри отдельного приложения с предметной навигацией. Кнопка «Настройки сравнения» над приложением открывает состояния, ширину, плотность, анимации и режим доступа. «Оформление приложения» меняет тему. Анимации учитывают системные настройки; их можно отключить для сравнения. При переключении панелей черновик остаётся на месте. Текст статьи, ответ в переписке и комментарий принадлежат выбранной записи: переход к другой записи не переносит туда чужой черновик.
В календаре длинные названия событий отображаются одной строкой. В компактном варианте событие обозначено точкой; нажмите её, чтобы открыть подробности.
Галерея использует явно заданные демонстрационные данные. «Открыть рабочий пример» переводит к рецепту с отдельным тестовым API. В блоке «Как собрать такой интерфейс» находятся состав компонентов, ссылки на референсы и параметры, которые можно передать Agent. Эти параметры описывают интерфейс; серверные возможности и права нужно подключить в самом приложении.
При конфликте текста или задачи сначала сравните свой черновик с актуальной версией. «Продолжить с черновиком» сохраняет введённые изменения для дальнейшей работы; загрузка версии сервера требует подтверждения замены. В переписке прокрутка вверх приостанавливает следование новым сообщениям. Кнопка «К последним сообщениям» возвращает к продолжению разговора.
Что дальше
Новые приложения начинают с пустых данных. После подключения API интерфейс показывает реальные записи и права текущего пользователя. Ваши изменения в установленном рецепте сохраняются при безопасном обновлении.
Для локальной интеграции доступны пакеты @nsp-labs/agnostic-ui, @nsp-labs/agnostic-app-kit и @nsp-labs/agnostic-app-recipes. До публикации в npm используйте собранные архивы пакетов; новые шаблоны приложений уже содержат необходимые копии UI и механизмов состояния.
Текущие версии: UI 0.2.0, App Kit 0.8.0, App Recipes 0.7.0. Новая версия каталога требует App Kit 0.8.0: формы сохраняют строковые версии Runtime SDK без преобразования в число. Для мини-приложений MAX используйте отдельный браузерный экспорт @nsp-labs/agnostic-app-kit/max; вход и проверку запуска выполняет сервер.
Карточки могут показывать этапы обработки через availableActions и createRecordActionsAdapter.transition. Сначала настройте и проверьте серверные переходы и роли: сама кнопка не даёт права изменить статус. Для последовательных согласований можно потребовать разных участников. При конфликте комментарий сохраняется, а повтор после потерянного ответа использует прежнее подтверждение. Подробнее: последовательные этапы.
Для записи по времени используйте createBookingAdapter: он подключает слоты, свои записи, подтверждение, отмену и перенос к серверному календарю. Сервер задаёт вместимость и срок резерва. При изменении записи интерфейс сохраняет контакт и предлагает принять текущую версию; после принятого действия повторяет только чтение. Подробнее: запись и бронирование.
Частые проблемы
| Проблема | Что сделать |
|---|---|
| Экран есть, но действие недоступно | Проверьте подключение серверной возможности и права пользователя. |
| Изменения не сохраняются | Проверьте ошибку API и обязательные поля; при конфликте перечитайте запись перед повтором. |
| Нужны собственные блоки | Сохраните общие механизмы форм, сохранения и ошибок, изменив представление. |
| Обновление остановилось на конфликте | Сравните свои изменения с новой версией рецепта и повторите план обновления после исправления. |