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

Use o comando a365 publish para empacotar seu agente e, em seguida, carregue o pacote no centro de administração do Microsoft 365. Depois de publicar o agente, você poderá criar instâncias de agente na sua organização e controlá-lo

Pré-requisitos

Antes de começar, verifique se você tem os seguinte itens:

Contas e permissões obrigatórias

  • Locatário do Microsoft 365 com uma das seguintes funções (necessárias para a etapa de upload para o centro de administração):

    • Administrador Global

Ferramentas necessárias

Etapas de configuração necessárias

Antes de publicar, conclua estas etapas:

  1. Crie o blueprint do agente – siga a etapa de configuração para criar o blueprint do seu agente.
  2. Teste o agente localmente – verifique o funcionamento correto do seu agente usando o Playground de Agentes (consulte Testar agentes localmente).
  3. Preparar os arquivos de configuração – certifique-se de que a365.config.json e a365.generated.config.json estejam atualizados.

Comando publish

Execute o comando a365 publish:

a365 publish

Observação

Executar a365 publish -h mostra todas as opções às quais este comando oferece suporte.

O que esse comando faz:

  1. Manifesto de atualização – Atualiza o manifest.json com a ID de blueprint do agente.
  2. Criar pacote – pacotes manifest.json e ícones em manifest.zip
  3. Instruções de impressão – exibe instruções passo a passo para upload pelo centro de administração do Microsoft 365.

Observação

O comando a365 publish funciona para agentes e para colegas de IA. Para agentes provisionados usando --agent-name (sem configuração), certifique-se de que a365.generated.config.json exista no seu diretório de trabalho antes de executar a365 publish, pois o comando lê a ID do blueprint desse arquivo.

Upload para o centro de administração

Após a conclusão de a365 publish, siga as instruções impressas para carregar seu agente:

  1. Acesse o Centro de administração do Microsoft 365.
  2. Navegue até Agentes>Todos os agentes.
  3. Selecione Upload de agente personalizado.
  4. Carregue o arquivo manifest.zip da pasta manifest no seu projeto.

Para obter mais informações, consulte Upload de agentes para o centro de administração do Microsoft 365.

Verificar o sucesso da publicação

Use a lista de verificação a seguir para verificar se o seu agente foi publicado com êxito:

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

Saída da CLI

As seguintes mensagens de saída aparecerão quando o comando publish for concluído com êxito:

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

Se houver falha no comando, revise as mensagens de erro e certifique-se de que concluiu a configuração do blueprint.

Possíveis erros:

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

Siga estas etapas quando houver falha na publicação:

Arquivos de manifesto

Você pode testar os arquivos a seguir na pasta manifest usando o comando Test-Path do PowerShell.

# 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

Observação

Se não vir esses arquivos, tente executar o comando a365 publish novamente.

O agente aparece no centro de administração

Observação

Após o upload, pode levar 5 a 10 minutos para o seu agente aparecer no centro de administração e no Teams. Esse atraso é normal.

Confirme que o agente esteja presente seguindo estas etapas:

  1. Acesse Centro de administração do Microsoft 365.
  2. Navegue até Agentes>Todos os agentes.
  3. O agente aparece na lista.

A tabela a seguir mostra quais detalhes você pode encontrar:

Campo O Que Verificar
Nome Nome do seu agente (de manifest.json)
Versão Número da versão (por exemplo, 1.0.0)
Editor O nome da sua organização
Disponibilidade Usuários disponíveis/Todos os usuários

Veja também

Próximas etapas

Depois de publicar seu agente, crie uma instância para que você possa configurá-la e usá-la no seu locatário.

Criar uma instância de agente

Solução de Problemas

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

Dica

O Guia de Solução de Problemas do Agent 365 contém recomendações de solução de problemas de alto nível, melhores práticas e links para conteúdo de solução de problemas para cada parte do ciclo de vida de desenvolvimento do Agent 365.

Falha no comando publish

Sintomas:

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

Causas raiz:

  • Configuração não concluída
  • Erros de validação do manifesto
  • Permissões insuficientes

Solução:

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

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

  2. Execute o comando publish e siga os prompts.

Falha do upload no centro de administração

Sintomas:

  • Erro ao fazer upload de manifest.zip no centro de administração do Microsoft 365
  • O agente não aparece após o upload

Causas raiz:

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

Solução:

  1. Verifique se você tem a função Administrador Global.
  2. Execute a365 publish novamente para gerar um novo manifest.zip.
  3. Tente fazer upload novamente seguindo as etapas de upload.

Para obter mais ajuda, consulte Upload de agentes para o centro de administração do Microsoft 365.

  • Last updated on