Home > Alexa > Alexa Skills Kit

Understanding How Users Invoke Custom Skills

Introduction

Users need to use a phrase supported by the Alexa service in combination with the invocation name for a custom skill to request information, ask a question, or tell Alexa to do something (“Alexa, ask Daily Horoscopes for the horoscope for Gemini”).

There are generally two main ways users begin interacting with a custom skill:

  • Invoking the skill and making a specific request at the same time (“intent”).
  • Invoking the skill with no specific request (“no intent”).

Invoking a Skill with a Specific Request (Intent)

Users can combine your invocation name with an action, command or question. This sends the service for your skill an IntentRequest with the specific intent that corresponds to the user’s request. The action, command, or question included in the phrase comes from the sample utterances you define and map to intents.

There are several ways users can combine your invocation name with the request:

  • Request followed by the invocation name, with a supported connecting word in between – this can make the phrase flow more naturally: “Alexa, get today’s Taurus report from Daily Horoscopes”.
  • Invocation name and request provided in a supported phrase with “ask”, “tell”, and other phrases: “Alexa, Ask Daily Horoscopes about Taurus”.

In addition, users can optionally include additional words around the utterance:

  • “the” can be included before the invocation name: “Alexa, give me my Taurus horoscope from the Daily Horoscopes” (in this example, the invocation name is just “Daily Horoscopes” and the user added in the word “the”).
  • Certain phrases can be included before the entire phrase:
    • “Can you…”
    • “Let’s…”
    • “I want to…” / “I wanna…”

      For example: “Alexa, can you give me my Taurus horoscope from Daily Horoscopes”. “Alexa, I want to order a car from Car Fu.”

  • Users can include “please” at the end of the utterance:
    • “Ask Daily Horoscopes to give me the horoscope for Taurus, please”.

The following table summarizes the set of supported phrases for invoking your skill with an intent. In these examples, the request portion (a sample utterance) is shown in italics, while words defined by Alexa are shown in bold.

Invocation Phrase Examples

<some action> <connecting word> <invocation name>

where the <connecting word> is one of the following:

by, from, in, using, with

give me my Taurus horoscope using Daily Horoscopes.

tell me the horoscope for Taurus from Daily Horoscopes.

order a car from Car Fu.

Ask <invocation name> <connecting word> <some action>

where the <connecting word> is one of the following:

to, about, for, if, whether

Ask Daily Horoscopes to give me the horoscope for Taurus.

Ask Daily Horoscopes about Taurus

Ask Daily Horoscopes for Taurus

Ask my ski reporter if there is snow at my favorite resort today

Ask my ski reporter whether there is snow at my favorite resort today

Ask <invocation name> <some action>

(note that there is no connecting word between “ask” and the command or question in this variation).

Ask Daily Horoscopes the Taurus report today

Ask <invocation name> <question beginning with a supported question word such as ‘what’, ‘how’, etc.>

(in this variation, the question word must be part of the sample utterance)

Ask recipes how do I make an omelet?

Ask Daily Horoscopes what’s the horoscope for Taurus

Tell <invocation name> <connecting word> <some action>

Where the <connecting word> is one of the following:

to, that

Tell scorekeeper to give ten points to Stephen

Tell scorekeeper that Stephen has ten points.

Tell <invocation name> <some action>

(note that there is no connecting word between “tell” and the command or question in this variation).

Tell Daily Horoscopes I want my Taurus horoscope today

Search <invocation name> for <some action>

Search Daily Horoscopes for Taurus

Open <invocation name> for <some action>

Open Daily Horoscopes for Taurus

Additional invocation phrases combined with “and”:

  • Talk to <invocation name> and <some action>
  • Open <invocation name> and <some action>
  • Launch <invocation name> and <some action>
  • Start <invocation name> and <some action>
  • Resume <invocation name> and <some action>
  • Run <invocation name> and <some action>
  • Load <invocation name> and <some action>
  • Begin <invocation name> and <some action>

Talk to Daily Horoscopes and give me the horoscope for Taurus

Open Daily Horoscopes and give me the horoscope for Taurus

Launch Daily Horoscopes and give me the horoscope for Taurus

Start Daily Horoscopes and give me the horoscope for Taurus

Resume Daily Horoscopes and give me the horoscope for Taurus

Run Daily Horoscopes and give me the horoscope for Taurus

Load Daily Horoscopes and give me the horoscope for Taurus

