Karanténa agentů nedodržujících předpisy pomocí rozhraní API Power Platform

Copilot Studio poskytuje správcům robustní nástroje pro správu zabezpečení a dodržování předpisů agentů, včetně akcí karantény pro agenty prostřednictvím Power Platform API.

Karanténa agentů je součástí širší architektury zabezpečení aplikace Copilot Studio a pracuje společně s celkovým přístupem k zabezpečení v Copilot Studio.

Agenty, kteří například porušují zásady pro data nebo nemají dokumentaci týkající se dodržování předpisů, lze označit jako součást auditů, ochrany modulu runtime nebo sestav či oznámení správců. Správci pak můžou pomocí rozhraní API pro karanténu izolovat agenty nedodržující předpisy při vyšetřování a odstraňování problémů se zabezpečením a dodržováním předpisů.

Uživatelé agentů a tvůrci v Copilot Studio můžou zobrazit agenty, kteří jsou v karanténě. Tvůrci mohou během testování komunikovat s agenty, ale nemohou komunikovat s agenty v karanténě v žádném jiném kanálu.

Důležité

Jmenný prostor powervirtualgents je zastaralý. Používejte jmenný prostor copilotstudio v API voláních.

Předpoklady

  • Pro cílového agenta máte ID robota a ID prostředí.
  • Musíte získat uživatelský přístupový token vydaný Microsoft Entra ID OAuth2. Pro získání tokenu viz Autentizace.
    • Uživatel přiřazený k tokenu musí mít jednu z následujících administrátorských rolí:
      • Globální správce klienta
      • AI správce
      • Správce Power Platform
    • Musíte získat přístupový token pomocí ID klienta registrace aplikace, která má rozsah CopilotStudio.AdminActions.Invoke udělený rozhraním API Power Platform.

Operace rozhraní API pro správu karantény agenta

Copilot Studio podporuje tři klíčové operace rozhraní REST API pro správu karantény agenta v rámci rozhraní Power Platform API.

Poznámka

API „SetAsQuarantined“ a „SetAsUnquarantined“ nelze použít s klasickými chatboty. Rozhraní API vrátí 405 Method Not Allowed, když se pokusíte umístit do karantény nebo uvolnit z karantény klasického chatbota.

Další informace o tom, jak a kdy používat rozhraní API Power Platform, najdete tady:

Získat stav karantény agenta

  • Koncový bod: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Účel: Načtěte aktuální stav karantény agenta
  • Odpověď: Vrátí logickou hodnotu isBotQuarantined a lastUpdateTimeUtc

Více informací najdete v referenční dokumentaci API Získat stav karantény robota.

Nastavit agenta coby v karanténě

  • Koncový bod: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Účel: Označte agenta coby v karanténě a omezte jeho dostupnost a interakce
  • Odpověď: Potvrdí aktualizaci stavu karantény

Více informací najdete v referenční dokumentaci API Nastavit robota jako v karanténě.

Nastavit agenta mimo karanténu

  • Koncový bod: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Účel: Odebrání agenta z karantény po posouzení rizik a nápravu
  • Odpověď: Potvrdí aktualizaci stavu karantény

Více informací najdete v referenční dokumentaci API Nastavit robota jako vyjmutého z karantény.

  • Last updated on