Power Platform API를 사용하여 비준수 에이전트 격리

Microsoft Copilot Studio는 Power Platform API를 통해 에이전트를 격리하는 작업을 포함하여 에이전트 보안 및 규정 준수를 관리하는 강력한 도구를 관리자에게 제공합니다.

에이전트 격리는 Copilot Studio의 광범위한 보안 프레임워크의 일부이며 Copilot Studio의 전반적인 보안 접근 방식과 함께 작동합니다.

예를 들어, 데이터 정책을 위반하거나 규정 준수 관련 문서가 부족한 에이전트는 감사, 런타임 보호 또는 기타 관리자 보고서나 알림을 통해 경고 대상으로 지정될 수 있습니다. 관리자는 격리 API를 사용하여 보안 및 규정 준수 문제를 조사하고 해결하는 동안 규정을 준수하지 않는 에이전트를 격리할 수 있습니다.

에이전트 사용자와 제작자는 Copilot Studio에서 격리된 에이전트를 계속 확인할 수 있습니다. 제조사는 테스트 중에 에이전트와 상호 작용할 수 있지만, 격리된 에이전트와는 다른 어떤 채널을 통해서도 상호 작용할 수 없습니다.

중요

powervirtualgents 네임스페이스는 더 이상 사용되지 않습니다. API 호출에서 copilotstudio 네임스페이스를 사용하세요.

필수 구성 요소

  • 대상 에이전트에 대한 봇 ID 및 환경 ID가 있습니다.
  • Microsoft Entra ID OAuth2에서 발급한 사용자 액세스 토큰을 반드시 획득해야 합니다. 토큰을 얻으려면 Authentication을 참조하세요.
    • 토큰과 연관된 사용자는 다음 관리자 역할 중 하나를 가져야 합니다:
      • 글로벌 테넌트 관리자
      • AI 관리자
      • Power Platform 관리자
    • Power Platform API에서 CopilotStudio.AdminActions.Invoke 범위가 부여된 앱 등록의 클라이언트 ID를 사용하여 액세스 토큰을 획득해야 합니다.

에이전트 격리 관리를 위한 API 작업

Copilot Studio는 Power Platform API의 일부로 에이전트 격리를 관리하기 위한 세 가지 주요 REST API 작업을 지원합니다.

참고

SetAsQuarantined 및 SetAsUnquarantined API는 클래식 챗봇을 지원하지 않습니다. 클래식 챗봇을 격리하거나 격리 해제하려고 할 때 API는 405 Method Not Allowed를 반환합니다.

Power Platform API 사용 방법 및 시기에 대한 자세한 내용은 다음을 참조하세요.

에이전트 격리 상태 가져오기

  • 엔드포인트: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • 목적: 에이전트의 현재 격리 상태를 검색합니다.
  • 응답: 부울 isBotQuarantined 및 lastUpdateTimeUtc를 반환합니다

자세한 내용은 Get Bot Quarantine Status API 참조 문서에서 확인하세요.

에이전트를 격리됨으로 설정

  • 엔드포인트: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • 목적: 에이전트를 격리됨으로 표시하여 가용성 및 상호 작용을 제한합니다
  • 응답: 격리 상태 업데이트를 확인합니다

자세한 내용은 Set Bot As Quarantined API 참조 문서에서 확인하세요.

에이전트를 격리 해제됨으로 설정

  • 엔드포인트: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • 목적: 위험 평가 및 수정 후 격리에서 에이전트를 제거합니다
  • 응답: 격리 상태 업데이트를 확인합니다

자세한 내용은 Set Bot As Unquarantined API 참조 문서에서 확인하세요.

  • Last updated on