Agentes, modelos e uso — Documentação do Noea Code

O Agente lê seu projeto e realiza tarefas; o modelo interpreta e gera conteúdo. Este guia explica como gerenciar Agentes, conectar provedores de modelos, escolher configurações e ler informações de uso. Os modelos, métodos de login e recursos disponíveis dependem do Agente selecionado.

Gerencie os Agentes locais

Abra Ajustes → Agente. O Noea oferece atualmente Codex, Claude Code, OpenCode e CodeBuddy Code, cada um com sua versão, status e ação principal.

Clique na linha de um Agente para abrir seu painel de detalhes e instalar, fazer login, verificar, atualizar ou desinstalar. Cada Agente é preparado separadamente. Fechar o painel não interrompe uma preparação já em andamento.

Pronto significa que a verificação passou. O status de instalado ou a detecção de credenciais ainda exigem verificação. Em caso de falha, siga o painel de detalhes. Consulte Instalar e preparar o Noea para a configuração inicial.

Conecte um provedor de modelos

Agentes que oferecem suporte a vários provedores mostram uma lista no painel de detalhes. Selecione um provedor e conecte usando uma conta ou chave de API conforme as instruções.

O mesmo provedor é conectado e gerenciado separadamente em cada Agente. O Agente cuida do login e do armazenamento de credenciais; o Noea não armazena chaves de login separadamente. O Agente ainda pode armazenar dados de autenticação localmente.

O OpenCode também oferece uma opção de endpoint personalizado. Digite um nome, a URL base, o protocolo e pelo menos um modelo; depois salve e configure as credenciais na janela de login. Escolha Chat Completions ou Responses conforme a API do seu serviço.

Uma falha ao ler a lista de provedores é diferente de um provedor não conectado. Atualize para conferir o estado atual da conexão e o horário da consulta.

Configure a conversa atual

Use o menu de configurações abaixo do campo de entrada para escolher o Agente, o modelo e o esforço de raciocínio. O esforço de raciocínio ajusta quanto raciocínio o modelo dedica a um problema. Os modelos são agrupados por provedor. Esforço de raciocínio, modo de planejamento, modo rápido e outras opções aparecem conforme o suporte do Agente.

Uma nova conversa normalmente usa o Agente da conversa comum conectada com sucesso mais recentemente. Você pode trocar antes da primeira mensagem, mas não depois da conexão. Inicie uma nova conversa para usar outro Agente.

Algumas listas de modelos só ficam disponíveis depois de conectar, como a interface indica. Se o Agente não aceitar uma opção, ela não será aplicada e a conversa explicará o motivo.

As permissões têm um controle separado no campo de entrada. Escolha entre as opções disponíveis do Agente de acordo com a tarefa.

Configure as operações do projeto

Em Ajustes → Projeto atual → Operações, escolha separadamente um Agente, modelo e esforço de raciocínio para Implementar, Explicar e Organizar Fonte.

Essas configurações se aplicam às respectivas operações do projeto, não a todas as conversas comuns. Explicar acionado após a implementação em uma conversa usa o Agente daquela conversa. Explicar após a aceitação de um plano de organização usa as configurações de Explicar do projeto.

Se o Agente selecionado estiver indisponível, o Noea usa uma alternativa disponível e mostra um aviso. Confira aqui a escolha efetiva antes de executar uma operação.

Leia o uso da conversa atual

O pequeno anel abaixo do campo de entrada mostra o uso de contexto. Clique nele para ver contexto, limites ou saldos da conta e informações de tokens e custos da conversa atual. Tokens são unidades usadas pelos modelos para processar texto e outros conteúdos; não são o mesmo que palavras ou caracteres.

O uso de contexto indica quanto do espaço de contexto disponível do modelo a conversa utiliza. Os limites da conta descrevem restrições de uso impostas pelo provedor ou pelo Agente. São medidas diferentes.

Veja os totais e interprete os custos

Abra Ajustes → Uso ou escolha a opção de ver todo o uso no painel de uso. Filtre por hoje, últimos 7 dias, últimos 30 dias ou todo o período. Expanda um Agente para ver detalhes de modelos e tokens.

Informação	Escopo e significado
Uso no aplicativo	Registros gerados pelo trabalho dentro do Noea.
Limites da conta	Podem incluir uso fora do Noea e não mudam com o filtro de período.
Equivalentes ou estimativas pelo preço de tabela da API	Uma forma de entender a escala do uso, não sua fatura real de assinatura.
Créditos	Exibidos separadamente por origem, sem serem tratados como dólares americanos.
Sem preço ou desconhecido	Faltam preços ou leituras; não significa custo zero ou uso zero.

As leituras mostram o horário de atualização. Uma falha ao atualizar mantém o valor anterior. Atualize depois do horário de redefinição antes de interpretar o limite. Se um Agente não puder informar limites da conta, a interface indica que estão indisponíveis.

Para problemas de conexão, consulte Solução de problemas. Para extensões, consulte Adicionar servidores MCP e Skills.