Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Importante
Questo articolo si basa su Bot Framework SDK v3.
- Se vuoi creare un bot di intelligenza artificiale, consulta Creare un bot di intelligenza artificiale.
- Se vuoi creare un bot di base, vedi Guida introduttiva e se vuoi cercare la documentazione corrente versione 4.6 o successiva dell'SDK, vedi Bot conversazionali.
Crea e connetti bot intelligenti per interagire con gli utenti di Microsoft Teams in modo naturale tramite la chat. Oppure fornire un semplice bot basato su comandi, da usare come interfaccia "riga di comando" per un'esperienza più ampia con l'app Teams. È possibile creare un bot di sola notifica, che può inviare informazioni rilevanti agli utenti direttamente a loro in un canale o in un messaggio diretto. È anche possibile usare il bot esistente basato su Bot Framework e aggiungere il supporto specifico di Teams per migliorare l'esperienza.
Importante
I bot sono disponibili in Government Community Cloud (GCC), GCC High, Department of Defense (DoD) e Teams gestiti da ambienti 21Vianet .
Cosa devi sapere: Bot
Un bot appare proprio come qualsiasi altro membro del team con cui interagisci in una conversazione, con la differenza che ha un'icona avatar esagonale ed è sempre online.
Un bot si comporta in modo diverso a seconda del tipo di conversazione in cui è coinvolto. I bot in Teams supportano diversi tipi di conversazione denominati ambiti nel manifesto dell'app.
-
teamsDette anche conversazioni di canale. -
personalConversazioni tra un bot e un singolo utente. -
groupChatConversazione tra un bot e due o più utenti.
Per altre informazioni, vedere Avviare una conversazione con un bot di Microsoft Teams.
Con le app di Teams, puoi rendere il bot il protagonista della tua esperienza o semplicemente un aiutante. I bot vengono pubblicati come parte del pacchetto di app più ampio, che può includere altre funzionalità, ad esempio schede o estensioni dei messaggi.
API bot
Teams supporta la maggior parte di Microsoft Bot Framework. Se si ha già un bot basato su Bot Framework, è possibile adattarlo facilmente per il lavoro in Teams. È consigliabile usare C# o Node.js per sfruttare gli SDK. Questi pacchetti estendono le classi e i metodi di base di Bot Builder SDK:
- Uso di tipi di schede specializzati, come la scheda connettore per i Gruppi di Microsoft 365.
- Utilizzo e impostazione di dati di canale specifici di Teams sulle attività.
- Elaborazione delle richieste di estensione messaggio.
Le estensioni SDK installano dipendenze, incluso Bot Builder SDK.
- .NET Per usare le estensioni di Microsoft Teams per Bot Builder SDK per .NET, installare il pacchetto NuGet Microsoft.Bot.Connector.Teams nel progetto Visual Studio. Per lo sviluppo Node.js, la funzionalità BotBuilder per Microsoft Teams è stata incorporata in Bot Framework SDK a partire dalla versione 4.6.
Importante
È possibile sviluppare app di Teams in qualsiasi altra tecnologia di programmazione Web e chiamare direttamente le API REST di Bot Framework , ma è necessario eseguire manualmente tutta la gestione dei token.
Il Portale per sviluppatori di Teams consente di creare e configurare il manifesto dell'app e può creare automaticamente il bot Bot Framework. Contiene anche una libreria di controlli React e un generatore di schede interattive.
Webhook in uscita
I webhook in uscita consentono di creare un semplice bot per l'interazione di base, ad esempio l'avvio di un flusso di lavoro o altri semplici comandi di cui potresti aver bisogno. I webhook in uscita si trovano solo nel team in cui vengono creati e sono destinati a processi semplici specifici per il flusso di lavoro della tua azienda. Per ulteriori informazioni, consulta webhook in uscita.
Creare un ottimo bot di Teams
Gli articoli seguenti illustrano il processo di creazione di un ottimo bot per Teams:
- Creare un bot: sfruttare gli ottimi strumenti, la documentazione e la community forniti dal team di Bot Framework.
- Parla con il tuo bot: aggiungi un flusso di conversazione di base e usa funzionalità specifiche del canale. Se si sviluppa in .NET o Node.js, usare le estensioni per Bot Builder SDK per semplificare il lavoro.
- Uso delle schede nel bot: progettare schede per comunicare e accettare la risposta dell'utente.
- Rispondere agli eventi bot
- Bot di sola notifica: uso di bot per inviare notifiche per l'app.
- Ottenere il contesto: ottenere informazioni sull'utente.
- Menu dei bot: uso dei menu nei bot.
- Bot e file: invio e ricezione di file dai bot.
- Uso delle schede con i bot: far lavorare insieme schede e bot.
- Testa il tuo bot: aggiungi il tuo bot per conversazioni personali o di team per vederlo in azione.
Bots SDK V3
Importante
Questo articolo si basa su Bot Framework SDK v3.
- Se vuoi creare un bot di intelligenza artificiale, consulta Creare un bot di intelligenza artificiale.
- Se vuoi creare un bot di base, vedi Guida introduttiva e se vuoi cercare la documentazione corrente versione 4.6 o successiva dell'SDK, vedi Bot conversazionali.
Il portale per sviluppatori di Teams per Teams è uno strumento che consente di compilare un bot e un pacchetto di app che fa riferimento al bot. Contiene anche una libreria di controlli React ed esempi configurabili per le schede. Per altre informazioni, vedere Introduzione al portale per sviluppatori di Teams per Teams. I passaggi seguenti presuppongono che si stia configurando manualmente il bot e non usando il portale per sviluppatori di Teams per Teams:
Creare il bot usando Bot Framework. Assicurarsi di aggiungere Microsoft Teams come canale dall'elenco dei canali in primo piano dopo aver creato il bot. Se hai già creato il pacchetto/manifesto dell'app, puoi riutilizzare qualsiasi ID app Microsoft che hai generato.
Nota
Se non si vuole creare il bot in Azure, è necessario usare questo collegamento per creare un nuovo bot: Bot Framework. Se invece si seleziona Crea un bot nel portale di Bot Framework, verrà creato il bot in Microsoft Azure.
Compilare il bot usando il pacchetto NuGet Microsoft.Bot.Connector.Teams , Bot Framework SDK o l'API Bot Connector.
Testare il bot usando Bot Framework Emulator.
Distribuire il bot in un servizio cloud, ad esempio Microsoft Azure. In alternativa, esegui l'app localmente e usa un servizio di tunneling come ngrok per esporre un endpoint https:// per il tuo bot, come
https://45az0eb1.ngrok-free.app/api/messages.
Nota
Bot e Microsoft Azure
Il portale di Bot Framework è ottimizzato per la registrazione dei bot in Microsoft Azure. Informazioni da tenere presenti:
- Il canale di Microsoft Teams per i bot registrati in Azure è gratuito. I messaggi inviati tramite il canale di Teams non verranno conteggiati per i messaggi utilizzati per il bot.
- Anche se è possibile creare un nuovo bot di Bot Framework senza usare Azure, è necessario usare creare un nuovo bot di Bot Framework, che non è più esposto nel portale di Bot Framework.
- Quando si modificano le proprietà di un bot esistente nell'elenco dei bot in Bot Framework, ad esempio l'"endpoint di messaggistica", comune quando si sviluppa un bot per la prima volta, soprattutto se si usa ngrogk, verrà visualizzata la colonna "Stato migrazione" e un pulsante blu "Migrazione" che consente di accedere al portale di Azure. Non selezionare il pulsante "Migra" a meno che non sia quello che vuoi fare; selezionare invece il nome del bot ed è possibile modificarne le proprietà:

- Se si registra il bot usando Microsoft Azure, il codice del bot non deve essere ospitato in Microsoft Azure.
- Se si registra un bot usando il portale di Azure, è necessario avere un account Microsoft Azure. È possibile crearne uno gratuitamente. Per verificare la tua identità quando ne crei una, devi fornire una carta di credito, ma non verrà addebitato alcun importo; creare e usare bot con Teams è sempre gratuito.
- Ora è possibile usare il portale per sviluppatori di Teams per registrare/aggiornare le informazioni di app e bot direttamente in Teams. Usare il portale di Azure solo per aggiungere o configurare altri canali Bot Framework, ad esempio Direct Line, chat Web, Skype e Facebook Messenger.