Configuração guiada por IA para o Agent 365

O ciclo de vida do Agente 365 desenvolvimento envolve várias etapas: instalar a CLI, configurar pré-requisitos, criar um blueprint de agente, implantar código e publicar no centro de administração do Microsoft 365. Cada etapa tem seus próprios pré-requisitos, verificações de validação e pontos de decisão.

A instalação guiada por AI automatiza todo esse fluxo de trabalho usando um agente de codificação de IA (como GitHub Copilot no VS Code) para executar as etapas do ciclo de vida em seu nome. Em vez de navegar entre várias páginas de documentação e executar comandos manualmente, você fornece ao agente de IA um único arquivo de instruções que te guia pelo processo de forma interativa.

Benefícios

A configuração guiada por IA oferece várias vantagens em relação ao fluxo de trabalho manual:

• Ponto de entrada único — Um arquivo de instruções substitui a necessidade de navegar entre várias páginas de documentação. O agente de IA segue os passos em ordem e lida com as transições automaticamente.
• Validação automática de pré-requisitos — O agente de IA valida que o Azure CLI está instalado e autenticado, que o registro do aplicativo cliente personalizado possui as permissões corretas e o consentimento do administrador, e que as ferramentas de compilação específicas de linguagem estão disponíveis — tudo antes de executar qualquer comando CLI.
• ** Padrões inteligentes e detecção automática — o agente de IA consulta sua assinatura do Azure para grupos de recursos existentes, planos de Serviço de Aplicativos e informações do usuário e então utiliza esses valores como sugestões ao coletar entradas de configuração.
• Convenções de nomenclatura derivadas – você fornece um único nome base para o agente e o agente de IA deriva todos os nomes de recursos relacionados (identidade, blueprint, nome da entidade de usuário, aplicativo Web) usando padrões consistentes.
• Tratamento de erros em linha — Quando um comando falha, o agente de IA analisa o erro, sugere uma correção e tenta novamente — em vez de exigir que você procure na documentação de solução de problemas.
• Configuração não interativa — O agente de IA cria o a365.config.json arquivo diretamente e o importa, evitando problemas com assistentes interativos de CLI em ambientes automatizados.

Pré-requisitos

Antes de começar, verifique se de que tem os seguintes pré-requisitos:

Ferramentas necessárias

• Visual Studio Code com extensões GitHub Copilot e GitHub Copilot Chat instaladas. A configuração guiada por IA requer um agente de codificação de IA com acesso ao terminal.
• .NET 8.0 ou posterior — necessário para a CLI do Agente 365. Instalar .NET.
• Azure CLI — necessário para autenticação e gerenciamento de recursos. Instalar Azure CLI.

Contas e permissões necessárias

• Assinatura do Azure com acesso de Colaborador
• Microsoft Entra tenant com uma das seguintes funções:
  • Administrador global
  • Administrador de ID de Agente
  • Desenvolvedor de 'Agent ID'
• Registro personalizado do aplicativo cliente - A configuração guiada por IA valida esse registro do app, mas o app já deve existir no seu tenant com as permissões necessárias e consentimento do administrador. Para criar um, consulte o registro de aplicativo cliente personalizado.

Código do agente obrigatório

• Um projeto de agente de trabalho (Python, Node.jsou .NET) que você deseja implantar. Se você não tiver um, comece com um dos exemplos de início rápido.

Acesse o arquivo de instruções de configuração

A configuração guiada por IA usa um arquivo de instruções chamado a365-setup-instructions.md. O repositório Agent365-devTools inclui esse arquivo.

Se você clonou o repositório, o arquivo está em:

Agent365-devTools/docs/agent365-guided-setup/a365-setup-instructions.md

Se você não clonou o repositório, baixe o arquivo diretamente do GitHub.

Execute a configuração guiada por IA

Siga estes passos para iniciar a configuração guiada por IA no seu projeto de agente.

Passo 1: Abra seu projeto de agente no VS Code

Abra o diretório do projeto do agente no Visual Studio Code. Esse diretório contém seu código de agente (por exemplo, o diretório com seu package.json, *.csproj, ou pyproject.toml arquivo).

Etapa 2: Abrir GitHub Copilot Chat no modo de agente

