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 Gestão de Pacotes permite que os administradores de TI vejam e giram agentes na sua organização. Esta API fornece pontos finais para listar todos os agentes e obter informações detalhadas sobre um 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 dentro da organização, filtrando opcionalmente por:
- Anfitrião (Copilot, Outlook, Teams)
- Plataforma (Copilot Studio, Microsoft 365 Copilot Agent Builder)
- Hora da última atualização
- Tipos de elementos contidos no pacote de agente (bots, agentes declarativos e muito mais).
- Obter mais metadados para um 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.
- 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 todos os agentes na organização. |
| Obter detalhes do pacote | GET /copilot/admin/catalog/packages/{id} |
Obtenha metadados detalhados para um agente específico. |
| Atualizar pacote (pré-visualização) | PATCH /copilot/admin/catalog/packages/{id} |
Atualizar metadados do pacote. |
| Bloquear (pré-visualização) | POST /copilot/admin/catalog/packages/{id}/block |
Bloquear um pacote para impedir a utilização. |
| Desbloquear (pré-visualização) | POST /copilot/admin/catalog/packages/{id}/unblock |
Desbloqueie um pacote para permitir a respetiva utilização. |
| Reatribuir (pré-visualização) | POST /copilot/admin/catalog/packages/{id}/reassign |
Reatribuir a propriedade de um pacote a um utilizador diferente. |