Per configurare Creator Assistant Hub fai tre cose: accetti i Termini di servizio, incolli la chiave API di OpenAI e inserisci le credenziali del tuo cluster Qdrant. Poi Hub indicizza i tuoi articoli da solo, in background, appena attivi un plugin che lo usa.
Ho creato Hub come base comune dei plugin Creator Assistant. Da solo non cambia nulla di ciò che vedono i tuoi visitatori: prepara i tuoi contenuti perché gli altri plugin, come la ricerca con intelligenza artificiale, possano usarli. In questa guida ti accompagno dalla prima apertura delle impostazioni fino alla verifica che tutto funzioni.
- Cosa ti serve prima di iniziare
- Passo 1: accetta i Termini di servizio
- Passo 2: collega OpenAI
- Passo 3: collega Qdrant
- Passo 4: scegli la cache
- Passo 5: verifica che tutto funzioni
- Come Hub indicizza i tuoi articoli
- Problemi comuni
- Riepilogo
Cosa ti serve prima di iniziare
- Hub installato e attivato. La versione attuale nella directory dei plugin di WordPress.org è la 1.2.0 e richiede WordPress 6.8 o successivo e PHP 7.4 o successivo.
- Una chiave API di OpenAI. La crei nella dashboard della piattaforma OpenAI, come spiega la guida rapida di OpenAI. Una chiave API è una specie di password che permette al tuo sito di usare i servizi di OpenAI a tuo nome.
- Un cluster Qdrant Cloud. Qdrant è il database che conserva la versione dei tuoi contenuti che l’intelligenza artificiale sa leggere. Il piano gratuito va bene: ti servono l’indirizzo del cluster e una chiave API del database.
- Un plugin che usa Hub, ad esempio Creator Assistant Search. Senza un plugin di questo tipo Hub resta in attesa e, come dice la sua pagina su WordPress.org, non invia nessun contenuto a servizi esterni.
Passo 1: accetta i Termini di servizio
Nel menu laterale della bacheca trovi la voce Creator Assistant: aprila e scegli Hub. La pagina si intitola Creator Assistant Hub – Configurazione.
La prima volta vedi solo la sezione Termini di servizio. Leggi i Termini e l’Informativa sulla privacy dai due link della sezione, spunta Ho letto e accetto i Termini di servizio e l’Informativa sulla privacy. e premi Salva le impostazioni.
Dopo il salvataggio compaiono le schede Generale, OpenAI, Qdrant, Cache e Strumenti. Se usi WordPress in italiano, c’è anche la scheda Supporto.

Passo 2: collega OpenAI
Apri la scheda OpenAI. Nella sezione Configurazione OpenAI il pulsante Ottieni una chiave API porta direttamente alla pagina delle chiavi della piattaforma OpenAI, se non ne hai ancora una.
Incolla la chiave nel campo Chiave API e premi Salva le impostazioni. Se la chiave funziona, in cima alla sezione compare il messaggio verde Connesso e pronto. Se invece leggi Connessione non riuscita. Controlla le tue impostazioni., la chiave non è stata accettata.
Dopo il salvataggio il campo torna vuoto e mostra la scritta Chiave già salvata. Lascia vuoto per mantenerla. È voluto: Hub non rimostra mai la chiave nella pagina, così nessuno può copiarla dal tuo schermo. Per cambiarla, incolla quella nuova e salva.
Un dettaglio utile: per controllare la connessione Hub chiede a OpenAI l’elenco dei modelli. Il messaggio verde conferma quindi che la chiave è valida, non che sul tuo account ci sia credito.

Passo 3: collega Qdrant
Apri la scheda Qdrant. Nella sezione Configurazione Qdrant trovi due campi: Chiave API e URL endpoint.
- URL endpoint è l’indirizzo del tuo cluster. Hub ti mostra un esempio del formato:
https://xxxx.aws.cloud.qdrant.io:6333. La porta 6333 è quella che Qdrant usa per le richieste REST, come indica la documentazione di Qdrant. - Chiave API è una chiave del database, che crei nella pagina di dettaglio del cluster, nella sezione API Keys. Secondo la documentazione sull’autenticazione Qdrant la mostra una sola volta: copiala subito. Lascia i permessi predefiniti, di scrittura, perché Hub deve creare le sue raccolte di dati e scriverci.
Fai attenzione alla scadenza: Qdrant propone per le nuove chiavi una scadenza predefinita di 90 giorni. Puoi sceglierne un’altra al momento della creazione, come spiega la stessa documentazione. Quando la chiave scade, Hub non riesce più a collegarsi.
Premi Salva le impostazioni. Anche qui il messaggio Connesso e pronto. ti dice che Hub ha raggiunto il cluster e che il cluster è in funzione.

