{“content”:“\u003cdiv data-theme-toc="true"\u003e \u003c/div\u003e\n\n## Ricerca Google per Discourse AI\nPer configurare un bot di ricerca Google con il plugin Discourse AI, dovrai configurare un Motore di Ricerca Programmabile Google e una chiave API di Ricerca Personalizzata. Qualsiasi modello AI utilizzerai dovrà usare questo strumento di ricerca per restituire i risultati della ricerca Google. Quando configuri un servizio AI per il tuo Plugin Discourse, ad esempio se stai usando OpenAI API GPT o Anthropic Claude, e vuoi usare un bot di supporto per effettuare ricerche su Google, dovrai configurare un Motore di Ricerca Programmabile per cercare su Google e una chiave API per consentire al tuo bot ricercatore di accedere al motore di ricerca e restituire i risultati.\n\n### Introduzione: Google Cloud, Motore di Ricerca Programmabile e API di Ricerca Personalizzata\n\nIl Motore di Ricerca Programmabile (o Motore di Ricerca Personalizzata) è un servizio di motore di ricerca gratuito che chiunque può configurare sul proprio sito web ed è identificato da un ID motore di ricerca (o numero CX). Una chiave API di Ricerca Personalizzata viene utilizzata per effettuare richieste API al motore di ricerca, e le chiavi API sono gestite dalla console Google Cloud. Pertanto, dovrai configurare un account Google Cloud - è richiesta una carta di credito per registrare il tuo account, ma l’API di Ricerca Personalizzata fornisce 100 query di ricerca al giorno gratuitamente prima di pagare (richieste aggiuntive costano $5 per 1.000 query, fino a 10.000 query al giorno, ma dovrai acquistare più utilizzo). Vedi come gestire la fatturazione.\n\nVorrai anche configurare la tua chiave sotto un progetto Google Cloud, preferibilmente uno nuovo designato per la chiave di ricerca (per un tracciamento più semplice). Nota che Google Cloud ha quote sia sul numero di progetti che sul numero di progetti collegati a un account di fatturazione, e i progetti possono essere aggiunti agli account di fatturazione dopo che sono stati configurati e le chiavi API sono state create.\n\nChecklist\n* Configura l’account Google Cloud\n* Crea un progetto per la tua chiave API di ricerca personalizzata\n* Collega il progetto all’account di fatturazione\n* Crea la chiave API\n* Configura la chiave API per la Ricerca Personalizzata\n* Imposta un Motore di Ricerca Programmabile Google\n* Salva la chiave API di ricerca personalizzata e l’ID di ricerca personalizzata nelle impostazioni di Discourse AI\n\n***\n \n### Passaggio 1: Configura un Progetto in Google Cloud\nPrima di configurare il tuo motore di ricerca personalizzato e la chiave API, configura un progetto in Google Cloud.\nVai su admin Google Cloud per le API per te (o la tua organizzazione), e assicurati di essere nell’organizzazione principale (puoi vederla nel campo in alto accanto al logo Google Cloud).\n\nDovrai creare un progetto per il tuo motore di ricerca se non ne hai già uno che vuoi usare - il link per selezionare o creare un nuovo progetto si trova vicino alla parte superiore della pagina.\n\n
\n\nCompleta la pagina di creazione nuovo progetto (assicurati che la tua organizzazione sia selezionata nei campi a discesa appropriati).\n\n\n\nPer gestire la fatturazione del tuo progetto, dovrai configurare un account di fatturazione per il progetto in fatturazione Google Cloud, supponendo che tu abbia la fatturazione configurata per la tua organizzazione. Tu (o il tuo responsabile dell’account di fatturazione) dovresti essere in grado di farlo in seguito, dopo che la chiave è stata creata. Nota che ci sono quote sui progetti e sui progetti di fatturazione a seconda dell’account Google Cloud della tua organizzazione.\n\nPer abilitare la fatturazione sul tuo progetto, vai alla scheda Fatturazione nel menu di navigazione di Google Cloud e collega un account di fatturazione, o abilita la fatturazione per il progetto dalla pagina dei progetti di fatturazione.\n\n\n\n\n\n\n***\n\n### Passaggio 2: Crea una Chiave API\n\nPer creare una chiave API dalla Google Cloud Console, vai alla scheda API e Servizi nella tua console Google Cloud e alle impostazioni delle credenziali per il tuo nuovo progetto. (Non preoccuparti del messaggio "configura schermata di consenso"). Fai clic sul link "+ crea credenziali" vicino alla parte superiore della pagina e seleziona "chiave API" dalle opzioni a discesa.\n\n\n\nVerrà creata una nuova chiave API per te. Copiala e salvala in un luogo sicuro come un gestore di password. Non condividere le chiavi.\n\n\n\nQuesta è la chiave API di Ricerca Personalizzata Google che dovrai inserire nelle tue impostazioni di Discourse AI per
ai_google_custom_search_api_key\n\n\n\nOra dovresti vedere la tua nuova chiave elencata nell’elenco delle chiavi API. Fai clic sui 3 puntini nella colonna Azioni all’estrema destra e seleziona "Modifica chiave API".\n\n\n\nQuesto aprirà la pagina di configurazione delle credenziali della chiave API, e qui puoi modificare il nome della chiave API in qualcosa di più appropriato. (Puoi anche visualizzare/copiare la tua chiave API o rigenerarla se necessario). Quindi vai alla sezione "Restrizioni API" in fondo e seleziona "Restringi chiave" quindi scegli "API di Ricerca Personalizzata". Fai clic su OK e poi Salva la tua chiave API.\n\n\n\nSe non vedi restrizioni elencate, potresti dover abilitare il servizio API nella Libreria API. Cerca "google custom search api" quindi selezionala. Qui vedrai i dettagli dell’API di Ricerca Personalizzata, inclusi i prezzi e i link a ulteriore documentazione - fai clic sul link per abilitare l’API.\n\n\n\nLa nuova chiave API sarà ora elencata con il suo nuovo nome e un segno di spunta verde per indicare che è limitata alle richieste JSON dell’API di Ricerca Personalizzata.\n\n\n\n\n*** \n\n### Passaggio 3: Crea un Motore di Ricerca Programmabile\n\nPer creare un motore di ricerca che la tua chiave API possa utilizzare, vai alla pagina Motore di Ricerca Programmabile Google e fai clic su "Inizia" se non hai già effettuato l’accesso (accedi o crea il tuo account). Una volta effettuato l’accesso, vai alla pagina della console del motore di ricerca. Qui saranno elencati tutti i tuoi motori di ricerca programmabili esistenti.\n\n\n\n\nFai clic sul pulsante "Aggiungi" (o sul link "Crea il tuo primo motore di ricerca!") per aprire la pagina del nuovo motore di ricerca. Dagli un nome appropriato e compila i campi come applicabile.\n\n\n\n\nFai clic sul pulsante "Crea" e il tuo nuovo motore di ricerca verrà creato. La pagina ti darà la possibilità di copiare lo script di ricerca se vuoi usare la casella di ricerca in un’interfaccia web da qualche parte, ma non è necessario qui, dato che siamo interessati solo ad usarla per le nostre credenziali della chiave API per accedervi.\n\nSeleziona il pulsante personalizza per andare alla pagina di panoramica del motore di ricerca. Qui possiamo ora vedere l’ID del Motore di Ricerca (numero CX) necessario per le nostre impostazioni di ricerca Google di Discourse AI, così come alcune altre opzioni che è possibile configurare. (Nota che se scorri fino in fondo, c’è un link per creare chiavi API - non è necessario farlo poiché l’hai fatto nel passaggio 2 sopra).\n\n\n\n***\n\n### Passaggio 4: Configura la Ricerca Personalizzata Google nel Plugin Discourse AI\n\nCopia il numero dell’ID del Motore di Ricerca e salvalo insieme alla chiave API creata nel passaggio 2. Vai su Admin - Impostazioni del sito e nel filtro Tutte le impostazioni del sito, digita "ricerca personalizzata google" per visualizzare le due impostazioni di cui hai bisogno. Incolla la chiave API in 
ai_google_custom_search_api_key e l’ID del Motore di Ricerca (numero CX) in ai_google_custom_search_cx della tua istanza Discourse e salva le nuove impostazioni. Configura le altre impostazioni AI secondo necessità.\n \n\n\n### Passaggio 5: Tracciamento delle Chiavi API di Ricerca\n\nPuoi vedere l’attività della tua chiave API di Ricerca Personalizzata nella Console Google Cloud API e Servizi Dettagli e anche configurare quote nella scheda Quota e Limiti di Sistema. I report sui costi possono essere visualizzati nella scheda Costi.\n\n\n\n\n***\n\n### Esempi di Ricerche Discourse AI\n \nEcco un esempio di OpenAI GPT-4 Turbo che utilizza la Ricerca Personalizzata Google per spiegare cosa fa e come configurarsi.\n\nEcco un esempio di Anthropic Claude Opus che utilizza la Ricerca Personalizzata Google per spiegare il significato di "centauro inverso".\n\n\n***\n\n### Link Rilevanti\n\n* https://meta.discourse.org/t/official-discourse-ai-plugin/259214\n* Documentazione Motore di Ricerca Personalizzata Google Developer\n* API di Ricerca Personalizzata Google\n* Fatturazione Google Cloud\n* Motore di Ricerca Programmabile Google\n\n\n***”,“target_locale”:“it”}
