ADEX-GPT README
O ADEX-GPT é uma extensão avançada para Visual Studio Code desenvolvida para acelerar, automatizar e padronizar processos de GenAI, migração de código, engenharia de dados e desenvolvimento assistido dentro do ecossistema da Claro.
Baseado em práticas modernas de DevEx, engenharia de software, multi-agentes e integração nativa com Azure OpenAI, o ADEX-GPT reúne Chat corporativo inteligente, assistente de migração PL/SQL → PySpark, validação automática, scaffolding de projetos, otimização de código, e geração de documentação técnica, tudo em uma interface consistente, confiável e pensada para ambiente empresarial.
Features
- Interface dedicada com histórico de sessões
- Suporte a prompts técnicos, revisão de código, troubleshooting e análise contextual
- Leitura de arquivos anexados pelo usuário diretamente no chat
- Suporte a arquivos
.py, .sql, .json, .txt, .log, .sas (dependendo da configuração local)
- Utiliza API corporativa (endpoint + deploymentName + apiKey)
🔹 Migração Inteligente PL/SQL → PySpark
- Comando dedicado para migrar código selecionado no editor
- Pipeline multiagente: Parser → Mapper → Optimizer → Generator → Validator
- Geração de código em PySpark altamente legível
- Ajuste automático de estrutura, funções, joins e regras de compatibilidade
- Suporte a documentação automática opcional
- Painel visual (Migration Panel) com preview e ações guiadas
🔹 Validação Automática
- Analisa sintaxe, padrões e funções críticas
- Detecta inconsistências no código migrado
- Sugere correções e melhorias
- Compatível com o fluxo de otimização
🔹 Scaffolding de Projetos
- Criação de um projeto-base ADEX-GPT
- Gera pastas padrão, templates e configurações
- Ideal para times de dados e migração estruturarem rapidamente novos repositórios
🔹 Gerenciamento de Artefatos
- Configuração global
adex-gpt.outputDir
- Todos os arquivos gerados são armazenados em uma pasta padrão no workspace
- Sistema automático de backup quando sobrescrevendo arquivos existentes
- Painéis em WebView para chat e migração
- Ações disponíveis no Command Palette
- Keybindings otimizados (
Ctrl + Alt + M para migração rápida)
- Ícones claros e padronizados no estilo VS Code
Requirements
Para utilizar a extensão, os seguintes requisitos são recomendados:
- VS Code 1.93.0 ou superior
- Permissões para leitura/escrita no workspace
Extension Settings
A extensão adiciona várias configurações poderosas via contributes.configuration.
Essas configurações permitem personalizar o comportamento de migração, chat e logs.
A extensão contribui com as seguintes configurações:
Configurações de Azure OpenAI
adex-gpt.azureOpenAI.apiKey – Chave privada da APIadex-gpt.azureOpenAI.endpoint – Endpoint corporativoadex-gpt.azureOpenAI.deploymentName – Nome do deployment (ex.: gpt-4o)adex-gpt.azureOpenAI.apiVersion – Versão da API
Funcionalidades
adex-gpt.features.enableOptimization – Otimização automática PySparkadex-gpt.features.autoValidation – Validação após migraçãoadex-gpt.features.generateDocumentation – Criação de documentaçãoadex-gpt.features.experimentalFeatures – Ativa recursos experimentais
Logs e Diretórios
adex-gpt.logging.level – Nível de log (error, warn, info, debug)adex-gpt.outputDir – Pasta para salvar artefatosadex-gpt.backupOnOverwrite – Backup automático
Known Issues
Alguns pontos que os usuários devem estar cientes:
- Recursos experimentais podem gerar comportamentos instáveis
- Análise de anexos muito grandes pode falhar dependendo da capacidade local
- Caso a instalação de dependências falhe, reabra o VS Code ou reinstale a extensão
Ter uma seção transparente reduz abertura de issues duplicadas e melhora o suporte interno.
Release Notes
1.0.0
- Release inicial da extensão
- Chat com Azure OpenAI
- Migração PL/SQL → PySpark
- Validação automática
- Painel interativo de migração
- Entradas de API Key e diretório de saída
- Scaffold de novos projetos
Following extension guidelines
Para garantir qualidade e consistência, a extensão segue as diretrizes oficiais de extensões VS Code:
Working with Markdown
Você pode editar este README usando o Visual Studio Code. Algumas teclas úteis:
- Dividir editor:
Ctrl + \
- Toggle Preview:
Ctrl + Shift + V
- Sugestões de Markdown:
Ctrl + Space
Enjoy!