Passo 4: scegli la cache
Questo passo è facoltativo. Nella scheda Cache il campo Scadenza della cache decide per quanto tempo Hub conserva le risposte di OpenAI e di Qdrant: da Disabilitato, il valore iniziale, fino a una settimana. Finché una risposta è in cache, una richiesta uguale non viene ripetuta: risparmi chiamate e la risposta arriva prima.
Puoi lasciarla disabilitata e attivarla più avanti, quando il sito riceve molte ricerche simili.
Passo 5: verifica che tutto funzioni
Hai due modi per controllare.
- Salute del sito. Vai in Strumenti > Salute del sito. Il controllo Creator Assistant Hub è attivo significa che hai accettato i Termini e che OpenAI e Qdrant sono entrambi collegati. Se invece leggi Creator Assistant Hub non è attivo, il pulsante Vai alle impostazioni dell’Hub ti riporta alla configurazione.
- Stato dei vettori. Quando è attivo un plugin che usa Hub, nell’elenco degli articoli compare la colonna Stato dei vettori. Per ogni articolo mostra il tipo di indicizzazione richiesto dai tuoi plugin, ad esempio Chunk con Creator Assistant Search: in verde con il segno ✓ quando l’articolo è indicizzato, in grigio quando non lo è ancora. Le stesse informazioni sono nell’editor, nel pannello Creator Assistant della barra laterale.

Come Hub indicizza i tuoi articoli
Indicizzare vuol dire trasformare il testo in una forma che l’intelligenza artificiale sa confrontare per significato, e salvarla in Qdrant. Hub lo fa in tre momenti.
- Quando salvi un articolo. Subito dopo il salvataggio, Hub programma l’indicizzazione in background: non devi aspettare davanti allo schermo.
- Per gli articoli che avevi già. Ogni ora Hub cerca i contenuti non ancora indicizzati e li elabora a gruppi di 10. Quando un gruppo è pieno ne avvia subito un altro, finché l’archivio è completo.
- Quando lo chiedi tu. Nella scheda Strumenti, alla voce Forza la reindicizzazione, il pulsante Forza reindicizzazione di tutto fa rielaborare tutti i contenuti. I dati già in Qdrant restano al loro posto e vengono sostituiti un articolo alla volta.
Hub considera articoli, pagine e gli altri contenuti pubblici che usano l’editor a blocchi. Nella stessa scheda trovi anche Ripristina tutti i dati: cancella tutte le raccolte in Qdrant e fa ripartire l’indicizzazione da zero. Usalo solo se vuoi davvero ricominciare.
Problemi comuni
- Connessione non riuscita su OpenAI. La chiave è stata copiata male o è stata revocata. Creane una nuova e incollala.
- Connessione non riuscita su Qdrant. Controlla che l’URL endpoint inizi con
https://e finisca con la porta, come nell’esempio della pagina. Se funzionava e ha smesso, la chiave potrebbe essere scaduta: creane una nuova. - La colonna Stato dei vettori non compare. Nessun plugin attivo usa Hub. Attiva, ad esempio, Creator Assistant Search.
- Gli articoli restano grigi a lungo. Le operazioni programmate di WordPress partono solo quando qualcuno visita il sito, come spiega la documentazione di WordPress sul cron. Su un sito con poche visite possono partire in ritardo: apri qualche pagina del sito e ricontrolla.
- Il cluster gratuito è sospeso. Qdrant sospende un cluster gratuito non usato per una settimana e lo elimina dopo quattro settimane di inattività, secondo la sua documentazione. Per evitarlo Hub invia ogni giorno una piccola richiesta al cluster, come indica la pagina del plugin.
Riepilogo
- Apri Creator Assistant > Hub e accetta i Termini di servizio.
- Incolla la chiave API di OpenAI nella scheda OpenAI.
- Inserisci chiave API e URL endpoint nella scheda Qdrant.
- Verifica in Strumenti > Salute del sito e nella colonna Stato dei vettori.
- Lascia lavorare Hub: indicizza i contenuti nuovi e quelli che avevi già.
Ora che Hub è pronto, il passo successivo è installare Creator Assistant Search. Quando un visitatore cerca qualcosa sul tuo sito, riceve in cima ai risultati una risposta breve, costruita solo sui tuoi contenuti, con l’elenco degli articoli da cui viene.









Lascia un commento