Połączenie bota do Alexy

DOTYCZY: ZESTAW SDK w wersji 4

Bot można skonfigurować tak, aby komunikował się z osobami za pomocą niestandardowej umiejętności Alexy. W tym artykule opisano sposób tworzenia umiejętności Alexa przy użyciu konsoli dewelopera Alexa, łączenia bota z umiejętnością Alexa na platformie Azure i testowania bota w Alexa.

Wymagania wstępne

• Subskrypcja platformy Azure. Jeśli jeszcze go nie masz, przed rozpoczęciem utwórz bezpłatne konto .
• Bot opublikowany na platformie Azure, z którym chcesz nawiązać połączenie z Aplikacją Alexa.
• Konto Amazon.

Ważne

Bot musi używać zestawu Bot Framework SDK w wersji 4.8 lub nowszej. Jeśli masz istniejącego bota, może być konieczne zaktualizowanie wersji zestawu SDK i ponowne opublikowanie bota.

Tworzenie umiejętności Alexa

1. Zaloguj się do konsoli dewelopera Alexa i wybierz pozycję Utwórz umiejętności.

2. Na następnej stronie:

   1. Wprowadź nazwę nowej umiejętności.
   2. Upewnij się, że pozycja Wybierz model do dodania do umiejętności jest ustawiona na Wartość niestandardowa.
   3. Upewnij się, że opcja Wybierz metodę do hostowania zasobów zaplecza umiejętności jest ustawiona na aprowizację własną.
   4. Wybierz pozycję Utwórz umiejętności.

   

3. Na następnej stronie:

   1. Upewnij się, że dla ustawienia Wybierz szablon ustawiono opcję Rozpocznij od podstaw
   2. Wybierz pozycję Wybierz.

   

4. Na pulpicie nawigacyjnym umiejętności w obszarze Model interakcji wybierz pozycję Edytor JSON.

5. W edytorze JSON:

   1. Zastąp istniejącą zawartość następującym kodem JSON.

      {
          "interactionModel": {
              "languageModel": {
                  "invocationName": "<your-skill-invocation-name>",
                  "intents": [
                      {
                          "name": "GetUserIntent",
                          "slots": [
                              {
                                  "name": "phrase",
                                  "type": "phrase"
                              }
                          ],
                          "samples": [
                              "{phrase}"
                          ]
                      },
                      {
                          "name": "AMAZON.StopIntent",
                          "samples": []
                      }
                  ],
                  "types": [
                      {
                          "name": "phrase",
                          "values": [
                              {
                                  "name": {
                                      "value": "<example-phrase>"
                                  }
                              },
                              {
                                  "name": {
                                      "value": "<example-phrase>"
                                  }
                              },
                              {
                                  "name": {
                                      "value": "<example-phrase>"
                                  }
                              }
                          ]
                      }
                  ]
              }
          }
      }
      

   2. W przypadku invocationNameelementu zmień <nazwę twoja-umiejętność-wywołania na nazwę> , której użytkownicy będą używać do wywoływania umiejętności na Alexie. Jeśli na przykład nazwa wywołania umiejętności to "pomocnik adaptera", użytkownik może powiedzieć "Alexa, uruchom pomocnik adaptera", aby uruchomić umiejętności.

   3. W tablicy w values obszarze typeszastąp trzy wystąpienia <example-phrase> fraz, które użytkownicy mogą powiedzieć, aby wyzwolić umiejętności. Jeśli na przykład użytkownik mówi "Alexa, poproś pomocnika adaptera o podanie szczegółów karty alexa", jedną z przykładowych fraz może być "podaj mi szczegóły adaptera alexa".

6. Wybierz pozycję Zapisz model, a następnie wybierz pozycję Kompiluj model. Spowoduje to zaktualizowanie konfiguracji umiejętności na Alexie.

Konfigurowanie bota na platformie Azure

