Compartilhar via

Configuração guiada por IA para o Agent 365

Importante

Você precisa fazer parte do programa de versão preliminar do 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.

O ciclo de vida do desenvolvimento do Agent 365 envolve múltiplas etapas: instalar a CLI, configurar pré-requisitos, criar um blueprint do 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 configuração guiada por IA automatiza todo esse fluxo de trabalho usando um agente de codificação por IA (como o 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 a CLI do Azure está instalada e autenticada, que o registro do seu aplicativo cliente personalizado tem as permissões corretas com consentimento do administrador, e que ferramentas de build específicas da linguagem estão disponíveis – tudo isso antes de executar qualquer a365 comando CLI.
  • Padrões inteligentes e auto-detecção — O agente de IA consulta sua assinatura Azure para grupos de recursos existentes, planos de App Service e informações de usuário, e então usa esses valores como sugestões ao coletar entradas de configuração.
  • Convenções derivadas de nomenclatura — Você fornece um único nome base para seu agente, e o agente de IA deriva todos os nomes de recursos relacionados (identidade, blueprint, nome principal do 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 as 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. Instale o .NET.
  • Azure CLI — Necessário para autenticação e gerenciamento de recursos. Instalar a CLI do Azure.

Permissões e acesso necessários

Código do agente obrigatório

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 seu projeto de 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).

Passo 2: Abra o GitHub Copilot Chat no modo agente

Abra o painel do GitHub Copilot Chat e mude para o modo Agente . O modo agente dá ao GitHub Copilot a capacidade de executar comandos de terminal, ler arquivos e interagir com seu projeto – todas as capacidades exigidas pela configuração guiada por IA.

Importante

Você deve usar o modo Agente (não o modo Perguntar ou Editar). A configuração guiada por IA exige a capacidade de executar comandos de terminal e interagir com o ambiente.

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

No input do Copilot Chat, anexe o a365-setup-instructions.md arquivo e envie com um pequeno prompt. Por exemplo:

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

O agente de IA lê o arquivo de instruções e inicia a configuração guiada. Ele cria uma lista de tarefas com cinco etapas e as percorre sequencialmente:

  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 da CLI do Azure, valida o registro e permissões do seu aplicativo cliente personalizado, e verifica se as ferramentas de build estão instaladas para o tipo de projeto.
  3. Configure a CLI do Agente 365 - Pergunta se você quer uma implantação hospedada no Azure ou auto-hospedada, coleta valores de configuração, deriva nomes de recursos e cria o a365.config.json arquivo.
  4. Provisionar recursos - Executa a365 setup all para criar a infraestrutura 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 a prompts

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.
  • Tipo de implantação — Se deve criar um Azure Web App (hospedado no Azure) ou usar um endpoint existente (auto-hospedado).
  • Valores de configuração — Grupo de recursos, localização, nome do agente, e-mail do gerente e plano de Serviço de Aplicativos (para hospedagem no Azure) ou nome do agente e e-mail do gerente (para autohospedagem).
  • Confirmação de valor derivada — Revise os nomes gerados automaticamente para a identidade do agente, blueprint e principal de usuário.
  • Revisão do manifesto — Confirme que manifest.json você está atualizado com o nome, descrição e informações do desenvolvedor do seu agente.

Dica

O agente de IA mostra valores reais da sua assinatura do Azure como exemplos quando pede entradas de configuração. Você pode aceitar as sugestões ou apresentar seus próprios valores.

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:

Estágio do ciclo de vida O que o agente de IA faz Equivalente manual
Instalação de CLI Instala ou atualiza a CLI do Agent 365 Agente 365 CLI
Pré-requisitos Valida a CLI do Azure, aplicativo cliente personalizado, permissões e ferramentas de build Registro personalizado de aplicativo cliente
Configuração Cria a365.config.json com valores validados Configuração do Setup Agent 365
Configuração do blueprint Campanhas a365 setup all para criar infraestrutura e blueprint Projeto do agente de configuração
Implantação Execuções a365 deploy para construir e implantar código Deploy agent to Azure
Publishing Corre a365 publish para registrar o agente no centro administrativo Publicar agente no Microsoft admin center

Observação

A configuração guiada por IA não substitui a necessidade de construir seu código de agente primeiro. Você deve ter um projeto de agente funcional antes de começar a configuração guiada. Para novos projetos, comece com um quickstart.

Resolução de problemas

Agente de IA não executa comandos de terminal

Se o agente de IA descrever comandos, mas não executar, certifique-se de estar usando o modo Agente no GitHub Copilot Chat. 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 IA valida esse registro na Etapa 2, mas se você pulou essa validação, volte e rode. Para o guia completo de configuração, veja Registro personalizado de aplicativo cliente.

Valores de configuração estão errados

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

  • 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

Saiba mais sobre o ciclo de vida do desenvolvimento do Agent 365

Criar instâncias de agente

  • Last updated on