Mettere in quarantena gli agenti non conformi con l'API Power Platform

Copilot Studio fornisce agli amministratori strumenti robusti per gestire la sicurezza e la conformità degli agenti, incluse le azioni di quarantena per gli agenti tramite l'API Power Platform.

La quarantena degli agenti fa parte del più ampio framework di sicurezza di Copilot Studio e lavora in sinergia con il vostro approccio complessivo alla sicurezza in Copilot Studio.

Ad esempio, gli agenti che violano le politiche sui dati o non hanno documentazione di conformità possono essere segnalati come parte di audit, protezione a tempo di esecuzione o altri report o notifiche amministrative. Gli amministratori possono quindi usare le API di quarantena per isolare gli agenti non conformi durante l'analisi e la correzione dei problemi di sicurezza e conformità.

Gli agenti che sono messi in quarantena sono comunque visibili agli utenti e ai creatori di agenti in Copilot Studio, ma non è possibile interagire o utilizzare l'agente.

Importante

Il powervirtualgents namespace è obsoleto. Usa il copilotstudio namespace nelle chiamate API.

Prerequisiti

  • Avete l'ID bot e l'ID ambiente per l'agente di destinazione.
  • È necessario ottenere un token di accesso utente rilasciato da Microsoft Entra ID OAuth2. Per ottenere un token, vedere Autenticazione.
    • L'utente associato al token deve avere uno dei seguenti ruoli amministrativi:
      • Amministratore del tenant globale
      • Amministratore di intelligenza artificiale
      • Amministratore di Power Platform
    • Devi acquisire il token di accesso utilizzando l'ID client di una registrazione di un'app che ha l'ambito CopilotStudio.AdminActions.Invoke concesso dall'API Power Platform.

Operazioni API per la gestione della quarantena dell'agente

Copilot Studio supporta tre operazioni chiave dell'API REST per la gestione della quarantena dell'agente, come parte dell'API Power Platform.

Annotazioni

Le API SetAsQuarantined e SetAsUnquarantined non supportano chatbot classici. L'API restituisce 405 Method Not Allowed quando si tenta di mettere in quarantena o rimuovere dalla quarantena un chatbot classico.

Per altre informazioni su come e quando usare l'API Power Platform, vedere:

Recuperare lo stato di quarantena dell'agente

  • Endpoint:GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Scopo: Recuperare lo stato attuale di quarantena di un agente
  • Risposta: restituisce un booleano isBotQuarantined e lastUpdateTimeUtc

Scopri di più nella documentazione di riferimento API Get Bot Quarantine Status.

Impostare l'agente in quarantena

  • Endpoint:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Scopo: Contrassegnare un agente come in quarantena, limitandone la disponibilità e le interazioni
  • Risposta: Conferma aggiornamento sullo stato della quarantena

Scopri di più nella documentazione di riferimento API Set Bot As Quarantined.

Impostare l'agente come non più in quarantena

  • Endpoint:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Scopo: Rimuovere un agente dalla quarantena dopo la valutazione del rischio e la bonifica
  • Risposta: Conferma aggiornamento sullo stato della quarantena

Scopri di più nella documentazione di riferimento dell'API "Set Bot As Unquarantined".

  • Last updated on