Aby wykonać ten krok, będziesz potrzebować identyfikatora umiejętności Alexa. Pobierz identyfikator z adresu URL w portalu Alexa lub przechodząc do konsoli dewelopera Alexa i wybierając pozycję Kopiuj identyfikator umiejętności. Identyfikator umiejętności Alexy powinien być wartością podobną do "amzn1.ask.skill.<some-guid>".

1. Otwórz portal Azure Portal.
2. Otwórz blok zasobów usługi Azure Bot dla bota.
3. Otwórz kanały i wybierz pozycję Alexa.
4. W obszarze Konfiguracja kanału Alexa wprowadź informacje skopiowane w poprzednim kroku.
   1. W polu Wprowadź identyfikator umiejętności wprowadź identyfikator umiejętności Alexa skopiowany z konsoli dewelopera Alexa.
   2. Wybierz Zastosuj.
   3. Skopiuj identyfikator URI punktu końcowego usługi Alexa wygenerowany przez platformę Azure.

Aktualizowanie rejestracji bota Alexa

1. Zaloguj się do konsoli dewelopera Alexa.

2. Znajdź i otwórz stronę konfiguracji umiejętności.

3. Wybierz pozycję Punkt końcowy.

4. W polu Typ punktu końcowego usługi wybierz pozycję HTTPS.

5. Dla regionu domyślnego:

   1. Wprowadź identyfikator URI punktu końcowego usługi Alexa skopiowany z witryny Azure Portal.
   2. Z listy rozwijanej wybierz pozycję Mój punkt końcowy programowania jest domeną podrzędną domeny z certyfikatem wieloznacznymi z urzędu certyfikacji.

   

6. Wybierz pozycję Zapisz punkty końcowe.

Testowanie i publikowanie umiejętności

Jeśli jesteś właścicielem urządzenia Alexa, możesz przetestować swoje umiejętności przed jego opublikowaniem.

Zapoznaj się z dokumentacją dla deweloperów zestawu Alexa Skills Kit, aby uzyskać informacje na temat testowania i publikowania umiejętności na ich platformie.

Dodatkowe informacje

Aby uzyskać więcej informacji na temat umiejętności Alexa, zobacz dokumentację dla deweloperów amazon:

• Co to jest zestaw Alexa Skills Kit?
• Niestandardowe umiejętności modelu głosu
• Schematy obiektów zestawu umiejętności Alexa

Uwierzytelnianie użytkownika w aplikacji Alexa

Uwierzytelnianie użytkowników w aplikacji Alexa odbywa się przez skonfigurowanie i użycie linku do konta na umiejętności Alexa. Aby uzyskać więcej informacji, zobacz Omówienie łączenia kont dla umiejętności Alexa. Możesz wymagać połączenia konta, gdy użytkownik włączy umiejętności, lub może wymagać go w ramach przepływu konwersacji.

W przypadku dodania uwierzytelniania użytkownika w ramach konwersacji:

1. Dołącz kartę logowania w działaniu wychodzącym. Zostanie on przekonwertowany na kartę Alexa LinkAccount, która monituje użytkownika o zalogowanie się przy użyciu aplikacji Alexa.

2. Jeśli użytkownik pomyślnie łączy swoje konto z aplikacją, token będzie dostępny dla kolejnych żądań w danych kanału.

Następne kroki

• Aby uzyskać informacje na temat tworzenia botów, zobacz Jak działają boty i przewodnik Szybki start Tworzenie bota przy użyciu zestawu SDK platformy Bot Framework.
• Aby uzyskać informacje na temat wdrażania botów, zobacz Samouczek: aprowizowanie bota na platformie Azure i Samouczek: publikowanie podstawowego bota.
• Aby uzyskać informacje na temat obsługi kanałów w usłudze Bot Połączenie or Service, zobacz Połączenie bota do kanałów.
• Aby uzyskać więcej informacji na temat schematów platformy Bot Framework, zobacz schemat działania platformy Bot Framework i schemat kart platformy Bot Framework.