Documentação / O agente
Modelos e provedores
Provedores compatíveis no Modo Platform, modelos locais, raciocínio estendido, contexto, cache, consumo e orçamentos.
No Modo Platform, o mecanismo do Yuli raciocina com o provedor e o modelo que você escolher, usando sua própria API key. Esta página explica como configurá-lo e como controlar o consumo.
Se você prefere usar sua assinatura do Claude Code, Kiro, Codex ou Antigravity, não precisa de nada disto. Veja Conectar uma IA.
Provedores
| Provedor | Para quê |
|---|---|
| Anthropic | A API do Claude. |
| OpenAI | Modelos GPT. |
| Gemini | Google AI Studio. |
| xAI | Grok. |
| DeepSeek | A API do DeepSeek. |
| Local | Um servidor compatível com a API da OpenAI no seu computador ou na sua rede: Ollama, LM Studio, vLLM ou llama.cpp. |
| AWS Bedrock | Claude, Llama, Mistral, Nova… com sua conta da AWS. |
| Vertex AI | Gemini e Claude com seu projeto do Google Cloud. |
Configurar um provedor
Abra Provedores de IA de qualquer uma destas formas:
- Cabeçalho do chat → Mais ações → Configurações do modelo.
- Opções globais (
Ctrl+Alt+S) → IA e modelos → Abrir configuração de modelos.
Depois:
- Escolha o cartão do provedor.
- Digite a API key e o Modelo. Para Local, informe também a URL do servidor.
- Clique em Testar conexão (opcional).
- Ative Usar como provedor ativo.
- Clique em Salvar configurações.
As credenciais são guardadas no chaveiro do sistema e nunca são exibidas por completo. Para alterar outro dado sem reescrever a chave, deixe o campo vazio: a atual é mantida.
AWS Bedrock e Vertex AI
| Provedor | Formas de autenticação |
|---|---|
| AWS Bedrock | Perfil / SSO, Chaves IAM, Função IAM ou API key. |
| Vertex AI | ADC, Conta de serviço, gcloud CLI ou API key. |
Modelo rápido
Opcionalmente, defina um Modelo rápido para tarefas leves, como resumos e títulos.
Modelos locais
Com Local, o contexto da IA não sai da sua rede. Inicie seu servidor (Ollama, LM Studio, vLLM ou llama.cpp com sua API compatível com a OpenAI), informe a URL e o nome do modelo, e teste a conexão.
Um modelo local precisa de boa capacidade de chamada de ferramentas para operar o IDE. Teste primeiro com uma tarefa pequena.
Raciocínio estendido
No mesmo painel, Raciocínio estendido oferece Desativado, Baixo, Médio ou Alto.
- Aplica-se apenas ao trabalho principal do agente, não a resumos nem títulos.
- Somente nos modelos que o suportam: orçamento de raciocínio no Claude (API, Vertex e Bedrock) e no Gemini 2.5, e esforço de raciocínio nos modelos de raciocínio da OpenAI.
Contexto
O Yuli administra a janela de contexto por você:
- Conhece o tamanho de contexto de cada modelo.
- O arquivo ativo, o diff de trabalho, as regras e o pacote de contexto têm limite. O que não cabe é mencionado para que o agente o leia, se precisar.
- As conversas longas são compactadas com resumos incrementais.
- Só são enviadas as ferramentas que se aplicam ao projeto (por exemplo, as do Web Studio só se houver front-end).
Cache de prompt
Automático. O prompt do sistema é dividido em uma parte estável e uma por turno, e só a estável vai para o cache. O contexto de cada mensagem viaja com essa mensagem, assim o resto da conversa continua sendo lido do cache. Com os modelos do Claude, cada rodada dentro de uma tarefa reutiliza tudo o que veio antes.
Economia
- Uma chamada idêntica, sem alterações no meio, não é repetida.
- As leituras independentes são resolvidas em paralelo.
- O que exige aprovação é executado ao ser aprovado, sem idas e vindas com o modelo.
- O
retry-afterdo provedor é respeitado em caso de queda.
Consumo e custo
| Onde | O que você vê |
|---|---|
| Barra de status | Tokens da sessão e da tarefa atual, e solicitações. Ao clicar, o detalhe. |
| Consumo desta sessão | Entrada, Saída e Total. São os números informados por cada provedor; são aproximados. |
| Agente → Solicitações de IA (recentes)… | Cada requisição com tokens, custo, latência e erros. |
No Modo assinatura, a barra mostra o uso do plano (janela de 5 horas e semana) em vez da contagem de tokens.
Orçamentos
| Onde | Configuração |
|---|---|
| Botão de verificação do cabeçalho do chat → Verificação automática | Máximo de iterações e Orçamento por tarefa (USD). |
| Mais ações → Equipe de agentes | Orçamento por tarefa (US$ 8) e Orçamento por missão (US$ 60). |
| Opções globais → IA e modelos → Tarefas em segundo plano | Veja abaixo. |
Tarefas em segundo plano
| Configuração | Padrão |
|---|---|
| Tarefas simultâneas | 2 (de 1 a 8) |
| Tokens por tarefa | 2.000.000 |
| Custo por tarefa (US$) | 5 |
| Tentativas de correção após testes | 2 |
Salve com Salvar limites. Quando uma tarefa atinge seu limite, ela é pausada com uma barra de consumo e você pode Ampliar limite e retomar.
Autocompletar com IA
O autocompletar em linha do mecanismo local está sempre disponível. O autocompletar com IA vem desligado e é ativado por escolha sua, com o provedor e o modelo que preferir.