Создание живого приложения на холсте

«Экспорт работает слишком медленно». «На телефоне мелкий текст». «Добавьте тёмную тему». «Отзывы разбросаны где попало». За две недели интервью с клиентами продуктовая команда заполнила доску свободного формата такими заметками, и последняя из них самая честная: отзывы повсюду, и никто не может сказать, какую просьбу повторили пять раз, а какую только однажды.

Обычно всё переносят в отдельную таблицу где-то на стороне. Неделю это работает. Потом на холсте появляются новые отзывы, таблица отстаёт, и команда спорит, опираясь на два разных списка. Живое приложение убирает этот разрыв. Вы описываете нужный инструмент, ALLO собирает работающее приложение, и оно запускается прямо на холсте, рядом с заметками, из которых выросла идея. Вся команда может его пополнять и голосовать в нём, а позже им можно поделиться с людьми за пределами рабочего пространства.

В этом руководстве мы пройдём вместе с командой путь от первого запроса до второй версии доски клиентских отзывов и разберём, кто и что может делать на каждом шаге.

Коротко о главном

На доске свободного формата нажмите Добавить живое приложение на панели инструментов, опишите нужное приложение и отправьте запрос. Ответьте на вопросы, которые задаст Lead, и продолжайте работать, пока идёт сборка. Пользуйтесь готовым приложением вместе с командой прямо на холсте, а когда ссылка понадобится кому-то извне, нажмите Опубликовать в панели Поделиться. Изменения просите в том же чате: все сохранённые записи переходят в следующую версию.

В этом 94-секундном обзоре план запуска и фотография кружки превращаются в приложение для предзаказов. Затем создатель просит в чате приложения добавить лист ожидания. В пошаговом разборе ниже все шаги объясняются на примере доски клиентских отзывов.

Подходит ли этот холст

Живые приложения работают только на досках свободного формата. На холстах со страницами, холстах со слайдами и компактных холстах этого инструмента нет, поэтому если ваши заметки лежат на холсте со страницами, заведите для приложения доску свободного формата. Чем различаются эти два формата, объясняет статья Холсты со страницами и доски свободного формата.

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

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

Запрос прямо с холста

Попасть в окно создания можно двумя путями, и оба ведут в одно и то же окно.

1. С панели инструментов. Нажмите Добавить живое приложение (значок с искрами) в первой группе панели инструментов, рядом с Основной инструмент "Мышь", Инструмент для "Рисования", Загрузить файл и Комментарий. Подсказка к кнопке гласит: «Создайте живое приложение: артефакт, построенный в чате и работающий на холсте».
2. Из выделения. Выделите заметки, текстовые блоки, таблицы, изображения или файлы, от которых должно отталкиваться приложение, и нажмите Открыть в AI Studio на встроенной панели инструментов. Окно откроется, и выделенное уже будет прикреплено.

Команда выбирает панель инструментов: её запрос умещается в одно предложение. Если же приложение должно опираться на конкретные заметки или файлы, второй путь избавляет от необходимости перепечатывать их содержимое. Кнопка Открыть в AI Studio не появляется, если в выделение попал заблокированный объект, заполнитель, объект, который ещё генерируется, или запрещённый файл.

В этом ролике окно открывается с панели инструментов, а запрос уходит, пока заметки из интервью остаются перед глазами.

Само нажатие на инструмент ничего не создаёт. Пока вы не отправите сообщение или не прикрепите файл, ничего не появится.

Сначала запрос, потом сборка

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

Переключатели видны, только пока тип ещё можно выбрать. Для доски отзывов оставьте Авто.

Если не знаете, как сформулировать запрос, откройте Начните с идеи. Выбранная идея подставится в черновик, и её можно отредактировать. Пока вы не отправите запрос, ничего не начнётся.

Файлы, с которыми должно работать приложение, прикрепите скрепкой (Прикрепить) или перетащите в чат. Принимаются таблицы (xlsx, xls, csv, tsv), документы (pdf, doc, docx, ppt, pptx, md, txt, json, html), изображения, аудио и видео. Прикреплённые изображения служат референсами для сборки.

