4.2 Definire le competenze Alexa

Introduzione

Questo esercizio ti guiderà attraverso tutti i passaggi necessari per definire e configurare una nuova abilità di Amazon Alexa.

Prerequisiti

Prima di poter creare e configurare una capacità di Amazon Alexa, devi:

  1. Chiedi a un account sviluppatore Amazon di effettuare l’accesso
  2. Avere un account AWS ed effettuare l'accesso

Vedi Esercizio 4.1 per ulteriori dettagli.

4.2.1 Creare una capacità Alexa

Per creare una nuova abilità, segui questi passaggi:

Alla Dashboard per sviluppatori di Amazon screen (https://developer.amazon.com/dashboard), seleziona Alexa Skills Kit dal Alexa menu.

Seleziona Abilità Alexa

In console per sviluppatori alexa, fai clic su Crea abilità pulsante .

Console per sviluppatori Alexa

In Creare una nuova abilità schermo:

  • Specifica AEP come Nome di fabbrica.
  • Seleziona Inglese (Regno Unito) o Inglese (Stati Uniti) come Lingua predefinita.
  • Seleziona Personalizzato come modello da utilizzare nel Scegliere un modello da aggiungere alla propria abilità sezione .

Crea abilità

Seleziona Effettuare il provisioning come metodo da utilizzare nel Scegliere un metodo per ospitare le risorse di backend della propria abilità sezione .

Crea abilità 2

Quindi, fai clic su Crea abilità.

NOTA

Lo schermo potrebbe avere un aspetto leggermente diverso a seconda delle Lingua predefinita hai selezionato.

In Scegliere un modello schermata, seleziona Inizia da zero come modello da utilizzare nel Scegliere un modello sezione .

Fai clic su Scegli.

Scegliere un modello

La tua abilità ora viene creata, dopodiché finirai per AEP schermata principale delle abilità, che si presenta così:

Schermata principale della piattaforma

4.2.2 Definire il nome della chiamata

Affinché la tua abilità possa essere invocata, ha bisogno di un nome di chiamata. Per definire quanto segue:

Fai clic su Invocazioni nel menu a sinistra, quindi fai clic su Nome dell'invito di Abilità. Cambia il nome dell'invocazione di Abilità in adobe experience platform. Quindi, fai clic su Salva modello.

Nome dell'invito

Questo aggiornerà l’invocazione della tua abilità Alexa in modo da poter dire Alexa, aprire adobe experience platform durante il test della tua abilità in uno dei passaggi successivi.

4.2.3 Definire intenti, campioni e slot

Il passo successivo è quello di configurare l'interazione con la nostra abilità. L’interazione con un’abilità Alexa avviene attraverso i cosiddetti intenti, dei quali Amazon fornisce 5 intenti incorporati (ad esempio AMAZON.HelpIntent, per chiedere aiuto). Ogni intento definisce espressioni di esempio; frasi utilizzate per richiamare l'intento. E ogni intento può avere uno o più valori di slot; valori forniti come input per l'intento.

Anziché consentire di definire passo dopo passo i vari intenti, le espressioni e i valori di slot necessari per la nostra abilità, utilizzeremo un file JSON per impostare tutto in una sola volta. Per eseguire questa operazione:

Quindi, fai clic su Modello di interazione nel menu a sinistra, quindi fai clic su Editor JSON.

Editor JSON

Scarica e apri il file Modello di interazione AWS Alexa.

Seleziona tutto e poi copia tutto.

Raw

In Editor JSON a destra, seleziona tutto e incolla il codice copiato nel passaggio precedente, sovrascrivendo il testo già presente. In questo modo verrà caricato il modello di interazione.

Fai clic su Salva modello.

Trascina e rilascia il file JSON

Fai clic su Intenti nel menu a sinistra, dopo di che vedrai i vari intenti specifici per la nostra abilità sulla barra a sinistra, ad esempio LdapIntent, GetProductIntentUseEmailAddressIntent. Alcuni di questi intenti hanno una fessura, per esempio come productId per GetProductIntent.

Salva modello

4.2.3 Definire le interfacce

Adesso definiremo l'interfaccia per l'abilità. Le interfacce definiscono il modo in cui interagisci con la tua abilità: solo attraverso la voce o l'abilità sarà anche supportare la visualizzazione e il tocco? Se vogliamo che le nostre capacità di usare gli eventi di visualizzazione e di contatto, dobbiamo abilitare quell'interfaccia. Anche l'implementazione delle nostre competenze utilizzerà la lingua di presentazione di Amazon (BETA). Per configurare correttamente questo comando:

Fai clic su Interfacce nel menu a sinistra.

Interfacce

In Interfacce , assicurati che Lingua della presentazione di Alexa e Delega automatica sono entrambi abilitati.

Abilita interfacce

Scorri verso l’alto e fai clic su Salvare le interfacce.

Abilita interfacce

4.2.4 Configurare l'implementazione

La logica della tua abilità viene implementata utilizzando SDK di NodeJS per Alexa v2.

È necessaria la tua funzionalità implementata in AWS Lambda in modo da poterla invocare dalla capacità. E poi devi anche dire alla tua abilità dove trovare quella funzionalità senza server in modo che possa richiamarla quando necessario.

Imposta prima la funzionalità senza server per l'abilità. Per eseguire questa operazione:

Assicurati di aver effettuato l'accesso al tuo Console di gestione AWS (https://us-east-2.console.aws.amazon.com/console/home).

Scegli un centro dati preferito dalla casella di riepilogo a discesa nel menu in alto a destra. Ad esempio USA Est (Ohio) o UE (Irlanda).

Centro dati

In Trova servizi type lambda e premere Invio.

Lambda

Finirà al AWS Lambda schermata iniziale. Fai clic su Creare una funzione.

Schermo principale della funzione Lambda

In Crea funzione schermo:

  • Seleziona Autore da zero
  • Assegna alla tua funzione un Nome funzione ad esempio AEP
  • Seleziona Node.js 14.x dal Runtime elenco a discesa

Autore da zero

Fai clic su Cambia il ruolo di esecuzione predefinito. Quindi seleziona Crea un nuovo ruolo con le autorizzazioni Lambda di base.

Quindi, fai clic su Crea funzione.

Autorizzazioni

Finirai nel tuo AEP schermata di definizione della funzione, con Codice scheda attiva. Fai clic su Aggiungi trigger.

Definizione della funzione della piattaforma

Nell’elenco a discesa del trigger disponibile, seleziona Alexa Skills Kit. Ora devi anche fornire l’ID di abilitazione della tua abilità Alexa.

Configurazione richiesta

NOTA

Se Alexa Skills Kit non è disponibile in Aggiungi trigger elenco, il centro dati selezionato non lo supporta. Seleziona un altro centro dati (ad es. UE (Irlanda)) che fornisce Alexa Skills Kit attivatore.

Torna alla pagina Abilità Alexa. Fai clic su Endpoint nel menu a sinistra. Cerca ID di fabbrica. Fai clic su Copia negli Appunti.

Endpoint

Fai clic su Copia negli Appunti per copiare l'abilità.

Torna alla pagina AEP nella schermata di definizione della funzione AWS Lambda schermata iniziale.

Incolla l'id di abilitazione nel ID di fabbrica campo sotto Verifica dell'ID di fabbrica. Assicurati Abilita è selezionata, che è l’impostazione predefinita e consigliata.

Quindi, fai clic su Aggiungi.

Configurare l’ID di attivazione

Nella schermata della funzione AWS Lambda, fai clic su Livelli gonfiare aep.

Seleziona piattaforma

In Codice scheda , fai clic su seleziona Carica da quindi seleziona file .zip.

Codice funzione

Vedrete questo. Scarica la Codice Lambda di AWS Alexa e salvare il file zip in un punto del computer come aepskill.zip.

Fai clic su Carica.

Codice funzione

Scegli la aepskill.zip salvato nel computer dalla finestra di dialogo del browser file. Fai clic su Apri.

ZIP della dimensione della piattaforma

Fai clic su Salva.

ZIP della dimensione della piattaforma

Quindi, vai alla scheda . Configurazione e fai clic su Variabili di ambiente.

Variabili di ambiente

Fai clic su Modifica e aggiungi le variabili richieste dalla tabella seguente, in modo che Variabili di ambiente Il pannello avrà questo aspetto.

Variabili di ambiente

Chiave Valore
alexaBrandName luma
emailAddress rmaur@adobe.com
ldap --demoProfileLdap--
configurationId --configurationID--
IMPORTANTE
  • Definisci i alexaBrandName come versione minuscola del nome del marchio (ad esempio Luma come luma),
  • Se il nome del marchio contiene un & sostituirlo con e. Ad esempio, H&M diventa h e m.

Assicurati di sostituire alexaBrandName, ldap e emailAddress con i dettagli di configurazione specifici.

Fai clic su Salva quando hai finito.

Variabili di ambiente

Come passaggio finale, devi copiare il nome risorsa Amazon (ARN) che rappresenta questa funzionalità per la nostra abilità.

Fai clic sull’icona di copia accanto al ARN - braccio:aws.lambda:… testo come indicato.

ARN

Torna alla pagina Console per sviluppatori Alexa.

In Endpoint schermata di configurazione, incolla l'ARN copiato dal passaggio precedente in Area predefinita (richiesta) campo .

Endpoint

Quindi, fai clic su Salva endpoint.

4.2.5 Finalizzazione dell'abilità

Dopo aver impostato invocazione, intenti, interfacce e endpoint, il passo finale è quello di costruire la versione finale della vostra abilità.

Per eseguire questa operazione:

  • Seleziona Invocazione dal menu a sinistra e fai clic su Nome dell'invito di Abilità.
  • Fai clic su Salva modello quindi fai clic su Modello di generazione. Questo costruirà il modello dell'abilità. Questo potrebbe richiedere un po'.

Crea

Verifica che nella schermata principale della tua abilità tutti gli elementi nel Lista di controllo di Skills Builder (ad eccezione del Prodotti in-skill) sono controllate. Per eseguire questa operazione:

Fai clic su Crea. Le console per sviluppatori alexa devono visualizzare i segni di spunta verdi per i primi quattro elementi nel Lista di controllo di Skills Builder.

Completato

La tua abilità e la sua implementazione sono ora pronte per essere utilizzate.

Ha finito questo esercizio.

Passaggio successivo: 4.3 Utilizza le tue competenze Alexa

Torna al modulo 4

Torna a tutti i moduli

In questa pagina