Chagency

Descrizione

Chagency è basato direttamente sull’AI Client incluso in WordPress 7.0.x: wp_ai_client_prompt(), i Connettori e l’API Abilities. Ogni prompt passa attraverso il core di WordPress, ogni provider è un connettore che hai già configurato in Impostazioni → Connettori, e l’assistente può richiamare tutte le funzionalità registrate dal tuo sito web.

È proprio quest’ultima parte che lo rende un “agente” piuttosto che una semplice chat. Seleziona le funzionalità che vuoi che utilizzi ed il modello potrà usarle durante la conversazione per risponderti: WordPress converte ciascuna di esse in uno strumento comprensibile al modello, lo esegue e verifica prima le autorizzazioni ed i permessi specifici di quella funzionalità. Chiedi «su cosa gira il mio sito web?» e lui va a controllare, invece di tirare e provare ad indovinare.

Funziona nell’area d’amministrazione di WordPress e, quando lo attivi, su ogni pagina del tuo sito web pubblico. Il nome (chat + ai + ency) vuole essere un piccolo ponte tra le nuove funzionalità d’intelligenza artificiale incluse in WordPress dalla versione 7.x.x ed il mondo più ampio delle chat e degli agenti.

🪨 Realizzato con WordPress, punto e basta

Chagency si affida interamente a ciò che la versione di WordPress 7.x.x include nel suo core:

• wp_ai_client_prompt(), l’API dell’intelligenza artificiale AI Client.
• using_abilities() e WP_AI_Client_Ability_Function_Resolver, il ponte della chiamata alle funzioni integrato nel core.
• wp_get_connectors(), l’API dei connettori.
• wp_register_ability() / wp_get_ability() / wp_get_abilities(), l’API delle abilità.
• @wordpress/components, @wordpress/element, @wordpress/boot, il toolkit di Gutenberg.

Questa è l’intera superficie di dipendenza. Nessun SDK di fornitori d’intelligenza artificiale IA integrato, nessuna libreria JavaScript di terze parti oltre allo stack di Gutenberg, nessuna telemetria, nessun “phone-home”. Il plugin rimane volutamente leggero: meno componenti in movimento significano meno attrito, meno falle di sicurezza e meno cose che possono andare storte quando cambiano WordPress, i browser oppure i fornitori.

Ti servirà almeno un plugin di un fornitore d’intelligenza artificiale IA (ad esempio fornitore d’intelligenza artificiale IA per Anthropic, fornitore d’intelligenza artificiale IA per Google, fornitore d’intelligenza artificiale IA per OpenAI) per comunicare con un modello. Ecco come funziona l’architettura di WordPress 7.x.x: i fornitori sono plugin separati che registrano un connettore. Non sono assolutamente una dipendenza di Chagency.

💡 Suggerimento: Per una configurazione senza intoppi, installa AI Engine. Registra ogni provider d’intelligenza artificiale IA che gestisce come connettore, quindi una singola configurazione copre tutti i tuoi plugin d’intelligenza artificiale IA per WordPress 7.x.x (incluso Chagency). Ogni richiesta passa poi attraverso un unico sistema pulito ed unificato.

🪄 Cosa ricevi

• Un pannello di chat mobile fissato in basso a destra su ogni pagina (area amministrativa e/o sito web pubblico, controllato da due interruttori attiva/disattiva completamente indipendenti).
• Una singola pagina delle impostazioni su Impostazioni → Chagency, con le opzioni essenziali: dove visualizzare il chatbot, il titolo della chat, il messaggio di benvenuto, le istruzioni di sistema, la preferenza del modello e quali funzionalità l’assistente può utilizzare.
• Funzionalità, attivabili una per una. Ogni funzionalità registrata sul tuo sito web (dal core, da Chagency o da qualsiasi altro plugin) può essere affidata all’assistente, ed ogni chiamata viene mostrata sotto la risposta, così puoi vedere cosa ha fatto esattamente ed effettivamente.
• Aggiornamenti in tempo reale: attivando o disattivando un interruttore nelle Impostazioni, il launcher viene visualizzato oppure nascosto immediatamente nella stessa pagina, senza bisogno di ricaricare la pagina.
• Pulsanti di Test per ogni fornitore che attivano un prompt canary e segnalano il tempo di andata e di ritorno.
• La persistenza delle conversazioni nel localStorage del tuo browser, con un’impostazione per ogni singolo utente.
• Gli errori vengono spiegati in parole semplici (chiave non valida, limite di frequenza, fornitore non disponibile, conversazione troppo lunga) con un pulsante Riprova, così un piccolo intoppo non ti fa mai perdere quello che hai scritto.
• Espansione dei segnaposto ({user_name}, {site_name}, {current_page}, {current_url}, {user_role}, {site_url}) in modo che l’assistente sappia sempre chi è e dove si trova.
• È disponibile come Ability (chagency/send-message), così altri plugin, client MCP ed agenti d’intelligenza artificiale IA possono richiamare direttamente Chagency.

