Sistemi Multiagente con AutoGen per creare articoli SEO automaticamente

Immagina di avere un team AI che scrive articoli SEO al posto tuo: un agente pianifica la struttura, un altro sviluppa il contenuto, un altro ancora controlla chiarezza, coerenza e ottimizzazione. Questo e precisamente cio che puoi costruire con i sistemi multiagente usando AutoGen.

In questa guida vedrai come funzionano i sistemi multiagente, perche sono utili nella produzione di contenuti, come installare AutoGen e come realizzare una pipeline pratica per generare articoli SEO automaticamente pronti per un sito web.

🧠 Cosa sono i sistemi multiagente

Un sistema multiagente e una struttura composta da piu agenti intelligenti che collaborano tra loro per raggiungere un obiettivo comune. Ogni agente ha un ruolo specifico e svolge un compito preciso all interno di un flusso di lavoro piu ampio.

Come funziona un sistema multiagente

Invece di affidare tutto a un unico modello, il lavoro viene distribuito tra piu agenti specializzati. Questo approccio permette di simulare il comportamento di un team reale, dove ogni membro si occupa di una fase specifica del progetto.

Perche e utile nella SEO

Nel contesto della scrittura per il web, un sistema multiagente consente di separare la pianificazione SEO, la scrittura, la revisione e il salvataggio finale. Il risultato e un contenuto piu ordinato, piu leggibile e piu vicino all intento di ricerca dell utente.

Ogni agente ha un compito chiaro
La qualita del contenuto migliora grazie alla revisione interna
Il flusso puo essere automatizzato su piu articoli
La produzione diventa piu scalabile per siti con molti contenuti

🚀 Perche usare AutoGen per creare articoli SEO

AutoGen e un framework pensato per orchestrare piu agenti AI all interno di una conversazione strutturata. In pratica ti permette di costruire una pipeline in cui diversi agenti collaborano per produrre un risultato finale.

Vantaggi principali

Con AutoGen puoi costruire un sistema che analizza un argomento, crea una struttura SEO, sviluppa il testo, lo corregge e lo salva in un formato pronto per la pubblicazione. Questo approccio e particolarmente utile per chi gestisce blog tecnici, magazine online e siti con aggiornamenti frequenti.

Riduce il lavoro manuale nella creazione di contenuti
Migliora la coerenza tra struttura e keyword
Permette di generare articoli in serie
Si integra con flussi Python e backend web

👥 Architettura del sistema multiagente per articoli SEO

Per creare articoli SEO automaticamente possiamo usare quattro agenti principali, ognuno con una responsabilita specifica.

SEO Planner

Analizza il topic e costruisce il piano editoriale dell articolo: search intent, keyword principale, keyword secondarie, struttura dei titoli e domande frequenti.

Writer

Riceve il piano SEO e scrive il contenuto dell articolo seguendo la struttura stabilita.

Reviewer

Controlla il testo, migliora leggibilita, grammatica, chiarezza e naturalezza della scrittura.

Publisher

Salva il contenuto finale in un file HTML o in un formato pronto per essere importato in un sito PHP o in un database MySQL.

SEO Planner definisce la strategia
Writer sviluppa il contenuto
Reviewer rifinisce il testo
Publisher prepara l output finale

⚙ Come installare AutoGen

Prima di usare il sistema multiagente devi creare un ambiente Python dedicato e installare le dipendenze necessarie.

Creazione ambiente virtuale e installazione

python -m venv .venv
source .venv/bin/activate
pip install "autogen-agentchat~=0.2" openai python-dotenv

Se lavori su Windows, il comando di attivazione cambia.

python -m venv .venv
.venv\Scripts\activate
pip install "autogen-agentchat~=0.2" openai python-dotenv

Configurazione della chiave API

Crea un file .env nella cartella del progetto e inserisci la tua chiave API.

OPENAI_API_KEY=la_tua_api_key

📁 Struttura del progetto

