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

Copilot Studio poskytuje administrátorům robustní nástroje pro správu bezpečnosti a souladu agentů, včetně karanténních akcí agentů prostřednictvím Power Platform API.

Karanténa agentů je součástí širšího bezpečnostního rámce Copilot Studia a funguje v souladu s vaším celkovým bezpečnostním přístupem v Copilot Studiu.

Například agenti, kteří porušují datové politiky nebo postrádají dokumentaci o souladu s předpisy , mohou být označeni jako součást auditů, ochrany za běhu nebo jiných administrativních zpráv či oznámení. 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ů.

Agenti, kteří jsou v karanténě, jsou stále viditelní pro uživatele a vývojáře v Copilot Studiu, ale není možné s agentem komunikovat ani jej používat.

Důležité

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

Požadavky

• 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. Informace o získání tokenu najdete v tématu Ověřování.
  • Uživatel přiřazený k tokenu musí mít jednu z následujících administrátorských rolí:
    • Globální správce tenanta
    • Správce AI
    • Správce Power Platform
  • Musíte získat přístupový token pomocí ID klienta registrace aplikace, která má rozsah CopilotStudio.AdminActions.Invoke udělený v rámci 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:

Rozhraní API SetAsQuarantined a SetAsUnquarantined nepodporují klasické chatovací roboty. 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:

• Power Platform API a sady SDK: Od UX-first po API-first (blog) ( Blog pro vývojáře Power Platform)
• Přehled programovatelnosti a rozšiřitelnosti (dokumentace k Power Platform)
• Začněte s Power Platform API (dokumentace k Power Platform)
• Referenční dokumentace operací API Power Platform

Získat stav karantény agenta

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

Více informací najdete v referenční dokumentaci API pro karanténní stav Get Bot.

Nastavit agenta do karantény

• Koncový bod:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
• Účel: Označit agenta jako karanténovaného, omezit jeho dostupnost a interakce
• Odpověď: Potvrzuje aktualizaci stavu karantény

Více informací najdete v referenční dokumentaci API Set Bot As Quarantined.

Nastavit agenta jako mimo karanténu

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

Více informací najdete v referenční dokumentaci API Set Bot As Unquarantined.