# Agentes e modelos — App e CLI do AI Game Dev · AI Game Developer Wiki

Escolha modelos de IA, esforço de raciocínio e agentes no app e na CLI do AI Game Dev, controle aprovações de ferramentas e use modelos locais na sua GPU.

Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/docs/wiki/app/agents-and-models).

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](https://ai-game.dev/pricing).
- **Região.** A disponibilidade depende do país do seu endereço de cobrança. Veja a [página de disponibilidade de modelos](https://ai-game.dev/model-availability).
- **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](https://ai-game.dev/pt-br/docs/wiki/app/workspace#panes).

## 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:

```bash
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`.

**Dica**

Um modelo mais barato e rápido usa uma porcentagem menor da sua cota mensal para o mesmo trabalho. Reserve os maiores modelos para as tarefas que precisam deles.

## 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:

```text
/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](https://ai-game.dev/pt-br/docs/wiki/app/packages).

## 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:

| Modo | Quando o agente pergunta |
| --- | --- |
| Perguntar sempre | Antes de cada ferramenta que a IA executa, mesmo dentro do projeto. O mais seguro, com o maior número de interrupções |
| Perguntar apenas fora do projeto (padrão) | Quando ela sai da pasta do projeto ou tenta alterar as configurações de permissão do próprio projeto. Dentro do projeto, ela lê, grava e executa comandos sem perguntar |
| Nunca perguntar | Nunca. A IA pode ler, gravar e executar comandos em qualquer lugar da sua máquina |

**Aviso**

No modo padrão, os comandos de shell rodam sem confirmação dentro do projeto, então a IA pode executar código na sua máquina. "Nunca perguntar" estende isso ao computador inteiro; use apenas quando confiar na tarefa.

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:

```text
/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](https://ai-game.dev/pt-br/blog/plan-mode-ai-agent-game-development) 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](https://ai-game.dev/pt-br/docs/wiki/app/packages-catalog#local-image-models).

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](https://ai-game.dev/pt-br/docs/wiki/app/packages-catalog#cloud-generation).

## Saiba mais

- [Boas práticas](https://ai-game.dev/docs/best-practices) para escrever solicitações por engine.
- [Geração local de imagens com IA para jogos](https://ai-game.dev/pt-br/blog/local-ai-image-generation-for-games) e [geração local de vídeo com IA](https://ai-game.dev/pt-br/blog/local-ai-video-generation-on-your-gpu).
- [Pacotes](https://ai-game.dev/pt-br/docs/wiki/app/packages) para adicionar ferramentas ao agente.

---

Source (HTML): https://ai-game.dev/pt-br/docs/wiki/app/agents-and-models

Machine-translated (pt-BR) from the English page: https://ai-game.dev/docs/wiki/app/agents-and-models