Costruisci un Generatore di Presentazioni Intelligenti con MultiAgentPPT

MultiAgentPPT si basa su un'architettura multi-agente che prevede la collaborazione tra diversi agenti specializzati. I componenti chiave includono:

• A2A (Ask-to-Answer): Un paradigma di comunicazione tra agenti che consente loro di interrogarsi e rispondere a vicenda per risolvere problemi complessi.
• MCP (Multi-agent Control Protocol): Un protocollo per la gestione e il coordinamento degli agenti all'interno del sistema.
• ADK (Agent Development Kit): Un kit di strumenti per lo sviluppo e l'implementazione di agenti.

Il flusso di lavoro tipico prevede i seguenti passaggi:

1. L'utente fornisce un input testuale che descrive l'argomento della presentazione.
2. Un agente di "Outline Generation" crea una struttura preliminare della presentazione.
3. Un agente di "Topic Splitting" suddivide la struttura in argomenti più piccoli.
4. Agenti di "Research" multipli conducono ricerche parallele su ciascun argomento.
5. Un agente di "Summary" riassume i risultati della ricerca e genera il contenuto delle slide.
6. Il contenuto generato viene presentato all'utente in formato PowerPoint.

Per una migliore comprensione visiva, ecco un diagramma Mermaid che illustra l'architettura:

Per iniziare, è necessario configurare l'ambiente di sviluppo e installare le dipendenze necessarie.

1. Clonare il repository:

   git clone https://github.com/johnson7788/MultiAgentPPT.git

2. Creare un ambiente virtuale Python:

   conda create --name multiagent python=3.12

3. Attivare l'ambiente virtuale:

   conda activate multiagent

4. Installare le dipendenze:

   cd backend

   pip install -r requirements.txt

5. Configurare le variabili d'ambiente: Copiare i file env_template in .env nelle directory dei singoli moduli (simpleOutline, simplePPT, slide_outline, slide_agent). Assicurarsi di configurare correttamente le variabili d'ambiente, come le chiavi API per l'accesso a modelli linguistici o motori di ricerca.

Durante l'installazione e la configurazione, potresti incontrare alcuni errori. Ecco alcuni dei più comuni e come risolverli:

• Errore: Chiave API non valida: Verifica che le chiavi API per i modelli linguistici o i motori di ricerca siano corrette e abbiano i permessi necessari.
• Errore: Dipendenze mancanti: Assicurati di aver installato tutte le dipendenze elencate nel file requirements.txt. Utilizza il comando pip install -r requirements.txt per installarle.
• Errore: Porta già in uso: Se un servizio non si avvia perché la porta è già in uso, prova a cambiare la porta di quel servizio o a terminare il processo che sta utilizzando la porta.
• Errore: Problemi con l'ambiente virtuale: Assicurati che l'ambiente virtuale sia attivo e che stai installando le dipendenze al suo interno.

Se continui ad avere problemi, consulta la documentazione del progetto o cerca aiuto online.

La struttura del progetto MultiAgentPPT è organizzata come segue:

MultiAgentPPT/
├── backend/              # 后端多Agent服务目录
│   ├── simpleOutline/    # 简化版大纲生成服务（无外部依赖）
│   ├── simplePPT/        # 简化版PPT生成服务（不使用检索或并发）
│   ├── slide_outline/    # 带外部检索的大纲生成服务
│   ├── slide_agent/      # 并发式多Agent PPT生成主服务
├── frontend/             # Next.js 前端界面

• backend/: Contiene il codice per i servizi backend, inclusi gli agenti e le API.
• simpleOutline/: Servizio semplificato per la generazione di outline, senza dipendenze esterne.
• simplePPT/: Servizio semplificato per la generazione di PPT, senza ricerca o concorrenza.
• slide_outline/: Servizio per la generazione di outline di alta qualità con ricerca esterna.
• slide_agent/: Servizio principale per la generazione di PPT con multi-agente concorrente.
• frontend/: Interfaccia utente basata su Next.js.

Per avviare i servizi backend, utilizzare i seguenti comandi:

python main_api.py

python main_api.py

python main_api.py

python main_api.py

Assicurarsi di avviare un solo servizio alla volta sulla stessa porta.

Ogni modulo svolge un ruolo specifico nel processo di generazione della presentazione. simpleOutline genera un'outline di base, mentre simplePPT crea una presentazione semplificata senza ricerca esterna o concorrenza. slide_outline migliora l'outline utilizzando la ricerca esterna per garantire informazioni accurate e pertinenti. Infine, slide_agent orchestra l'intero processo con agenti multipli che lavorano in parallelo per creare una presentazione completa e di alta qualità. I risultati di ciascun modulo vengono passati al modulo successivo, culminando nella presentazione finale.

Il frontend è sviluppato con Next.js e richiede una configurazione separata.

1. Installare le dipendenze:

   cd frontend

   npm install

2. Configurare le variabili d'ambiente: Copiare il file env_template in .env e configurare le variabili, in particolare DATABASE_URL, A2A_AGENT_OUTLINE_URL e A2A_AGENT_SLIDES_URL. Questi URL devono puntare ai servizi backend in esecuzione.
3. Avviare il server di sviluppo:

   npm run dev

4. Accedere all'applicazione: Aprire il browser all'indirizzo http://localhost:3000.

MultiAgentPPT utilizza un database PostgreSQL per memorizzare le presentazioni generate. È possibile utilizzare Docker per avviare un'istanza di PostgreSQL.

1. Avviare PostgreSQL con Docker:

   docker run --name postgresdb -p 5432:5432 -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=welcome -d postgres

2. Installare le dipendenze e applicare il modello del database:

   pnpm install

   pnpm db:push

3. Inserire un utente predefinito (se necessario): In alcuni casi, potrebbe essere necessario inserire manualmente un utente nel database utilizzando lo script SQL frontend/insert_one_user.sql.

Congratulazioni! Hai implementato un generatore di presentazioni intelligenti con MultiAgentPPT. Questo sistema dimostra come l'architettura multi-agente può essere utilizzata per automatizzare compiti complessi come la creazione di presentazioni. Puoi ulteriormente personalizzare e migliorare il sistema aggiungendo nuovi agenti, integrando modelli linguistici più avanzati e ottimizzando il flusso di lavoro degli agenti.

Ora, prova a creare la tua presentazione! Quali argomenti ti piacerebbe automatizzare con MultiAgentPPT? Condividi le tue idee e i tuoi risultati nei commenti!