Microsoft Copilot Studio는 Power Platform API를 통해 에이전트를 격리하는 작업을 포함하여 봇 보안 및 규정 준수를 관리하는 강력한 도구를 관리자에게 제공합니다.
에이전트 격리는 Copilot Studio의 광범위한 보안 프레임워크의 일부이며 Copilot Studio의 전반적인 보안 접근 방식과 함께 작동합니다.
예를 들어 DLP(데이터 손실 방지) 정책을 위반하거나 규정 준수 설명서가 없는 봇은 감사, 런타임 보호 또는 기타 관리자 보고서 또는 알림의 일부로 플래그를 지정할 수 있습니다. 관리자는 격리 API를 사용하여 보안 및 규정 준수 문제를 조사하고 해결하는 동안 규정을 준수하지 않는 에이전트를 격리할 수 있습니다.
격리된 에이전트는 에이전트 사용자(및 Copilot Studio의 에이전트 제작자)에게 계속 표시되지만 에이전트와 상호 작용하거나 사용할 수는 없습니다.
중요
이전 powervirtualgents 네임스페이스는 더 이상 사용되지 않으며 2025년 말까지 제거됩니다.
이 문서에 나열된 대로 API 호출에서 copilotstudio 네임스페이스를 사용합니다.
필수 구성 요소
- Power Platform 테넌트 관리자 또는 Power Platform 관리자 또는 Dynamics 365 서비스 관리자여야 합니다.
- 대상 에이전트에 대한 봇 ID 및 환경 ID가 있습니다.
- API를 사용하는 서비스 또는 사용자에 대한 인증 토큰이 있습니다.
- 권한 부여 URL
https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.powerplatform.com의 암시적 흐름을 사용하여 Microsoft Entra ID OAuth2를 통해 인증됩니다.
에이전트 격리 관리를 위한 API 작업
Copilot Studio는 Power Platform API의 일부로 에이전트 격리를 관리하기 위한 세 가지 주요 REST API 작업을 지원합니다.
Power Platform API 사용 방법 및 시기에 대한 자세한 내용은 다음을 참조하세요.
- Power Platform API 및 SDK: UX 우선에서 API 우선으로(블로그)(Power Platform 개발자 블로그)
- 프로그래밍 가능성 및 확장성 개요(Power Platform 설명서)
- Power Platform API 시작(프리뷰)(Power Platform 설명서)
이 문서에서는 Power Platform API 참조 설명서에도 정의된 사용 가능한 작업에 대해 설명합니다.
중요
copilotstudio 네임스페이스는 Copilot Studio 관련 API 작업에 사용해야 합니다.
이전 powervirtualgents 네임스페이스는 더 이상 사용되지 않으며 2025년 말까지 제거됩니다.
이전에 powervirtualagents 네임스페이스를 사용한 경우 copilotstudio 네임스페이스를 사용하도록 API 호출을 업데이트하여 지속적인 기능을 보장합니다.
에이전트 격리 상태 가져오기
- 엔드포인트:
GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/GetBotQuarantineStatus?api-version=1. - 목적: 에이전트의 현재 격리 상태를 검색합니다.
- 응답: 부울
isBotQuarantined및lastUpdateTimeUtc를 반환합니다.
매개 변수 요구 사항 및 응답 코드는 격리 상태에 대한 API 참조 설명서를 참조하세요.
에이전트를 격리됨으로 설정
- 엔드포인트:
POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1. - 목적: 에이전트를 격리됨으로 표시하여 가용성 및 상호 작용을 제한합니다.
- 응답: 격리 상태 업데이트를 확인합니다.
매개 변수 요구 사항 및 응답 코드는 에이전트 격리에 대한 API 참조 설명서를 참조하세요.
에이전트를 격리 해제됨으로 설정
- 엔드포인트:
POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1. - 목적: 위험 평가 및 수정 후 격리에서 에이전트를 제거합니다.
- 응답: 격리 상태 업데이트를 확인합니다.
매개 변수 요구 사항 및 응답 코드는 에이전트 격리 해제에 대한 API 참조 설명서를 참조하세요.