Agentes e modelos

O app AI Game Dev permite escolher qual modelo de IA responde, com quanto esforço ele pensa, qual persona de agente trabalha na tarefa e quais ferramentas ele pode usar. Esta página explica o seletor de modelos, provedores e disponibilidade, agentes e skills, aprovações, modo de plano, entrada por voz e os modelos locais que rodam no seu próprio computador.

Modelos e provedores#

O app oferece modelos de chat hospedados de vários provedores: a família Claude, da Anthropic, a família GPT, da OpenAI, DeepSeek e o Gemini, do Google. A lista exata não fica embutida no app: ela vem de ai-game.dev para a sua conta, então sempre corresponde ao seu plano e região. Uma conta nova começa no modelo padrão atribuído pelo servidor.

O que determina se você pode usar um modelo:

• Plano. Alguns modelos exigem um plano específico, por exemplo Studio ou superior. Veja a página de preços.
• Região. A disponibilidade depende do país do seu endereço de cobrança. Veja a página de disponibilidade de modelos.
• Idade. Alguns modelos exigem que você tenha confirmado na sua conta que tem 18 anos ou mais.

Um modelo que você não pode usar continua listado, com o motivo abaixo do nome.

Escolher um modelo no app para desktop#

1. Abra um chat. O selo do modelo na linha de controles do composer mostra o modelo atual.
2. Clique no selo para abrir a lista de modelos.
3. Escolha um modelo. Modelos indisponíveis mostram o motivo, como uma dica de upgrade ou "indisponível na sua região". A parte inferior da lista mostra a região usada como base para a sua disponibilidade.

Os modelos que oferecem suporte também têm uma configuração de esforço de raciocínio. Um esforço maior é melhor para tarefas difíceis de design e depuração; um esforço menor é mais rápido para edições rotineiras.

Cada painel mantém seu próprio modelo, esforço de raciocínio e agente. Uma configuração prática é um modelo grande em um painel que planeja e constrói um recurso, e um modelo mais rápido em um segundo painel para perguntas rápidas. Veja Workspace.

Escolher um modelo na CLI#

Digite /model para abrir o seletor de modelos. Use as setas e Enter para escolher; Tab altera o esforço de raciocínio. Você também pode escolher o modelo ao iniciar:

gamedev --model <model-id>

Se o modelo indicado não estiver disponível para a sua conta, a CLI avisa e pede que você escolha outro com --model ou /model.

Agentes e skills#

Além do modelo, uma sessão tem um agente: um papel com instruções próprias, como um especialista em um tipo de trabalho. A lista contém os agentes integrados do Claude agent SDK, mais os agentes definidos na configuração do Claude do seu projeto ou adicionados por plugins do Claude.

Na CLI:

/agent                    list the agents and show the active one
/agent use <agent-id>     switch this session to an agent
/agent refresh            ask for the agent list again
/skills                   list the skills available in this project

No app para desktop, cada painel mantém seu próprio agente, assim como seu próprio modelo.

Skills, comandos e agentes podem ser adicionados com plugins do Claude (Settings, Claude Plugins, ou /plugin na CLI) e com pacotes. Veja Pacotes.

Ferramentas da sessão#

Cada sessão escolhe quais ferramentas carrega. A Tools row acima do composer lista as ferramentas dos seus pacotes instalados (Blender, Music, Knowledge Base, Image Gen, Video, Tripo, geração em nuvem) e ativa ou desativa cada uma apenas para esta sessão. Na CLI, abra /config e use a seção Tools.

Toda ferramenta ocupa parte do contexto do agente, então uma sessão com apenas as ferramentas de que a tarefa precisa é mais rápida e tem menos chance de escolher a ferramenta errada. Uma alteração vale a partir da próxima mensagem, sem reiniciar o chat.

Aprovações e permissões#

O agente pergunta antes de executar uma ferramenta quando sua política de aprovação assim exige. Há três modos:

Você também pode confiar em pastas extras fora do projeto; um pedido de aprovação para esse caminho oferece permitir sempre aquela pasta. Altere o modo em Settings, Permissions, ou na CLI:

/permissions                     show the mode and trusted folders
/permissions always              ask every time
/permissions outside-project     ask only outside the project
/permissions never               never ask
/permissions trust <folder>      trust a folder and everything in it
/permissions untrust <folder>    stop trusting a folder
/permissions timeout on          auto-deny a request left unanswered for 5 minutes

As alterações valem a partir do próximo turno.

Modo de plano e perguntas#

O modo de plano é um interruptor por sessão no composer. Com ele ativado, o agente lê arquivos e pesquisa o projeto, mas toda alteração é recusada até ele apresentar um plano e você aprová-lo. O agente também pode fazer perguntas de esclarecimento, e você pode enfileirar mensagens de acompanhamento enquanto ele trabalha. O post sobre modo de plano percorre um recurso completo.

Entrada por voz#

O push-to-talk funciona nas duas interfaces: segure Space no campo de chat (ou use o botão de microfone no app para desktop), fale e solte. A fala é transcrita no seu computador com um modelo Whisper local; nada precisa ser instalado. Defina o idioma em Settings, Voice, ou com /voice-language na CLI.

Modelos locais na sua própria GPU#

Os modelos de chat são hospedados, mas os modelos de mídia podem rodar no seu computador, de graça e sem usar sua cota:

• Geração de imagens local: FLUX, modelos baseados em SDXL, Qwen-Image, Qwen-Image-Edit, Z-Image Turbo e outros, executados pelo stable-diffusion.cpp. Ative Image Gen na Tools row da sessão.
• Geração de vídeo local: LTX-2.5 e Wan 2.2 TI2V 5B. Ative Video.

Os modelos são pacotes baixados somente após a sua aprovação. O app verifica sua GPU, memória de vídeo e driver e recomenda os modelos que seu computador consegue executar. Gerencie-os na aba Models da janela Packages, ou com /images e /models na CLI. A lista completa com requisitos de hardware está no catálogo de pacotes.

Os modelos de mídia em nuvem (vídeo, fala, efeitos sonoros e música) rodam nos servidores do AI Game Dev e usam sua cota; veja Geração em nuvem.

Saiba mais#

• Boas práticas para escrever solicitações por engine.
• Geração local de imagens com IA para jogos e geração local de vídeo com IA.
• Pacotes para adicionar ferramentas ao agente.