Concetti chiave in Direct Line API 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.

Autenticazione

Le richieste dell'API Direct Line 3.0 possono essere autenticate usando un segreto ottenuto dalla pagina di configurazione del canale Direct Line nel 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 gli 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.DirectLine pacchetto NuGet.s

  • Per usare la libreria client Node.js, installare la libreria botframework-directlinejsusando NPM (o scaricare il codice sorgente).

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).