Команда пишет одно предложение: доска для клиентских отзывов, где у каждого отзыва своя карточка и за него можно проголосовать. Нажмите Enter, чтобы отправить.

Сборка идёт, а вы работаете дальше

После отправки в разговоре видно, как продвигается работа.

• Если что-то неясно, Lead сначала спрашивает. Вопросы приходят в виде вариантов на выбор или короткой карточки для ввода. Пока вы не ответите, в окне видно Ждём вашего ответа. Продолжите в чате. Если пропустить вопрос, Lead сам выберет направление и скажет, какое именно.
• Как всё прошло перечисляет этапы и показывает, сколько в каждом сделано, от планирования до проверки качества и тестирования поведения.
• На холсте карточка в это время показывает Создание живого приложения…

Закройте окно и продолжайте работать с холстом: сборка не прервётся. Если по ходу появилась новая мысль, всё равно напишите её. Кнопка Отправить сменится на Поставить уточнение в очередь, и запрос дождётся своей очереди, не прерывая сборку. Чтобы отменить сборку, нажмите кнопку остановки. Итог будет помечен как Остановлено, а опубликованная версия не изменится.

Иногда готовая сборка не включается сразу, а ждёт вашего решения. В чате появляется Нужна ваша проверка с кнопками Посмотреть результат, Исправь ещё раз и Не использовать. Посмотреть результат открывает превью без подключения к реальным данным, поэтому ничего из введённого там не сохранится. Выберите Исправь ещё раз, чтобы отправить результат на доработку, или Не использовать, чтобы отказаться от него и оставить текущую версию. Когда автоматические исправления заканчиваются, кнопка Исправь ещё раз пропадает. Тогда отправьте новый запрос в чате.

Когда сборка завершится, доска появится на холсте рядом с заметкой, из которой выросла. Следите за правым нижним углом: там появится счётчик Живые приложения.

Кто пользуется приложением, а кто его меняет

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

В этом ролике двое коллег одновременно добавляют отзывы и голосуют, и все карточки и голоса попадают в одну доску.

Пользоваться приложением и менять его разрешено не одним и тем же людям. В заголовке окна указан создатель (Автор приложения), и общаться с живым приложением в чате или менять его могут только две группы людей:

Создатель добавляет людей в разделе Управление → Обзор → Администраторы приложения кнопкой Добавить администратора. Права на редактирование холста не делают человека администратором приложения. Так задумано: коллега, который переставляет заметки, не должен случайно переписать доску отзывов.

Что люди могут делать с данными приложения, настраивается отдельно. В разделе Управление → Данные у каждой коллекции есть блок Права доступа к коллекции. Владелец и администраторы всегда имеют полный доступ. Строка Все остальные охватывает участников холста, гостей и посетителей по опубликованной ссылке. Создатель меняет её кнопкой Изменить доступ:

• Просмотр и Добавление либо включены, либо выключены.
• Для Изменять и Удалять есть значения Выключено, Только свои и Все.

Нажмите Сохранить, чтобы применить настройки. Когда вы включаете Просмотр, ALLO сначала предупреждает, что данные станут видны, и вы подтверждаете это кнопкой Открыть доступ к записям. Для доски отзывов разумно включить Просмотр и Добавление, для Изменять выбрать Только свои, а Удалять оставить в положении Выключено.

Публикация и отправка ссылки

Команда хочет, чтобы участники интервью добавляли отзывы сами. Живое приложение остаётся на холсте, пока вы его не опубликуете. Само по себе оно никуда не уходит.

1. Откройте живое приложение и нажмите значок общего доступа, чтобы открыть панель Поделиться.
2. Нажмите Опубликовать. В панели появится пояснение: «Поделитесь этой версией по ссылке. Последующие правки остаются закрытыми, пока вы не опубликуете снова.»
3. Нажмите Скопировать ссылку (или Открыть в новой вкладке, чтобы проверить самостоятельно) и отправьте ссылку.

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

