Pular para o conteúdo
@aws/nx-plugin
Blog

Jogo de Dungeons com IA

Visão Geral

Seção intitulada “Visão Geral”

Você construirá um jogo de aventura em masmorra com IA durante este tutorial. Este tutorial não assume nenhum conhecimento prévio do @aws/nx-plugin ou tecnologias relacionadas. As técnicas que você aprenderá são fundamentais para construir qualquer aplicação baseada no @aws/nx-plugin, e compreendê-las completamente lhe dará um conhecimento profundo do @aws/nx-plugin e uma compreensão básica de como usar NX.

Ao completar este tutorial, você terá conhecimento para:

  • Usar o @aws/nx-plugin para criar novas aplicações
  • Usar NX para gerenciar/construir sua base de código
  • Construir APIs usando tRPC e FastAPI
  • Usar Tanstack router para criar novas páginas
  • Usar Tanstack query para chamar APIs de backend
  • Fazer modificações no código gerado para adequá-lo a propósitos específicos
  • Criar e implantar infraestrutura CDK

O que você vai construir?

Seção intitulada “O que você vai construir?”

Neste tutorial, você construirá um jogo de aventura em masmorra com IA usando @aws/nx-plugin.

Veja como ficará ao final:

game-select.png
game-conversation.png

Componentes da aplicação

Seção intitulada “Componentes da aplicação”

O jogo será construído usando a seguinte arquitetura de componentes:

dungeon-game-architecture.png
  • API tRPC usando ElectroDB/DynamoDB para gerenciar o estado do jogo
  • Função Lambda Python/FastAPI com respostas em streaming para geração de história (alimentada por Amazon Bedrock)
  • Frontend React/Vite utilizando:
    • Amazon Cognito/Identity Pools para chamadas seguras de API
    • Tanstack router com roteamento baseado em arquivos e type-safety
    • SDKs gerados para consumir as APIs de Jogo e História (usando Tanstack query)
  • Infraestrutura CDK para implantação

Pré-requisitos

Seção intitulada “Pré-requisitos”

Os seguintes requisitos globais são necessários:

  • Git
  • Node >= 22 (Recomendamos usar algo como NVM para gerenciar versões do Node)
    • verifique executando node --version
  • PNPM >= 10 (também pode usar Yarn >= 4, Bun >= 1 ou NPM >= 10 se preferir)
    • verifique executando pnpm --version, yarn --version, bun --version ou npm --version
  • UV >= 0.5.29
    1. instale Python 3.12 executando: uv python install 3.12.0
    2. verifique com uv python list --only-installed
  • Credenciais AWS configuradas para sua conta AWS de destino (onde seu aplicativo será implantado)
  • Se estiver usando VSCode, recomendamos instalar o Nx Console VSCode Plugin.
  • Garanta que sua conta AWS tenha acesso ao modelo Anthropic Claude 3.5 Sonnet v2 no Bedrock para sua região alvo, seguindo os passos deste guia.