Wichtige Konzepte in der Direct Line-API 1.1

  • Artikel

Sie können die Kommunikation zwischen Ihrem Bot und Ihrer eigenen Clientanwendung mithilfe der Direct Line-API aktivieren.

Wichtig

In diesem Artikel werden die wichtigsten Konzepte in der Direct Line-API 1.1 vorgestellt und Informationen zu den relevanten Entwicklerressourcen angegeben. Wenn Sie eine neue Verbindung zwischen Ihrer Clientanwendung und Ihrem Bot erstellen, verwenden Sie stattdessen Direct Line API 3.0.

Authentifizierung

Anforderungen der Direct Line-API 1.1 können entweder mithilfe eines Geheimnisses, das Sie von der Konfigurationsseite des Direct Line-Kanals im Azure-Portal abrufen, oder mithilfe eines zur Laufzeit abgerufenen Tokens authentifiziert werden. Weitere Informationen finden Sie unter Authentifizierung.

Starten einer Konversation

Direct Line-Unterhaltungen werden explizit von Clients geöffnet und können solange ausgeführt werden, wie Bot und Client daran teilnehmen und gültige Anmeldeinformationen aufweisen. Weitere Informationen finden Sie unter Starten einer Konversation.

Senden von Nachrichten

Ein Client kann unter Verwendung der Direct Line-API 1.1 Nachrichten an Ihren Bot senden, indem er HTTP POST-Anforderungen ausgibt. Ein Client kann eine einzelne Nachricht pro Anforderung senden. Weitere Informationen finden Sie unter Senden einer Nachricht an den Bot.

Empfangen von Nachrichten

Ein Client kann unter Verwendung der Direct Line-API 1.1 Nachrichten empfangen, indem er sie über HTTP GET-Anforderungen abruft. Als Antwort auf jede Anforderung kann ein Client mehrere Nachrichten vom Bot als Teil eines MessageSet empfangen. Weitere Informationen finden Sie unter Empfangen von Nachrichten vom Bot.

Entwicklerressourcen

Clientbibliothek

Bot Framework stellt eine Clientbibliothek bereit, die den Zugriff auf die Direct Line-API 1.1 über C# vereinfacht. Um die Clientbibliothek in einem Visual Studio-Projekt zu verwenden, installieren Sie das Microsoft.Bot.Connector.DirectLinev1.x NuGet-Paket.

Alternativ zur Verwendung der C#-Clientbibliothek können Sie Ihre eigene Clientbibliothek in der Sprache Ihrer Wahl erstellen, indem Sie die Swagger-Datei der Direct Line-API 1.1 verwenden.