Посмотрите весь путь целиком: доска публикуется, ссылка копируется и уходит адресату, а участник интервью открывает её в браузере без аккаунта ALLO и добавляет запись.

Участник интервью смог добавить запись, потому что коллекция разрешает Добавление для строки Все остальные. Права доступа к коллекции действуют на посетителей по ссылке точно так же, как на участников холста.

Статус в панели Поделиться показывает, где вы находитесь: Опубликовано, Изменения не опубликованы (опубликована более ранняя версия, а последние правки ещё не видны по ссылке) или Не опубликовано. Снять с публикации закрывает ссылку. Холст при этом остаётся как есть.

Следующая версия

Через неделю доска заполнена, и команде нужно понимать, какие карточки уже в работе. Об этом просят в том же чате: добавить каждой карточке статус.

Уточнения пишутся в том же разговоре (Продолжите запрос…). Каждое завершённое изменение, после которого сохраняется новая версия, получает контрольную точку (Контрольная точка v1, Контрольная точка v2 и так далее). В заголовке видна текущая Версия, а в панели Версии более раннюю версию можно вернуть кнопкой Восстановить.

В ролике вторая версия добавляет статус каждой карточке и занимает на холсте то же место, а все записи из первой версии остаются на месте.

Вот правило, которое стоит запомнить: при изменении кода данные остаются с приложением. Отзывы, голоса и запись участника интервью переходят во вторую версию. Верно и обратное: восстановление старого кода не возвращает удалённые данные.

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

Бывает, что уточнение на деле просит о чём-то другом. Попросите одностраничную сводку по отзывам, и ALLO спросит, где её создать, отметив рекомендуемый вариант:

• Если создать её в этом объекте, новый результат заменит текущий объект. Предыдущую версию можно будет восстановить из истории версий.
• Новый объект оставляет этот объект и его разговор нетронутыми. В новый объект уходит только этот запрос, поэтому нужные файлы прикрепите заново.

Для доски отзывов выберите Новый объект: доска продолжает работать, а сводка становится отдельным объектом. Документ, таблица, изображение или аудиообъект не может стать веб-приложением, поэтому такой запрос тоже уходит в новый объект.

Данные, ключи и расписания на вкладке «Управление»

Те, кто может управлять приложением, видят вкладки Просмотр, Код и Управление. Код доступен только для чтения и показывает Журнал запуска, Активность и Файлы. На вкладке Управление приложение ведут изо дня в день, и статья Управление живым приложением разбирает каждый её раздел. Если коротко:

• Данные. Правьте записи, загружайте их через Добавить из файла CSV и следите за блоком Использование записей: каждое приложение хранит до 10 000 записей, а файлы, прикреплённые к записям, учитываются в хранилище рабочего пространства. Подробнее в разделе Следите за лимитом записей в разделе «Данные».
• Изменения из чата. Когда вы просите ИИ (модель) изменить или удалить сохранённую запись, ничего не меняется, пока вы не выберете Применить в строке на проверку, а Отменить отклоняет предложение. Подробнее в разделе Проверка изменений ИИ в сохранённых данных.
• Секреты. Ключами приложения управляет только создатель, ИИ (модель) никогда не видит их значений, а для Показать значения пароль не нужен. Подробнее в разделе Ключи в разделе «Секреты».
• Автоматизация. Повторять задачу приложения повторяет ваш последний запрос и расходует кредиты ИИ, а Только обновлять данные бесплатно подтягивает свежие данные. Подробнее в разделе Расписание в разделе «Автоматизация».
• Общий доступ. Опубликованная версия, адрес приложения и описание для превью ссылки. Подробнее в разделе Публикация версий и ссылка в разделе «Общий доступ».

Создать копию (в контекстном меню объекта) копирует приложение на холст, который вы можете редактировать, причём копия начинается с пустыми данными. Удалить приложение навсегда в настройках данных удаляет все копии и всё, что они сохранили. Отменить это нельзя.

