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
Zaloguj się do konsoli dewelopera Alexa i wybierz pozycję Utwórz umiejętności.
Na następnej stronie:
- Wprowadź nazwę nowej umiejętności.
- Upewnij się, że pozycja Wybierz model do dodania do umiejętności jest ustawiona na Wartość niestandardowa.
- Upewnij się, że opcja Wybierz metodę do hostowania zasobów zaplecza umiejętności jest ustawiona na aprowizację własną.
- Wybierz pozycję Utwórz umiejętności.
Na następnej stronie:
- Upewnij się, że dla ustawienia Wybierz szablon ustawiono opcję Rozpocznij od podstaw
- Wybierz pozycję Wybierz.
Na pulpicie nawigacyjnym umiejętności w obszarze Model interakcji wybierz pozycję Edytor JSON.
W edytorze JSON:
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>" } } ] } ] } } }
W przypadku
invocationName
elementu 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.W tablicy w
values
obszarzetypes
zastą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".
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>".
- Otwórz portal Azure Portal.
- Otwórz blok zasobów usługi Azure Bot dla bota.
- Otwórz kanały i wybierz pozycję Alexa.
- W obszarze Konfiguracja kanału Alexa wprowadź informacje skopiowane w poprzednim kroku.
- W polu Wprowadź identyfikator umiejętności wprowadź identyfikator umiejętności Alexa skopiowany z konsoli dewelopera Alexa.
- Wybierz Zastosuj.
- Skopiuj identyfikator URI punktu końcowego usługi Alexa wygenerowany przez platformę Azure.
Aktualizowanie rejestracji bota Alexa
Zaloguj się do konsoli dewelopera Alexa.
Znajdź i otwórz stronę konfiguracji umiejętności.
Wybierz pozycję Punkt końcowy.
W polu Typ punktu końcowego usługi wybierz pozycję HTTPS.
Dla regionu domyślnego:
- Wprowadź identyfikator URI punktu końcowego usługi Alexa skopiowany z witryny Azure Portal.
- Z listy rozwijanej wybierz pozycję Mój punkt końcowy programowania jest domeną podrzędną domeny z certyfikatem wieloznacznymi z urzędu certyfikacji.
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:
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.
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.