Introdução
Imagine a situação: você conecta um agente ao Unreal e pede para ele mover um objeto da cena. O agente responde normalmente, mas nada muda no editor. Antes de testar outro modelo ou reescrever o prompt pela quinta vez, vale perguntar: quais ferramentas esse agente recebeu? Este problema é documentado no Unreal Engine 5.9 MegaJam Preview.
Conexão do Agente e Desligamento das Ferramentas
Em projetos afetados pelo UE-412135, o servidor MCP está ligado e os plugins que fornecem conjuntos de ferramentas estão desligados. Isso deixa a conexão funcional, mas sem as ferramentas esperadas para editar o nível. O problema documentado deixa esses conjuntos desabilitados, list_toolsets não oferece as ferramentas esperadas para atores, níveis, assets (os recursos do projeto), Blueprints ou Python. Isso descreve aquele problema conhecido, não o comportamento de todo projeto Unreal.
O Protocolo MCP
MCP, sigla de Model Context Protocol, é o protocolo usado nessa integração para o agente chamar ferramentas do editor. Ele não garante, sozinho, que determinada ferramenta esteja disponível ou que uma alteração tenha dado certo. Uma chamada terminar sem erro também não garante que o agente alterou o objeto certo.
Solução Temporária
A solução publicada para o UE-412135 é habilitar All Toolsets em Edit > Plugins, reiniciar o editor e reconectar o agente. O ajuste é por projeto e deve ser feito antes da nova conexão. Depois, confira novamente o que ficou disponível.
Evitando o Problema
Se as ferramentas continuarem ausentes, pare nesse ponto e registre a configuração observada. Contornar a ausência com scripts arbitrários só troca um problema identificado por outro mais difícil de revisar. Teste uma alteração que você consiga conferir.
Teste de Conformidade
Com as ferramentas disponíveis, o primeiro pedido não precisa ser “crie uma fase”. Escolha uma mudança pequena, com alvo e resultado esperado claros. Esse é um roteiro proposto, não um teste que executei no editor. O pedido pode ser simples: “Neste nível de teste, mova somente o ator identificado para a posição combinada e informe qual ferramenta usou. Se ela não estiver disponível ou retornar erro, pare e mostre o erro”. Isso ajuda a comunicar o escopo, mas não substitui limites de acesso nem a conferência do resultado.
Conclusão
A conexão do agente com o Unreal pode funcionar sem fornecer as ferramentas esperadas para editar a cena. É crucial revisar e ajustar as configurações de ferramentas para garantir que o agente tenha acesso às ferramentas necessárias para realizar suas tarefas.
Comentários