Все живые приложения на холсте

Когда на холсте больше одного живого приложения, пользуйтесь кнопкой Живые приложения в правом нижнем углу. Она показывает, сколько их, и открывает список с поиском («Поиск по названию или источнику данных»), где первыми идут недавно обновлённые. Выберите строку, чтобы открыть приложение, или нажмите Показать на холсте, чтобы перейти к месту, где оно находится. Их также перечисляет командная палитра.

Оплата сборок кредитами ИИ

Сборки расходуют кредиты ИИ рабочего пространства: списывается ровно то, что использовала каждая сборка. Создание или изменение приложения обычно стоит 300-700 кредитов. Изображения, озвучка и музыка, которые создаёт приложение, расходуют кредиты отдельно, а ответ в чате, который ничего не меняет, стоит гораздо меньше. Неудачная сборка ничего не стоит. Для запуска сборки нужен минимальный остаток кредитов, а запуски Повторять задачу приложения по расписанию расходуют кредиты каждый раз.

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

Если что-то пошло не так

Не видно кнопки «Добавить живое приложение». Проверьте следующее:

• Это холст со страницами или холст со слайдами. Живые приложения работают только на досках свободного формата.
• У вас нет прав на редактирование холста.
• Вы открыли холст в мобильном браузере. Там на панели инструментов нет Добавить живое приложение, но выделить объекты и нажать Открыть в AI Studio можно.

Сборка застряла на «Ждём вашего ответа. Продолжите в чате». Lead задал вопрос. Откройте живое приложение и ответьте в чате.

В результате написано «Нужна ваша проверка». Сборка завершилась, но ещё не включена. Откройте Посмотреть результат, проверьте его и выберите Исправь ещё раз или Не использовать. Если кнопки Исправь ещё раз нет, автоматические исправления исчерпаны, поэтому опишите исправление в новом сообщении.

Появилось сообщение «Запуск остановлен из-за проблемы». Запуск не удался, и кредиты не списаны. Нажмите Повторить этот запрос. Черновик и запрос сохранены, а последняя рабочая версия не изменилась. Если повторы раз за разом не помогают, загляните в статью Если результат ИИ получился неверным.

Появилось сообщение «Не удалось завершить часть медиа». Проверьте метку у каждого элемента:

• Сервис генерации перегружен. Повторите попытку. За этот элемент ничего не списано. Повторите попытку именно для него.
• Не подтверждено. Результат не удалось подтвердить. ALLO не покупает его повторно автоматически.

Появилось сообщение «AI-кредиты закончились». Администраторы увидят кнопку Купить кредиты. Остальным нужно попросить владельца или администратора рабочего пространства пополнить кредиты. Подробнее в статье Как работают кредиты ИИ.

Коллега не может открыть разговор или изменить приложение. Это доступно только создателю и администраторам приложения, которых он добавил. Попросите создателя добавить коллегу в разделе Управление → Обзор → Администраторы приложения и включить Делиться перепиской, если коллеге нужен чат.

Посетители по ссылке не могут добавлять записи. Коллекция этого не разрешает. Создатель открывает Управление → Данные, нажимает Изменить доступ, включает Добавление для строки Все остальные и нажимает Сохранить.

Появилось сообщение «Лимит записей приложения достигнут». Приложение упёрлось в лимит в 10 000 записей, или изменение, которое вы пытались внести, вышло бы за него. Создатель и администраторы приложения нажимают в уведомлении Связаться с нами, чтобы запросить более высокий лимит, а остальные обращаются к администратору приложения. Как устроен лимит, объясняет статья Управление живым приложением.

Не удаётся прикрепить файл. «Администратор рабочего пространства заблокировал этот тип файлов» означает, что администратор ограничил этот тип. «Хранилище рабочего пространства заполнено» означает, что нужно удалить файлы или добавить место. Подробнее в статье о лимитах хранилища.

Если ничего из этого не подходит, обратитесь в поддержку и приложите ссылку на холст и точный текст сообщения.