Begin Daily Horoscopes and give me the horoscope for Taurus

Use <invocation name> <connecting word> <some action>

Where the <connecting word> is one of the following:

and, to

Use Daily Horoscopes and get the horoscope for Taurus

Use Daily Horoscopes to get the horoscope for Taurus

Ensuring that the Sample Utterances Support the Invocation Phrases

All of the phrases described in this document are available for all skills. You do not need to enable the specific phrases. However, you do need to write sample utterances that flow naturally with these phrases.

For example, if all of your sample utterances are phrased as questions (“what is the horoscope for Taurus”), then phrases that work with noun or verb utterances won’t flow naturally. Users are unlikely to say something like “tell Daily Horoscopes what is the horoscope for Taurus,” as this is not a natural way to ask this question. This reduces the number of useful invocation phrases.

For a better user experience, provide a large variety of sample utterances written in different forms:

  • Noun utterances (“the horoscope for…”)
  • Verb utterances (“give me the horoscope for…”)
  • Question utterances (“what is the horoscope for…”)

Test how your utterances sound when combined with the invocation phrases shown in the table above. Write utterances that work with as many of the invocation phrases as possible.

Invoking a Skill with No Specific Request (No Intent)

Users can begin interacting with your skill without providing a specific question, request, or command. This sends the service for your skill a LaunchRequest.

At a minimum, users can just say the wake word (“Alexa”) and your skill’s invocation name. For example, “Alexa, Daily Horoscopes” would invoke the skill with the invocation name “Daily Horoscopes.”

Ways to start a skill with no intent:

Starting Phrase Example
<invocation name> Alexa, Daily Horoscopes
Ask <invocation name> Alexa, Ask Daily Horoscopes
Begin <invocation name> Alexa, Begin Trivia Master
Do <invocation name> Alexa, Do Trivia Master
Launch <invocation name> Alexa, Launch Car Fu
Load <invocation name> Alexa, Load Daily Horoscopes
Open <invocation name> Alexa, Open Daily Horoscopes
Play <invocation name> Alexa, Play Trivia Master
Play the game <invocation name> Alexa, Play the game Trivia Master
Resume <invocation name> Alexa, Resume Trivia Master
Run <invocation name> Alexa, Run Daily Horoscopes
Start <invocation name> Alexa, Start Daily Horoscopes
Start playing <invocation name> Alexa, Start playing the game Trivia Master
Start playing the game <invocation name> Alexa, Start playing the game Trivia Master
Talk to <invocation name> Alexa, Talk to Daily Horoscopes
Tell <invocation name> Alexa, Tell Daily Horoscopes
Use <invocation name> Alexa, Use Daily Horoscopes

Wie Benutzer benutzerdefinierte Skills aufrufen

Einleitung

Benutzer müssen eine Phrase verwenden, die vom Alexa Service unterstützt wird, und diese mit einem Aufrufsnamen für einen benutzerdefinierten Skill kombinieren, um Informationen abzurufen, eine Frage zu stellen oder Alexa anzuweisen, etwas zu tun („Alexa, frage Astro Dienst nach dem Horoskop für Zwilling”).

Im Allgemeinen verläuft die Interaktion der Benutzer mit einem benutzerdefinierten Skill auf zwei Arten:

  • Der Skill wird aufgerufen und gleichzeitig wird eine bestimmte Aufforderung geäußert („Absicht“).
  • Der Skill wird aufgerufen, aber es wird keine bestimmte Aufforderung geäußert („keine Absicht“).

Aufrufen eines Skills mit einer bestimmten Anforderung (Absicht)

Benutzer können Ihren Aufrufsnamen mit einer Aktion, einem Befehl oder einer Frage kombinieren. Damit wird dem Dienst für Ihren Skill eine Absichtsaufforderung (IntentRequest) mit der spezifischen Absicht übermittelt, die der Anforderung des Benutzers entspricht. Die Aktion, der Befehl oder die Frage, die in der Phrase enthalten sind, werden aus den Musteräußerungen abgeleitet, die Sie definieren und den Absichten zuordnen.

Es gibt mehrere Möglichkeiten, wie Benutzer Ihren Aufrufsnamen mit der Anforderung kombinieren können:

  • Anforderung, gefolgt durch den Aufrufsnamen, mit einem unterstützenden Verbindungswort dazwischen – die Phrase wirkt natürlicher. „Alexa, ruf mir das heutige Horoskop für Stier bei Astro Dienst ab.“
  • Der Aufrufsname und die Anforderung in einer unterstützten Phrase mit „frage“, „sage“ und anderen Phrasen: „Alexa, frage bei Astro Dienst nach dem Stier-Horoskop.“

