Карантин несовместимых агентов с API Power Platform

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

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

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

Агенты, находящиеся на карантине, всё ещё видны пользователям и создателям агентов в Copilot Studio, но взаимодействовать с агентом или использовать их невозможно.

Это важно

Пространство powervirtualgents имён устарело. Используйте copilotstudio пространство имён в ваших API-вызовах.

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

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

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

Copilot Studio поддерживает три ключевых операции REST API для управления карантином агентов в рамках API Power Platform.

Замечание

API SetAsQuarantined и SetAsUnquarantined не поддерживают классические чат-боты. API возвращается 405 Method Not Allowed , когда вы пытаетесь изолировать или снять с карантина классический чат-бот.

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

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

Получите статус карантина агента

• Конечная точка: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.