Publicar agente no centro de administração do Microsoft

Use o comando a365 publish para empacotar seu agente e carregar o pacote no Centro de administração do Microsoft 365. Após a publicação, você pode criar instâncias de agente em sua organização e controlar o agente.

Pré-requisitos

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

Contas e permissões necessárias

  • Microsoft 365 tenant com uma das seguintes funções (necessária para a etapa de carregamento no Centro de Administração):

    • Administrador global

Ferramentas necessárias

Etapas necessárias de configuração

Antes de publicar, conclua estas etapas:

  1. Criar o blueprint do agente - Siga a etapa de configuração para criar o blueprint do seu agente.
  2. Agente de teste localmente – verifique se o agente funciona corretamente usando o Agents Playground (consulte agentes de teste localmente).
  3. Preparar arquivos de configuração – Verifique a365.config.json e a365.generated.config.json esteja atualizado.

Comando de Publicação

Execute o a365 publish comando:

a365 publish

Note

A execução a365 publish -h mostra todas as opções compatíveis com esse comando.

O que este comando faz:

  1. Atualizar manifesto – Atualiza manifest.json com a ID do blueprint do agente.
  2. Criar pacote - Empacotar manifest.json e ícones em manifest.zip.
  3. Instruções de impressão – exibe instruções passo a passo para carregar por meio do centro de administração do Microsoft 365.

Note

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

Enviar 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 Carregar agente personalizado.
  4. Carregue o arquivo manifest.zip da pasta manifest no seu projeto.

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

Verificar publicações bem-sucedidas

Use a lista de verificação a seguir para verificar se seu agente publicou com sucesso:

✅ 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 CLI

Você verá essas mensagens de saída quando o comando de publicação for bem-sucedido:

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

Se o comando falhar, examine as mensagens de erro e verifique se você concluiu a instalação do blueprint.

Possíveis erros:

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

Siga estes passos quando a publicação falhar.

Ficheiros de manifesto

Você pode testar os seguintes arquivos na manifest pasta usando o comando Test-Path 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

Note

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

Agente aparece no centro administrativo

Note

Depois de carregar, pode levar de 5 a 10 minutos para que seu agente apareça no centro de administração e no Teams. Esse atraso é normal.

Confirme se o agente está presente usando estas etapas:

  1. Vá para Centro de administração do Microsoft 365.
  2. Navegue até Agentes>Todos os agentes.
  3. Seu 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 de versão (por exemplo, 1.0.0)
Publisher Nome da sua organização
Disponibilidade Disponível/Todos os Usuários

Consulte também

Próximas etapas

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

Crie uma instância de agente

Solucionando problemas

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

Tip

O Guia de Solução de Problemas do Agente 365 contém recomendações de resoluçã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 desenvolvimento do Agente 365.

Falha no comando de publicação

Sintomas:

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

Causas raiz:

  • A configuração não está completa
  • Erros de validação manifesta
  • Permissões insuficientes

Solution:

  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 prompts.

Falha no upload no centro de administração

Sintomas:

  • Erro ao carregar 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
  • Inválido ou desatualizado manifest.zip

Solution:

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

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

  • Last updated on