Benutzer können zudem weitere Wörter zur Äußerung hinzufügen:

  • Vor den Aufrufsnamen kann ein Artikel gesetzt werden: „Alexa, rufe das Horoskop für Stier bei dem Astro Dienst ab.“ (Bei diesem Beispiel ist der Aufrufsname bloß „Astro Dienst“ und der Benutzer hat einen Artikel hinzugefügt).
  • Bestimmte Phrasen können vor die gesamte Phrase gesetzt werden:
    • „Kannst du…“
    • „Lass uns…“
    • „ich möchte…” / „Ich will…“

      Zum Beispiel: „Alexa, kannst du mir das Stierhoroskop von Astro Dienst abrufen.“ „Alexa, ich möchte eine Mitfahrgelegenheit bei Mitfahrdienst buchen.“

  • „Benutzer können ein 'bitte' am Anfang, am Ende und zwischen Aufrufphrase und Anforderung einfügen: '(Bitte) Frage bei Astro Dienst (bitte) das Horoskop für Stier ab(, bitte)'

Die nachfolgende Tabelle fasst die Gruppe der unterstützten Phrasen für den Aufruf Ihres Skills mit einer Absicht zusammen: Bei diesen Beispielen wird der Anforderungsteil (eine Musteräußerung) kursiv geschrieben, während die von Alexa definierten Wörter fett erscheinen.

Aufrufphrase Beispiele:

<Eine Aktion> <Verbindungswort> <Aufrufsname>

Dabei ist das <Verbindungswort> eines der folgenden:

durch, von, in, mit, bei, über

Rufe mir mein Horoskop für Stier vom Astro Dienst ab.

Buche eine Mitfahrgelegenheit in Mitfahrdienst.

Frage <Aufrufsname> <Verbindungswort> <eine Aktion>

Dabei ist das <Verbindungswort> eines der folgenden:

ob, nach

Frage Astro Dienst nach dem Horoskop für Stier.

Rufe bei Astro Dienst das Horoskop für Stier ab.

Frage Astro Dienst nach Stier.

Frage bei Bergfex, ob in Tirol schon Schnee liegt.

Frage <Aufrufsname> <eine Aktion>

(Beachten Sie, dass zwischen „Frage“ und dem Befehl oder der Frage bei dieser Variation kein Verbindungswort steht.)

Frage Astro Dienst, was das heutige Horoskop für Stier ist.

Frage <Aufrufsname> <Frage, die mit einem unterstützten Fragewort wie „was“, „wie“ usw. beginnt>

(Beachten Sie, dass das Fragewort Teil der Musteräußerung sein muss.)

Frage Meisterkoch, wie ich ein Omelette mache.

Frage Astro Dienst, wie das Horoskop für Stier lautet.

Sage <Aufrufsname> <Verbindungswort> <eine Aktion>

Dabei ist das <Verbindungswort> eines der folgenden:

dass

Sag dem Scorekeeper, dass Stefan zehn Punkte hat.

Sage <Aufrufsname> <eine Aktion>

(Beachten Sie, dass bei dieser Variante kein Verbindungswort zwischen „sage“ und dem Befehl oder der Frage liegt.)

Sag dem Astro Dienst, ich möchte mein Stierhoroskop für heute.

Öffne < Aufrufsname> für <eine Aktion>

Öffne Astro Dienst für das Stierhoroskop.

Zusätzliche Aufrufsphrasen mit „und“

  • Sprich mit <Aufrufsname> und <eine Aktion>
  • Öffne <Aufrusfsname> und <eine Aktion>
  • Starte <Aufrufsname> und <eine Aktion>
  • Öffne <Aufrufsname> und <eine Aktion>
  • Lade <Aufrufsname> und <eine Aktion>
  • Beginne <Aufrufsname> und <eine Aktion>
  • Führe <Ausrufsname> aus und <eine Aktion>

Sprich mit Astro Dienst und gib mir das Horoskop für Stier.

Öffne Astro Dienst und gib mir das Horoskop für Stier.

Starte Astro Dienst und gib mir das Horoskop für Stier.

Beginne Astro Dienst und gib mir das Horoskop für Stier.

