Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Un package représente un agent dans le catalogue de l’organisation. L’API de gestion des packages permet aux administrateurs informatiques d’afficher et de gérer les agents de votre organisation. 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 des métadonnées et des éléments détaillés.
Importante
L’accès à l’API Gestion des packages nécessite une licence Microsoft Agent 365.
Fonctionnalités clés
- Récupérez un inventaire de tous les agents au sein de l’organisation, en filtrant éventuellement par :
- Hôte (Copilot, Outlook, Teams)
- Plateforme (Copilot Studio, générateur d’agent Microsoft 365 Copilot)
- Dernière mise à jour
- Types d’éléments contenus dans le package d’agent (bots, agents déclaratifs, etc.).
- Request status or request type, pour passer en revue les agents que les utilisateurs de l’organization ont demandés.
- Récupérez plus de métadonnées pour un agent spécifique.
- Bloquer, débloquer et réattribuer 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, y compris la disponibilité et les status de déploiement.
- Administration passe en revue les agents demandés par les utilisateurs afin qu’ils puissent trier les demandes en attente.
- Administration examine les détails de l’élément agent, y compris l’objet d’élément declarativeAgent ou customEngineAgent.
- L’Administration bloque un package pour empêcher son utilisation au sein de l’organisation.
- L’Administration réattribue la propriété du package lorsqu’un employé quitte l’organisation.
Liste des API
| Opération | Méthode HTTP | Description |
|---|---|---|
| Liste des packages | GET /copilot/admin/catalog/packages |
Obtenez tous les agents de l’organisation. |
| Obtenir les détails du package | GET /copilot/admin/catalog/packages/{id} |
Obtenez les métadonnées détaillées d’un agent spécifique. |
| Package de mise à jour (préversion) | PATCH /copilot/admin/catalog/packages/{id} |
Métadonnées de package de mise à jour. |
| Bloc (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éattribuer la propriété d’un package à un autre utilisateur. |
| Répertorier les demandes d’agent | GET /copilot/admin/catalog/packages |
Obtenez toutes les demandes d’agent actives dans l’organisation. |
| Obtenir les détails de la demande d’agent | GET /copilot/admin/catalog/packages/{id} |
Obtenez des métadonnées détaillées pour une demande d’agent spécifique. |