Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Este tutorial mostra-te como usar o Microsoft Dev Box Model Context Protocol (MCP) Server para gerir as tuas dev boxes através de agentes de IA. Aprendes a realizar operações comuns de dev box usando comandos em linguagem natural em vez de navegar por múltiplas interfaces.
Neste tutorial, você:
- Liga-te aos teus recursos da Dev Box através de um agente de IA
- Lista e explora os teus projetos e dev boxes disponíveis
- Realizar operações básicas de dev box usando comandos conversacionais
- Verifique as suas operações concluídas com sucesso
Pré-requisitos
Antes de começar este tutorial, certifique-se de:
| Requisito | Detalhes |
|---|---|
| Dev Box MCP Server instalado | Siga os passos de instalação no repositório Dev Box MCP Server |
| Recursos da Dev Box | - Pelo menos um projeto Dev Box com um pool configurado - Caixas de desenvolvimento existentes para gerir (opcional mas recomendado) |
| Authentication | Iniciado sessão através do Azure CLI, Visual Studio Code ou Windows SSO |
| Permissões obrigatórias | Função de utilizador do Dev Box ou superior nos seus recursos do Dev Box |
Passo 1: Abra o seu agente de IA e teste a conectividade
Começa por abrir o teu agente de IA e testar a ligação aos recursos do teu Dev Box.
Abre o GitHub Copilot Chat no teu IDE (VS Code ou Visual Studio)
Teste a ligação ao servidor MCP introduzindo este prompt:
List my Dev Box projectsVerifique a resposta: Deverá ver uma lista de projetos a que tem acesso. Se aparecer um erro, verifique se está autenticado via Azure CLI (
az login) ou Windows SSO.
Resultado esperado: Uma lista que mostra os nomes dos seus projetos, descrições e grupos de recursos.
Passo 2: Explore o seu ambiente Dev Box
Agora que confirmaste a conectividade, explora os recursos do teu Dev Box para perceberes o teu ambiente.
Veja as suas dev boxes em todos os projetos:
Show me all my dev boxes
Obtenha detalhes sobre um projeto específico (substitua "SeuNomeDeProjeto" por um nome real do projeto):
Show me details about the YourProjectName project
Liste os pools de dev box disponíveis num projeto:
What dev box pools are available in the YourProjectName project?
Resultado esperado: Informação sobre as suas dev boxs, incluindo nomes, estado (Em Execução, Parado, etc.), projetos e configurações do pool.
Passo 3: Realizar operações básicas de dev box
Pratica tarefas comuns de gestão de dev boxes usando comandos em linguagem natural.
Verificar o estado da dev box
Verifique o estado de uma caixa de desenvolvimento específica:
What's the status of my DevBoxName dev box?
Obtenha informações detalhadas sobre uma "dev box":
Show me detailed information about DevBoxName including its configuration and current state
Ligar ou desligar uma caixa de desenvolvimento
Inicie uma caixa de desenvolvimento parada:
Start my DevBoxName dev box
Parar uma caixa de desenvolvimento em execução:
Stop my DevBoxName dev box
Observação
Iniciar e parar caixas de desenvolvimento são operações de longa duração que podem demorar vários minutos para serem concluídas.
Trabalho com horários
Consulte os horários de encerramento:
When is my DevBoxName dev box scheduled to shut down?
Adiar um encerramento programado:
Delay the shutdown of my DevBoxName dev box until 6 PM today
Passo 4: Verifique o seu trabalho
Confirme que as suas operações foram concluídas com sucesso, verificando os resultados.
Verifique o estado da operação para tarefas de longa duração:
What's the status of the operation I just started?
Verificar alterações no estado da dev box:
Show me the current status of DevBoxName
Confirmar alterações no horário:
Show me the updated schedule for DevBoxName
O que procurar:
- As operações devem mostrar o estado "Bem-sucedido" quando concluídas
- Os estados de energia da dev box devem refletir os teus comandos de início/parar
- As modificações do calendário devem ser visíveis na informação do calendário
Passo 5: Experimente cenários avançados (opcional)
Quando se sentir confortável com operações básicas, experimente estes cenários mais avançados:
Criar uma nova dev box
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
Progresso da personalização do monitor
What's the status of the customization running on my FeatureWork dev box?
Solução de problemas
Se encontrares problemas durante este tutorial:
Problemas de autenticação
- Verifique se está iniciado:
az account show - Verifique as suas permissões no portal Azure
- Tenta sair e voltar a entrar:
az logoutdepoisaz login
Erros de registo de ferramentas
- Prima
Ctrl+Shift+P(VS Code) ouCtrl+Shift+P(Visual Studio) - Executar MCP: Reiniciar ferramentas em cache
- Reinicie o seu IDE
Falhas operacionais
- Verifica se os nomes das caixas de desenvolvimento e dos projetos estão corretos
- Verifique se tem as permissões adequadas para a operação
- Algumas operações podem demorar tempo – verifique periodicamente o estado da operação
Limpar recursos (opcional)
Se criaste recursos de teste durante este tutorial:
Elimine as caixas de desenvolvimento de teste que já não precisa:
Delete the FeatureWork dev box from DevelopmentProject
Pare de usar dev boxes para poupar custos:
Stop all my running dev boxes
Próximos passos
Agora que completaste o tutorial, podes:
- Explorar toda a gama de operações apoiadas
- Integre os comandos do Dev Box MCP Server no seu fluxo diário de desenvolvimento
- Partilhe comandos de linguagem natural com a sua equipa para operações comuns