Lade Astro Dienst und gib mir das Horoskop für Stier.

Beginne Astro Dienst und gib mir das Horoskop für Stier.

Führe Astro Dienst aus und gib mir das Horoskop für Stier.

Verwende <Aufrufsname> <Verbindungswort> <eine Aktion>

Benutze <Aufrufsname> <Verbindungswort> <eine Aktion>

Dabei ist das <Verbindungswort> eines der folgenden:

und, um…zu, für

Verwende Astro Dienst und hole das Horoskop für Stier.

Benutze Astro Dienst und hole das Horoskop für Stier.

Verwende Astro Dienst, um das Horoskop für Stier abzufragen.

Verwende Astro Dienst für das Stierhoroskop.

Sicherstellen, dass die Musteräußerung die Aufrufsphrasen unterstützt

Alle in diesem Dokument beschriebenen Phrasen stehen für alle Skills zur Verfügung. Sie brauchen die spezifischen Phrasen nicht eigens zu aktivieren. Allerdings sollten Sie Musteräußerungen verfassen, die mit diesen Phrasen natürlich verbunden werden können.

Beispiel: Wenn alle Ihre Musteräußerungen als Fragen abgefasst sind („wie ist das Horoskop für Stier“), ist eine Verbindung mit Phrasen, die Äußerungen mit Hauptwörtern oder Zeitwörtern enthalten nicht fließend möglich. Benutzer werden wahrscheinlich nicht sagen: „Sage Astro Dienst, was das Horoskop für Stier ist“. Diese Art der Formulierung ist für eine Frage unnatürlich. Damit wird die Anzahl der nützlichen Aufrufsphrasen reduziert.

Die Benutzererfahrung wird verbessert, wenn Sie zahlreiche Varianten von Musteräußerungen bereitstellen, die in verschiedenen Formen geschrieben wurden:

  • Nominale Äußerungen („Das Horoskop für …“)
  • Verbale Äußerungen („Gib mir das Horoskop für …“)
  • Fragende Äußerungen („Wie lautet das Horoskop für …“)

Testen Sie, wie Ihre Äußerungen klingen, wenn sie mit Aufrufsphrasen kombiniert werden, die Sie der oben stehenden Tabelle entnehmen können. Schreiben Sie Äußerungen, die mit so vielen Aufrufsphrasen wie möglich beginnen.

Aufruf eines Skills ohne bestimmte Anforderung (keine Absicht)

Benutzer können die Interaktion mit Ihrem Skill beginnen, ohne eine bestimmte Frage oder Anforderung zu äußern bzw. einen Befehl zu formulieren. Dadurch wird dem Service Ihres Skills eine Startaufforderung (LaunchRequest) übermittelt.

Als Mindestvoraussetzung können Benutzer einfach nur das Aktivierungswort („Alexa“) und den Aufrufsnamen Ihres Skills sagen. Beispiel: „Alexa, Astro Dienst“ würde den Skill mit dem Aufrufsnamen „Astro Dienst“ aufrufen.

Möglichkeiten zum Aufruf eines Skills ohne Absicht:

Startphrase Beispiel
< Aufrufsname> Alexa, Astro Dienst
Frage < Aufrufsname> Alexa, frage Astro Dienst
Starte <Aufrufsname> Alexa, starte Mitfahrdienst
Lade <Aufrufsname> Alexa, lade Astro Dienst
Öffne <Aufrufsname> Alexa, öffne Astro Dienst
Spiele <Aufrufsname> Alexa, spiele Fragespiel
Spiel das Spiel <Aufrufsname> Alexa, spiel das Spiel Fragespiel
Starte <Aufrufsname> Alexa, starte Astro Dienst
Spiele <Aufbruchsname> ab Alexa, starte das Spiel Fragespiel
Starte mit dem Spiel <Aufrufsname> Alexa, starte mit dem Spiel Fragespiel
Sprich mit <Aufrufsname> Alexa, sprich mit Astro Dienst
Verwende <Aufrufsname> Alexa, verwende Astro Dienst
„ausführen“ <Aufrufsname> Alexa, „Führe den Astro Dienst aus“
„durchsuchen“ <Aufrufsname> Alexa, „Durchsuche den Astro Dienst“
„fortsetzen“ <Aufrufsname> Alexa, „Setze Astro Dienst fort“
„Suche“ <Aufrufsname> Alexa, „Suche im Astro Dienst“

Nächste Schritte