Sistema e agente

Memoria persistente, sub-agenti, skill, file e checklist operativa dell’agente.

dispatch_agent

Cosa fa. Avvia un sub-agente di ricerca autonomo per un sotto-compito pesante e auto-contenuto; restituisce un briefing compatto (tiene il testo grezzo fuori dal contesto principale).

Quando/come lo usa l’AI. Per fan-out di ricerca (es. una fonte di sentiment per agente). Più chiamate nello stesso turno girano in parallelo.

Parametri. Prompt auto-contenuto del sotto-compito.

Restituisce. Briefing sintetico.

skill

Cosa fa. Invoca un workflow specializzato (es. dcf-valuation) con istruzioni dedicate.

Quando/come lo usa l’AI. Quando un comando delega a una skill (es. /dcf-valuation).

Parametri. name, query.

Restituisce. Risultato della skill.

memory_search

Cosa fa. Cerca nella memoria persistente e nelle conversazioni passate fatti e preferenze salvati.

Quando/come lo usa l’AI. All’inizio, per recuperare obiettivi/preferenze dell’utente.

Parametri. Query.

Restituisce. Risultati di memoria pertinenti.

memory_get

Cosa fa. Legge sezioni specifiche di un file di memoria per intervallo di righe.

Quando/come lo usa l’AI. Per leggere il contenuto esatto prima di modificarlo.

Parametri. file, range di righe.

Restituisce. Contenuto della memoria.

memory_update

Cosa fa. Aggiunge, modifica o elimina voci della memoria persistente.

Quando/come lo usa l’AI. Per salvare nuovi fatti durevoli (al termine delle analisi) o correggerli.

Parametri. action (append/edit/delete), file, content/old_text/new_text.

Restituisce. Esito dell’operazione.

Possibili errori / stati.

• "content" is required for append.
• "old_text" and "new_text" are required for edit.
• Could not find the specified text in <file> — usa memory_get per verificare il testo esatto.

heartbeat

Cosa fa. Visualizza o aggiorna la checklist periodica dell’agente (.dexter/HEARTBEAT.md).

Quando/come lo usa l’AI. Nei task automatici ricorrenti per tenere lo stato.

Parametri. Azione + contenuto.

Restituisce. Stato della checklist.

read_file

Cosa fa. Legge un file locale per percorso e ne restituisce il contenuto come testo.

Quando/come lo usa l’AI. Per leggere file dell’area di lavoro dell’agente.

Parametri. path.

Restituisce. Contenuto del file.

write_file

Cosa fa. Crea o sovrascrive un file. Richiede la conferma dell’utente.

Quando/come lo usa l’AI. Per salvare output su file (es. /export-report).

Parametri. path, contenuto.

Restituisce. Esito della scrittura.

Nota. Operazione che richiede approvazione.

edit_file

Cosa fa. Modifica un file sostituendo testo. Richiede la conferma dell’utente.

Quando/come lo usa l’AI. Per modifiche puntuali a un file esistente.

Parametri. path, testo da sostituire.

Restituisce. Esito della modifica.

Nota. Operazione che richiede approvazione.