Una struttura ordinata semplifica l esecuzione del codice e la gestione dei file generati.

Esempio di cartelle

seo-autogen/
main.py
.env
output/
articoli/
templates/
prompt_seo.txt

In questo esempio il file main.py gestisce tutta la pipeline, mentre la cartella output contiene gli articoli finali.

💻 Codice completo per generare articoli SEO automaticamente

Di seguito trovi un esempio pratico di script Python con AutoGen. Il flusso crea un piano SEO, scrive l articolo, lo revisiona e lo salva in formato HTML.

import os
from pathlib import Path
from dotenv import load_dotenv

import autogen
from autogen import AssistantAgent, UserProxyAgent

load_dotenv()

OUTPUT_DIR = Path("output/articoli")
OUTPUT_DIR.mkdir(parents=True, exist_ok=True)

llm_config = {
    "config_list": [
        {
            "model": "gpt-4o-mini",
            "api_key": os.getenv("OPENAI_API_KEY"),
        }
    ],
    "temperature": 0.5,
    "timeout": 120,
}

seo_planner = AssistantAgent(
    name="SEOPlanner",
    system_message=(
        "Sei un SEO strategist esperto. "
        "Per ogni tema devi produrre: "
        "search intent, keyword principale, 5 keyword secondarie, "
        "titolo SEO, meta description, struttura H1 H2 H3 e FAQ."
    ),
    llm_config=llm_config,
)

writer = AssistantAgent(
    name="Writer",
    system_message=(
        "Sei un content writer tecnico in italiano. "
        "Scrivi articoli SEO chiari, completi e ben strutturati."
    ),
    llm_config=llm_config,
)

reviewer = AssistantAgent(
    name="Reviewer",
    system_message=(
        "Sei un editor SEO. Migliora chiarezza, grammatica, "
        "coerenza tecnica e leggibilita. Restituisci HTML pulito."
    ),
    llm_config=llm_config,
)

user = UserProxyAgent(
    name="User",
    human_input_mode="NEVER",
    code_execution_config=False,
)

topic = "Sistemi multiagente con AutoGen per creare articoli SEO automaticamente"

planner_chat = user.initiate_chat(
    seo_planner,
    message=(
        f"Crea un piano SEO completo per un articolo sul tema: {topic}. "
        "Target: sviluppatori web e creatori di contenuti. Lingua: italiano."
    ),
    silent=True,
)

seo_plan = planner_chat.chat_history[-1]["content"]

writer_chat = user.initiate_chat(
    writer,
    message=(
        "Usa il seguente piano SEO per scrivere un articolo lungo, utile e originale. "
        f"{seo_plan}"
    ),
    silent=True,
)

draft_article = writer_chat.chat_history[-1]["content"]

review_chat = user.initiate_chat(
    reviewer,
    message=(
        "Rivedi e migliora il seguente articolo. "
        "Restituisci solo HTML pulito pronto da pubblicare. "
        f"{draft_article}"
    ),
    silent=True,
)

final_html = review_chat.chat_history[-1]["content"]

filename = "sistemi-multiagente-autogen-articoli-seo.html"
filepath = OUTPUT_DIR / filename

with open(filepath, "w", encoding="utf-8") as f:
    f.write(final_html)

print(f"Articolo creato: {filepath}")

▶ Come lanciare il programma

Una volta creato il file main.py ed eseguita l installazione dei pacchetti, puoi avviare il sistema dal terminale.

Comando di esecuzione

python main.py

Al termine dell esecuzione troverai il file HTML generato nella cartella output dedicata agli articoli.

output/articoli/sistemi-multiagente-autogen-articoli-seo.html

🔗 Come collegare il sistema al sito web

Dopo aver generato il file HTML, puoi usarlo in due modi: leggerlo direttamente dal sito PHP oppure importarlo nel database.

Opzione 1: lettura diretta da file HTML

Questa soluzione e semplice e veloce. Il tuo sito legge il file generato e lo mostra nella pagina corrispondente.

