Inteligência Artificial

Agentes Geradores: Revolucionando a Simulação de Comportamento Humano com IA

Mizael Xavier

08 Jun 2025 • 5 min read

O Despertar dos Agentes Geradores: Uma Nova Fronteira na Inteligência Artificial

A Inteligência Artificial (IA) tem dado passos largos, e um dos avanços mais fascinantes reside na criação de agentes autônomos capazes de simular comportamentos humanos complexos. Recentemente, um projeto colaborativo entre pesquisadores da Google e da Universidade de Stanford, detalhado no paper intitulado "Generative Agents: Interactive Simulacra of Human Behavior", ganhou destaque ao ter seu código-fonte disponibilizado para a comunidade. Esta iniciativa permite que qualquer pessoa explore, modifique e implemente seus próprios Agentes Geradores em um ambiente simulado chamado "Smallville".

Smallville: Um Ecossistema Digital para Agentes Geradores Autônomos

Smallville é um ambiente sandbox que abriga 25 Agentes Geradores de IA. Esses agentes vivem suas vidas digitais de forma autônoma, realizando atividades cotidianas como trabalhar, interagir socialmente, formar novas amizades e até mesmo se apaixonar, tudo isso sem a consciência de que estão em uma simulação. Cada agente possui uma personalidade única, uma história de fundo e memórias que moldam suas ações e comportamentos futuros. A capacidade de observar e intervir nas rotinas desses agentes oferece um campo fértil para o estudo da dinâmica social e do comportamento emergente.

Este projeto vai além de uma simples simulação, pois permite que os usuários implementem o código localmente em seus próprios computadores. Isso abre um leque de possibilidades para desenvolvedores e pesquisadores, que podem ajustar, analisar e contribuir com o código, personalizando os Agentes Geradores e seus ambientes para diversos fins.

A Importância dos Agentes Geradores e a Emergência Multiagente

O estudo dos Agentes Geradores é considerado um dos experimentos mais inspiradores no campo da IA em 2023. Enquanto muito se discute sobre a emergência de capacidades em grandes modelos de linguagem (LLMs) individuais, a emergência em sistemas multiagente, como o visto em Smallville, apresenta um nível de complexidade e fascínio ainda maior. A interação entre múltiplos agentes autônomos pode levar a comportamentos coletivos imprevisíveis e sofisticados, espelhando de forma mais próxima a complexidade das sociedades humanas.

O paper "Generative Agents" destaca a importância de se ter "proxies" realistas do comportamento humano para potencializar aplicações interativas, desde ambientes virtuais e jogos até plataformas de comunicação e ferramentas de prototipagem. A capacidade desses agentes de formar opiniões, interagir, lembrar-se de eventos passados e planejar o futuro com base nessas memórias é crucial para criar simulações críveis.

Arquitetura dos Agentes Geradores

Para habilitar os Agentes Geradores, os pesquisadores descrevem uma arquitetura que estende um grande modelo de linguagem para armazenar um registro completo das experiências do agente usando linguagem natural. As memórias são sintetizadas ao longo do tempo em reflexões de nível superior, que são então recuperadas para planejar dinamicamente o comportamento do agente. Essa arquitetura permite que os agentes:

Lembrem-se de interações passadas.
Formem novas relações.
Planejem atividades diárias.
Reajam a mudanças no ambiente.

Instalando e Executando os Agentes Geradores em Smallville Localmente

A disponibilização do código-fonte de Smallville permite que entusiastas e pesquisadores explorem esse fascinante mundo dos Agentes Geradores. A seguir, apresentamos um guia passo a passo para instalar e executar a simulação em seu computador local, baseado nas instruções do repositório oficial no GitHub.

Pré-requisitos para os Agentes Geradores

Antes de começar, certifique-se de ter os seguintes softwares instalados:

Git: Para clonar o repositório do projeto.
Python: A linguagem de programação base do projeto (a versão 3.9.12 foi testada no ambiente do paper).
Visual Studio Code (ou outro editor de código): Para editar os arquivos de configuração.
Chave de API da OpenAI: Necessária para o funcionamento dos modelos de linguagem dos agentes. É preciso ter uma conta de cobrança válida associada.

Passo 1: Clonar o Repositório dos Agentes Geradores

Abra o terminal ou prompt de comando e execute o seguinte comando para clonar o repositório:

git clone https://github.com/joonspk-research/generative_agents.git

Após a clonagem, navegue até a pasta do projeto:

cd generative_agents

Passo 2: Configurar o Arquivo de Utilitários (utils.py)

No repositório clonado, você precisará criar um arquivo para suas configurações, incluindo sua chave de API da OpenAI.

