Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este tutorial mostra como usar o servidor MCP (Protocolo de Contexto do Modelo do Microsoft Dev Box) para gerenciar suas caixas de desenvolvimento por meio de agentes de IA. Você aprenderá a executar operações comuns de caixa de desenvolvimento usando comandos de linguagem natural em vez de navegar por várias interfaces.
Neste tutorial, você aprenderá a:
- Conectar-se aos recursos do Dev Box por meio de um agente de IA
- Listar e explorar seus projetos e caixas de desenvolvimento disponíveis
- Executar operações básicas de ambiente de desenvolvimento usando comandos conversacionais
- Verificar se suas operações foram concluídas com êxito
Pré-requisitos
Antes de começar este tutorial, verifique se você tem:
| Requirement | Detalhes |
|---|---|
| Servidor MCP do Dev Box instalado | Siga as etapas de instalação no repositório Dov Box MCP Server |
| Recursos do Dev Box | – Pelo menos um projeto do Dev Box com um pool configurado – Caixas de desenvolvimento existentes para gerenciar (opcional, mas recomendado) |
| Autenticação | Conectado por meio da CLI do Azure, do Visual Studio Code ou do SSO do Windows |
| Permissões necessárias | Função Usuário do Computador de Desenvolvimento ou superior em seus recursos do Computador de Desenvolvimento |
Etapa 1: Abrir o agente de IA e testar a conectividade
Comece abrindo o agente de IA e testando a conexão com os recursos do Dev Box.
Abra o GitHub Copilot Chat em seu IDE (VS Code ou Visual Studio)
Teste a conexão do SERVIDOR MCP inserindo este prompt:
List my Dev Box projectsVerifique a resposta: você deve ver uma lista de projetos aos quais tem acesso. Se você receber um erro, verifique se você está autenticado por meio da CLI do Azure (
az login) ou do SSO do Windows.
Saída esperada: uma lista mostrando os nomes, descrições e grupos de recursos do projeto.
Etapa 2: Explorar seu ambiente do Dev Box
Agora que você confirmou a conectividade, explore os recursos do Dev Box para entender seu ambiente.
Exiba suas caixas de desenvolvimento em todos os projetos:
Show me all my dev boxes
Obtenha detalhes sobre um projeto específico (substitua "YourProjectName" por um nome de projeto real):
Show me details about the YourProjectName project
Listar pools de computador de desenvolvimento em um projeto:
What dev box pools are available in the YourProjectName project?
Saída esperada: informações sobre suas caixas de desenvolvimento, incluindo seus nomes, status (Executando, Parado etc.), projetos e configurações de pool.
Etapa 3: executar operações básicas no ambiente de desenvolvimento
Pratique tarefas comuns de gerenciamento de caixa de desenvolvimento usando comandos de linguagem natural.
Verificar o status do computador de desenvolvimento
Verifique o status de uma caixa de desenvolvimento específica:
What's the status of my DevBoxName dev box?
Obtenha informações detalhadas sobre uma caixa de desenvolvimento:
Show me detailed information about DevBoxName including its configuration and current state
Iniciar ou encerrar um ambiente de desenvolvimento
Inicie uma caixa de desenvolvimento parada:
Start my DevBoxName dev box
Interrompa uma ambiente de desenvolvimento em execução:
Stop my DevBoxName dev box
Observação
Iniciar e parar ambientes de desenvolvimento são operações demoradas que podem levar vários minutos para serem realizadas.
Trabalhar com agendas
Verifique os agendamentos de desligamento:
When is my DevBoxName dev box scheduled to shut down?
Atrasar um desligamento agendado:
Delay the shutdown of my DevBoxName dev box until 6 PM today
Etapa 4: Verificar seu trabalho
Confirme se suas operações foram concluídas com êxito verificando os resultados.
Verifique o status da operação para tarefas de execução prolongada:
What's the status of the operation I just started?
Verifique as alterações de estado da caixa de desenvolvimento:
Show me the current status of DevBoxName
Confirme as alterações de agendamento:
Show me the updated schedule for DevBoxName
O que procurar:
- As operações devem mostrar o status "Bem-sucedido" quando concluídas
- Os estados de energia da caixa de desenvolvimento devem refletir seus comandos de início/parada
- As modificações de agendamento devem estar visíveis nas informações de agendamento
Etapa 5: Experimentar cenários avançados (opcional)
Depois de se sentir confortável com operações básicas, experimente estes cenários mais avançados:
Criar uma nova caixa de desenvolvimento
Create a new dev box called "FeatureWork" in the DevelopmentProject using the StandardPool
Aplicar personalizações
What customization tasks are available for my project?
Install the development tools customization on my FeatureWork dev box
Monitorar o progresso da personalização
What's the status of the customization running on my FeatureWork dev box?
Resolução de problemas
Se você encontrar problemas durante este tutorial:
Problemas de autenticação
- Verifique se você está conectado:
az account show - Verificar suas permissões no portal do Azure
- Tente sair e entrar novamente em:
az logoutentãoaz login
Erros de registro de ferramenta
- Pressione
Ctrl+Shift+P(VS Code) ouCtrl+Shift+P(Visual Studio) - Executar MCP: Redefinir ferramentas armazenadas em cache
- Reiniciar o IDE
Falhas de operação
- Verifique se os nomes das caixas de desenvolvimento e os nomes do projeto estão corretos
- Verifique se você tem permissões apropriadas para a operação
- Algumas operações podem levar tempo – verificar o status da operação periodicamente
Limpar recursos (opcional)
Se você criou recursos de teste durante este tutorial:
Exclua as caixas de desenvolvimento de teste que você não precisa mais:
Delete the FeatureWork dev box from DevelopmentProject
Pare de executar computadores de desenvolvimento para economizar custos:
Stop all my running dev boxes
Próximas etapas
Agora que você concluiu o tutorial, você pode:
- Explorar toda a gama de operações com suporte
- Integrar comandos do Servidor MCP do Dev Box ao fluxo de trabalho de desenvolvimento diário
- Compartilhar comandos de linguagem natural com sua equipe para operações comuns