Descrição geral da API de Gestão de Pacotes de Agentes e aplicações (pré-visualização)

Um pacote representa um agente ou uma aplicação do Microsoft 365 no catálogo da organização. A API de Gestão de Pacotes permite que os administradores de TI vejam e giram aplicações e agentes no Microsoft 365. Esta API fornece pontos finais para listar todas as aplicações e agentes, obter informações detalhadas sobre uma aplicação ou agente individual, incluindo metadados e elementos detalhados.

Importante

O acesso à API de Gestão de Pacotes requer uma licença de Microsoft Agent 365.

Principais recursos

  • Obtenha um inventário de todos os agentes e aplicações na organização, filtrando opcionalmente por:
    • Anfitrião (Copilot, Outlook, Teams)
    • Hora da última atualização
    • Tipos de elementos contidos no pacote de aplicações (bots, agentes declarativos, etc.).
  • Obtenha mais metadados para uma aplicação ou agente específico.
  • Bloquear, desbloquear e reatribuir a propriedade dos pacotes.

Exemplos de cenários

  • O administrador da organização obtém o inventário de todos os agentes copilot e aplicações do Microsoft 365.
  • Administração analisa os detalhes do pacote, incluindo status de disponibilidade e implementação.
  • Administração analisa os detalhes do elemento do agente, incluindo o objeto de elemento declarativeAgent ou customEngineAgent.
  • Administração bloqueia um pacote para impedir a sua utilização em toda a organização.
  • Administração reatribui a propriedade do pacote quando um funcionário sai da organização.

Lista de API

Operação Método HTTP Descrição
Listar pacotes GET /copilot/admin/catalog/packages Obtenha todas as aplicações e agentes na organização.
Obter detalhes do pacote GET /copilot/admin/catalog/packages/{id} Obtenha metadados detalhados para uma aplicação ou agente específico.
Pacote de atualização PATCH /copilot/admin/catalog/packages/{id} Atualizar metadados do pacote.
Bloquear POST /copilot/admin/catalog/packages/{id}/block Bloquear um pacote para impedir a utilização.
Desbloquear POST /copilot/admin/catalog/packages/{id}/unblock Desbloqueie um pacote para permitir a respetiva utilização.
Reatribuir POST /copilot/admin/catalog/packages/{id}/reassign Reatribuir a propriedade de um pacote a um utilizador diferente.

Recursos