Skip to content

Latest commit

 

History

History
32 lines (24 loc) · 1.29 KB

File metadata and controls

32 lines (24 loc) · 1.29 KB

CausalCraft

Descrição

Framework Python que utiliza LLMs para gerar, validar causalmente e executar planos de ação para um agente no ambiente Crafter.

Arquitetura

  • main.py: Orquestra o ciclo de percepção, planejamento e ação.
  • SymbolicWrapper: Converte observações do ambiente em uma representação simbólica JSON.
  • LLMPlanner: Gera um sub-objetivo atômico (ex: 'collect_wood') a partir do estado simbólico, utilizando um LLM local via subprocesso.
  • CausalValidator: Verifica se um sub-objetivo é causalmente viável com base em pré-condições de inventário e proximidade de entidades.
  • SubgoalExecutor: Decompõe o sub-objetivo em ações de baixo nível (navegação e interação) e as executa no ambiente.
  • ActionMapper: Mapeia sub-objetivos para alvos e ações específicas do ambiente.

Dependências

  • Python 3.x
  • crafter: Instalável via pip install crafter.
  • Um modelo de linguagem local, acessado pelo script scripts/token_budget_wrapper.py.

Como executar

  1. Instale a dependência principal:
    pip install crafter
  2. Configure o ambiente do modelo de linguagem para que seja acessível pelo script scripts/token_budget_wrapper.py.
  3. Execute o script principal:
    python3 main.py