Обзор Actions SDK (Dialogflow)

Actions on Google позволяет расширить функциональность Google Assistant с помощью Actions . Действия позволяют пользователям выполнять задачи через диалоговый интерфейс, который может варьироваться от быстрой команды для включения света до более длительного разговора, например, игры в викторину.

Actions SDK — это метод разработки выполнения разговоров без использования Dialogflow. При использовании Actions SDK вы используете пакет действий для сопоставления намерений с их выполнением. Вы также должны предоставить шаблоны запросов в пакете действий, чтобы определить примеры фраз, которые могут произнести ваши пользователи.

интерфейс командной строки

При разработке с помощью Actions SDK вы используете интерфейс командной строки (CLI) gactions для тестирования и обновления проекта Actions. Интерфейс командной строки gactions также помогает вам создавать пакет действий для вашего диалогового действия и управлять им.

Создайте действия в своем пакете действий.

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

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

  • «Эй, Google, поговори с exampleAction».
  • «Окей, Google, поговори с exampleAction, чтобы купить туфли».
  • «Окей, Google, поговори с exampleAction, чтобы проверить мой заказ».
  • «Окей, Google, поговори с exampleAction, чтобы показать мне сегодняшние предложения».

JSON-файл пакета действий может выглядеть примерно так:

{
  "actions": [
    {
      "name": "MAIN",
      "intent": {
        "name": "actions.intent.MAIN"
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "BUY",
      "intent": {
        "name": "com.example.ExampleAction.BUY",
        "parameters": [{
          "name": "color",
          "type": "org.schema.type.Color"
        }],
        "trigger": {
          "queryPatterns": [
            "find some $org.schema.type.Color:color sneakers",
            "buy some blue suede shoes",
            "get running shoes"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "ORDER_STATUS",
      "intent": {
        "name": "com.example.ExampleAction.ORDER_STATUS",
        "trigger": {
          "queryPatterns": [
            "check on my order",
            "see order updates",
            "check where my order is"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "DAILY_DEALS",
      "intent": {
        "name": "com.example.ExampleAction.DAILY_DEALS",
        "trigger": {
          "queryPatterns": [
            "hear about daily deals",
            "buying some daily deals",
            "get today's deals"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    }
  ],
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  }
}

Создайте и разверните вебхук выполнения

Когда вызывается действие в вашем проекте, Actions on Google вызывает ваше выполнение, чтобы начать разговор с пользователями для выполнения действия.

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

Загрузите свой пакет действий

После создания пакета действий и развертывания его выполнения вы можете загрузить пакет действий в консоль действий. Консоль «Действия» использует проекты действий для группировки вашего диалогового действия с метаданными, такими как статус проверки и отображаемое имя в каталоге Ассистента. Проект также позволяет вам определять метаданные о вашем Действии, а также управлять им и отслеживать его в процессе утверждения.

Если у вас есть проект, вы можете загрузить свой пакет действий, который определяет все ваши действия, с помощью интерфейса командной строки gactions .

Отправьте свой проект на утверждение и сделайте его доступным для пользователей.

Образцы

Чтобы изучить завершенные проекты, просмотрите примеры Node.js и Java Actions SDK .