Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Um pacote representa um agente no catálogo da organização. A API de gerenciamento de pacotes permite que os administradores de TI visualizem e gerenciem agentes em toda a sua organização. Essa API fornece endpoints para listar todos os agentes e recuperar informações detalhadas sobre um agente individual, incluindo metadados e elementos detalhados.
Importante
O acesso à API de Gerenciamento de Pacotes requer uma licença do Microsoft Agent 365.
Principais recursos
- Recupere um inventário de todos os agentes da organização, filtrando opcionalmente por:
- Host (Copilot, Outlook, Teams)
- (Copilot Studio, Construtor de Agentes do Microsoft 365 Copilot)
- Hora da última atualização
- Tipos de elementos contidos no pacote do agente (bots, agentes declarativos e muito mais).
- Recupere mais metadados para um agente específico.
- Bloqueie, desbloqueie e reatribua a propriedade dos pacotes.
Exemplos de cenários
- O administrador da organização recupera o inventário de todos os agentes.
- A Administração analisa os detalhes do pacote, incluindo a disponibilidade e o status da implantação.
- A Administração revisa os detalhes do elemento do agente, incluindo o objeto de elemento declarativeAgent ou customEngineAgent.
- O Administrador bloqueia um pacote para impedir seu uso em toda a organização.
- O Administrador atribui novamente a propriedade do pacote quando um funcionário deixa a organização.
Lista de APIs
| Operação | Método HTTP | Descrição |
|---|---|---|
| Listar pacotes | GET /copilot/admin/catalog/packages |
Obtenha todos os agentes da organização. |
| Obter detalhes do pacote | GET /copilot/admin/catalog/packages/{id} |
Obtenha metadados detalhados para um agente específico. |
| Pacote de atualização (versão prévia) | PATCH /copilot/admin/catalog/packages/{id} |
Atualizar metadados do pacote. |
| Bloquear (versão prévia) | POST /copilot/admin/catalog/packages/{id}/block |
Bloquear um pacote para impedir seu uso. |
| Desbloquear (versão prévia) | POST /copilot/admin/catalog/packages/{id}/unblock |
Desbloquear um pacote para permitir seu uso. |
| Reatribuir (versão prévia) | POST /copilot/admin/catalog/packages/{id}/reassign |
Reatribuir a propriedade de um pacote a um usuário diferente. |