Connessione a Microsoft Teams

Modifica online

Anteprima

Microsoft Teams è una potente piattaforma di comunicazione e collaborazione. Riunisce chat, riunioni, condivisione di file e integrazione di app in un unico spazio di lavoro unificato. Collegando il tuo agente a Microsoft Teams, puoi creare un hub centralizzato in cui gli utenti possono interagire con il tuo agente per semplificare i flussi di lavoro, automatizzare le attività e migliorare la produttività.

Prima di iniziare

Prima di iniziare l'integrazione, è necessario soddisfare i seguenti prerequisiti:

Per collegare il tuo agente con Microsoft Teams, devi:

  1. Creare il bot

  2. Crea un'app per l' Microsoft Teams

Procedura

Per connettersi a Microsoft Teams, procedere come segue:

  1. Vai alla pagina di configurazione dell'agente.

  2. Spostarsi su Canali > Squadre.

  3. Selezionare l'ambiente (Draft o Live) e fare clic su Crea nuovo.

  4. Leggete le istruzioni della pagina Iniziare e fate clic su Avanti.

  5. Leggete le istruzioni sulla pagina di registrazione dell'App.

  6. Immettere l' ID dell'applicazione (client), l' ID del tenant e il Client secret.

  7. Fare clic su Avanti.

  8. Rivedi e completa i passaggi relativi alla creazione del bot nella pagina Configura l' Microsoft Teams. Per maggiori dettagli, consultare la sezione Creare il bot.

  9. Rivedi e completa i passaggi relativi alla creazione dell'app Teams nella pagina Configura Microsoft Teams. Per ulteriori informazioni, consultare la sezione Creazione dell'applicazione Teams.

  10. Fare clic su Fine per completare l'impostazione.

È possibile visualizzare gli oggetti di classe " Microsoft Teams " che sono stati collegati correttamente nei rispettivi ambienti. Fai clic sul pulsante con i puntini di sospensione menu_trabocco verticali per modificare o eliminare l' Microsoft Teams e da quell'ambiente agente.

Richiedi un indirizzo e-mail da amministratore per sviluppatori su Microsoft 365

  1. Accedi al Programma per sviluppatori di Microsoft 365.

  2. Fate clic su Iscriviti ora e seguite i passaggi per iscrivervi.

  3. Nella dashboard, fare clic su Imposta abbonamento E5 e selezionare una sandbox istantanea o configurabile.

  4. Copiare l'indirizzo e-mail indicato in Amministratore. Conservatelo per un uso futuro.

Per ulteriori informazioni, consulta le politiche relative alle autorizzazioni delle app.

Registrate la vostra applicazione in Microsoft Azure

  1. Accedi al portale Microsoft Azure utilizzando le tue credenziali di amministratore.

  2. Vai su Registrazioni app > Nuova registrazione.

  3. Nella pagina Registra un'applicazione, inserire un nome, scegliere il tipo di inquilino appropriato e fare clic su Registra.

  4. Copia l'ID dell'applicazione dalla pagina Panoramica della tua app e incollalo nel campo ID applicazione (client) della tua configurazione di watsonx Orchestrate Microsoft Teams.

Creare il bot

Nota:

IBM Questa politica limita l'accesso ai servizi bot quando si utilizza un account sviluppatore E5. Questi servizi sono compatibili solo con account Azure non approvati da IBM. Gli account personali (ad esempio: Gmail o Outlook) non sono idonei per l'accesso all' E5 e o a livelli superiori. Sono ammessi solo i conti aziendali. In alternativa, gli sviluppatori possono acquistare una licenza per ottenere l'accesso richiesto.

  1. Accedi al portale Microsoft Azure. Utilizzare le proprie credenziali di amministratore.

  2. Cercare Azure Bot nella barra di ricerca e fare clic su Crea.

  3. Scegliere il tipo di creazione:

    • Selezionare Usa registrazione app esistente e inserire l'ID applicazione (client) generato in precedenza.

    • Nota : se si sceglie Crea nuovo Microsoft App ID, assicurarsi di aggiornare la registrazione dell'app con il nuovo ID generato.

  4. Salvare l'ID dell'applicazione per riferimenti futuri.

  5. Vai su Impostazioni > Configurazione, copia e salva l'endpoint generato per configurare successivamente il tuo Microsoft Teams.

  6. Completare il profilo del bot nella pagina Parlaci del tuo bot. Fornire dettagli rilevanti come il nome del bot, la descrizione e lo scopo.

  7. Copia l'endpoint generato dalla pagina "Crea il tuo bot " del tuo account watsonx Orchestrate Microsoft Teams e incollalo nel campo "Endpoint di messaggistica " della sezione "Configurazione ".

  8. Selezionare il tipo di bot:

    • Per un accesso più ampio, scegliete Multi-Tenant.

    • Per limitare l'accesso all'interno di una singola organizzazione, scegliere Single-tenant, immettere l' App Tenant ID e fare clic su Apply.

