Удаляйте агенты программно, используя API Power Platform

Copilot Studio предоставляет администраторам надежные инструменты для управления безопасностью и соответствием агентов, включая возможность удалять агентов через API Power Platform API.

Удаление агентов является частью более широкой системы безопасности Copilot Studio и работает в тандеме с вашим общим подходом к безопасности в Copilot Studio.

Например, аудиты, защита во время выполнения и другие административные отчёты или уведомления могут отмечать агенты, нарушающие требования организации по безопасности и аутентификации. Администраторы могут использовать delete эту операцию для удаления несоответствующих агентов, одновременно расследуя и устраняя вопросы безопасности и соответствия.

Когда вы удаляете агентов, вы удаляете их из своей среды. Создатели и бывшие пользователи больше не могут их видеть.

Когда вы удаляете агент с Microsoft Entra Agent ID, связанный с ним ID агента (или регистрация приложений для устаревших агентов) также удаляется из Microsoft Entra ID. Для получения дополнительной информации см. Автоматически создание Microsoft Entra идентификаторов агентов.

Необходимые условия

• У вас есть идентификатор бота и идентификатор среды для целевого агента.
• Вы должны получить пользовательский токен доступа, выпущенный Microsoft Entra ID OAuth2. Чтобы получить токен, см. раздел «Аутентификация».
  • Пользователь, связанный с токеном, должен выполнять одну из следующих администраторских ролей:
    • Глобальный администратор клиента
    • Администратор ИИ
    • Администратор Power Platform
  • Вы должны получить токен доступа, используя идентификатор клиента регистрации приложения, у которого предоставлен область действия CopilotStudio.AdminActions.Invoke в API Power Platform.

Операции API для удаления агентов

Copilot Studio, как часть API Power Platform, поддерживает операцию REST API delete для удаления агентов.

Для получения дополнительной информации о том, как и когда использовать API Power Platform, см.:

• API и SDK Power Platform: от UX-first к API-первую (блог) (Power Platform Developer Blog)
• Обзор программируемости и расширяемости (документация Power Platform)
• Начните работу с Power Platform API (документация Power Platform)
• Справочная документация по операциям API Power Platform

Удаление агента

• Конечная точка:DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
• Цель: Навсегда удалить агента
• Ответ: Возвращается 204 OK , если агент был успешно удален

Узнайте больше в документации Delete Copilot Agent API.