Vue d’ensemble de l’API gestion des packages d’agent et d’application (préversion)

Un package représente un agent ou une application Microsoft 365 dans le catalogue organization. L’API Gestion des packages permet aux administrateurs informatiques d’afficher et de gérer les applications et les agents dans Microsoft 365. Cette API fournit des points de terminaison pour répertorier toutes les applications et tous les agents, récupérer des informations détaillées sur une application ou un agent individuel, notamment des métadonnées et des éléments détaillés.

Importante

L’accès à l’API De gestion des packages nécessite une licence Microsoft Agent 365.

Fonctionnalités clés

  • Récupérez un inventaire de tous les agents et applications dans le organization, en filtrant éventuellement par :
    • Hôte (Copilot, Outlook, Teams)
    • Heure de la dernière mise à jour
    • Types d’éléments contenus dans le package d’application (bots, agents déclaratifs, etc.).
  • Récupérez davantage de métadonnées pour une application ou un agent spécifique.
  • Bloquer, débloquer et réaffecter la propriété des packages.

Exemples de scénarios

  • L’administrateur de l’organisation récupère l’inventaire de tous les agents Copilot et des applications Microsoft 365.
  • Administration passe en revue les détails du package, notamment la disponibilité et les status de déploiement.
  • Administration examine les détails des éléments de l’agent, notamment l’objet d’élément declarativeAgent ou customEngineAgent.
  • Administration bloque un package pour empêcher son utilisation dans le organization.
  • Administration réaffecte la propriété du package lorsqu’un employé quitte le organization.

Liste des API

Opération HTTP, méthode Description
Répertorier les packages GET /copilot/admin/catalog/packages Obtenez toutes les applications et agents dans le organization.
Obtenir les détails du package GET /copilot/admin/catalog/packages/{id} Obtenez des métadonnées détaillées pour une application ou un agent spécifique.
Package de mise à jour PATCH /copilot/admin/catalog/packages/{id} Mettre à jour les métadonnées du package.
Bloquer POST /copilot/admin/catalog/packages/{id}/block Bloquer un package pour empêcher son utilisation.
Débloquer POST /copilot/admin/catalog/packages/{id}/unblock Débloquez un package pour autoriser son utilisation.
Réaffecter POST /copilot/admin/catalog/packages/{id}/reassign Réaffecter la propriété d’un package à un autre utilisateur.

Ressources