Power Platform API를 사용하여 프로그래밍 방식으로 에이전트 삭제

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

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

예를 들어 감사, 런타임 보호 및 기타 관리자 보고서 또는 알림은 보안 및 인증에 대한 조직의 요구 사항을 위반하는 에이전트에 플래그를 지정할 수 있습니다. 관리자는 이 작업을 사용하여 delete 보안 및 규정 준수 문제를 조사하고 수정하는 동안 비규격 에이전트를 제거할 수 있습니다.

에이전트를 삭제하면 사용자 환경에서 에이전트를 제거합니다. 제작자와 이전 사용자는 더 이상 볼 수 없습니다.

Microsoft Entra 에이전트 ID 있는 에이전트를 삭제하면 연결된 에이전트 ID(또는 레거시 에이전트에 대한 앱 등록)도 Microsoft Entra ID 제거됩니다. 자세한 내용은 자체로 Microsoft Entra 에이전트 ID 만들기 참조하세요.

필수 조건

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

에이전트 삭제를 위한 API 작업

Copilot Studio Power Platform API의 일부로 에이전트를 제거하기 위한 REST API delete 작업을 지원합니다.

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

• Power Platform API 및 SDK: UX 우선에서 API 우선으로(블로그)(Power Platform 개발자 블로그)
• 프로그래밍 가능성 및 확장성 개요(Power Platform 설명서)
• Power Platform API 시작하기(Power Platform 관련 설명서)
• 파워 플랫폼 API 운영 참고 문서

에이전트 삭제

• 엔드포인트:DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
• 목적: 에이전트를 영구 삭제하기
• 응답: 에이전트가 성공적으로 삭제되면 반환 204 OK

Delete Copilot 에이전트 API 참조 문서에서 자세히 알아보세요.