Planeje primeiro, depois mude — Modo de plano para agentes de IA no desenvolvimento de jogos

Um agente de IA é rápido, e é exatamente por isso que uma tarefa grande pode dar errado em pouco tempo: ele começa a editar código antes de vocês entrarem em acordo sobre o que deve ser feito. O modo de plano no AI Game Developer inverte isso. O agente lê o seu projeto e escreve um plano, toda alteração é recusada até você aprovar, e só então ele começa a trabalhar.

Junto com perguntas de esclarecimento, uma fila de mensagens e cartões de achados de revisão de código, o modo de plano dá a você uma forma simples de conduzir um agente de IA por uma tarefa maior de desenvolvimento de jogos. Neste post usamos todos eles em uma sessão do nosso jogo de demonstração, Skyward Keep: adicionar um planeio ao personagem do jogador. O vídeo é uma gravação real do app: as respostas do agente são roteirizadas para a demonstração, e toda chamada de ferramenta nele rodou de verdade.

Por que planejar antes de o agente editar

Pedidos pequenos, como "deixe o pulo mais alto", não precisam de plano. Os maiores precisam. Uma nova habilidade de movimento mexe com o controlador do jogador, a entrada, os valores de ajuste, a documentação e, muitas vezes, o áudio. Se o agente errar em um desses pontos, você acaba desfazendo alterações em vários arquivos.

Um plano resolve três problemas de uma vez:

• Você vê o escopo antes de qualquer alteração: quais arquivos, quais sistemas, em que ordem.
• Mal-entendidos aparecem cedo, enquanto custam uma frase para corrigir.
• O plano aprovado vira a lista de verificação que você usa para revisar o resultado.

Passo 1: Ative o modo de plano

O modo de plano é um interruptor por sessão no campo de mensagem. Ative-o antes de enviar a tarefa. No modo de plano, o agente pode ler arquivos e buscar no projeto e nas suas notas, mas toda alteração é recusada até ele apresentar um plano.

Depois, descreva o objetivo, não os passos. O pedido da demonstração é curto:

"Adicione um planeio: segure o pulo no ar para planar com a capa da Wren."

O agente começa lendo o controlador do jogador e as notas do projeto sobre habilidades do jogador.

Passo 2: Responda às perguntas do agente

Um bom plano precisa de algumas decisões que só você pode tomar. O agente pode fazer uma pergunta com opções, e ela desliza para fora acima do campo de entrada. Na demonstração, ele faz uma pergunta de design antes de escrever o plano, "Quanto tempo a Wren pode planar?", com três opções:

• 3 segundos de estamina, recarregada ao pousar, o que mantém o ritmo aconchegante.
• Ilimitado, enquanto o pulo estiver pressionado.
• Aprimorável, começando em 1,5 segundo e ampliado por melhorias da capa.

Quando o agente tem várias perguntas, elas viram um questionário editável: você pode clicar em qualquer pergunta para revisitá-la, mudar uma resposta anterior ou pular adiante, e as respostas só são enviadas quando todas tiverem uma. Responder leva um minuto e evita uma rodada de retrabalho depois. Se o seu projeto tem uma Base de Conhecimento, o agente lê as convenções que você já decidiu lá e faz menos perguntas.

Passo 3: Revise o plano

O agente apresenta o plano com um cartão de aprovação que oferece duas escolhas: Aprovar e executar, ou Continuar planejando. O plano da demonstração tem quatro itens:

1. Um novo script Glide: no ar e caindo, segurar o pulo limita a velocidade de queda a 2,5 m/s.
2. Estamina de 3 segundos, a resposta à pergunta, consumida ao planar e recarregada ao pousar.
3. O controlador do jogador chama o planeio depois da gravidade, sem alteração no buffer de pulo nem no tempo de coyote.
4. As regras de planeio são adicionadas à nota Player abilities na Base de Conhecimento.

Ele também observa que os mapeamentos de entrada não precisam de alteração, porque uma ação de planeio já existe.

Leia o plano como leria a nota de design de um colega de equipe. Ele mexe apenas nos arquivos que deveria? A ordem faz sentido? Falta alguma coisa? Se algo estiver errado, escolha Continuar planejando e escreva o que deve mudar; o agente revisa o plano e mostra de novo. Quando estiver certo, aprove e o agente começa a trabalhar.

Passo 4: Enfileire mensagens enquanto ele trabalha

Enquanto o agente trabalha, você vai pensar em coisas. Você não precisa mais esperar nem interromper. Na demonstração, enquanto o planeio está sendo implementado, uma mensagem de acompanhamento é digitada e enfileirada:

"Toque também um whoosh suave quando o planeio começar."

Mensagens enviadas durante um turno em execução ficam esperando em uma gaveta de enfileiradas acima do campo de mensagem. Você pode enviar uma imediatamente ou trazê-la de volta ao campo para editá-la. Se você pressionar Parar, o turno em execução é cancelado e o texto enfileirado volta para o campo, então uma mensagem que você retirou nunca poderá rodar. O agente termina primeiro o plano aprovado e depois pega o pedido enfileirado.

Pedidos de permissão de ferramenta aparecem na mesma gaveta, e a sessão mostra uma marca de esperando por você enquanto um prompt está aberto, para você ver de relance quais sessões precisam de você.

Passo 5: Confira o resultado com cartões de revisão de código

Antes de entregar o trabalho, o agente revisa a própria alteração. Os resultados da revisão de código aparecem como cartões de achados, cada um com um veredito, o arquivo e a linha, uma categoria, um resumo curto e um cenário de falha que explica como o problema apareceria no jogo. Quando nada é encontrado, o cartão diz isso claramente.

Na demonstração, os cartões de revisão mostram dois achados:

• Confirmado e corrigido: a estamina nunca era recarregada ao pousar. Planeie por 3 segundos, pouse, pule de novo, e o segundo planeio nunca começa.
• Plausível e deixado para você decidir: o planeio lê o estado de solo do frame anterior, então pousar em uma plataforma móvel segurando o pulo poderia dar um frame de velocidade de planeio no chão.

Trate os cartões como uma lista de tarefas: peça ao agente para corrigir os achados com os quais você concorda e diga por que pula os outros. Depois confira o plano aprovado item por item e jogue o jogo. Um planeio correto no código ainda pode parecer errado na jogabilidade.

Mantenha sessões longas saudáveis

Tarefas grandes enchem o contexto do agente. Quando uma sessão longa está prestes a assumir uma nova tarefa não relacionada, o campo de mensagem oferece começar do zero, o que economiza seu limite. A oferta aparece só quando o agente está ocioso e o contexto está grande, e você sempre pode continuar trabalhando na sessão atual. Um bom ritmo é uma sessão por recurso: planeje, construa, revise e comece o próximo recurso em uma sessão nova.

Um fluxo de trabalho que você pode reutilizar

Para qualquer tarefa que mexa em mais do que alguns arquivos:

1. Ative o modo de plano e descreva o objetivo.
2. Responda às perguntas do agente.
3. Revise o plano e continue planejando até ficar certo.
4. Aprove e enfileire ideias de acompanhamento em vez de interromper.
5. Revise as alterações com os cartões de achados e depois teste jogando.

O modo de plano e as perguntas do agente chegaram na versão 0.25.0, e a fila de mensagens e os cartões de achados na 0.25.8 (https://ai-game.dev/releases/0.25.8). As boas práticas para cada engine em ai-game.dev/docs/best-practices vão além em como dimensionar tarefas para um agente de IA. Baixe o app em ai-game.dev/download e experimente o modo de plano no seu próximo recurso.