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 a 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
- Recuperar un inventario de todos los agentes de la organización, filtrando opcionalmente por:
- Host (Copilot, Outlook, Teams)
- Plataforma (Copilot Studio, Microsoft 365 Copilot Agent Builder)
- Hora de última actualización
- Tipos de elementos incluidos en el paquete de agentes (bots, agentes declarativos, etc.).
- Estado o tipo de solicitud para revisar los agentes que solicitaron los usuarios de la organización.
- Recuperar 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.
- El Administración revisa los detalles del paquete, incluida la disponibilidad y el estado de implementación.
- El Administrador revisa los agentes que los usuarios solicitaron para que puedan evaluar la demanda pendiente.
- El Administración revisa los detalles del elemento agente, incluido el objeto declarativeAgent o el objeto del elemento customEngineAgent.
- El Administrador bloquea un paquete para impedir su uso en toda la organización.
- El Administración reasigna la propiedad del paquete cuando un empleado deja la organización.
Lista de API
| Operación | Método HTTP | Description |
|---|---|---|
| Enumerar paquetes | GET /copilot/admin/catalog/packages |
Obtener todos los agentes de la organización. |
| Obtener los detalles del paquete | GET /copilot/admin/catalog/packages/{id} |
Obtenga metadatos detallados de un agente específico. |
| Paquete de actualización (versión preliminar) | PATCH /copilot/admin/catalog/packages/{id} |
Actualizar metadatos del paquete. |
| Bloque (versión preliminar) | POST /copilot/admin/catalog/packages/{id}/block |
Bloquear un paquete para impedir su uso. |
| Desbloquear (versión preliminar) | POST /copilot/admin/catalog/packages/{id}/unblock |
Desbloquear un paquete para permitir su uso. |
| Reasignar (versión preliminar) | POST /copilot/admin/catalog/packages/{id}/reassign |
Reasignar la propiedad de un paquete a un usuario diferente. |
| Enumerar solicitudes de agente | GET /copilot/admin/catalog/packages |
Obtener todas las solicitudes de agentes activos de la organización. |
| Obtener detalles de la solicitud de agente | GET /copilot/admin/catalog/packages/{id} |
Obtenga metadatos detallados para una solicitud de agente específica. |