Questa pagina presenta l'integrazione di Agent Search con il motore RAG.
Agent Search fornisce una soluzione per il recupero e la gestione dei dati all'interno delle tue applicazioni RAG di Gemini Enterprise Agent Platform. Utilizzando Agent Search come backend di recupero, puoi migliorare le prestazioni, la scalabilità e la facilità di integrazione.
Prestazioni e scalabilità migliorate: Agent Search è progettato per gestire grandi volumi di dati con una latenza eccezionalmente bassa. Ciò si traduce in tempi di risposta più rapidi e prestazioni migliorate per le tue applicazioni RAG, soprattutto quando si tratta di knowledge base complesse o estese.
Gestione dei dati semplificata: importa i dati da varie origini, come siti web, set di dati BigQuery e bucket Cloud Storage, per semplificare il processo di acquisizione dei dati.
Integrazione perfetta: Agent Platform fornisce un'integrazione integrata con Agent Search, che ti consente di selezionare Agent Search come backend del corpus per la tua applicazione RAG. In questo modo, il processo di integrazione viene semplificato e viene garantita una compatibilità ottimale tra i componenti.
Miglioramento della qualità dell'output dell'LLM: utilizzando le funzionalità di recupero di Agent Search, puoi contribuire a garantire che l'applicazione RAG recuperi le informazioni più pertinenti dal tuo corpus, il che porta a output generati dall'LLM più accurati e informativi.
Agent Search
Agent Search riunisce il recupero di informazioni approfondito, l'elaborazione del linguaggio naturale e le funzionalità più recenti per l'elaborazione di modelli linguistici di grandi dimensioni (LLM), che aiutano a comprendere l'intenzione dell'utente e a restituire i risultati più pertinenti per l'utente.
Con Agent Search, puoi creare un'applicazione di ricerca di qualità Google utilizzando i dati che controlli.
Configura Agent Search
Per configurare una ricerca dell'agente, segui questi passaggi:
Utilizza Agent Search come backend di recupero per RAG Engine
Una volta configurato Agent Search, segui questi passaggi per impostarlo come backend di recupero per l'applicazione RAG.
Imposta Agent Search come backend di recupero per creare un corpus RAG
Questi esempi di codice mostrano come configurare Agent Search come backend di recupero per un corpus RAG.
REST
Per utilizzare la riga di comando per creare un corpus RAG, segui questi passaggi:
Crea un corpus RAG
Sostituisci le seguenti variabili utilizzate nell'esempio di codice:
- PROJECT_ID: l'ID del tuo progetto Google Cloud .
- LOCATION: la regione in cui elaborare la richiesta.
- DISPLAY_NAME: il nome visualizzato del corpus RAG che vuoi creare.
- ENGINE_NAME: il nome completo della risorsa del motore di ricerca dell'agente o del datastore di ricerca dell'agente. Ad esempio,
projects/PROJECT_NUMBER/locations/LOCATION/collections/default_collection/engines/ENGINE_NAME/servingConfigs/default_search
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/ragCorpora" \ -d '{ "display_name" : "DISPLAY_NAME", "vertex_ai_search_config" : { "serving_config": "ENGINE_NAME/servingConfigs/default_search" } }'Monitora l'avanzamento
Sostituisci le seguenti variabili utilizzate nell'esempio di codice:
- PROJECT_ID: l'ID del tuo progetto Google Cloud .
- LOCATION: la regione in cui elaborare la richiesta.
- OPERATION_ID: l'ID dell'operazione di creazione del corpus RAG.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID"
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Agent Platform per l'utilizzo delle librerie client.
Per eseguire l'autenticazione in Agent Platform, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Recupera i contesti utilizzando l'API RAG
Dopo la creazione del corpus RAG, i contesti pertinenti possono essere recuperati dalla ricerca dell'agente tramite l'API RetrieveContexts.
REST
Questo esempio di codice mostra come recuperare i contesti utilizzando REST.
Sostituisci le seguenti variabili utilizzate nell'esempio di codice:
- PROJECT_ID: l'ID del tuo progetto Google Cloud .
- LOCATION: la regione in cui elaborare la richiesta.
- RAG_CORPUS_RESOURCE: il nome della risorsa del corpus RAG.
Formato:
projects/{project}/locations/{location}/ragCorpora/{rag_corpus}. - TEXT: il testo della query per ottenere contesti pertinenti.
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:retrieveContexts" \
-d '{
"vertex_rag_store": {
"rag_resources": {
"rag_corpus": "RAG_CORPUS_RESOURCE"
}
},
"query": {
"text": "TEXT"
}
}'
Python
Per scoprire come installare o aggiornare l'SDK Vertex AI Python, consulta Installa l'SDK Vertex AI Python. Per saperne di più, consulta la documentazione di riferimento dell'API Python.
Genera contenuti utilizzando l'API Gemini di Agent Platform
REST
Per generare contenuti utilizzando i modelli Gemini, effettua una chiamata all'API GenerateContent di Agent Platform. Se specifichi RAG_CORPUS_RESOURCE nella richiesta, i dati vengono recuperati automaticamente da Agent Search.
Sostituisci le seguenti variabili utilizzate nel codice campione:
PROJECT_ID: l'ID del tuo progetto Google Cloud .
LOCATION: la regione in cui elaborare la richiesta.
MODEL_ID: modello LLM per la generazione di contenuti. Ad esempio:
gemini-3.8-flash.GENERATION_METHOD: metodo LLM per la generazione di contenuti. Ad esempio,
generateContent,streamGenerateContent.INPUT_PROMPT: il testo inviato all'LLM per la generazione dei contenuti. Prova a utilizzare un prompt pertinente ai documenti in Agent Search.
RAG_CORPUS_RESOURCE: il nome della risorsa del corpus RAG. Formato:
projects/{project}/locations/{location}/ragCorpora/{rag_corpus}.SIMILARITY_TOP_K: (facoltativo) il numero di contesti principali da recuperare.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:GENERATION_METHOD" \ -d '{ "contents": { "role": "user", "parts": { "text": "INPUT_PROMPT" } }, "tools": { "retrieval": { "disable_attribution": false, "vertex_rag_store": { "rag_resources": { "rag_corpus": "RAG_CORPUS_RESOURCE" }, "similarity_top_k": SIMILARITY_TOP_K } } } }'
Python
Per scoprire come installare o aggiornare l'SDK Vertex AI Python, consulta Installa l'SDK Vertex AI Python. Per saperne di più, consulta la documentazione di riferimento dell'API Python.