Come funzionano i comandi

Ogni comando slash (/comando) è in realtà una prompt salvata: un set di istruzioni dettagliate che Dexter invia al modello AI al posto tuo. Non è codice rigido — è linguaggio naturale strutturato che guida l’agente passo passo. Capire come è fatta una prompt ti aiuta a sfruttare i comandi al meglio e a sapere cosa aspettarti.

Su ogni pagina di comando trovi la sezione “Prompt completa” con il testo esatto inviato all’AI: è la stessa prompt che gira quando lanci il comando.

Il segnaposto {arg}

Quasi tutte le prompt contengono {arg}: è il punto in cui viene inserito ciò che scrivi dopo il comando.

• /fundamental-analysis AAPL → ogni {arg} nella prompt diventa AAPL.
• /price-analysis NVDA 6m → {arg} diventa NVDA 6m (la prompt estrae da sola ticker e orizzonte).
• Comandi senza argomenti (es. /portfolio-review) ignorano {arg} e usano il tuo portafoglio.

Se lanci un comando che richiede un argomento senza fornirlo, molte prompt mostrano un breve messaggio d’uso (es. “Usage: /sec TICKER”) e si fermano.

Chiamate agli strumenti in parallelo

Dexter non “sa” i numeri: li recupera con gli strumenti (tools). Le prompt quasi sempre chiedono di chiamare più strumenti in parallelo all’inizio (“all in parallel”), così la raccolta dati è veloce. Nella sezione Come funziona di ogni comando trovi l’elenco degli strumenti che quel comando può usare, con il link alla loro spiegazione.

Anti-allucinazione

Una regola vale per tutte le analisi: niente numeri inventati.

• Se un dato manca, l’AI lo dice; non lo stima a caso.
• Una metrica non disponibile diventa N/A, mai un valore di fantasia.
• I calcoli vengono mostrati passo per passo, con le formule.

Le tre fasi di un’analisi

Le analisi approfondite su 1-2 titoli seguono un ordine preciso, per evitare report troncati o ripetuti:

1. Fase A — Memoria. Prima di scrivere, l’AI salva un breve appunto con memory_update (prezzo, segnale, raccomandazione) e registra eventuali nuovi fatti durevoli su di te (obiettivi, tolleranza al rischio).
2. Fase B — Report. Scrive l’analisi completa: tabelle, verdetto, rischi. Una volta sola.
3. Fase C — Widget di chiusura. Come ultima azione rende i widget visivi (vedi sotto). Sono terminali: chiudono il turno, quindi vengono chiamati dopo che il testo è già scritto.

I widget visivi

Tre strumenti producono elementi grafici nel terminale:

• render_price_chart — un grafico annotato dei prezzi. Va all’inizio (es. /price-analysis, /earnings-analysis, /explain-move): prima il grafico, poi la prosa.
• render_value_range — la barra del fair value (basso/base/alto vs prezzo attuale). Va alla fine (es. /fair-value, /dcf-valuation), insieme ai pulsanti di dettaglio.
• show_ticker_link — i pulsanti che aprono la scheda di dettaglio del titolo. Compaiono nei deep-dive su 1-2 titoli (si saltano negli screening con più titoli).

La sezione Come funziona di ogni comando segnala già se quel comando apre con un grafico, chiude con la barra del valore o salva un appunto in memoria.

Modificare i comandi

Le prompt vivono nel file services/dexter_terminal/prompts.yaml. Le pagine di questa sezione sono generate da quel file, così mostrano sempre la versione reale. Se cambi una prompt, riavvia il server Dexter perché abbia effetto.