Działania w pakiecie SDK – omówienie (Dialogflow)

Actions on Google umożliwia rozszerzenie działania Asystenta Google za pomocą Akcji. Działania umożliwiają użytkownikom wykonywanie różnych czynności za pomocą interfejsu konwersacyjnego, który może obejmować szybkie polecenia, włączenie światła lub dłuższe rozmowy, takie jak quizy.

Actions SDK to metoda tworzenia rozmów bez użycia Dialogflow. W przypadku pakietu SDK Actions pakiet SDK Action służy do mapowania intencji do ich realizacji. Musisz też podać wzorce zapytań w pakiecie Action, aby zdefiniować przykładowe wyrażenia, które użytkownicy mogą powiedzieć.

interfejs wiersza poleceń

Podczas tworzenia pakietu SDK Actions możesz użyć projektu wiersza poleceń gactions do przetestowania i zaktualizowania projektu Actions. Interfejs wiersza poleceń gactions ułatwia też tworzenie pakietu działań związanego z działaniem konwersacyjnym i zarządzanie nim.

Tworzenie działań w pakiecie Action

Działania w pakiecie Action możesz tworzyć, mapując intencje na realizację. Czynność określa punkt początkowy, aby rozpocząć rozmowę z unikalnym identyfikatorem o nazwie intencja. Intencje mapują się na realizację, która przetwarza intencję.

Załóżmy, że chcesz utworzyć projekt zawierający działania, w ramach których kupisz niektóre produkty, sprawdzisz stan zamówień i wyświetlisz niektóre oferty dnia. Możesz definiować intencje w ten sposób:

  • „OK Google, mów do przykładowej akcji”.
  • „OK Google, kup przykładowe buty, aby kupić buty”.
  • „OK Google, skontaktuj się z przykładową firmą, aby sprawdzić moje zamówienie”.
  • „OK Google, porozmawiaj z Przykładowym Działaniem, aby przedstawić dzisiejsze oferty”.

Plik JSON pakietu Action może wyglądać mniej więcej tak:

{
  "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"
    }
  }
}

Tworzenie i wdrażanie webhooka realizacji zamówień

Gdy nastąpi wywołanie akcji w Twoim projekcie, Actions on Google wywołuje Twoją realizację, aby rozpocząć rozmowę z użytkownikami w celu wykonania działania.

W każdym żądaniu wysyłanym do webhooka realizacji zamówień użytkownicy otrzymują dane wejściowe w postaci ciągu tekstowego. Aby przetworzyć intencję, zwykle analizujesz dane wejściowe i zwracasz odpowiedź. Wymiana będzie odbywać się do momentu, gdy akcja zostanie zakończona.

Przesyłanie pakietu działań

Po utworzeniu pakietu działań i wdrożeniu jego realizacji możesz przesłać pakiet działań do konsoli Actions. Konsola Actions korzysta z projektów akcji, aby pogrupować działanie konwersacyjne za pomocą metadanych, takich jak stan sprawdzania i wyświetlana nazwa w katalogu Asystenta. Projekt umożliwia też definiowanie metadanych akcji oraz zarządzanie nią i jej śledzenie w ramach procesu zatwierdzania.

Po utworzeniu projektu możesz przesłać pakiet działań, który określa wszystkie akcje za pomocą interfejsu wiersza poleceń gactions.

Prześlij projekt do zatwierdzenia i udostępnij go użytkownikom

Sample

Aby zapoznać się z ukończonymi projektami, wyświetl przykłady pakietu SDK Actions w języku Node.js i Java.