Deploy agent to Azure

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.

Você criou seu agente e o testou localmente — agora é hora de trazê-lo à vida na nuvem. Essa etapa é opcional e pode ser pulada se você já tiver implantado seu agente em alguma nuvem (nem precisa ser Azure).

Este guia guia como implantar seu código de agente no Azure e publicá-lo no Microsoft Admin Center, onde ele se torna um ativo descobrível para sua organização.

Também existem recursos disponíveis para mostrar como você pode atualizar o endpoint de mensagens se, em vez do Azure, você já tiver implantado seu agente para outros provedores de nuvem como AWS ou GCP:

• Use código de agente implantado na AWS
• Use o código do agente implantado no GCP

Pré-requisitos

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

Permissões e acesso necessários

• Assinatura Azure com acesso para colaboradores.
• Código de agente trabalhando com um endpoint de mensagens válido e acessível. Por favor, certifique-se de ter testado isso localmente e verifique se o código do agente pode ser construído e executado.
• Complete a etapa do blueprint de configuração do agente para ter um blueprint válido do agente.
• Certifique-se de que os arquivos a365.config.jsonde configuração e a365.generated.config.json o arquivo de configuração no código (por exemplo, arquivo .env) estejam atualizados.

Ferramentas necessárias

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

Publicar no Azure

O a365 deploy comando implanta seu agente no Azure Web App criado durante a configuração. Isso faz o upload do seu código de agente para o Azure, tornando-o disponível para rodar na nuvem e lidar com quaisquer requisições agenticas para esse endpoint.

Implantar agentes

Este é o comando de implantação:

a365 deploy

Observação

a365 deploy -h mostra todas as opções para executar esse comando, incluindo subcomandos.

.NET

O comando deploy para agentes .NET:

• Detecta arquivos de projeto .NET (*.csproj, *.fsproj, ou *.vbproj)
• Restaura pacotes NuGet usando dotnet restore
• Publica aplicação usando dotnet publish com configuração de Release
• Cria manifesto Oryx com comando DLL de entrada (por exemplo, dotnet YourApp.dll)
• Configura o tempo de execução do Azure com base na versão .NET detectada (padrão: DOTNET|8.0)
• Implanta via zip com progresso em tempo real

Python

O comando deploy para agentes Python:

• Detecta estrutura de projeto em Python (pyproject.toml, requirements.txt, e *.py arquivos)
• Compila pacotes usando uv build if pyproject.toml exists
• Converte .env automaticamente para as Configurações do App Azure
• Detecção inteligente de inicialização: Encontra pontos de entrada do Agente 365.
• Configures Azure runtime to to PYTHON|3.11
• Implanta via zip com progresso em tempo real

Node.js

O comando de implantação para agentes Node.js:

• Detecta Node.js estrutura do projeto (package.json arquivo)
• Instala dependências usando npm ci (retorna se npm install necessário)
• Executa o script de build (npm run build) se definido em package.json
• Copia arquivos de aplicação: saída construída (dist/build) ou arquivos fonte
• Cópias node_modules para implantação no Azure
• Cria o manifesto do Oryx com o comando start de package.json (ou detecta o ponto de entrada)
• Configura o tempo de execução do Azure com base na versão detectada do Node (padrão: NODE|18)
• Implanta via zip com progresso em tempo real

Aviso

Gerenciamento de segredos: Quando você implanta, variáveis do ambiente (incluindo chaves de API e segredos) são armazenadas como Configurações de Apps do Azure. Embora variáveis de ambiente sejam comumente usadas para configuração, elas são armazenadas em texto simples. Para ambientes de produção, a Microsoft recomenda o uso do Azure Key Vault para segredos sensíveis. Para obter mais informações, confira Armazenamento seguro de segredos do aplicativo em desenvolvimento no ASP.NET Core. Trate esses arquivos como informações confidenciais e nunca os registre no controle do código-fonte.

Verificar a implantação

Após a conclusão da implantação:

1. Navegue até o seu aplicativo Web no portal do Azure.
2. No aplicativo, vá até Configurações>Configurações Avançadas.
3. Verifique os registros de implantação no Centro de Implantação

Próximas etapas

Em seguida, publique seu aplicativo de agente no Microsoft Admin Center para que instâncias de agentes e usuários possam ser criados a partir dele: Publicar o agente no Microsoft Admin Center

Seu agente agora está ao vivo na nuvem e pronto para responder a solicitações agentais. Enquanto seu agente lida com solicitações do mundo real, considere os próximos passos do seu código:

• Monitore o desempenho: Use recursos de observabilidade para acompanhar o comportamento dos agentes e otimizar respostas
• Adicione mais ferramentas: Explore o catálogo de ferramentas para expandir as capacidades do seu agente
• Itere e melhore: Atualize o código do seu agente, reimplante e republique (lembre-se de incrementar o número da versão!)
• Escale em toda a sua organização: Compartilhe histórias de sucesso do seu agente para impulsionar a adoção