diff --git a/README.md b/README.md
index 205d54c..2390d7f 100644
--- a/README.md
+++ b/README.md
@@ -11,12 +11,20 @@ conversazioni di ragionamento multi-turno.
 | Capacità | Tool | Esempio |
 |---|---|---|
 | Conversazione multi-turno | `agy` | `agy(prompt="Analizza questo problema...")` |
-| Generazione immagini | `agy` | `agy(prompt="Genera un'immagine di un gatto cyberpunk", mode="image")` |
-| Analisi immagini | `agy` | `agy(prompt="Descrivi l'immagine", filePath="/path/foto.jpg")` |
-| Analisi audio | `agy` | `agy(prompt="Trascrivi l'audio", filePath="/path/voce.wav", yolo=true)` |
-| Analisi video | `agy` | `agy(prompt="Descrivi il video", filePath="/path/clip.mp4", yolo=true)` |
+| Generazione immagini (strutturata) | `agy_generate` | `agy_generate(subject="un gatto", style="fotorealistico")` |
+| Editing controllato (Keep+Change+Add+Render) | `agy_edit` | `agy_edit(baseImage=..., change="...", keep="...")` |
+| Editing zona specifica (inpainting) | `agy_inpaint` | `agy_inpaint(baseImage=..., target="il divano", replacement="blu navy")` |
+| Style transfer | `agy_style_transfer` | `agy_style_transfer(baseImage=..., style="Van Gogh")` |
+| Composizione multi-immagine | `agy_compose` | `agy_compose(images=[...], instruction="...")` |
+| Consistenza personaggio | `agy_character` | `agy_character(referenceImage=..., name="Maya", task="...")` |
+| Analisi file (imm/audio/video) | `agy_analyze` | `agy_analyze(filePath=..., question="...")` |
+| Trascrizione audio | `agy_transcribe` | `agy_transcribe(filePath="voce.wav", language="italiano")` |
+| Analisi video | `agy_video` | `agy_video(filePath="clip.mp4", question="...")` |
+| Elenco modelli | `agy_models` | `agy_models()` |
 | Gestione stato conversazione | `agy_conversation` | `agy_conversation(action="id" \| "list" \| "reset")` |
 
+L'agente (pi) decide autonomamente quale strumento usare in base al task richiesto.
+
 ## Installazione
 
 Requisito: `agy` installato e autenticato (una volta: `agy`, poi login OAuth nel browser).