---
title: Erstellen einer Cortana-Funktion mit .NET | Microsoft-Dokumentation
description: Lernen Sie die grundlegenden Konzepte des Erstellens einer Cortana-Funktion im Bot Builder SDK für .NET kennen.
keywords: Bot Framework, Cortana-Funktion, Sprache, .NET, Bot Builder, SDK, Hauptkonzepte, Kernkonzepte
author: DeniseMak
manager: kamrani
ms.topic: article
ms.service: bot-service
ms.subservice: sdk
ms.date: 12/13/2017
monikerRange: azure-bot-service-3.0
ms.openlocfilehash: 030d17fa25a436ee8e8a1d093924e61f12e14e18
ms.sourcegitcommit: b78fe3d8dd604c4f7233740658a229e85b8535dd
ms.translationtype: HT
ms.contentlocale: de-DE
ms.lasthandoff: 10/24/2018
ms.locfileid: "49998307"
---
# Erstellen eines sprachaktivierten Bots mit Cortana-Funktionen
[!INCLUDE [pre-release-label](../includes/pre-release-label-v3.md)]
> [!div class="op_single_selector"]
> - [.NET](../dotnet/bot-builder-dotnet-cortana-skill.md)
> - [Node.js](../nodejs/bot-builder-nodejs-cortana-skill.md)
Das Bot Builder SDK für .NET ermöglicht Ihnen, einen sprachaktivierten Bot zu erstellen, indem Sie ihn als eine Cortana-Funktion mit dem Cortana-Kanal verbinden.
> [!TIP]
> Weitere Informationen zur Definition einer Funktion und zu den Einsatzmöglichkeiten finden Sie im [Cortana Skills Kit][CortanaGetStarted].
Das Erstellen einer Cortana-Funktion mit dem Bot Framework erfordert nur sehr geringe Cortana-spezifische Kenntnisse und besteht in erster Linie aus dem Erstellen eines Bots. Einer der wichtigsten Unterschiede zu anderen Bots, die Sie vielleicht schon erstellt haben, besteht wahrscheinlich darin, dass Cortana sowohl über eine visuelle als auch eine Audiokomponente verfügt. Für die visuelle Komponente stellt Cortana einen Bereich der Canvas zum Rendern von Inhalten (z.B. Karten) bereit. Für die Audiokomponente geben Sie Text oder SSML in Ihre Botnachrichten ein, die Cortana dem Benutzer vorliest und so Ihrem Bot eine Stimme verleiht.
> [!NOTE]
> Cortana ist auf vielen verschiedenen Geräten verfügbar. Einige haben einen Bildschirm, während das bei anderen (z.B. eigenständiger Lautsprecher) möglicherweise nicht der Fall ist. Sie sollten sicherstellen, dass Ihr Bot beide Szenarien verarbeiten kann. Informationen zum Überprüfen von Geräteinformationen finden Sie unter [Cortana-spezifische Entitäten][CortanaSpecificEntities].
## Hinzufügen von Sprache zu Ihrem Bot
Gesprochene Nachrichten von Ihrem Bot werden in der Speech Synthesis Markup Language (SSML) dargestellt. Mit dem Bot Builder SDK können Sie SSML in Ihre Bot-Antworten einbinden, um neben der Anzeige des Bots auch dessen Sprachausgabe zu steuern. Sie können auch den Status des Mikrofons von Cortana steuern, indem Sie angeben, ob Ihr Bot Benutzereingaben akzeptiert, erwartet oder ignoriert.
Legen Sie die `Speak`-Eigenschaft des `IMessageActivity`-Objekts fest, um eine Nachricht anzugeben, die Cortana sprechen soll. Wenn Sie reinen Text angeben, legt Cortana fest, wie die Wörter indiziert werden.
```cs
Activity reply = activity.CreateReply("This is the text that Cortana displays.");
reply.Speak = "This is the text that Cortana will say.";
```
Wenn Sie Tonhöhe, Ton und Betonung genauer steuern möchten, formatieren Sie die `Speak`-Eigenschaft als [Speech Synthesis Markup Language (SSML)](http://www.w3.org/TR/speech-synthesis/).
Im folgenden Codebeispiel wird angegeben, dass das Wort „Text“ mit mäßiger Betonung gesprochen werden soll:
```cs
Activity reply = activity.CreateReply("This is the text that will be displayed.");
reply.Speak = "This is the text that will be spoken.";
```
Mit der **InputHint**-Eigenschaft wird in Cortana angegeben, ob Ihr Bot eine Eingabe erwartet. Der Standardwert ist **ExpectingInput** für eine Eingabeaufforderung und **AcceptingInput** für anderen Arten von Antworten.
| Wert | BESCHREIBUNG |
|------|------|
| **AcceptingInput** | Ihr Bot ist passiv bereit für eine Eingabe, wartet jedoch nicht auf eine Antwort. Cortana akzeptiert Eingaben vom Benutzer, wenn der Benutzer die Mikrofontaste gedrückt hält.|
| **ExpectingInput** | Gibt an, dass der Bot aktiv eine Antwort vom Benutzer erwartet. Cortana lauscht auf eine Spracheingabe des Benutzers über das Mikrofon. |
| **IgnoringInput** | Cortana ignoriert Eingaben. Ihr Bot kann diesen Hinweis senden, wenn er aktiv eine Anforderung verarbeitet und Eingaben von Benutzern ignoriert, bis die Anforderung abgeschlossen ist. |
Dieses Beispiel zeigt, wie Sie Cortana bekannt geben, dass eine Benutzereingabe erwartet wird. Das Mikrofon bleibt geöffnet.
```cs
// Add an InputHint to let Cortana know to expect user input
Activity reply = activity.CreateReply("This is the text that will be displayed.");
reply.Speak = "This is the text that will be spoken.";
reply.InputHint = InputHints.ExpectingInput;
```
## Anzeigen von Karten in Cortana
Zusätzlich zu den gesprochenen Antworten kann Cortana auch Karten als Anlagen anzeigen. Cortana unterstützt die folgenden Rich Cards:
| Kartentyp | BESCHREIBUNG |
|----|----|
| [HeroCard][heroCard] | Rich Cards, die in der Regel ein einzelnes großes Bild, eine oder mehrere Schaltflächen sowie Text enthalten. |
| [ThumbnailCard][thumbnailCard] | Rich Cards, die in der Regel ein Miniaturbild, eine oder mehrere Schaltflächen sowie Text enthalten. |
| [ReceiptCard][receiptCard] | Rich Cards, die einen Bot enthalten, der Benutzern eine Quittung bereitstellen kann. Sie enthalten in der Regel die Liste der Elemente, die in der Quittung enthalten sein sollen, Steuer- und Gesamtbeträge sowie anderen Text. |
| [SignInCard][signinCard] | Rich Cards, die einen Bot enthalten, der den Benutzer auffordert, sich anzumelden. Sie enthalten in der Regel Text und eine oder mehrere Schaltflächen, auf die der Benutzer klicken kann, um den Anmeldevorgang zu initiieren. |
Wie diese Karten in Cortana aussehen, ist unter [Bewährte Methoden für Kartendesign][CardDesign] beschrieben. Ein Beispiel, wie Sie eine Rich Card in einen Bot verwenden, finden Sie unter [Hinzufügen von Rich Card-Anlagen zu Nachrichten](bot-builder-dotnet-add-rich-card-attachments.md).
## Beispiel: RollerSkill
Der Code in den folgenden Abschnitten stammt aus einer Cortana-Beispielfunktion für das Werfen von Würfeln. Laden Sie den vollständigen Code für den Bot aus dem [Repository für Bot Builder-Beispiele](https://github.com/Microsoft/BotBuilder-Samples/) herunter.
Sie rufen die Fähigkeit auf, indem Sie Cortana den [Aufrufnamen][InvocationNameGuidelines] sagen. Bei RollerSkill können Sie die Funktion aufrufen, nachdem Sie dem [Cortana-Kanal den Bot hinzugefügt ][CortanaChannel] und ihn als Cortana-Funktion registriert haben, indem Sie Cortana „Ask Roller“ oder „Ask Roller to roll dice“ sagen.
### Untersuchen des Codes
Um die entsprechenden Dialoge aufzurufen, untersuchen die in `RootDispatchDialog.cs` definierten Aktivitätshandler die Eingabe des Benutzers anhand von regulären Ausdrücken auf Übereinstimmung. Beispielsweise wird der Handler im folgenden Beispiel ausgelöst, wenn der Benutzer etwas Ähnliches wie „Ich möchte würfeln“ sagt. Im regulären Ausdruck sind Synonyme enthalten, sodass ähnliche Äußerungen den Dialog auslösen.
```cs
[RegexPattern("(roll|role|throw|shoot).*(dice|die|dye|bones)")]
[RegexPattern("new game")]
[ScorableGroup(1)]
public async Task NewGame(IDialogContext context, IActivity activity)
{
context.Call(new CreateGameDialog(), AfterGameCreated);
}
```
Im Dialog `CreateGameDialog` wird ein benutzerdefiniertes Spiel eingerichtet, das der Bot spielen soll. Der Benutzer wird mithilfe von `PromptDialog` gefragt, wie viele Seiten der Würfel haben soll, und anschließend, wie viele geworfen werden sollen. Beachten Sie, dass das zum Initialisieren der Aufforderung verwendete `PromptOptions`-Objekt eine `speak`-Eigenschaft für die gesprochene Version der Aufforderung aufweist.
```cs
[Serializable]
public class CreateGameDialog : IDialog
{
public async Task StartAsync(IDialogContext context)
{
context.UserData.SetValue(Utils.GameDataKey, new GameData());
var descriptions = new List() { "4 Sides", "6 Sides", "8 Sides", "10 Sides", "12 Sides", "20 Sides" };
var choices = new Dictionary>()
{
{ "4", new List { "four", "for", "4 sided", "4 sides" } },
{ "6", new List { "six", "sex", "6 sided", "6 sides" } },
{ "8", new List { "eight", "8 sided", "8 sides" } },
{ "10", new List { "ten", "10 sided", "10 sides" } },
{ "12", new List { "twelve", "12 sided", "12 sides" } },
{ "20", new List { "twenty", "20 sided", "20 sides" } }
};
var promptOptions = new PromptOptions(
Resources.ChooseSides,
choices: choices,
descriptions: descriptions,
speak: SSMLHelper.Speak(Utils.RandomPick(Resources.ChooseSidesSSML))); // spoken prompt
PromptDialog.Choice(context, this.DiceChoiceReceivedAsync, promptOptions);
}
private async Task DiceChoiceReceivedAsync(IDialogContext context, IAwaitable result)
{
GameData game;
if (context.UserData.TryGetValue(Utils.GameDataKey, out game))
{
int sides;
if (int.TryParse(await result, out sides))
{
game.Sides = sides;
context.UserData.SetValue(Utils.GameDataKey, game);
}
var promptText = string.Format(Resources.ChooseCount, sides);
var promptOption = new PromptOptions(promptText, choices: null, speak: SSMLHelper.Speak(Utils.RandomPick(Resources.ChooseCountSSML)));
var prompt = new PromptDialog.PromptInt64(promptOption);
context.Call(prompt, this.DiceNumberReceivedAsync);
}
}
private async Task DiceNumberReceivedAsync(IDialogContext context, IAwaitable result)
{
GameData game;
if (context.UserData.TryGetValue(Utils.GameDataKey, out game))
{
game.Count = await result;
context.UserData.SetValue(Utils.GameDataKey, game);
}
context.Done(game);
}
}
```
`PlayGameDialog` rendert die Ergebnisse durch Anzeige auf einer `HeroCard` und Erstellen einer gesprochenen Nachricht, die mit der `Speak`-Methode ausgegeben werden soll.
```cs
[Serializable]
public class PlayGameDialog : IDialog