Crea o reutiliza una instancia de Example Store

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta página, se muestra cómo crear una instancia nueva de Example Store o reutilizar una existente. Puedes almacenar tus ejemplos en un Almacén de ejemplos cuando desarrolles tu aplicación de LLM y recuperarlos de forma dinámica para usarlos en tus instrucciones de LLM.

Para enseñar a un LLM o a un agente con ejemplos de pocas imágenes, primero debes crear o reutilizar una instancia de Example Store para tu proyecto y ubicación, y, luego, subir ejemplos a ella.

Para cada proyecto y ubicación, puedes tener un máximo de 50 instancias de Example Store. Después de crear una instancia de Example Store, puedes compartirla en varias aplicaciones y agentes de LLM.

Existen dos maneras de aprovisionar una instancia de Example Store:

• Crea una nueva instancia de Example Store: Cuando creas una instancia nueva de Example Store, debes especificar el modelo de incorporación que Example Store usa para determinar qué ejemplos son relevantes para las consultas de los usuarios. Example Store admite los siguientes modelos de incorporación:

  • text-embedding-005

  • text-multilingual-embedding-002

  No puedes cambiar un modelo de incorporación después de crear la instancia de Example Store. Si deseas usar un modelo de incorporación diferente, debes crear otra tienda de ejemplos. Para obtener más información sobre las incorporaciones de texto, consulta Obtén incorporaciones de texto.

• Cómo volver a usar una instancia existente de Example Store: Las instancias de Example Store están diseñadas para que las usen varios agentes, de modo que puedas acceder a los ejemplos almacenados en todas las aplicaciones de LLM. No puedes cambiar el modelo de incorporación cuando reutilizas una instancia existente de Example Store.

Requisitos previos

Antes de usar las muestras de Python en esta página, instala y, luego, inicializa el SDK de Vertex AI para Python en tu entorno de Python local.

1. Ejecuta el siguiente comando para instalar el SDK de Vertex AI para Python para Example Store.

   pip install --upgrade google-cloud-aiplatform>=1.87.0

2. Usa la siguiente muestra de código para importar y, luego, inicializar el SDK de Example Store.

   import vertexai
   from vertexai.preview import example_stores
   
   vertexai.init(
     project="PROJECT_ID",
     location="LOCATION"
   )
   

   Reemplaza lo siguiente:

   • PROJECT_ID: ID del proyecto

   • LOCATION: Tu región. Solo se admite us-central1.

Crea una instancia de Example Store

Usa las siguientes muestras para crear una instancia de Example Store para un proyecto y una ubicación especificados. Ten en cuenta que la creación de una instancia de Example Store tarda unos minutos.

import vertexai
from vertexai.preview import example_stores

vertexai.init(
    project="PROJECT_ID",
    location="LOCATION"
)

my_example_store = example_stores.ExampleStore.create(
    example_store_config=example_stores.ExampleStoreConfig(
        vertex_embedding_model="EMBEDDING_MODEL"
    )
)

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/exampleStores

{
  "display_name": "DISPLAY_NAME",
  "example_store_config": {"vertex_embedding_model": EMBEDDING_MODEL}
}

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/exampleStores"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/exampleStores" | Select-Object -Expand Content

{
  "name": "projects/PROJECT_ID/locations/LOCATION/exampleStores/EXAMPLE_STORE_ID/operations/",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.CreateExampleStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2024-10-10T02:06:10.417111Z",
      "updateTime": "2024-10-10T02:06:10.417111Z"
    }
  }
}

Cómo volver a usar una instancia existente de Example Store

Usa la siguiente muestra para volver a usar una instancia de Example Store existente para un proyecto y una ubicación especificados.

import vertexai
from vertexai.preview import example_stores

vertexai.init(
    project="PROJECT_ID",
    location="LOCATION"
)

example_store = example_stores.ExampleStore(
    "EXAMPLE_STORE_NAME")

¿Qué sigue?

• Sube ejemplos a la instancia de Example Store.