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

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

에이전트 격리는 Copilot Studio의 광범위한 보안 프레임워크의 일부이며, Copilot Studio의 전반적인 보안 접근법과 연계되어 작동합니다.

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

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

Important

네임스페이스는 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 작업을 지원합니다.

Note

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