Pular para o conteúdo

Jogo de Dungeons de IA Agêntica

Neste tutorial você construirá um jogo de aventura em masmorra com IA agentica. Este tutorial não assume 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 totalmente dará a você um conhecimento profundo deste pacote e uma noçã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 bases de código
  • Construir APIs com tRPC
  • Desenvolver Agentes usando Strands
  • Criar servidores MCP em TypeScript
  • Usar Tanstack router para criar páginas
  • Utilizar Tanstack query para chamar APIs backend
  • Criar e implantar infraestrutura CDK

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

Veja como ficará o resultado final:

game-select.png
game-conversation.png

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

dungeon-game-architecture.png
  • Website frontend React/Vite utilizando:
    • Amazon Cognito/Identity Pools para chamadas API seguras
    • Tanstack router com roteamento baseado em arquivos e type-safety
    • SDKs gerados para comunicação com a Game API
  • API tRPC usando ElectroDB/DynamoDB para gerenciar estado do jogo
  • Agente Strands hospedado no Amazon Bedrock AgentCore para execução do jogo
  • Servidor MCP TypeScript no Amazon Bedrock AgentCore para gerenciar inventário do jogador
  • Infraestrutura CDK para implantação da aplicação

São necessários os seguintes requisitos globais:

  • Git
  • Node >= 22 (Recomendamos usar algo como NVM para gerenciar suas versões do Node)
    • verifique executando node --version
  • PNPM >= 10 (você 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 o Python 3.12 executando: uv python install 3.12.0
    2. verifique com uv python list --only-installed
  • AWS Credentials configuradas para sua conta AWS de destino (onde sua aplicação será implantada)
  • Docker para construção dos componentes AgentCore
  • Garanta que sua conta AWS tenha acesso ao modelo padrão do Strands no Bedrock para sua região-alvo seguindo este guia. Atualmente este modelo é o Anthropic Claude Sonnet 4.