Introducción a la API de administración de paquetes del agente y la aplicación (versión preliminar)

Un paquete representa un agente o una aplicación de Microsoft 365 en el catálogo de la organización. La API de administración de paquetes permite a los administradores de TI ver y administrar aplicaciones y agentes en Microsoft 365. Esta API proporciona puntos de conexión para enumerar todas las aplicaciones y agentes, recuperar información detallada sobre una aplicación o 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 y aplicaciones dentro de la organización, filtrando opcionalmente por:
    • Host (Copilot, Outlook, Teams)
    • Hora de la última actualización
    • Tipos de elementos incluidos en el paquete de la aplicación (bots, agentes declarativos, etc.).
  • Recupere más metadatos para una aplicación o 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 de Copilot y las aplicaciones de Microsoft 365.
  • 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 todas las aplicaciones y agentes de la organización.
Obtener detalles del paquete GET /copilot/admin/catalog/packages/{id} Obtenga metadatos detallados para una aplicación o agente específico.
Paquete de actualización PATCH /copilot/admin/catalog/packages/{id} Actualice los metadatos del paquete.
Bloquear POST /copilot/admin/catalog/packages/{id}/block Bloquee un paquete para evitar su uso.
Desbloquear POST /copilot/admin/catalog/packages/{id}/unblock Desbloquee un paquete para permitir su uso.
Reasignar POST /copilot/admin/catalog/packages/{id}/reassign Reasignar la propiedad de un paquete a otro usuario.

Recursos