Abra o painel GitHub Copilot Chat e alterne para o modo Agent. O modo de agente fornece GitHub Copilot a capacidade de executar comandos de terminal, ler arquivos e interagir com seu projeto – todos os recursos exigidos pela instalação orientada por IA.

Passo 3: Anexe o arquivo de instruções e comece

Na entrada Copilot Chat, anexe o arquivo a365-setup-instructions.md e envie-o com um prompt curto. Por exemplo:

Follow the steps in #file:a365-setup-instructions.md

O agente de IA lê o arquivo de instrução e inicia a configuração guiada. Ele cria uma lista de tarefas com cinco etapas e funciona por meio delas uma a uma:

1. Verifique e instale a CLI do Agente 365 - Verifica a linha de código, instala ou atualiza, e verifica se funciona.
2. Validar pré-requisitos - Confirma a autenticação do Azure CLI, valida o registro e as permissões do aplicativo cliente personalizado, e verifica se as ferramentas de compilação estão instaladas para o tipo de projeto.
3. Configurar a CLI do Agente 365 – pergunta se deseja uma implantação hospedada no Azure ou auto-hospedada, coleta valores de configuração, deriva nomes de recursos e cria o arquivo a365.config.json.
4. Provisionar recursos – executa a365 setup all para criar a infraestrutura do Azure e o blueprint do agente.
5. Publicar e implantar - Revisa o manifesto, publica o agente no Centro de Administração do Microsoft 365, implanta o código no Azure e fornece instruções pós-implantação.

Passo 4: Responda às solicitações

O agente IA pausa em pontos específicos para coletar informações suas:

• ID de aplicativo cliente personalizado — Seu ID de aplicação (cliente) para o registro personalizado do aplicativo cliente.
• Deployment type – Seja para criar um aplicativo Web Azure (Azure hospedado) ou usar um ponto de extremidade existente (auto-hospedado).
• Configuration values — Grupo de recursos, local, nome do agente, email do gerente e plano do Serviço de Aplicativo (para Azure hospedado) ou nome do agente e email do gerente (para auto-hospedado).
• Confirmação de valor derivado – examine os nomes gerados automaticamente para a identidade do agente, o projeto e o principal de usuário.
• Revisão do manifesto — Confirme que o seu manifest.json está atualizado com o nome, a descrição e as informações do desenvolvedor do seu agente.

Passo 5: Completar tarefas pós-implantação

Após o término dos comandos CLI, o agente de IA fornece instruções para etapas manuais que exigem interação com o navegador:

1. Configure o agente no Portal de Desenvolvedores do Teams — Defina o tipo de agente e o ID do bot.
2. Crie uma instância de agente — Solicite uma instância do Teams e peça para um administrador aprovar.
3. Teste o agente — Envie mensagens para seu agente no Teams para verificar se ele funciona.

Para instruções detalhadas sobre essas etapas pós-implantação, veja Criar instâncias de agente.

O que a configuração guiada por IA cobre

A configuração guiada por IA automatiza as seguintes etapas do ciclo de vida do desenvolvimento:

Resolução de problemas

Agente de IA não executa comandos de terminal

Se o agente de IA descreve comandos, mas não os executa, verifique se você está usando o modo Agent no chat GitHub Copilot. Os modos Perguntar e Editar não têm acesso ao terminal.

Agente de IA pula etapas de validação

O arquivo de instruções impõe uma ordenação rigorosa de passos. Se o agente de IA parecer pular uma etapa, lembre-o de seguir as instruções desde o início. Por exemplo:

Please start from Step 1 in the setup instructions and work through each step in order.

Comandos CLI falham com erros de permissão

Se a365 os comandos CLI falharem com erros de autorização, a causa mais comum é o registro de aplicativo personalizado ausente ou incompleto. O agente de Inteligência Artificial valida esse registro na Etapa 2, mas se você pulou essa validação, volte e execute. Para o guia completo de configuração, veja Registro personalizado de aplicativo cliente.

Valores de configuração estão errados

Se você precisar alterar valores de configuração após criar o arquivo a365.config.json, você pode:

• Edite o a365.config.json arquivo diretamente e execute novamente a365 config init -c ./a365.config.json
• Peça ao agente de IA para atualizar valores específicos

Próximas etapas