다음을 통해 공유

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

Copilot Studio는 관리자에게 에이전트 보안 및 규정 준수를 관리할 수 있는 강력한 도구를 제공하며, Power Platform API를 통해 에이전트에 대한 격리 조치를 포함합니다.

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

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

격리된 에이전트는 여전히 Copilot Studio의 에이전트 사용자 및 제작자에게 표시되지만 에이전트와 상호 작용하거나 사용할 수는 없습니다.

중요

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

필수 구성 요소

  • 대상 에이전트에 대한 봇 ID 및 환경 ID가 있습니다.
  • Microsoft Entra ID OAuth2에서 발급한 사용자 액세스 토큰을 가져와야 합니다. 토큰을 가져오려면 인증을 참조하세요.
    • 토큰과 연관된 사용자는 다음 관리자 역할 중 하나를 가져야 합니다:
      • 글로벌 테넌트 관리자
      • 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

더 알아보려면 Bot Quarantine Status API 참조 문서를 참고하세요.

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

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

Bot을 격리 상태로 설정하기 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