Jogo de Dungeons com IA
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?
Neste tutorial, você construirá um jogo de aventura em masmorra com IA usando @aws/nx-plugin
.
Veja como ficará ao final:


Componentes da aplicação
O jogo será construído usando a seguinte arquitetura de componentes:

- 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
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
- verifique executando
- PNPM >= 10 (também pode usar Yarn >= 4, Bun >= 1 ou NPM >= 10 se preferir)
- verifique executando
pnpm --version
,yarn --version
,bun --version
ounpm --version
- verifique executando
- UV >= 0.5.29
- instale Python 3.12 executando:
uv python install 3.12.0
- verifique com
uv python list --only-installed
- instale Python 3.12 executando:
- Credenciais da AWS configuradas para a sua conta AWS de destino (onde sua aplicação será implantada)
- 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.