Crea un'app per l' Microsoft Teams

  1. Vai al portale per sviluppatori Microsoft Teams ed effettua l'accesso con le tue credenziali di amministratore.

  2. Fare clic su Applicazioni > Nuova applicazione.

  3. Immettere il nome dell'applicazione e fare clic su Aggiungi.

  4. In Informazioni di base, aggiungere i nomi delle app, l'ID dell'app, le descrizioni, le informazioni sullo sviluppatore e gli URL dell'app, quindi copiare e incollare l'ID dell'app in ID applicazione (client).

  5. Fare clic su Salva.

  6. Selezionare Configura > Caratteristiche dell'app > Bot.

  7. Nella pagina Seleziona un bot esistente, selezionare il proprio bot.

  8. In Seleziona l'ambito in cui le persone possono utilizzare questo comando, seleziona Chat personale, di gruppo e Chat di gruppo.

  9. Fare clic su Salva, quindi su Pubblica il bot.

Per aggiornare la sessione su Microsoft Teams, consulta la sezione "Aggiorna la sessione"

Trova il tuo ID inquilino

  1. Accedere all'ID Microsoft Entra. È possibile trovarlo nel menu o utilizzare la barra di ricerca per trovare Microsoft Entra ID.

  2. Passare a Gestione > Proprietà.

  3. Copiare l'ID inquilino per un uso futuro. L'ID inquilino (chiamato anche Directory ID) si trova nella sezione ID inquilino.

Genera il tuo ID segreto cliente

  1. Nella pagina Panoramica di Microsoft Azure, fare clic su Aggiungi un certificato o un segreto accanto a Credenziali client.

  2. Nella pagina Certificati e segreti per la creazione di token, fare clic su Nuovo segreto client.

  3. Inserire una descrizione e scegliere una durata Consigliato 180 giorni.

  4. Fare clic su Aggiungi.

  5. La stringa sotto Valore è l'ID segreto del cliente. Conservatelo per un uso futuro.

Suggerimento:

È necessario generare un nuovo valore prima che quello attuale scada il 180° giorno.

Aggiornamento della sessione in Microsoft Teams

Puoi aggiornare la tua sessione di conversazione in Teams in qualsiasi momento per cancellare il contesto precedente e ricominciare da capo. Questo è utile se il bot va in confusione, si blocca o semplicemente se vuoi iniziare una nuova attività.

Come aggiornare la sessione

Se desideri azzerare la conversazione o cancellare il contesto precedente, puoi aggiornare la sessione utilizzando una delle opzioni riportate di seguito.

Opzione 1: Utilizza un comando della chat

In qualsiasi conversazione su Teams con il bot, digita:

/refreshSession

Questo cancella immediatamente la sessione corrente e ripristina il contesto della conversazione.

Opzione 2: Utilizzare l'opzione basata sull'interfaccia utente

È possibile utilizzare l'opzione basata sull'interfaccia utente per aggiornare una sessione. Per abilitare questa funzione, devi prima definire un'estensione di composizione nel manifesto dell'app Teams. Una volta attivato, questo componente dell'interfaccia utente offre un ulteriore modo per aggiornare la sessione. Poiché si basa sull'identificazione di una sessione esistente, è necessario inviare prima un messaggio; se non viene rilevata alcuna sessione attiva, l'utente ne verrà informato.

"composeExtensions": [
  {
    "botId": "d1b6b6b7-7ae3-4c51-b05e-1316b7ff5c41",
    "commands": [
      {
        "id": "refreshSession",
        "botId": "d1b6b6b7-7ae3-4c51-b05e-1316b7ff5c41", 
        "type": "action",
        "title": "Refresh Session",
        "description": "Refresh the conversation session's context",
        "initialRun": false,
        "fetchTask": false,
        "context": [
          "commandBox",
          "compose"
        ]
      }
    ]
  }
]

Per botId, utilizza l'ID bot Microsoft corrispondente, disponibile nel manifesto dell'app.

Una volta effettuata questa configurazione, l'opzione "Aggiorna sessione" apparirà nella barra superiore quando digiti:

/YOUR_APP_NAME
Nota:

L'aggiornamento della sessione avviene automaticamente. Non è richiesta alcuna configurazione. La sessione corrente proseguirà normalmente finché non deciderai di aggiornarla.

Cosa fare successivamente

Per aggiungere variabili di contesto specifiche del canale per Microsoft Teams, segui le istruzioni fornite nelle variabili di contesto di Teams.