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. Prévias da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

O a365 publish comando publica seu agente no centro de administração do Microsoft 365, tornando-o disponível para criar instâncias de agentes dentro da sua organização e também tornando o agente facilmente governável.

Pré-requisitos

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

Permissões e acesso necessários

• Uma conta de usuário do Microsoft Entra com uma das seguintes funções:
  • Administrador global
  • Administrador de ID de Agente
  • Desenvolvedor de ID de Agente
• Assinatura Azure com acesso para contribuidores ou proprietários

Ferramentas necessárias

• Azure CLI instalado e autenticado (Instalar Azure CLI)
• CLI A365 instalado (CLI do Agente 365)

Etapas necessárias de configuração

Antes de publicar, certifique-se de completar estes passos em ordem:

1. Blueprint do agente criado - Complete a etapa de configuração para criar o blueprint do agente.
2. Agente testado localmente - Verifique se seu agente funciona corretamente com o Agents Playground (veja Testar agentes localmente)
3. Arquivos de configuração prontos - Garantir a365.config.json e a365.generated.config.json estar atualizado

Comando Publish

Execute o comando a seguir:

a365 publish

Observação

Executar a365 publish -h mostra todas as opções e subcomandos que esse comando suporta.

O que este comando faz:

1. Extrai templates de manifestos de recursos incorporados (caso manifest a pasta não exista)
2. Manifesto de atualizações - Atualizações manifest.json com ID do blueprint do agente
3. Pausa de personalização - Permite personalizar versões, nomes, descrições e ícones
4. Cria pacote - Empacota seu pacote de aplicativo de agentes como manifest.zip
5. Envios para o centro de administração - Publica no centro de administração do Microsoft 365
6. Configura identidade - Cria identidade federada para integração com o Teams
7. Atribui permissões - Aplica as permissões necessárias do grafo

Saída esperada:

Você deve ver as mensagens de progresso para:

• Extração e atualizações de manifestos
• Prompt de personalização (pressione Enter após revisar)
• Criação de pacote
• Enviar para o centro de administração
• Identidade e configuração de permissões

Personalizar manifesto

A CLI pausa durante a publicação para permitir que você personalize seu manifesto de agente:

=== CUSTOMIZE YOUR AGENT MANIFEST ===

Your manifest has been updated at: [path]\manifest\manifest.json

When you're done customizing, type 'continue' (or 'c') and press Enter to proceed:

Passos manuais:

1. Abra manifest.json em um editor de texto.

2. Personalize os campos exigidos:

   • Atualize o número da versão. Incremente em relação ao anterior se for reupload.
   • Defina um nome significativo do agente. Os nomes devem ter igual ou menos que 30 caracteres.
   • Escrever descrições de PR
   • Informações do desenvolvedor
   • Opcionalmente, substituir arquivos de ícones

3. Atualizar o arquivo de manifesto

4. Volte para o CLI e digite continue ou c e pressione Enter.

Verificar a disponibilidade do agente

Se tudo correr como esperado, a CLI completa o processo de publicação e seu agente agora estará disponível no Microsoft 365 Admin Center.

Você pode ver seu agente publicado aqui: Microsoft 365 Admin Center - Agentes

Próximas etapas

Depois de publicar seu agente, crie uma instância para que ela possa ser configurada e usada no seu locatário.

Aprenda a criar uma instância de agente.