Обзор SDK действий (Dialogflow)

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

Пакет SDK для действий — это метод разработки выполнения диалога без использования Dialogflow. При использовании 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 .