🚀 Per iniziare

1. Installa ed attiva ora Chagency.
2. Installa e configura almeno un plugin per un fornitore d’intelligenza artificiale IA in Impostazioni → Connettori (ti consigliamo caldamente AI Engine, che mette a disposizione tutti i suoi fornitori come connettori in un colpo solo, sicuro, facile e veloce).
3. Clicca sull’icona della chat in basso a destra in qualsiasi pagina d’amministrazione ed inizia a chattare.
4. Vuoi che appaia anche sul sito web pubblico? Apri Impostazioni → Chagency e fai clic su attiva attivando/disattivando il secondo interruttore.

Domande frequenti (FAQ)

Perché “Chagency”?

È un termine che unisce chat, AI e un po’ di agent. Non “agenzia” nel senso di un’agenzia di marketing. Il plugin parte come un chatbot essenziale per il nuovo framework AI disponibile dalla versione di WordPress 7.x.x ed, insieme all’API Abilities, si evolve fino a diventare un vero e proprio agente.

Serve la versione di WordPress 7.x.x?

Sì. Utilizza wp_ai_client_prompt(), wp_get_connectors() e l’API Abilities, tutte aggiunte dalla versione di WordPress 7.0.x Sulle versioni precedenti non si avvia e ti spiega il motivo. Si consiglia di usare la versione di WordPress 7.1.x.

Come funzionano le abilità? Ed inoltre, sono sicure?

Apri Impostazioni → Chagency, attiva Consenti all’assistente di usare le abilità, poi seleziona quelle che vuoi autorizzare. Di default in modo predefinito non ne è autorizzata nessuna.

Tre cose garantiscono la sicurezza. Al modello vengono offerte solo le funzionalità che hai selezionato. WordPress gestisce direttamente ogni funzionalità e verifica il relativo permission_callback per chi sta chattando, così l’assistente non potrà mai fare più di quanto possa fare quell’utente. Inoltre, le autorizzazioni sono riservate solo agli amministratori: il widget pubblico non le riceve mai, nemmeno quando attivi il sito web pubblico.

Ogni risposta elenca le abilità che ha usato, quindi non succede nulla al di fuori dello schermo.

Quali abilità può usare?

Tutto ciò che è registrato sul tuo sito web. WordPress include di default core/get-site-info, core/get-user-info e core/get-environment-info, e qualsiasi plugin può registrarne altri. Vengono visualizzati tutti nell’elenco.

Quali fornitori d’intelligenza artificiale IA sono supportati?

Qualunque cosa tu configuri in Impostazioni → Connettori. Chagency è indipendente dal provider. Anthropic, Google, OpenAI o qualsiasi altro connettore di terze parti vengono trattati tutti allo stesso modo.

I visitatori del frontend del sito web possono usarlo?

Sì. Apri Impostazioni → Chagency ed attiva Mostra sul sito web pubblico. La chat apparirà così a tutti i visitatori del tuo sito web, indipendentemente o meno che abbiano effettuato l’accesso oppure no.

Salva le mie conversazioni?

No. Le conversazioni rimangono solo nel tuo browser (localStorage, per ogni singolo utente). Fai clic su Reset nel pannello per cancellarle. Nulla viene salvato sul server.

Posso usarlo come elemento di base nel mio plugin?

Sì. L’abilità chagency/send-message è registrata su wp_abilities_api_init e può essere richiamata con wp_get_ability( 'chagency/send-message' )->execute( array( 'message' => '...' ) ).

Codice sorgente

Il codice sorgente non minimizzato di React/JavaScript si trova nella cartella del plugin, in src/, insieme al codice compilato in build/. Repository pubblico del codice sorgente: https://github.com/jordymeow/chagency

Per ricompilare dal codice sorgente:

pnpm install && pnpm run build

La build è @wordpress/scripts (webpack) senza plugin o trasformazioni personalizzate.