Общие сведения об API управления пакетами агентов и приложений (предварительная версия)

Пакет представляет агент или приложение Microsoft 365 в каталоге организации. API управления пакетами позволяет ИТ-администраторам просматривать приложения и агенты в Microsoft 365 и управлять ими. Этот API предоставляет конечные точки для вывода списка всех приложений и агентов, получения подробных сведений об отдельном приложении или агенте, включая метаданные и подробные элементы.

Важно!

Для доступа к API управления пакетами требуется лицензия Microsoft Agent 365.

Ключевые возможности

  • Получите список всех агентов и приложений в организации, при необходимости фильтруя по следующим параметрам:
    • Host (Copilot, Outlook, Teams)
    • Время последнего обновления
    • Типы элементов, содержащиеся в пакете приложения (боты, декларативные агенты и т. д.).
  • Получите дополнительные метаданные для определенного приложения или агента.
  • Блокировка, разблокировка и переназначение владения пакетами.

Примеры сценариев

  • Администратор организации получает список всех агентов Copilot и приложений Microsoft 365.
  • Администратор проверяет сведения о пакете, включая доступность и состояние развертывания.
  • Администратор проверяет сведения об элементах агента, включая объект элемента declarativeAgent или customEngineAgent.
  • Администратор блокирует пакет, чтобы предотвратить его использование в организации.
  • Администратор переназначает владение пакетом, когда сотрудник покидает организацию.

Список API

Operation Метод HTTP Описание
Вывод списка пакетов GET /copilot/admin/catalog/packages Получение всех приложений и агентов в организации.
Получение сведений о пакете GET /copilot/admin/catalog/packages/{id} Получение подробных метаданных для определенного приложения или агента.
Пакет обновления PATCH /copilot/admin/catalog/packages/{id} Обновление метаданных пакета.
Блокировка POST /copilot/admin/catalog/packages/{id}/block Блокировать пакет, чтобы предотвратить его использование.
Разблокировать POST /copilot/admin/catalog/packages/{id}/unblock Разблокируйте пакет, чтобы разрешить его использование.
Переназначить POST /copilot/admin/catalog/packages/{id}/reassign Переназначение владельца пакета другому пользователю.

Ресурсы