Publicar o agente no centro de administração da Microsoft

Utilize o comando a365 publish para empacotar o seu agente e, em seguida, carregue o pacote no centro de administração do Microsoft 365. Depois de publicar, pode criar instâncias de agente dentro da sua organização e gerir o agente.

Pré-requisitos

Antes de começar, certifique-se de que tem os seguintes itens.

Contas e permissões necessárias

  • Inquilino do Microsoft 365 com uma das seguintes funções (necessário para o passo de carregamento no Centro de Administração):

    • Administrador Global

Ferramentas necessárias

Passos de configuração necessários

Antes de publicar, conclua estes passos:

  1. Criar esquema de agente – Siga o passo de configuração para criar o esquema de agente.
  2. Testar o agente localmente – Verifique se o seu agente funciona corretamente utilizando o Ambiente de Demonstração de Agentes (consulte Testar agentes localmente).
  3. Preparar os ficheiros de configuração – Certifique-se de que a365.config.json e a365.generated.config.json estão atualizados.

Comando de publicação

Execute o comando a365 publish:

a365 publish

Nota

Ao executar a365 publish -h, são mostradas todas as opções que este comando suporta.

O que este comando faz:

  1. Atualizar o manifesto - Atualiza manifest.json com o ID do seu esquema de agente.
  2. Criar pacote - Empacota manifest.json e ícones em manifest.zip.
  3. Imprimir instruções - Apresenta instruções passo a passo para carregar através do centro de administração do Microsoft 365.

Nota

O comando a365 publish funciona tanto para agentes como para colegas de IA. Para agentes aprovisionados usando --agent-name (config-free), certifique-se de que a365.generated.config.json existe no seu diretório de trabalho antes de executar a365 publish, pois o comando lê o ID do esquema deste ficheiro.

Carregar no centro de administração

Depois de a365 publish terminar, siga as instruções apresentadas para carregar o seu agente:

  1. Aceda ao Centro de administração do Microsoft 365.
  2. Aceda a Agentes>Todos os agentes.
  3. Selecione Carregar agente personalizado.
  4. Carregue o ficheiro manifest.zip a partir da pasta manifest do seu projeto.

Para mais informações, consulte Carregar agentes no centro de administração do Microsoft 365.

Verificar a publicação bem-sucedida

Utilize a seguinte lista de verificação para verificar se o seu agente foi publicado com sucesso:

✅ A publicação da CLI é bem-sucedida
✅ manifest pasta criada com manifest.json e manifest.zip
✅ O agente é apresentado no centro de administração da Microsoft

Saída da CLI

Verá estas mensagens de saída quando o comando publish é bem-sucedido:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Instruções de carregamento passo a passo impressas

Se o comando falhar, reveja as mensagens de erro e certifique-se de que concluiu a configuração do esquema.

Possíveis erros:

Erro Passo para resolver
Agent blueprint ID not found Execute a365 setup para concluir a configuração do esquema.
Permissions missing Volte a executar a configuração com o comando a365 setup permissions.

Siga estes passos quando a publicação falhar.

Ficheiros de manifesto

Pode testar os seguintes ficheiros na pasta manifest utilizando o comando PowerShell Test-Path.

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

Nota

Se não conseguir ver estes ficheiros, experimente executar o comando a365 publish novamente.

O agente é apresentado no centro de administração

Nota

Depois de carregar, pode demorar 5-10 minutos até que o seu agente seja apresentado no centro de administração e no Teams. Este atraso é normal.

Verifique se o agente está presente seguindo estes passos:

  1. Vá para Centro de administração do Microsoft 365.
  2. Aceda a Agentes>Todos os agentes.
  3. O seu agente aparece na lista.

A tabela seguinte mostra os detalhes que pode encontrar:

Campo O Que Verificar
Nome Nome do seu agente (de manifest.json)
Versão Número de versão (por exemplo, 1.0.0)
Editor Introduzir o nome da sua organização
Disponibilidade Disponível/Todos os utilizadores

Consultar também

Passos seguintes

Depois de publicar o agente, crie uma instância para que possa configurá-lo e utilizá-lo no seu inquilino.

Criar uma instância de agente

Resolução de Problemas

Problemas comuns ao publicar agentes no centro de administração do Microsoft 365.

Sugestão

O Guia de Resolução de Problemas do Agent 365 inclui recomendações de resolução de problemas de alto nível, melhores práticas e ligações para conteúdo de resolução de problemas para cada parte do ciclo de vida de desenvolvimento do Agent 365.

O comando de publicação falha

Sintomas:

  • Erro durante a365 publish
  • manifest.zip não foi criado

Causas raiz:

  • A configuração não está concluída
  • Erros de validação do manifesto
  • Permissões insuficientes

Solução:

  1. Verifique se a configuração está concluída.

    Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

  2. Execute o comando publish e siga os pedidos.

Falha no carregamento no centro de administração

Sintomas:

  • Erro ao carregar manifest.zip no centro de administração do Microsoft 365
  • O agente não é apresentado após o carregamento

Causas raiz:

  • Permissões insuficientes no centro de administração
  • manifest.zip inválido ou desatualizado

Solução:

  1. Certifique-se de que tem a função de Administrador Global.
  2. Execute a365 publish novamente para gerar um novo manifest.zip.
  3. Tente carregar novamente seguindo os passos de carregamento.

Para mais ajuda, consulte Carregar agentes no centro de administração do Microsoft 365.

  • Last updated on