Come configurare Creator Assistant Hub: collegare WordPress a OpenAI e Qdrant

Come collegare il tuo sito WordPress a OpenAI e Qdrant con Creator Assistant Hub, passo per passo: Termini di servizio, chiavi API, verifica e indicizzazione degli articoli.

Questo articolo è stato generato con l’ausilio dell’intelligenza artificiale, a partire da idee e indicazioni fornite dall’autore.

Hub digitale collega un pannello web, un nodo cloud e un database mentre organizza schede di contenuto.

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

  • 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.

La pagina Creator Assistant Hub - Configurazione alla prima apertura, con la sezione Termini di servizio, i link ai documenti e la casella di accettazione
La prima apertura delle impostazioni di Hub: finché non spunti la casella e salvi, non compare nessun’altra scheda.

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.

La scheda OpenAI delle impostazioni di Hub con il messaggio verde Connesso e pronto e il campo Chiave API già salvata
La scheda OpenAI dopo il salvataggio di una chiave valida: il messaggio verde conferma la connessione e il campo non mostra più la chiave.

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.

La scheda Qdrant delle impostazioni di Hub con il messaggio Connesso e pronto, il campo Chiave API salvata e il campo URL endpoint
La scheda Qdrant dopo il salvataggio: l’URL endpoint ha il formato dell’esempio (qui un indirizzo di fantasia) e la chiave non viene mai rimostrata.

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.
L'elenco degli articoli con la colonna Stato dei vettori, che mostra Chunk con il segno di spunta verde su ogni articolo
L’elenco Articoli con la colonna Stato dei vettori: Chunk in verde con il segno di spunta indica che l’articolo è indicizzato; finché non lo è, la voce resta in grigio.

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.
  1. Apri Creator Assistant > Hub e accetta i Termini di servizio.
  2. Incolla la chiave API di OpenAI nella scheda OpenAI.
  3. Inserisci chiave API e URL endpoint nella scheda Qdrant.
  4. Verifica in Strumenti > Salute del sito e nella colonna Stato dei vettori.
  5. 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

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *