Cómo cambiar de modo

Vista previa

Algunas de las funciones de RAG son ofertas de vista previa, sujetas a las “Condiciones de las ofertas de la fase previa a la DG” de las Condiciones específicas del servicio de Google Cloud. Los productos y las características anteriores a la DG están disponibles “tal cual” y pueden tener asistencia limitada, y es posible que los cambios en estos productos y características no sean compatibles con otras versiones de la fase previa a la DG. Para obtener más información, consulta las descripciones de la etapa de lanzamiento. Si usas la API de Gemini en Gemini Enterprise Agent Platform, aceptas los términos y condiciones de la versión preliminar de IA generativa(Términos de la versión preliminar).

El motor de RAG de la Agent Platform admite los controles de seguridad de VPC-SC y CMEK. No se admiten los controles de seguridad de residencia de datos ni de AXT.

Los modos de Deployment son una configuración a nivel del proyecto. Cambiar entre los dos modos no mueve ni borra tus datos del otro modo. Puedes usar la API de UpdateRagEngineConfig para cambiar entre los modos de implementación de Spanner y sin servidores. También puedes usar esta API para establecer el nivel en tu modo de implementación de Spanner o para anular el aprovisionamiento de tu modo de Spanner y detener la facturación. Puedes usar la API de GetRagEngineConfig para leer la información de tu modo de implementación actual.

Cambiando al modo sin servidores

En las siguientes muestras de código, se muestra cómo cambiar tu RagEngineConfig al modo sin servidores:

Console

1. En la consola de Google Cloud , ve a la página RAG Engine.

   Ir a RAG Engine

2. Selecciona la región en la que se ejecuta tu motor de RAG.
3. Haz clic en la opción Cambiar a sin servidores. Es posible que no se vea si estás en el modo sin servidores. Puedes verificar tu modo actual en la etiqueta de modo que se encuentra en la sección superior derecha de la página.

REST

PROJECT_ID: Your project ID.
LOCATION: The region to process the request.

curl -X PATCH \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/ragEngineConfig -d "{'ragManagedDbConfig': {'serverless': {}}}"

Python

from vertexai.preview import rag
import vertexai

PROJECT_ID = YOUR_PROJECT_ID
LOCATION = YOUR_RAG_ENGINE_LOCATION

# Initialize Agent Platform API once per session
vertexai.init(project=PROJECT_ID, location=LOCATION)

rag_engine_config_name=f"projects/{PROJECT_ID}/locations/{LOCATION}/ragEngineConfig"

new_rag_engine_config = rag.RagEngineConfig(
    name=rag_engine_config_name,
    rag_managed_db_config=rag.RagManagedDbConfig(mode=rag.Serverless()),
)

updated_rag_engine_config = rag.rag_data.update_rag_engine_config(
    rag_engine_config=new_rag_engine_config
)

print(updated_rag_engine_config)

Cambiando al modo de Spanner

En las siguientes muestras de código, se muestra cómo cambiar tu RagEngineConfig al modo de Spanner. Si ya usaste el modo Spanner y elegiste un nivel, no es necesario que lo proporciones de forma explícita cuando cambies de modo. De lo contrario, consulta los ejemplos de código que se encuentran más abajo para cambiar al modo de Spanner y, al mismo tiempo, proporcionar un nivel.

Console

1. En la consola de Google Cloud , ve a la página RAG Engine.

   Ir a RAG Engine

2. Selecciona la región en la que se ejecuta tu motor de RAG.
3. Haz clic en la opción Cambiar a Spanner. Es posible que no se vea si estás en el modo de Spanner. Puedes verificar tu modo actual en la etiqueta de modo.

REST

PROJECT_ID: Your project ID.
LOCATION: The region to process the request.

curl -X PATCH \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/ragEngineConfig -d "{'ragManagedDbConfig': {'spanner': {}}}"

Python

from vertexai.preview import rag
import vertexai

PROJECT_ID = YOUR_PROJECT_ID
LOCATION = YOUR_RAG_ENGINE_LOCATION

# Initialize Agent Platform API once per session
vertexai.init(project=PROJECT_ID, location=LOCATION)

rag_engine_config_name=f"projects/{PROJECT_ID}/locations/{LOCATION}/ragEngineConfig"

new_rag_engine_config = rag.RagEngineConfig(
    name=rag_engine_config_name,
    rag_managed_db_config=rag.RagManagedDbConfig(mode=rag.Spanner()),
)

updated_rag_engine_config = rag.rag_data.update_rag_engine_config(
    rag_engine_config=new_rag_engine_config
)

print(updated_rag_engine_config)

Cómo leer tu RagEngineConfig actual

En las siguientes muestras de código, se muestra cómo leer tu RagEngineConfig para ver qué modo y nivel se eligen:

REST

PROJECT_ID: Your project ID.
LOCATION: The region to process the request.

curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/ragEngineConfig

Python

from vertexai.preview import rag
import vertexai

PROJECT_ID = YOUR_PROJECT_ID
LOCATION = YOUR_RAG_ENGINE_LOCATION

# Initialize Agent Platform API once per session
vertexai.init(project=PROJECT_ID, location=LOCATION)

rag_engine_config = rag.rag_data.get_rag_engine_config(
    name=f"projects/{PROJECT_ID}/locations/{LOCATION}/ragEngineConfig"
)

print(rag_engine_config)

Actualiza el nivel en el modo de Spanner

