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

Jogo de Dungeons de IA Agêntica

Visão Geral

Seção intitulada “Visão Geral”

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

O que você vai construir?

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

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

Componentes da aplicação

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

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

Pré-requisitos

Seção intitulada “Pré-requisitos”

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.