Поддержка диалоговых действий будет прекращена 13 июня 2023 г. Дополнительные сведения см. в разделе Закрытие диалоговых действий .

Краткое руководство по Actions SDK и Builder

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Это руководство поможет вам настроить среду для создания действий с помощью пакета SDK для действий и построителя действий. Вы будете выполнять следующие задачи:

  • Установите Node.js: вам нужна эта среда выполнения, чтобы использовать нашу библиотеку выполнения Node.js.
  • Установите интерфейс командной строки Firebase: этот инструмент командной строки позволяет разрабатывать и развертывать зависимости Firebase, такие как веб-приложения для Interactive Canvas , на хостинге Firebase.
  • Установите инструмент командной строки gactions: при разработке с помощью SDK действий вы используете этот инструмент для создания, управления и развертывания пакета действий для вашего действия.
  • Создайте проект Actions. Проект Actions — это логический контейнер для ваших диалоговых действий. Вы должны создать его в консоли действий, прежде чем сможете начать сборку.
  • Инициализация и развертывание примера. В этом простом примере показано, как приступить к созданию действий на основе интерактивного холста.

После завершения этого краткого руководства вы сможете синхронизировать свой проект Actions между локальной средой разработки и веб-интерфейсом Actions Builder.

Установите Node.js и интерфейс командной строки Firebase.

Загрузите и установите Node.js в соответствии с документацией Node.js, чтобы использовать нашу библиотеку выполнения. Ваша установка Node.js также позволяет вам установить интерфейс командной строки Firebase с npm , а затем запустить реализацию диалогового выполнения локально.

Установите и настройте интерфейс командной строки Firebase в соответствии с документацией Firebase. Интерфейс командной строки Firebase позволяет развернуть веб-приложение Interactive Canvas на хостинге Firebase и, при необходимости, вручную развернуть выполнение в облачных функциях для Firebase.

Установите инструмент командной строки gactions

Установите инструмент интерфейса командной строки (CLI) gactions, загрузив установочный пакет, распаковав его и настроив путь выполнения.

Чтобы установить и настроить gactions, выполните следующие действия:

  1. Загрузите соответствующий пакет для вашей операционной системы:

    Платформа Упаковка Контрольная сумма
    Окна Скачать SHA256
    линукс Скачать SHA256
    Mac OS Скачать SHA256

  2. Извлеките пакет в любое место по вашему выбору и добавьте двоичный файл в переменную PATH вашей среды. В качестве альтернативы извлеките пакет в место, которое уже находится в вашей PATH (например, /usr/local/bin ).

  3. В Linux и Mac при необходимости включите разрешения на выполнение:

    chmod +x PATH_TO/gactions

  4. Выполните следующую команду для аутентификации CLI. Эта команда запускает процесс аутентификации и требует веб-браузера:

    gactions login

    Когда поток завершен, CLI автоматически аутентифицируется.

Создать и настроить проект

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

  1. Перейдите в консоль действий .
  2. Щелкните Новый проект , введите имя проекта и щелкните Создать проект .
  3. Выберите категорию и нажмите « Далее ».
  4. Выберите Пустой проект и нажмите Начать сборку .
  5. Включите API действий в консоли Google Cloud, следуя инструкциям в разделе Включение и отключение API . Это позволяет фракциям взаимодействовать с вашим проектом.

Получите образец приветствия, мир

Интерактивный образец hello world показывает, как создать простой проект Actions с одним Action на базе Interactive Canvas.

  1. Создайте пустой каталог и инициализируйте образец Interactive Canvas в этом каталоге. Например, следующий код инициализирует образец в каталоге interactive-canvas-sample/ , который используется в качестве примера в этом документе:

    gactions init interactive-canvas --dest interactive-canvas-sample
cd interactive-canvas-sample

  2. Откройте interactive-canvas-sample/sdk/settings/settings.yaml и измените значение поля projectId на идентификатор вашего проекта.

Разверните и протестируйте образец

После настройки примера вы можете развернуть веб-приложение Interactive Canvas и проект Actions. Этот процесс создает черновую версию вашего проекта Actions, которую вы можете развернуть в симуляторе Actions для предварительного просмотра и тестирования:

  1. В каталоге interactive-canvas-sample/ выполните следующую команду, чтобы развернуть веб-приложение Interactive Canvas (содержимое каталога public/ ).

    firebase deploy --project PROJECT_ID --only hosting

    Вы можете увидеть обработанную версию веб-приложения по URL-адресу, возвращаемому интерфейсом командной строки Firebase в браузере: https:// PROJECT_ID .web.app .

  2. Откройте interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js и измените значение переменной CANVAS_URL на URL-адрес веб-приложения вашего проекта.

    const CANVAS_URL = 'https://PROJECT_ID.web.app';

  3. В каталоге interactive-canvas-sample/sdk/ выполните следующую команду, чтобы отправить локальную версию вашего проекта Actions на консоль в качестве черновой версии:

    gactions push

  4. В каталоге interactive-canvas-sample/sdk/ запустите следующую команду, чтобы протестировать проект Actions в симуляторе:

    gactions deploy preview

  5. Откройте ссылку, которую возвращает инструмент командной строки, чтобы перейти к симулятору.

  6. В симуляторе введите «Поговорить с интерактивным образцом холста» , чтобы запустить действие. Вы должны увидеть вращающийся треугольник на базе веб-приложения, развернутого по адресу https:// PROJECT_ID .web.app

    Рисунок 1 . Симулятор предварительного просмотра проекта Actions