Gestire l'accesso all'API di trascrizione per le riunioni di Teams

SI APPLICA A:Immagine di un segno di spunta per sìRiunioni Immagine di una x per nessunEventi

È possibile usare l'interfaccia di amministrazione di Teams o PowerShell per controllare se agenti e app possono accedere alle trascrizioni delle riunioni di Teams tramite le API di Microsoft Graph e se le trascrizioni includono l'attribuzione del relatore. Puoi anche controllare se agenti e app possono accedere alle trascrizioni in tempo reale tramite Work IQ.

Per impostazione predefinita, l'accesso a Microsoft Graph è disattivato, quindi agenti e app non possono accedere alle trascrizioni delle riunioni, indipendentemente dalle autorizzazioni a livello di app. Anche l'accesso a Work IQ è disattivato per impostazione predefinita. Per maggiori dettagli, consulta Gestire l'accesso di Work IQ alle trascrizioni in tempo reale.

Utilizzo dell'interfaccia di amministrazione di Teams

Per abilitare l'accesso all'API della trascrizione tramite l'interfaccia di amministrazione di Teams, seguire questa procedura:

  1. Nel riquadro di spostamento sinistro dell'interfaccia di amministrazione di Teams, passare a Impostazioni>riunione.

  2. In Accesso API Trascrizione, attivare l'interruttore diaccesso Microsoft Graph per consentire alle app e agli agenti di accedere alle trascrizioni delle riunioni.

    Screenshot dell'impostazione di accesso all'API Trascrizione nell'interfaccia di amministrazione di Teams.

  3. Seleziona Configura, quindi esegui le operazioni seguenti:

    • Per includere l'attribuzione del parlante nelle trascrizioni a cui si accede tramite l'API Graph, attiva l'interruttore Includi attribuzione del parlante. Per impostazione predefinita, questa impostazione è disattivata.
    • Per consentire o impedire a singole app e agenti di accedere alle trascrizioni, utilizzare il collegamento all'interfaccia di amministrazione di Microsoft Entra per gestire le autorizzazioni API per ogni app.

Utilizzo di PowerShell

Per configurare l'accesso all'API di trascrizione tramite PowerShell, usare il cmdlet Set-CsTeamsMeetingConfiguration con i parametri seguenti:

  • -EnableGraphTranscriptAccess: se impostato su true, gli agenti e le app possono accedere alle trascrizioni delle riunioni tramite le API di Graph.
  • -EnableAttributedTranscripts: se impostato su true, le trascrizioni a cui si accede tramite le API di Graph includono l'attribuzione del parlante.

Ad esempio, per abilitare l'accesso a Microsoft Graph alle trascrizioni delle riunioni dell'organizzazione e includere l'attribuzione del relatore, eseguire il comando seguente:

Set-CsTeamsMeetingConfiguration -EnableGraphTranscriptAccess $true -EnableAttributedTranscripts $true -Identity Global

Gestisci l'accesso di Work IQ alle trascrizioni in tempo reale

Work IQ consente ad agenti e app, incluse quelle create dall'organizzazione, di ricevere la trascrizione di una riunione o di una chiamata di Teams mentre è in corso. L'impostazione di accesso Work IQ controlla se possono. È indipendente dall'accesso a Microsoft Graph ed è disattivato per impostazione predefinita.

Importante

L'accesso a Work IQ entrerà in vigore il 14 novembre 2026. Se le app nella tua organizzazione ricevono già trascrizioni in tempo reale tramite Work IQ, attiva l'accesso a Work IQ prima di tale data per mantenerle funzionanti.

La disattivazione dell'accesso a Work IQ non disattiva la trascrizione né modifica l'accesso a Microsoft Graph. Le esperienze di Microsoft AI in Teams, ad esempio Microsoft 365 Copilot, Facilitator e Riepilogo intelligente, continuano a funzionare come configurate.

Attivare l'accesso a Work IQ

Nell'interfaccia di amministrazione di Teams, passare a Riunioni>,Impostazioni riunione. In Accesso API Trascrizione, attiva l'interruttore diaccesso WorkIQ.

Per usare PowerShell, eseguire il cmdlet Set-CsTeamsMeetingConfiguration con il -EnableWorkIQTranscriptAccess parametro. Se impostato su true, gli agenti e le app possono accedere alle trascrizioni in tempo reale tramite Work IQ. Questo parametro richiede l'ultima versione del modulo PowerShell di Teams.

Set-CsTeamsMeetingConfiguration -EnableWorkIQTranscriptAccess $true -Identity Global

Quando le app ricevono trascrizioni in tempo reale

L'attivazione dell'accesso a Work IQ non fornisce, di per sé, una trascrizione alle app. Un'app riceve una trascrizione in tempo reale solo quando vengono soddisfatte anche queste condizioni:

  • L'intelligenza artificiale è consentita nella riunione, come illustrato nella tabella seguente.
  • La trascrizione è in esecuzione. Work IQ non avvia la trascrizione. Per altre informazioni, vedere Gestire la trascrizione e i sottotitoli per le riunioni di Teams.
  • L'app agisce per conto di un utente connesso e dispone delle autorizzazioni necessarie in Microsoft Entra ID.
  • Work IQ è abilitato per l'organizzazione di quell'utente. Per ulteriori informazioni, consulta Abilitare il tenant per Work IQ.
Consenti l'intelligenza artificiale in tutte le riunioni Accesso a Work IQ Risultato
Disattivato Disattivato o attivato Nessuna trascrizione è disponibile.
Attivato Disattivato Le richieste di QI di lavoro vengono negate. Altre esperienze di intelligenza artificiale funzionano in base alla configurazione.
Attivato Attivato Gli agenti e le app possono ricevere la trascrizione in tempo reale.

Modalità di applicazione dell'impostazione

  • La decide l'organizzazione dell'organizzatore. Work IQ utilizza l'impostazione dell'organizzazione che ha organizzato la riunione, non l'impostazione dell'organizzazione dell'app o dell'utente per cui l'app agisce.
  • Le trascrizioni in corso continuano. La disattivazione dell'accesso a Work IQ non interrompe le trascrizioni che le app stanno già ricevendo. Continuano fino al termine della riunione o della chiamata. Le nuove richieste vengono negate.
  • Le modifiche non sono immediate. La procedura può richiedere del tempo prima che una modifica si applichi alle nuove richieste.
  • Sono inclusi i nomi dei relatori. Le trascrizioni in tempo reale che le app ricevono tramite Work IQ includono i nomi dei relatori. L'impostazione Includi attribuzione parlante si applica solo a Microsoft Graph.