Sdílet prostřednictvím

Připojení robota k Alexii

  • Článek

PLATÍ PRO: SDK v4

Robota můžete nakonfigurovat tak, aby komunikovali s lidmi prostřednictvím vlastní dovednosti Alexa. Tento článek popisuje, jak vytvořit dovednosti Alexa pomocí Alexa Developer Console, připojit robota k dovednosti Alexa v Azure a otestovat robota v Alexa.

Požadavky

  • Předplatné Azure. Pokud ho ještě nemáte, vytvořte si před zahájením bezplatný účet .
  • Robot publikovaný v Azure, který chcete připojit k Alexii.
  • Účet Amazon.

Důležité

Robot musí používat sadu SDK služby Bot Framework verze 4.8 nebo novější. Pokud máte existujícího robota, možná budete muset aktualizovat verzi sady SDK a znovu publikovat robota.

Vytvoření dovednosti Alexa

  1. Přihlaste se ke konzole Alexa Developer Console a vyberte Vytvořit dovednost.

  2. Na další stránce:

    1. Zadejte název nové dovednosti.
    2. Ujistěte se, že možnost Zvolit model, který chcete přidat do své dovednosti, je nastavená na Vlastní.
    3. Ujistěte se, že možnost Zvolit metodu pro hostování back-endových prostředků vaší dovednosti je nastavená na Zřízení vlastního prostředku.
    4. Vyberte Vytvořit dovednost.

    Volba modelu a hostování

  3. Na další stránce:

    1. Ujistěte se, že je možnost Zvolit šablonu nastavená na Začít od začátku.
    2. Vyberte Choose (Zvolit).

    Vyberte šablonu

  4. Na řídicím panelu dovedností v části Model interakce vyberte Editor JSON.

  5. V editoru JSON:

    1. Nahraďte existující obsah následujícím kódem 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. Pokud invocationNamechcete , změňte <své jméno-dovednost-vyvolání-jméno> na jméno, které budou uživatelé používat k vyvolání vaší dovednosti na Alexii. Pokud například název vyvolání dovedností byl "pomocník adaptéru", pak uživatel může říct "Alexa, launch adapter helper" pro spuštění dovednosti.

    3. values V poli v poli typesnahraďte tři instancemi <example-phrase> frází, které uživatelé můžou říct, aby aktivovaly vaši dovednost. Pokud například uživatel řekne "Alexa, požádejte pomocníka adaptéru, aby mi poskytl podrobnosti o adaptéru alexa", může být jedna ukázková fráze "zadejte podrobnosti o adaptéru alexa".

  6. Vyberte Uložit model a pak vyberte Sestavit model. Tím se aktualizuje konfigurace vaší dovednosti na Alexii.

Konfigurace robota v Azure

K dokončení tohoto kroku budete potřebovat ID dovednosti Alexa. Získejte ID buď z adresy URL na portálu Alexa, nebo tak, že přejdete do konzoly alexa pro vývojáře a vyberete Copy Skill ID. Id dovednosti Alexa by mělo být hodnota jako "amzn1.ask.skill.<some-guid>".

  1. Otevřete Azure Portal.
  2. Otevřete okno prostředku robota Azure pro vašeho robota.
  3. Otevřete Kanály a vyberte Alexa.
  4. V nástroji Alexa Channel Configuration zadejte informace, které jste zkopírovali v předchozím kroku.
    1. Do pole Zadejte ID dovednosti, zadejte ID dovednosti Alexa, které jste zkopírovali z konzoly Alexa Developer Console.
    2. Vyberte Použít.
    3. Zkopírujte identifikátor URI koncového bodu služby Alexa vygenerovaný v Azure.

Aktualizace registrace robota Alexa

  1. Přihlaste se ke konzole Alexa Developer Console.

  2. Najděte a otevřete stránku konfigurace vaší dovednosti.

  3. Vyberte Koncový bod.

  4. Jako typ koncového bodu služby vyberte HTTPS.

  5. Výchozí oblast:

    1. Zadejte identifikátor URI koncového bodu služby Alexa, který jste zkopírovali z webu Azure Portal.
    2. V rozevíracím seznamu vyberte Můj koncový bod pro vývoj je subdoménou domény, která má certifikát se zástupnými adresou od certifikační autority.

  6. Vyberte Uložit koncové body.

Testování a publikování dovedností

Pokud vlastníte zařízení Alexa, můžete před publikováním otestovat svou dovednost.

Informace o testování a publikování dovedností na platformě najdete v dokumentaci k vývojářské sadě Alexa Skills Kit pro vlastní dovednosti hlasového modelu.

Další informace

Další informace o dovednostech Alexa najdete v dokumentaci pro vývojáře Amazonu:

Ověřování uživatelů v Alexii

Ověřování uživatelů v Alexa se provádí nastavením a používáním propojení účtů na dovednost Alexa. Další informace najdete v tématu Principy propojení účtů pro Alexa Skills. Propojení účtů můžete vyžadovat, když uživatel povolí dovednost, nebo ho můžete vyžadovat jako součást toku konverzace.

Pokud přidáte ověřování uživatelů jako součást konverzace:

  1. Připojte přihlašovací kartu k odchozí aktivitě. Tato karta se převede na kartu Alexa LinkAccount, která uživatele vyzve k přihlášení pomocí aplikace Alexa.

  2. Pokud uživatel úspěšně propojí svůj účet s aplikací, bude token k dispozici v následných požadavcích v datech kanálu.

Další kroky