Vue d’ensemble de l’API gestion des packages Agent 365

Un package représente un agent dans le catalogue organization. L’API Gestion des packages permet aux administrateurs informatiques d’afficher et de gérer les agents dans votre organization. Cette API fournit des points de terminaison pour répertorier tous les agents et récupérer des informations détaillées sur un agent individuel, y compris les métadonnées et les é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 dans le organization, en filtrant éventuellement par :
    • Hôte (Copilot, Outlook, Teams)
    • Plateforme (Copilot Studio, Microsoft 365 Copilot Agent Builder)
    • Heure de la dernière mise à jour
    • Types d’éléments contenus dans le package d’agent (bots, agents déclaratifs, etc.).
  • Récupérez davantage de métadonnées pour 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.
  • 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 tous les agents dans le organization.
Obtenir les détails du package GET /copilot/admin/catalog/packages/{id} Obtenir des métadonnées détaillées pour un agent spécifique.
Package de mise à jour (préversion) PATCH /copilot/admin/catalog/packages/{id} Mettre à jour les métadonnées du package.
Bloquer (préversion) POST /copilot/admin/catalog/packages/{id}/block Bloquer un package pour empêcher son utilisation.
Débloquer (préversion) POST /copilot/admin/catalog/packages/{id}/unblock Débloquez un package pour autoriser son utilisation.
Réaffecter (préversion) POST /copilot/admin/catalog/packages/{id}/reassign Réaffecter la propriété d’un package à un autre utilisateur.

Ressources