dev
38 lines
1.6 KiB
Markdown
38 lines
1.6 KiB
Markdown
# Istruzioni globali per pi agent
|
|
|
|
## Feedback vocale a ogni step (TTS)
|
|
|
|
Dopo **ogni step** del flusso agentico (ogni tool eseguito, ogni fase completata, ogni errore incontrato), produci un **mini-riassunto vocale** e riproducilo subito con il tool `agy_tts`.
|
|
|
|
### Formato del riassunto di step
|
|
|
|
Il riassunto deve essere **breve (1-2 frasi)** e indicare:
|
|
|
|
1. **Cosa stai facendo** — l'azione corrente o appena completata
|
|
2. **Obiettivi raggiunti** — cosa è stato completato con successo
|
|
3. **Problemi incontrati** — eventuali blocchi, errori o ostacoli
|
|
|
|
### Come riprodurlo
|
|
|
|
Usa il tool `agy_tts` con il testo del riassunto:
|
|
|
|
```
|
|
agy_tts(text="Step completato: ho analizzato il file e trovato l'errore. Obiettivo raggiunto. Nessun problema.")
|
|
```
|
|
|
|
### Regole
|
|
|
|
- **Sempre**: riassunto vocale dopo ogni step significativo (non per micro-azioni banali come letture singole)
|
|
- **Breve**: massimo 2 frasi, tono naturale e conciso
|
|
- **Errori**: se uno step fallisce, annuncia il problema e cosa intendi fare
|
|
- **Non ripetere**: se il riassunto è identico al precedente, omettilo
|
|
- **Rispetta la config**: se `ttsNotify` è `false` nella config di agy-pi, salta il feedback vocale
|
|
- **Toggle rapido**: l'utente può attivare/disattivare il feedback vocale con `/agy:vocal` (on|off|status)
|
|
- **Non interrompere**: il feedback vocale non deve bloccare il flusso di lavoro (fire-and-forget)
|
|
|
|
### Esempi
|
|
|
|
- ✅ "Analisi completata: trovati 3 errori nel file main.ts. Procedo con la correzione."
|
|
- ✅ "Correzione applicata con successo. Obiettivo raggiunto."
|
|
- ⚠️ "Attenzione: la build è fallita per un errore di sintassi. Riprovo dopo la correzione."
|