TutorialStefan VaskevichStefan Vaskevich

Criando um portfólio 3D interativo em estilo de jogo com agentes de IA

Um guia para usar ferramentas de programação com agentes para criar uma vitrine de personagens 3D de alto desempenho — de otimizadores GLB personalizados a uma interface em estilo de jogo em ~20 minutos.

O desenvolvimento web moderno está deixando a codificação manual para assumir um papel mais voltado à arquitetura, no qual desenvolvedores usam agentes de IA para cuidar dos detalhes de implementação de pipelines complexos. Este guia detalha um fluxo de trabalho completo para criar um site de portfólio 3D com visualizadores interativos de personagens, assets otimizados e uma estética inspirada em jogos.

Ao utilizar fluxos de trabalho agênticos, você pode ir de um projeto em branco a um site interativo pronto para produção em uma fração do tempo exigido pelos métodos tradicionais.

Vídeo de referência

Assista ao passo a passo completo deste pipeline no YouTube.

Abrir no YouTube

1. Configuração de ambiente e ferramentas

Para começar, você precisa configurar um ambiente de desenvolvimento centrado em um agente de IA para programação capaz de realizar planejamento de alto nível e execução de tarefas em paralelo.

1

Selecionando a plataforma de agentes

Para este pipeline, é usada a plataforma agêntica Verdent. Embora esteja disponível para VS Code e JetBrains, o aplicativo desktop é recomendado por sua interface simplificada, tornando-o acessível para quem foca na arquitetura geral em vez da sintaxe de baixo nível.

Experimente o Verdent
2

Seleção e integração de modelos

O motor principal deste fluxo de trabalho é o Claude 4.5 Opus. Este modelo é particularmente eficaz para aplicações web 3D devido à sua alta capacidade de raciocínio e eficiência na geração de estruturas de código complexas.

  • Conexão com o GitHub: Vincule sua conta do GitHub ao Verdent para permitir que o agente gerencie o controle de versão e a criação de branches automaticamente.
  • Gerenciamento de workspaces: Um dos recursos mais poderosos dessa configuração é a capacidade de executar múltiplos workspaces em paralelo. Isso permite desenvolver ferramentas auxiliares (como otimizadores de assets) em uma branch enquanto cria o portfólio principal em outra, evitando os conflitos de código comuns em editores de código com IA convencionais.
Interface desktop do Verdent mostrando Create New Project e a seleção de modelo
Interface desktop do Verdent mostrando o botão Create New Project e o menu suspenso de seleção de modelo definido como Claude 4.5 Opus.

2. Desenvolvendo um otimizador de assets 3D personalizado

Um portfólio 3D de alta qualidade depende de desempenho. Modelos 3D (arquivos GLB) costumam ser pesados, às vezes ultrapassando 50 MB, o que resulta em tempos de carregamento inaceitáveis na web. Antes de criar o site, você deve desenvolver uma ferramenta de otimização dedicada.

1

Criando o prompt da arquitetura da ferramenta

Abra um novo workspace e peça ao agente para criar uma aplicação web local em Next.js que utilize a biblioteca glTF-transform. O objetivo é uma interface simples de "arrastar e soltar" que automatize o seguinte:

  • Conversão de texturas para o formato WebP.
  • Otimização da malha para reduzir a contagem de vértices.
  • Redimensionamento de texturas para uma resolução máxima de 1k ou 2k.
2

Execução e testes

Execute o agente e deixe-o criar a estrutura de arquivos. Quando terminar, você pode iniciar o servidor local e soltar um modelo GLB pesado na interface.

Por que isso é importante

Uma otimização eficiente pode reduzir o tamanho de um modelo de 49 MB para cerca de 500 KB sem degradação visual significativa.

Melhor prática: Use texturas de 2k ou 4k quando precisar de alta fidelidade, mas garanta que o otimizador as comprima no build final para a web, para que o site continue responsivo em dispositivos móveis.

Interface do otimizador 3D mostrando o modelo antes e depois da compressão
A interface do otimizador 3D personalizado mostrando um modelo antes e depois da compressão com métricas de tamanho.

3. Projetando a arquitetura do portfólio

Com a ferramenta de otimização pronta, mude para um novo workspace para começar o projeto principal do portfólio.

1

Usando o modo de planejamento do agente

Em vez de ir direto para o código, mude o agente para o Plan Mode. Isso força o agente a analisar os requisitos, revisar sua própria lógica e apresentar um roadmap.

  • Revisando o diagrama: O agente vai gerar um diagrama técnico da arquitetura do site.
  • Reduzindo a complexidade: Agentes de IA costumam sugerir layouts de várias páginas por padrão. Para manter uma estética moderna de jogo, instrua o agente a reunir a experiência em uma única tela inicial de alto impacto e um visualizador principal.
2

Definindo as restrições de UI e UX

