Agent, modelli e utilizzo — Documentazione di Noea Code

L’Agent legge il progetto e svolge le attività; il modello interpreta e genera contenuti. Questa guida spiega come gestire gli Agent, collegare fornitori di modelli, scegliere le impostazioni e leggere le informazioni sull’utilizzo. Modelli disponibili, metodi di accesso e funzionalità dipendono dall’Agent selezionato.

Gestisci gli Agent locali

Apri Impostazioni → Agent (Settings → Agent). Noea offre attualmente Codex, Claude Code, OpenCode e CodeBuddy Code, ciascuno con versione, stato e azione principale.

Fai clic sulla riga di un Agent per aprire il pannello dei dettagli e gestire installazione, accesso, verifiche, aggiornamenti o disinstallazione. Ogni Agent viene preparato separatamente. Chiudere il pannello non interrompe la preparazione già in corso.

Pronto (Ready) significa che la verifica è riuscita. Lo stato installato o il rilevamento delle credenziali richiedono comunque la verifica. In caso di errore, segui il pannello dei dettagli. Consulta Installare e preparare l’app per la configurazione iniziale.

Collega un fornitore di modelli

Gli Agent che supportano più fornitori mostrano un elenco nel pannello dei dettagli. Seleziona un fornitore e collegalo con un account o una chiave API secondo le istruzioni.

Lo stesso fornitore viene collegato e gestito separatamente in ciascun Agent. L’Agent gestisce l’accesso e l’archiviazione delle credenziali; Noea non conserva separatamente le chiavi di accesso. L’Agent può comunque salvare localmente dati di autenticazione.

OpenCode offre anche un endpoint personalizzato. Inserisci nome, URL di base, protocollo e almeno un modello, poi salva e configura le credenziali nella finestra di accesso. Scegli Chat Completions o Responses in base all’API del servizio.

Una lettura fallita dell’elenco dei fornitori è diversa da un fornitore non collegato. Aggiorna per controllare lo stato attuale della connessione e l’ora di recupero.

Configura la chat attuale

Usa il menu delle impostazioni sotto il campo di input per scegliere Agent, modello e livello di ragionamento. Il livello di ragionamento regola l’impegno che il modello dedica al problema. I modelli sono raggruppati per fornitore. Livello di ragionamento, modalità piano, modalità veloce e altre opzioni compaiono secondo il supporto dell’Agent.

Una nuova chat usa normalmente l’Agent dell’ultima chat normale connessa correttamente. Puoi cambiarlo prima del primo messaggio, ma non dopo la connessione. Avvia una nuova chat per usare un altro Agent.

Alcuni elenchi di modelli sono disponibili solo dopo la connessione, come indicato dall’interfaccia. Se l’Agent non accetta un’opzione, questa non viene applicata e la chat ne spiega il motivo.

Le autorizzazioni hanno un controllo separato nel campo di input. Scegli tra le opzioni disponibili dell’Agent in base all’attività.

Configura le operazioni del progetto

In Impostazioni → Progetto attuale → Operazioni (Settings → Current Project → Operations), scegli separatamente Agent, modello e livello di ragionamento per Implementa (Realize), Spiega (Explain) e Organizza Source (Organize Source).

Queste impostazioni valgono per le rispettive operazioni di progetto, non per tutte le chat normali. Spiega avviato dopo un’implementazione in chat usa l’Agent di quella chat. Spiega dopo l’accettazione di un piano di organizzazione usa le impostazioni Spiega del progetto.

Se l’Agent selezionato non è disponibile, Noea usa un’alternativa disponibile e mostra un avviso. Controlla qui la scelta effettiva prima di eseguire un’operazione.

Leggi l’utilizzo della chat attuale

Il piccolo anello sotto il campo di input mostra l’utilizzo del contesto. Fai clic per visualizzare contesto, limiti o saldi dell’account e informazioni su token e costi della chat attuale. I token sono unità usate dai modelli per elaborare testo e altri contenuti; non equivalgono a parole o caratteri.

L’utilizzo del contesto indica quanta parte dello spazio di contesto disponibile del modello occupa la chat. I limiti dell’account descrivono restrizioni d’uso imposte dal fornitore o dall’Agent. Misurano cose diverse.

Visualizza i totali e interpreta i costi

Apri Impostazioni → Utilizzo (Settings → Usage) oppure scegli di visualizzare tutto l’utilizzo nel relativo pannello. Filtra per oggi, ultimi 7 giorni, ultimi 30 giorni o intero periodo. Espandi un Agent per i dettagli di modelli e token.

Informazione	Ambito e significato
Utilizzo nell’app	Registri generati dal lavoro svolto in Noea.
Limiti dell’account	Possono includere l’uso fuori da Noea e non cambiano con il filtro del periodo.
Equivalenti o stime ai prezzi di listino API	Un modo per capire la scala dell’utilizzo, non la fattura effettiva dell’abbonamento.
Crediti	Mostrati separatamente per fonte, senza considerarli dollari statunitensi.
Senza prezzo o sconosciuto	Prezzi o letture mancanti, non costo o utilizzo pari a zero.

Le letture mostrano l’ora di aggiornamento. Un aggiornamento fallito conserva il valore precedente. Dopo l’ora di ripristino, aggiorna prima di interpretare il limite. Se un Agent non può riportare i limiti dell’account, l’interfaccia li indica come non disponibili.

Per problemi di connessione, consulta Risoluzione dei problemi. Per le estensioni, consulta Aggiungere server MCP e Skills.