ym88659208ym87991671
Работа с блоками для смартапов | Документация для разработчиков

Работа с блоками

Обновлено 20 февраля 2024

Блок — это минимальная единица, из которой строится сценарий смартапа. Блок задает действие, которое смартап совершит в процессе диалога с пользователем. Например:

  • вывод текста и изображений на экран;
  • перевод в режим ожидания действия пользователя, например, ввода фразы;
  • выполнение фоновых действий, например, HTTP-запросов.

Описание каждого из блоков Graph вы найдете в соответствующем подразделе.

Как работают блоки

Блоки добавляются на экран сценария.

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

Пример экрана с тремя блоками:

Пример последовательности блоков

При работе с представленным экраном ассистент будет действовать в следующей последовательности:

  1. Выведет сообщение «Привет!» из первого блока Текст.
  2. Выведет сообщение «Ты хочешь поучаствовать в нашей программе?» из второго блока Текст.
  3. Выполнит блок Интенты: будет ждать реакции пользователя и, в зависимости от ответа, выполнит следующее необходимое действие.

Связи блоков

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

В приведенном примере, после того как ассистент скажет «Привет!» и «Ты хочешь участвовать в нашей программе?», смартап будет ждать реакции пользователя. Если пользователь скажет «да», то ответ пользователя попадет в интент Согласие, и ассистент перейдет к связанному экрану.

Добавление блоков

Блоки можно добавлять как на новые, так и на уже существующие экраны.

Добавление блока на новый экран

Чтобы добавить блок на новый экран сценария:

  1. Нажмите кнопку Добавить экран.

    Откроется список всех блоков.

  2. Выберите блок из списка и заполните его параметры.

  3. Сохраните блок.

Будет создан новый экран, с заданным блоком.

Добавление блока на существующий экран

Чтобы добавить блок на существующий экран:

  1. Наведите курсор на экран, куда требуется добавить блок.
  2. Нажмите кнопку Добавить блок.
  3. Выберите блок из списка и заполните его параметры.
  4. Сохраните блок.

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

Например, на экран с блоком HTTP-запрос нельзя добавить блоки Ввод текстаВвод числаНомер телефонаИнтенты и другие. Это связано с тем, что блок HTTP-запрос предполагает дальнейшие действия, после которых эти блоки станут недоступны.

Параметры блока

Блоки обладают параметрами, которые определяют логику смартапа.

Например:

  • В блоке Текст можно указать текст, который будет писать или произносить ассистент и дополнительные реплики, которые будут выбираться случайным образом, а также добавить опции для голосового ассистента, например, разметку синтеза речи.
  • В блоке HTTP-запрос можно указать адрес, к которому будет обращаться смартап, выражение и переменную, в которую будет записан результат, данные, которые будут передаваться, формат передаваемых данных и другие параметры.

Изменение названия блока

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

Вы можете изменить название, чтобы лучше ориентироваться в сценарии смартапа.

Для этого:

  1. Откройте блок.
  2. Нажмите на название блока.
  3. Укажите новое название.

Переменные

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

Некоторые блоки, например, Ввод числа или Ввод текста, создают переменные с определенным именем, куда сохраняют полученные в этом блоке данные. Так, блок Ввод числа сохранит в переменную $number число, которое ввел пользователь.

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

Управление блоками

Блоки можно копировать и вырезать, чтобы добавить их на уже существующие экраны. Связи блоков не копируются при этом.

Чтобы копировать или вырезать блок:

  1. Откройте меню в правой части блока.
  2. Выберите пункт Скопировать или Вырезать. Если вы вырезали блок и хотите отменить действие, нажмите CTRL+Z.
    Меню действий с блоком
  3. Чтобы добавить блок или экран на существующий экран, нажмите кнопку Добавить блок или Добавить экран. Блок, который вы скопировали, будет первым в списке.

Блок нельзя вставить на экран, если он содержит несовместимые блоки.

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.