Testare ed eseguire il debug del bot di Microsoft Teams

Quando si esegue il test del bot, è necessario prendere in considerazione sia i contesti in cui si vuole che il bot venga eseguito sia qualsiasi funzionalità aggiunta al bot che richiede dati specifici di Microsoft Teams. Assicurarsi che il metodo scelto per testare il bot sia allineato con la relativa funzionalità.

Eseguire il test caricando in Teams

Il modo più completo per testare il bot consiste nel creare un pacchetto dell'app e caricarlo in Teams. Il caricamento dell'app in Teams è l'unico modo per testare tutte le funzionalità disponibili per il bot, in tutti gli ambiti.

Esistono due modi per caricare l'app. È possibile usare il Portale per sviluppatori per Teams oppure creare manualmente un pacchetto dell'app e caricare l'app. Se è necessario modificare il manifesto e ricaricare l'app, è necessario eliminare il bot prima di caricare il pacchetto dell'app modificato.

Eseguire il debug del bot in locale

Se si ospita il bot in locale durante lo sviluppo, sarà necessario usare un servizio di tunneling come ngrok per testare il bot. Dopo aver scaricato e installato ngrok, esegui il comando seguente per avviare il servizio di tunneling. Potrebbe essere necessario aggiungere ngrok al tuo percorso.

ngrok http <port> --host-header=localhost:<port>

Usa l'endpoint https fornito da ngrok nel manifesto dell'app. Se chiudi la finestra di comando e lo riavvii, otterrai un nuovo URL e dovrai aggiornare l'indirizzo dell'endpoint del bot per usare anche quello.

Testare il bot senza caricarlo in Teams

A volte è necessario testare il bot senza installarlo come app in Teams. Testare il bot senza installarlo come app può essere utile per assicurarsi che il bot sia disponibile e risponda, tuttavia non consentirà di testare l'intera gamma di funzionalità di Teams aggiunte al bot. Se è necessario testare completamente il bot, seguire le istruzioni per il test mediante caricamento.

Usare l'emulatore di bot

Bot Framework Emulator è un'applicazione desktop che consente agli sviluppatori di bot di testare ed eseguire il debug dei propri bot, in locale o in remoto. Usando l'emulatore, è possibile chattare con il bot e ispezionare i messaggi inviati e ricevuti dal bot. Questo può essere utile per verificare che il bot sia disponibile e risponda, tuttavia l'emulatore non consentirà di testare alcuna funzionalità specifica di Teams aggiunta al bot, né le risposte del bot saranno una rappresentazione visiva accurata di come vengono visualizzate in Teams. Se è necessario testare una di queste cose, non è meglio caricare il bot.

Le istruzioni complete su Bot Framework Emulator sono disponibili qui.

Blocco di un bot nella chat personale

Gli utenti possono scegliere di impedire al bot di inviare messaggi di chat personali. Possono attivare o disattivare questa impostazione facendo clic con il pulsante destro del mouse sul bot nel canale della chat e scegliendo Blocca conversazione bot. Ciò significa che i bot continueranno a inviare messaggi, ma l'utente non riceverà tali messaggi.

Rimozione di un bot da un team

Gli utenti possono eliminare il bot scegliendo l'icona del cestino nell'elenco dei bot nella visualizzazione dei team. Nota che questo rimuove solo il bot dall'uso di quel team, i singoli utenti possono interagire nel contesto personale.

I bot nel contesto personale non possono essere disabilitati o rimossi da un utente, a meno che non vengano rimossi completamente da Teams.

Disabilitazione di un bot in Teams

Per interrompere la ricezione di messaggi nel bot, passare al dashboard dei bot e modificare il canale Microsoft Teams. Deselezionare l'opzione Abilita su Microsoft Teams . La disabilitazione di un bot in Teams impedisce agli utenti di interagire con il bot, ma sarà comunque individuabile e gli utenti potranno aggiungerlo a Teams.

Eliminazione di un bot da Teams

Per rimuovere completamente il bot da Teams, passare alla dashboard dei bot e modificare il canale Microsoft Teams. Scegli il pulsante Elimina in basso. L'eliminazione di un bot da Teams impedisce agli utenti di individuare, aggiungere o interagire con il bot. L'eliminazione di un bot da Teams non rimuove il bot dalle istanze di Teams di altri utenti, anche se cesserà di funzionare anche per loro.

Rimozione del bot da AppSource

Se si vuole rimuovere il bot dall'app Teams in AppSource (in precedenza Office Store), è necessario rimuovere il bot dal manifesto dell'app e inviare di nuovo l'app per la convalida. Per altre informazioni, vedere Pubblicare l'app Microsoft Teams in AppSource.