Compartilhar via

Publicar agente no Microsoft admin center

Importante

Você precisa fazer parte do programa de prévia Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA da Microsoft. As versões preliminares da Frontier estão sujeitas aos termos de versão preliminar existentes dos contratos de cliente. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

Use o a365 publish comando para empacotar seu agente e, em seguida, carregue 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

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

    • Administrador global
    • Administrador de ID de Agente

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

Observação

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ções manifest.json com a ID do 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 carregar por meio do Centro de administração do Microsoft 365

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

Observação

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

Agente aparece no centro administrativo

Observação

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 Microsoft 365 centro de administração.
  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)
Publicador 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

Resoluçã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 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.

    a365 config display -g
# Check for: 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 administrador global ou administrador de ID do agente.
  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