<?php
$slug = $_GET["slug"] ?? "";
$file = __DIR__ . "/articoli_ai/" . basename($slug) . ".html";

if (file_exists($file)) {
    echo file_get_contents($file);
} else {
    echo "<h1>Articolo non trovato</h1>";
}
?>

Opzione 2: importazione nel database MySQL

Se il tuo sito usa gia una tabella articoli, puoi far salvare a Python i dati in JSON oppure inserirli direttamente nel database.

import json

data = {
    "title": "Sistemi multiagente con AutoGen per creare articoli SEO automaticamente",
    "slug": "sistemi-multiagente-autogen-articoli-seo",
    "meta_description": "Guida pratica ai sistemi multiagente con AutoGen per generare articoli SEO automatici.",
    "content_html": final_html,
    "category_id": 12
}

with open("output/articoli/articolo.json", "w", encoding="utf-8") as f:
    json.dump(data, f, ensure_ascii=False, indent=2)

🗃 Inserimento diretto nel database MySQL

Se vuoi pubblicare senza passaggi manuali, Python puo scrivere direttamente nella tabella del tuo sito.

Esempio con pymysql

import pymysql

conn = pymysql.connect(
    host="127.0.0.1",
    user="root",
    password="root",
    database="nome_database",
    charset="utf8mb4"
)

title = "Sistemi multiagente con AutoGen per creare articoli SEO automaticamente"
slug = "sistemi-multiagente-autogen-articoli-seo"
meta_description = "Guida pratica ai sistemi multiagente con AutoGen per generare articoli SEO automatici."

with conn.cursor() as cur:
    sql = """
        INSERT INTO articoli (title, slug, meta_description, content_html)
        VALUES (%s, %s, %s, %s)
    """
    cur.execute(sql, (title, slug, meta_description, final_html))

conn.commit()
conn.close()

📈 Come automatizzare la creazione di piu articoli

Il vero vantaggio di un sistema multiagente emerge quando lavori su una lista di topic e vuoi generare molti articoli in sequenza.

Esempio con piu argomenti

topics = [
    "Cos e il machine learning",
    "Reti neurali spiegate bene",
    "Prompt engineering per principianti",
    "Cybersecurity: attacchi phishing e difese",
]

for topic in topics:
    pass

In uno scenario reale, al posto di pass userai la stessa pipeline formata da planner, writer e reviewer. In questo modo puoi creare una vera content factory per il tuo sito tecnico.

Prepari una lista di keyword o topic
Il planner definisce la strategia SEO
Il writer genera il contenuto
Il reviewer migliora il risultato finale
Il publisher salva o pubblica l articolo

🎯 Vantaggi concreti per un sito tecnico

Se gestisci un sito con articoli su programmazione, intelligenza artificiale, cybersecurity o machine learning, un sistema multiagente puo aiutarti a produrre contenuti piu velocemente senza rinunciare a struttura e qualita.

Benefici principali

Riduzione del tempo di scrittura
Migliore coerenza SEO tra gli articoli
Possibilita di standardizzare il tono editoriale
Produzione continua di nuovi contenuti
Facile integrazione con PHP, MAMP e MySQL

✅ Conclusione

I sistemi multiagente con AutoGen rappresentano una soluzione concreta per automatizzare la scrittura di articoli SEO. Invece di usare un unico agente generico, puoi organizzare il lavoro tra piu agenti specializzati e ottenere contenuti piu ordinati, piu utili e piu facili da pubblicare.

La pipeline SEO Planner, Writer e Reviewer e una base molto efficace per chi vuole creare un sistema editoriale automatico. Una volta generato l HTML finale, puoi salvarlo su file, mostrarlo nel sito oppure inserirlo direttamente nel database.

Se vuoi evolvere questo progetto, il passo successivo e aggiungere un agente capace di generare meta tag, uno per creare slug automaticamente e uno per pubblicare direttamente sul tuo CMS o sulla tua tabella articoli.

Sistemi Multi Agenti