Pular para o conteúdo

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:

game-select.png
game-conversation.png

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

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 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.