Comunique sua visão usando uma combinação de texto e imagens de referência. Uma estrutura de prompt altamente eficiente para este portfólio inclui:

  • Tela inicial: Uma landing page com uma miniatura e um botão "Enter Portfolio".
  • Layout do visualizador de personagens: Uma abordagem em tela dividida em que o personagem 3D ocupa 60% do lado esquerdo e um card de informações ocupa o lado direito.
  • Navegação: Botões para alternar entre os personagens (Left/Right) e um sistema que ajusta automaticamente o personagem à altura da tela.
  • Estilo visual: Um fundo preto puro, um piso em grade infinita que desaparece ao longe e partículas flutuantes, como brilhos ou pontos de luz que lembram estrelas, para dar profundidade.
Visualização do Planning Mode no Verdent com diagrama de arquitetura
A visualização do Planning Mode no Verdent mostrando o diagrama de arquitetura gerado e a estrutura de pastas proposta.

4. Refinando o ambiente 3D

Assim que o agente começar a construir, ele fará pausas para fazer perguntas de esclarecimento. Esse loop interativo é fundamental para alcançar a estética específica de "estilo de jogo".

1

Configurações de ambiente

Quando solicitado pelo agente, especifique as seguintes configurações:

  • Estilo da grade: Escolha uma grade infinita que desaparece gradualmente no fundo preto. Para manter a consistência da marca, você pode solicitar mais tarde que a cor da grade seja alterada (por exemplo, para laranja).
  • Estilo das partículas: Selecione "floating sparkles" para criar uma sensação sutil de movimento no fundo.
  • Interação do usuário: Desative a rotação automática. O personagem deve girar apenas com base na interação do usuário para proporcionar uma sensação mais tátil, de "menu de jogo".
2

Lidando com animações

Certifique-se de que seus modelos de personagem (GLB) incluam animações de corrida ou idle. O agente deve ser instruído a acionar essas animações automaticamente assim que o personagem carregar.


5. Integração de assets e correção automática de caminhos

Uma grande vantagem desse fluxo de trabalho com agentes é a capacidade do agente de escanear suas pastas locais e ajustar o código com base no que encontra.

1

Organização dos arquivos locais

Navegue até a pasta do projeto no explorador de arquivos e coloque seus assets da seguinte forma:

  • Modelos: Coloque os arquivos .glb otimizados no diretório public/models.
  • Imagens da UI: Coloque miniaturas ou fotos de perfil na pasta public/images.
2

Injeção dinâmica de dados

Forneça ao agente uma lista de dados dos seus personagens, incluindo: nomes e descrições, ferramentas usadas para criá-los e links para arquivos de origem ou conteúdo de vídeo externo. O agente não apenas preencherá as estruturas de dados, mas também corrigirá automaticamente os caminhos dos arquivos. Por exemplo, se você fornecer um .jpg, mas o código esperava um .png, o agente detectará o arquivo na sua pasta e atualizará o código de acordo, sem intervenção manual.

Explorador de arquivos com editor de código mostrando o agente atualizando caminhos
O explorador de arquivos lado a lado com o editor de código mostrando o agente atualizando os caminhos dos arquivos com base no conteúdo da pasta public.

6. Refinamento iterativo e feedback visual

A etapa final do pipeline envolve um "loop de feedback", no qual você usa capturas de tela para "reclamar" com o agente sobre inconsistências visuais.

1

Correção de proporções e layout

Carregue o projeto no seu navegador. Se o modelo 3D parecer muito pequeno ou o card de informações estiver desalinhado, tire uma captura de tela da janela do navegador.

O prompt com a captura de tela: Envie a captura de tela de volta para o agente e forneça críticas específicas. Por exemplo: "O card da direita está atualmente sobre um fundo preto; mova-o para que fique sobreposto ao viewer 3D. Além disso, faça o modelo ocupar toda a altura da tela e dê zoom normalmente."

2

Estilização avançada

Para fugir de um visual genérico, aplique uma identidade visual personalizada:

  • Branding: Peça um tema com "estilo laranja" para combinar com as cores específicas da marca.
  • Upgrades de componentes: Em vez de links de texto simples para vídeos externos, peça ao agente para criar "cards com miniaturas do YouTube" que ofereçam uma prévia visual do conteúdo.
Layout antes e depois, com UI de tema laranja
Mostrando a UI refinada em tema laranja com o card de informações sobreposto.

Resultado final

Ao seguir este pipeline, você passa de "programador" a um arquiteto. O resultado é um portfólio 3D interativo e de alto desempenho que inclui:

Otimizador 3D personalizado

Uma ferramenta dedicada para preparar assets prontos para a web.

Carrossel interativo de personagens

Transições suaves entre modelos 3D com animações ativas.

UI no estilo de jogo

Uma interface escura e elegante, com partículas flutuantes, grades infinitas e cards interativos com a identidade visual da marca.

Gerenciamento automatizado de dados

Um sistema que vincula seus assets 3D a metadados descritivos e links externos automaticamente.

Todo esse processo, desde a criação da ferramenta até o refinamento final, pode ser concluído em aproximadamente 20 minutos ao gerenciar com eficácia as fases de planejamento e execução do agente de IA.

A demo descrita neste guia está no ar no TOP 3D AI. Abra-a para ver o portfólio 3D no estilo de jogo em ação.

Abrir demo do portfólio 3D

Quer comparar essas ferramentas você mesmo?

Criando um portfólio 3D interativo em estilo de jogo com agentes de IA | Top 3D AI