Che cosa sono le estensioni dei messaggi?

Completato

Quando si compila un'estensione di messaggio, si crea un'app per Microsoft Teams estesa a Microsoft 365. L'estensione dell'app consente di visualizzarla in Microsoft Outlook e in Microsoft 365 Copilot come plug-in.

Un'app estesa di Microsoft Teams viene definita app di Microsoft 365. Un'app di Microsoft 365 usa un manifesto dell'app comune, un formato di creazione di pacchetti delle app e strumenti di sviluppo e amministrazione usati per creare un'app per Microsoft Teams.

Un'estensione di messaggio è una funzionalità dell'app e usa un bot per comunicare tra l'utente e il sistema esterno.

Funzionalità di estensione dei messaggi

Le funzionalità dell'estensione del messaggio, il modo in cui viene visualizzata nell'interfaccia utente e le interazioni che può supportare, sono definite nel manifesto dell'app.

I comandi e i gestori dei messaggi sono funzionalità che un'estensione del messaggio può avere. Un'estensione del messaggio può usare una combinazione di comandi di ricerca e azione e gestori di messaggi.

Esistono due tipi di comandi:

• Comandi di ricerca, consentono agli utenti di cercare sistemi esterni e inserire i risultati di tale ricerca in un messaggio sotto forma di scheda.
• Comandi di azione, consentono agli utenti di agire sui messaggi in Teams, visualizzando un popup modale che può essere usato per raccogliere o visualizzare informazioni.

I gestori dei messaggi consentono all'estensione del messaggio di rimuovere i collegamenti quando un URL con un determinato dominio viene incollato nella finestra di messaggio compose.

Comandi di ricerca

I comandi di ricerca vengono usati per eseguire ricerche nei sistemi esterni e restituire i risultati come schede formattate avanzate. Quando si compila un plug-in di estensione messaggio Microsoft 365 Copilot, è necessaria un'app che contenga un comando di ricerca dell'estensione del messaggio.

Come funziona un'estensione del messaggio?

Le estensioni dei messaggi usano un bot registrato con Bot Framework per comunicare tra un client e il sistema esterno.

Bot Framework è una piattaforma fornita da Microsoft, che offre gli strumenti e i servizi necessari per compilare, testare, distribuire e gestire i bot.

Un'estensione del messaggio è costituita da una risorsa bot, un Microsoft Entra registrazione dell'app e codice che usa Bot Framework SDK per gestire le interazioni degli utenti.

L'immagine seguente mostra una struttura di alto livello di un'estensione del messaggio:

Il servizio bot registra un bot con Bot Framework e riceve le richieste dal client quando l'utente interagisce con l'estensione del messaggio. Invia richieste a un servizio Web, che contiene il codice del bot. Il servizio Web usa le credenziali di registrazione dell'app bot in Microsoft Entra per eseguire l'autenticazione con il servizio bot. Raccoglie i dati dal sistema esterno e restituisce i dati al servizio bot, che viene passato al client.

Si supponga che un utente avvii una ricerca usando un'estensione di messaggio. Il diagramma di sequenza seguente mostra le interazioni:

1. L'utente apre l'estensione del messaggio nel client e immette una query di ricerca.
2. Il client invia una richiesta al servizio bot tramite un endpoint del canale, contenente informazioni sulla query utente.
3. Il servizio bot invia una richiesta a un endpoint di messaggistica esposto nel servizio Web per gestire la query utente.
4. L'endpoint di messaggistica riceve la richiesta e richiama l'adattatore bot. L'adattatore bot usa il bot Microsoft Entra le credenziali di registrazione dell'app per proteggere la comunicazione tra il servizio Web e il servizio bot.
5. L'adattatore bot richiama il OnTeamsMessageExtensionQuery metodo nella classe del gestore dell'attività del bot, che contiene la logica per gestire la richiesta in ingresso.
6. Il gestore dell'attività del bot ottiene i dati dal sistema esterno. Crea un oggetto MessageExtensionResult, che contiene i dati esterni come schede formattate avanzate e crea un MessageExtensionResponseoggetto , che contiene .MessageExtensionResult
7. L'adattatore bot riceve la risposta dal gestore dell'attività del bot e crea una risposta HTTP.
8. L'endpoint di messaggistica restituisce la risposta al servizio bot.
9. Il servizio bot restituisce la risposta tramite l'endpoint del canale all'estensione del messaggio.
10. L'estensione del messaggio esegue il rendering della risposta nel client e visualizza i risultati della ricerca all'utente.

Se l'estensione del messaggio supporta, i comandi di ricerca o azione o lo srotolamento dei collegamenti, si verifica lo stesso flusso. Il servizio bot inoltra una richiesta al servizio Web che gestisce e risponde.