Concetti chiave sull'API Direct Line 3.0

  • Articolo

Usando l'API Direct Line è possibile consentire la comunicazione tra il bot e l'applicazione client. Questo articolo illustra i concetti chiave sull'API Direct Line 3.0 e fornisce informazioni sulle relative risorse per sviluppatori. È possibile compilare un client usando l'SDK, l'API REST o Chat.

Authentication

Direct Line richieste API 3.0 possono essere autenticate usando un segreto ottenuto dalla pagina di configurazione del canale Direct Line nell'portale di Azure o usando un token ottenuto in fase di esecuzione. Per altre informazioni, vedere Autenticazione.

Avviare una conversazione

Le conversazioni Direct Line vengono aperte esplicitamente dai client e possono essere eseguite fintanto che il bot e il client partecipano e hanno credenziali valide. Per altre informazioni, vedere Avviare una conversazione.

Invio di messaggi

Con l'API Direct Line 3.0, un client può inviare messaggi al bot inviando delle richieste HTTP POST. I client possono inviare un solo messaggio per richiesta. Per altre informazioni, vedere Inviare un'attività al bot.

Ricezione di messaggi

Con l'API Direct Line 3.0, un client può ricevere messaggi dal bot tramite il flusso WebSocket o inviando delle richieste HTTP GET. Usando una di queste due tecniche, un client può ricevere più messaggi dal bot alla volta nell'ambito di un ActivitySet. Per altre informazioni, vedere Ricevere attività dal bot.

Risorse per sviluppatori

Librerie client

Bot Framework fornisce librerie client che facilitano l'accesso all'API Direct Line 3.0 con C# e Node.js.

  • Per usare la libreria client .NET all'interno di un progetto di Visual Studio, installare il Microsoft.Bot.Connector.DirectLinepacchetto NuGet.s

  • Per usare la libreria client Node.js, installare la botframework-directlinejs libreria usando NPM (o scaricare l'origine).

Controllo della chat Web

Bot Framework fornisce un controllo che consente di incorporare un bot basato su Direct Line nell'applicazione client. Per altre informazioni, vedere Microsoft Bot Framework WebChat control (Controllo WebChat di Microsoft Bot Framework).