Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Un paquete representa un agente en el catálogo de la organización. La API de administración de paquetes permite a los administradores de TI ver y administrar agentes en toda la organización. Esta API proporciona puntos de conexión para enumerar todos los agentes y recuperar información detallada sobre un agente individual, incluidos metadatos y elementos detallados.
Importante
El acceso a la API de administración de paquetes requiere una licencia de Microsoft Agent 365.
Principales funcionalidades
- Recupere un inventario de todos los agentes de la organización y, opcionalmente, filtre por:
- Host (Copilot, Outlook, Teams)
- Plataforma (Copilot Studio, generador de agentes de Microsoft 365 Copilot)
- Hora de la última actualización
- Tipos de elementos incluidos en el paquete de agente (bots, agentes declarativos, etc.).
- Recupere más metadatos para un agente específico.
- Bloquear, desbloquear y reasignar la propiedad de los paquetes.
Escenarios de ejemplo
- El administrador de la organización recupera el inventario de todos los agentes.
- Administración revisa los detalles del paquete, incluida la disponibilidad y el estado de implementación.
- Administración revisa los detalles del elemento del agente, incluidos los objetos de elemento declarativeAgent o customEngineAgent.
- Administración bloquea un paquete para evitar su uso en toda la organización.
- Administración reasigna la propiedad del paquete cuando un empleado deja la organización.
Lista de API
| Operación | Http (método) | Descripción |
|---|---|---|
| Enumerar paquetes | GET /copilot/admin/catalog/packages |
Obtenga todos los agentes de la organización. |
| Obtener detalles del paquete | GET /copilot/admin/catalog/packages/{id} |
Obtenga metadatos detallados para un agente específico. |
| Paquete de actualización (versión preliminar) | PATCH /copilot/admin/catalog/packages/{id} |
Actualice los metadatos del paquete. |
| Bloquear (versión preliminar) | POST /copilot/admin/catalog/packages/{id}/block |
Bloquee un paquete para evitar su uso. |
| Desbloquear (versión preliminar) | POST /copilot/admin/catalog/packages/{id}/unblock |
Desbloquee un paquete para permitir su uso. |
| Reasignación (versión preliminar) | POST /copilot/admin/catalog/packages/{id}/reassign |
Reasignar la propiedad de un paquete a otro usuario. |