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

Jogo de Dungeons de IA Agêntica

Usando este tutorial, você construirá um jogo de aventura em masmorra com IA agentica usando @aws/nx-plugin. Este tutorial não assume conhecimento prévio do @aws/nx-plugin ou tecnologias relacionadas. As técnicas que você aprenderá neste tutorial ajudarão a:

  • Construir qualquer aplicação baseada no @aws/nx-plugin,
  • Fornecer um entendimento profundo do @aws/nx-plugin, e
  • Obter uma compreensão básica de como usar o framework NX.

Ao final do 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,
  • construir Agentes usando Strands,
  • construir servidores MCP em TypeScript,
  • usar Tanstack router para criar novas páginas,
  • usar Tanstack query para chamar APIs backend, e
  • 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 agentica usando @aws/nx-plugin.

A interface do jogo se parecerá com algo assim neste diagrama:

game-select.png
game-conversation.png

Arquitetura da aplicação

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

O jogo de aventura em masmorra com IA agentica é construído usando a seguinte arquitetura:

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

Pré-requisitos

Seção intitulada “Pré-requisitos”

Antes de prosseguir, você precisará das seguintes dependências 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 é necessário para construir os componentes AgentCore