Questa pagina descrive come creare un'app di ricerca.
Crea un'app
Console
Per utilizzare la console Google Cloud per creare un'app di ricerca, segui questi passaggi:
Nella console Google Cloud, vai alla pagina Agent Builder.
Nella pagina App, fai clic su Crea app.
Nella pagina Crea app, fai clic su Crea in Cerca il tuo sito web.
Decidi se vuoi le funzionalità di Enterprise per questa app e poi fai clic sull'opzione per attivarle o disattivarle.
L'attivazione delle funzionalità della versione Enterprise è obbligatoria per usufruire di funzionalità come la ricerca sul sito web e la scelta di una regione per la tua app. Le funzionalità della versione Enterprise comportano un costo aggiuntivo. Per saperne di più, consulta Funzionalità della versione Enterprise.
Decidi se vuoi le funzionalità LLM avanzate per questa app, quindi fai clic sul pulsante di attivazione/disattivazione per attivarle o disattivarle.
L'attivazione delle funzionalità LLM avanzate è necessaria per ottenere funzionalità come i riepiloghi della ricerca o la ricerca con domande aggiuntive. Per saperne di più, consulta Funzionalità LLM avanzate.
Nel campo Nome app, inserisci un nome per l'app.
Nel campo Nome esterno della tua azienda o organizzazione, inserisci il nome comune della tua azienda o organizzazione. Non è necessario includere suffissi come Inc o LLC. Questo campo è utile per consentire all'LLM di identificare la società rappresentata dall'app.
Seleziona una località per la tua app. Per scegliere una località, le funzionalità di Enterprise devono essere attive. Google consiglia di utilizzare l'opzione predefinita globale (Globale), a meno che tu non abbia un motivo per limitare i dati a una determinata area geografica.
Fai clic su Continua.
Per connetterti a un datastore, nella pagina Datastore seleziona un datastore che hai creato in precedenza o creane uno nuovo.
Esegui almeno una delle seguenti operazioni:
Seleziona un datastore esistente.
Se colleghi un solo datastore, non potrai rimuoverlo o aggiungere altri datastore a questa app in un secondo momento. Se colleghi più datastore, puoi modificarli in un secondo momento, ma questa app deve sempre avere almeno due datastore collegati.
Crea un nuovo datastore e importavi i dati.
A tal fine, fai clic su Crea datastore e segui i passaggi nel riquadro Crea un nuovo datastore che si apre. Quindi seleziona il nuovo datastore. Per ulteriori informazioni, consulta Creare un archivio dati di ricerca.
(Facoltativo) Per visualizzare un elenco di datastore non disponibili, fai clic su Scopri perché.
Viene visualizzata una tabella con un elenco di datastore e il motivo per cui non sono disponibili. Ecco alcuni motivi per cui un datastore potrebbe non essere disponibile:
- Il tipo di datastore consente il collegamento a una sola app e il datastore è già collegato.
- Il tuo datastore e la tua app si trovano in regioni diverse.
- Il tuo datastore e la tua app sono di tipi diversi. Ad esempio, non puoi collegare un datastore di ricerca sanitaria a un'app di ricerca di siti web.
- Il tuo datastore dispone della ricerca di siti web di base, mentre la tua app di ricerca di siti web richiede un datastore con indicizzazione avanzata dei siti web.
Fai clic su Crea.
REST
Prima di utilizzare la riga di comando per creare un'app, devi avere un datastore esistente. Se non hai un datastore, creane uno seguendo i passaggi descritti in Creare un datastore e importare i dati per Vertex AI Search.
Per utilizzare il metodo engines.create
per creare un'app di ricerca dalla riga di comando, segui questi passaggi:
Trova l'ID del tuo datastore. Se hai già l'ID del tuo datastore, vai al passaggio successivo.
Nella console Google Cloud, vai alla pagina Agent Builder e nel menu di navigazione fai clic su Data Store.
Fai clic sul nome del tuo datastore.
Nella pagina Dati del tuo datastore, ottieni l'ID del datastore.
Crea un'app di ricerca e collegala a un datastore. Un datastore può essere collegato a una sola app e non può essere rimosso dall'app in un secondo momento.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \ -d '{ "displayName": "APP_DISPLAY_NAME", "dataStoreIds": ["DATA_STORE_ID"], "solutionType": "SOLUTION_TYPE_SEARCH", "searchEngineConfig": { "searchTier": "SEARCH_TIER", "searchAddOns": ["SEARCH_ADD_ON"] } }'
Sostituisci quanto segue:
PROJECT_ID
: l'ID del tuo progetto Google Cloud.APP_ID
: l'ID dell'app Vertex AI Search che vuoi creare.APP_DISPLAY_NAME
: il nome visualizzato dell'app Vertex AI Search che vuoi creare.DATA_STORE_ID
: l'ID di un datastore Vertex AI Search esistente che vuoi aggiungere all'app Vertex AI Search.SEARCH_TIER
: il livello di ricerca può essereSEARCH_TIER_STANDARD
oSEARCH_TIER_ENTERPRISE
.SEARCH_TIER_ENTERPRISE
è necessario per usufruire di funzionalità come la ricerca sui siti web e la scelta di una regione per la tua app. Le funzionalità della versione Enterprise comportano un costo aggiuntivo. Per ulteriori informazioni, consulta le funzionalità della versione Enterprise.SEARCH_ADD_ON
: se vuoi le funzionalità LLM avanzate per questa app, specificaSEARCH_ADD_ON_LLM
. Le funzionalità LLM avanzate includono risultati di ricerca con riepilogo e ricerca con domande aggiuntive.Se non vuoi le funzionalità LLM avanzate, specifica
SEARCH_ADD_ON_UNSPECIFIED
o rimuovi il camposearchAddOns
.Per saperne di più, consulta Funzionalità LLM avanzate.
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python Vertex AI Agent Builder.
Per autenticarti in Vertex AI Agent Builder, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Terraform
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base. Per ulteriori informazioni, consulta la Terraform documentazione di riferimento del provider.
Per creare un'app di ricerca utilizzando Terraform, consulta
discovery_engine_search_engine
.