Ottieni ID motore di ricerca e chiave API

Creare un motore di ricerca programmabile Google. Quindi, ottenere l'ID del motore di ricerca e una chiave API. Per istruzioni dettagliate, consultare Create Programmable Search Engine nella documentazione di Google Programmable Search Engine.

Scarica la specifica OpenAPI

Scarica il file di specifica OpenAPI: google-custom-search-openapi.json. Utilizza questo file per aggiungere l'estensione al tuo assistente.

La specifica OpenAPI definisce i metodi seguenti:

• GET /customsearch/v1: cerca il contenuto su tutto il Web.
• GET /customsearch/v1/siterestrict: ricercare il contenuto su una raccolta specifica di siti Web.

Per ulteriori informazioni sugli endpoint, consultare Ricerca personalizzata o Sito di ricerca personalizzato limitato.

Gli endpoint hanno gli stessi argomenti e risposte, ma con differenze:

• Sito di ricerca personalizzato limitato è limitato alla ricerca di 10 o meno siti Web, ognuno dei quali può avere un numero illimitato di pagine.
• Ricerca personalizzata può supportare qualsiasi numero di siti Web indicizzati da Google, ma ha un limite di query giornaliere.

Per un tipico assistente focalizzato su un argomento specifico, di solito è solo necessario cercare un singolo sito web o alcuni siti web. Sito di ricerca personalizzato limitato è una scelta migliore poiché non ha un limite sul numero di query che possono essere eseguite al giorno. Gli assistenti che devono eseguire la ricerca in più di 10 siti Web devono utilizzare invece Ricerca personalizzata.

Crea e aggiungi estensione

1. Nel tuo assistente, nella pagina Integrazioni, fai clic su Crea estensione personalizzata e utilizza il file di specifica OpenAPI per creare un'estensione personalizzata. Per istruzioni generali sulla creazione di un'estensione personalizzata, consultare Creazione di un'estensione personalizzata.

2. Dopo aver creato l'estensione di ricerca personalizzata Google e averla visualizzata nella tua pagina Integrazioni, fai clic su Aggiungi per aggiungerla al tuo assistente. Utilizzare la chiave API del motore di ricerca programmabile Google per l'autenticazione. Per istruzioni generali sull'aggiunta di qualsiasi estensione personalizzata, vedi Aggiunta di un'estensione al tuo assistente.

Aggiungi il modello di azione del kit starter di ricerca personalizzata Google

1. Aprire la pagina Azioni.

2. Se non si dispone di alcuna azione, scegliere Crea una nuova azione. Se hai già alcune azioni, scegli Nuova azione.

3. In Crea un'azione, scegliere Avvio rapido con i template.

   Avvio rapido con i template è disponibile solo in lingua inglese.

4. In Quick start with templates, aggiungi il kit starter di ricerca personalizzato Google.

Modifica azioni di sistema

1. Fai clic su Imposta per assistente e apri l'azione Nessuna corrispondenza.

2. Eliminare i due passi predefiniti.

3. Aggiungere un passo. Imposta And quindi su Go to a subaction e scegli l'azione Google search.

4. Se non stai collegando i tuoi clienti a un agent attivo, potresti voler modificare l'azione Fallback nello stesso modo di Nessuna corrispondenza.

Utilizzo della tua estensione di ricerca personalizzata Google

Invia una query al tuo assistente. Se nessuna azione corrisponde a tale query, utilizza Google per produrre i risultati della ricerca.

Limita alla dimensione dei risultati della ricerca

watsonx Assistant ha un limite di 100 kb sulla dimensione delle informazioni memorizzate nelle variabili di contesto, che comprende i risultati della ricerca. Se i risultati dell'estensione superano tale limite, l'azione può avere esito negativo senza alcuna avvertenza o errore visibile. In genere si verifica un lungo ritardo e quindi non c'è risposta. Questo errore si verifica raramente con l'estensione di ricerca personalizzata Google, ma potrebbe verificarsi se si sta ricercando un sito con grandi volumi di metadati restituiti dalla ricerca personalizzata Google. Se pensi che questo potrebbe essere un problema, prova ad eseguire la query in uno strumento di test API come curl, Insomnia o Postman. Controllare quanti byte di dati si stanno ottenendo come risultati della ricerca. Se il totale è pari o vicino a 100 kb, potresti essere in grado di risolvere il problema riducendo num_of_results e ottenendo meno risultati per ogni query o escludendo siti o pagine con grandi volumi di metadati.

Per ulteriori informazioni, vedi Limit on Size of Search Results in un kit starter per IBM Watson® Discovery.