En los siguientes ejemplos de código, se muestra cómo actualizar el nivel en el modo de Spanner:

Actualiza tu RagEngineConfig al nivel de escalamiento del modo Spanner

En las siguientes muestras de código, se muestra cómo configurar RagEngineConfig en el modo de Spanner con el nivel de servicio Escalado:

Console

1. En la consola de Google Cloud , ve a la página RAG Engine.

   Ir a RAG Engine

2. Selecciona la región en la que se ejecuta tu motor de RAG.
3. Haz clic en la opción Cambiar a Spanner si aún no estás en el modo de Spanner.
4. Haz clic en Configurar RAG Engine. Aparecerá el panel Configurar RAG Engine.
5. Selecciona el nivel con el que deseas ejecutar tu RAG Engine.
6. Haz clic en Guardar.

REST

PROJECT_ID: Your project ID.
LOCATION: The region to process the request.

curl -X PATCH \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/ragEngineConfig -d "{'ragManagedDbConfig': {'spanner': {'scaled': {}}}}"

Python

from vertexai.preview import rag
import vertexai

PROJECT_ID = YOUR_PROJECT_ID
LOCATION = YOUR_RAG_ENGINE_LOCATION

# Initialize Agent Platform API once per session
vertexai.init(project=PROJECT_ID, location=LOCATION)

rag_engine_config_name=f"projects/{PROJECT_ID}/locations/{LOCATION}/ragEngineConfig"

new_rag_engine_config = rag.RagEngineConfig(
    name=rag_engine_config_name,
    rag_managed_db_config=rag.RagManagedDbConfig(mode=rag.Spanner(tier=rag.Scaled())),
)

updated_rag_engine_config = rag.rag_data.update_rag_engine_config(
    rag_engine_config=new_rag_engine_config
)

print(updated_rag_engine_config)

Actualiza tu RagEngineConfig al modo de Spanner con el nivel Basic

En los siguientes ejemplos de código, se muestra cómo establecer RagEngineConfig en el modo de Spanner con el nivel Básico:

Console

1. En la consola de Google Cloud , ve a la página RAG Engine.

   Ir a RAG Engine

2. Selecciona la región en la que se ejecuta tu motor de RAG.
3. Haz clic en la opción Cambiar a Spanner si aún no estás en el modo de Spanner.
4. Haz clic en Configurar RAG Engine. Aparecerá el panel Configurar RAG Engine.
5. Selecciona el nivel en el que deseas ejecutar tu RAG Engine.
6. Haz clic en Guardar.

REST

PROJECT_ID: Your project ID.
LOCATION: The region to process the request.

curl -X PATCH \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/ragEngineConfig -d "{'ragManagedDbConfig': {'spanner': {'basic': {}}}}"

Python

from vertexai.preview import rag
import vertexai

PROJECT_ID = YOUR_PROJECT_ID
LOCATION = YOUR_RAG_ENGINE_LOCATION

# Initialize Agent Platform API once per session
vertexai.init(project=PROJECT_ID, location=LOCATION)

rag_engine_config_name=f"projects/{PROJECT_ID}/locations/{LOCATION}/ragEngineConfig"

new_rag_engine_config = rag.RagEngineConfig(
    name=rag_engine_config_name,
    rag_managed_db_config=rag.RagManagedDbConfig(mode=rag.Spanner(tier=rag.Basic())),
)

updated_rag_engine_config = rag.rag_data.update_rag_engine_config(
    rag_engine_config=new_rag_engine_config
)

print(updated_rag_engine_config)

Actualiza tu RagEngineConfig al nivel Unprovisioned

En los siguientes ejemplos de código, se muestra cómo configurar RagEngineConfig en el modo de Spanner con el nivel sin aprovisionar. Esta acción borrará permanentemente todos los datos de tu modo de implementación de Spanner y detendrá los gastos de facturación que surjan de él.

Console

1. En la consola de Google Cloud , ve a la página RAG Engine.

   Ir a RAG Engine

2. Selecciona la región en la que se ejecuta tu motor de RAG.
3. Haz clic en la opción Cambiar a Spanner si aún no estás en el modo de Spanner.
4. Haz clic en Borrar RAG Engine. Aparecerá un diálogo de confirmación.
5. Para verificar que estás a punto de borrar tus datos en RAG Engine, ingresa delete.
6. Haz clic en Confirmar.
7. Haz clic en Guardar.

REST

PROJECT_ID: Your project ID.
LOCATION: The region to process the request.

curl -X PATCH \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/ragEngineConfig -d "{'ragManagedDbConfig': {'spanner': {'unprovisioned': {}}}}"

Python

from vertexai.preview import rag
import vertexai

PROJECT_ID = YOUR_PROJECT_ID
LOCATION = YOUR_RAG_ENGINE_LOCATION

# Initialize Agent Platform API once per session
vertexai.init(project=PROJECT_ID, location=LOCATION)

rag_engine_config_name=f"projects/{PROJECT_ID}/locations/{LOCATION}/ragEngineConfig"

new_rag_engine_config = rag.RagEngineConfig(
    name=rag_engine_config_name,
    rag_managed_db_config=rag.RagManagedDbConfig(mode=rag.Spanner(tier=rag.Unprovisioned())),
)

updated_rag_engine_config = rag.rag_data.update_rag_engine_config(
    rag_engine_config=new_rag_engine_config
)

print(updated_rag_engine_config)