Navegue até a pasta reverie/backend_server.
Crie um novo arquivo chamado utils.py.
Copie o conteúdo fornecido na seção "Step 1. Generate Utils File" do arquivo README.md do GitHub e cole-o em seu novo arquivo utils.py.
Dentro do arquivo utils.py, substitua <Your OpenAI API> pela sua chave de API da OpenAI e <name> pelo nome do proprietário da chave (seu nome, por exemplo). Salve o arquivo.

O conteúdo do utils.py deverá ser algo como:

# Copy and paste your OpenAI API Key
openai_api_key = "SUA_CHAVE_API_OPENAI_AQUI"
# Put your name
key_owner = "SEU_NOME_AQUI"

maze_assets_loc = "../../environment/frontend_server/static_dirs/assets"
env_matrix = f"{maze_assets_loc}/the_ville/matrix"
env_visuals = f"{maze_assets_loc}/the_ville/visuals"

fs_storage = "../../environment/frontend_server/storage"
fs_temp_storage = "../../environment/frontend_server/temp_storage"

collision_block_id = "32125"

# Verbose
debug = True

Passo 3: Instalar as Dependências dos Agentes Geradores

Ainda no diretório raiz do projeto (generative_agents), execute o seguinte comando para instalar todas as dependências listadas no arquivo requirements.txt:

pip install -r requirements.txt

Nota: Pode ser necessário criar e ativar um ambiente virtual Python antes de instalar as dependências para evitar conflitos com outros projetos.

Passo 4: Executando a Simulação dos Agentes Geradores

Para executar a simulação, você precisará iniciar dois servidores concorrentemente: o servidor do ambiente e o servidor de simulação dos agentes.

4.1 Iniciando o Servidor do Ambiente

Abra um novo terminal ou prompt de comando.

Navegue até a pasta generative_agents/environment/frontend_server. É nesta pasta que o arquivo manage.py está localizado.
Execute o seguinte comando:

python manage.py runserver

Isso iniciará o servidor Django. Você deverá ver uma mensagem indicando que o servidor está rodando, geralmente em http://localhost:8000/. Mantenha este terminal aberto.

4.2 Iniciando o Servidor de Simulação dos Agentes Geradores

Abra um segundo terminal ou prompt de comando (deixe o primeiro rodando o servidor do ambiente).

Navegue até a pasta generative_agents/reverie/backend_server.
Execute o seguinte comando:

python reverie.py

Este comando iniciará o servidor de simulação. O terminal solicitará algumas informações:

"Enter the name of the forked simulation": Você pode usar uma das simulações base fornecidas no repositório, como base_the_ville_isabella_maria_klaus (para uma simulação com 3 agentes) ou base_the_ville_n25 (para 25 agentes).
"Enter the name of the new simulation": Digite um nome para sua instância de simulação atual (ex: minha-simulacao-teste).

Após inserir esses dados, o servidor de simulação estará ativo.

Passo 5: Acessando e Interagindo com a Simulação

Com os dois servidores rodando:

Abra seu navegador de preferência e acesse http://localhost:8000/simulator_home.
Você deverá ver o mapa de Smallville com os Agentes Geradores ativos. Você pode mover-se pelo mapa usando as teclas de seta.
Para rodar a simulação, no terminal do servidor de simulação (o segundo que você abriu), quando solicitado "Enter option:", digite o comando para avançar os passos da simulação, por exemplo, run <step-count> (substitua <step-count> pelo número de passos desejado, ex: run 100). Um passo de jogo geralmente representa 10 segundos no jogo.

A simulação começará e você verá os agentes se movendo e interagindo no navegador. O terminal do servidor de simulação mostrará prompts para continuar simulando mais passos, salvar o estado da simulação (digitando fin) ou sair.

O Futuro Moldado pelos Agentes Geradores

O projeto "Generative Agents" e a disponibilização de seu código representam um passo significativo para a democratização da pesquisa em IA e o desenvolvimento de simulações de comportamento humano mais ricas e interativas. As implicações são vastas, desde a criação de NPCs (Non-Player Characters) incrivelmente realistas em jogos, que podem revolucionar a indústria do entretenimento, até o desenvolvimento de ferramentas mais sofisticadas para treinamento, planejamento urbano e estudos sociológicos.

À medida que a comunidade explora e expande este trabalho, podemos esperar ver aplicações ainda mais inovadoras e uma compreensão mais profunda da emergência de comportamentos complexos em sistemas de IA. A capacidade de ajustar e personalizar esses Agentes Geradores abre um novo capítulo na forma como interagimos e compreendemos a inteligência artificial.