Como alternar entre os modos

Os modos de implantação são uma configuração para envolvidos no projeto. Alternar entre os dois modos não move nem exclui seus dados do outro modo. Use a API UpdateRagEngineConfig para alternar entre os modos de implantação sem servidor e do Spanner. Também é possível usar essa API para definir o nível no modo de implantação do Spanner ou desprovisionar o modo do Spanner para interromper o faturamento. Use a API GetRagEngineConfig para ler as informações do modo de implantação atual.

Alternar para o modo sem servidor

Os exemplos de código a seguir demonstram como alternar o RagEngineConfig para o modo sem servidor:

Console

  1. No console do Google Cloud , acesse a página RAG Engine.

    Acessar o RAG Engine

  2. Selecione a região em que o RAG Engine está em execução.
  3. Clique na opção Mudar para sem servidor. Talvez ele não esteja visível se você estiver no modo sem servidor. Para verificar o modo atual, consulte o rótulo no canto superior direito da 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)

Como mudar para o modo Spanner

Os exemplos de código a seguir demonstram como alternar o RagEngineConfig para o modo Spanner. Se você já usou o modo Spanner e escolheu um nível, não é necessário fornecê-lo explicitamente ao alternar. Caso contrário, consulte os exemplos de código abaixo para saber como mudar para o modo Spanner ao fornecer um nível.

Console

  1. No console do Google Cloud , acesse a página RAG Engine.

    Acessar o RAG Engine

  2. Selecione a região em que o RAG Engine está em execução.
  3. Clique na opção Mudar para o Spanner. Talvez ela não esteja visível se você estiver no modo Spanner. Você pode verificar o modo atual no rótulo do 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)

Ler o RagEngineConfig atual

Os exemplos de código a seguir demonstram como ler o RagEngineConfig para ver qual modo e nível foram escolhidos:

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)

Atualizar o nível no modo Spanner

Os exemplos de código a seguir demonstram como atualizar o nível no modo Spanner:

Atualize seu RagEngineConfig para o nível escalonado do modo Spanner

Os exemplos de código a seguir demonstram como definir o RagEngineConfig para o modo Spanner com o nível escalonado:

Console

  1. No console do Google Cloud , acesse a página RAG Engine.

    Acessar o RAG Engine

  2. Selecione a região em que o RAG Engine está em execução.
  3. Clique na opção Mudar para o Spanner, se ainda não estiver no modo Spanner.
  4. Clique em Configurar o mecanismo RAG. O painel Configurar o mecanismo RAG é exibido.
  5. Selecione o nível em que você quer executar o mecanismo RAG.
  6. Clique em Salvar.

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)

Atualize o RagEngineConfig para o modo Spanner com o nível Basic

Os exemplos de código a seguir demonstram como definir o RagEngineConfig para o modo Spanner com o nível Basic:

Console

  1. No console do Google Cloud , acesse a página RAG Engine.

    Acessar o RAG Engine

  2. Selecione a região em que o RAG Engine está em execução.
  3. Clique na opção Mudar para o Spanner, se ainda não estiver no modo Spanner.
  4. Clique em Configurar o mecanismo RAG. O painel Configurar o mecanismo RAG é exibido.
  5. Selecione o nível em que você quer executar o RAG Engine.
  6. Clique em Salvar.

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)

Atualizar o RagEngineConfig para o nível não provisionado

Os exemplos de código a seguir demonstram como definir o RagEngineConfig para o modo Spanner com o nível não provisionado. Isso vai excluir permanentemente todos os dados do modo de implantação do Spanner e interromper as despesas de faturamento decorrentes dele.

Console

  1. No console do Google Cloud , acesse a página RAG Engine.

    Acessar o RAG Engine

  2. Selecione a região em que o RAG Engine está em execução.
  3. Clique na opção Mudar para o Spanner, se ainda não estiver no modo Spanner.
  4. Clique em Excluir mecanismo RAG. Uma caixa de diálogo de confirmação é exibida.
  5. Confirme que você quer excluir seus dados no RAG Engine digitando delete.
  6. Clique em Confirmar.
  7. Clique em Salvar.

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)