agenzia/azioni_implementazione.md

Roadmap Implementazione: Redazione Social Multi-Agente

Questo documento elenca i passi necessari per costruire il sistema di automazione social.

Fase 1: Setup Ambiente e Dati (Dockerized)

• Inizializzare un progetto con Docker e docker-compose.
• Creare la struttura delle cartelle persistenti (volumi):
  • data/images/artista_n: per le foto.
  • data/audio/artista_n: per i brani .mp3 da analizzare.
• Creare un file config.json con i profili dei 4 cantanti e i link Spotify/Distrokid.
• Preparare il Dockerfile con le dipendenze (Python, FFmpeg per audio, ecc.).

Fase 2: Sviluppo del Database delle Immagini

• Creare uno script che scansiona la cartella immagini.
• Implementare una logica di "tracking" per segnare le immagini già usate (per evitare ripetizioni).
• (Opzionale) Usare un modello Vision per pre-analizzare le immagini e salvarne una descrizione.

Fase 3: Sviluppo degli Agenti

• Agente Audio Analyst: Utilizza modelli AI multimodali (es. Gemini) per ascoltare il brano .mp3 e dedurre genere, mood, bpm e temi principali.
• Agente Asset Manager: Seleziona l'immagine non usata dal folder specifico dell'artista.
• Agente Copywriter: Genera testi basandosi sull'output dell'Audio Analyst (non più su generi predefiniti).
• Agente Visual-Harmonizer: Incrocia l'analisi audio con l'estetica dell'immagine scelta.
• Agente Hashtag: Genera tag basati sul brano analizzato e sul visual.
• Agente Supervisore: Verifica finale della coerenza tra audio, immagine e link.

Fase 4: Orchestrazione e Approvazione

• Configurare il grafo di LangGraph per collegare gli agenti.
• Creare una semplice interfaccia (es. Streamlit) per visualizzare la proposta del post e cliccare su "Approva" o "Rifiuta".
• Integrare un sistema di notifiche (es. Telegram Bot) per avvisarti quando un post è pronto.

Fase 5: Distribuzione (Post reale)

• Integrare le API dei social media o un aggregatore (es. Buffer API o un webhook verso Make.com).
• Testare il flusso completo con un post di prova.

Fase 6: Manutenzione

• Implementare un log dei post pubblicati.
• Sistema di alert se le immagini in una cartella stanno per finire.