Criar ou reutilizar uma instância da loja de exemplo

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Nesta página, mostramos como criar uma nova instância da loja de exemplo ou reutilizar uma existente. Você pode armazenar seus exemplos em um Example Store ao desenvolver seu aplicativo de LLM e extraí-los dinamicamente para usar nos comandos de LLM.

Para ensinar um LLM ou um agente usando exemplos de few-shot, primeiro crie ou reutilize uma instância da loja de exemplos para seu projeto e local, e depois faça upload de exemplos para ela.

Para cada projeto e local, é possível ter no máximo 50 instâncias da loja de exemplo. Depois de criar uma instância da Example Store, você pode compartilhá-la em vários aplicativos e agentes de LLM.

Há duas maneiras de provisionar uma instância da loja de exemplo:

• Criar uma nova instância da loja de exemplo: ao criar uma nova instância da loja de exemplo, é necessário especificar o modelo de incorporação, que a loja de exemplo usa para determinar quais exemplos são relevantes para as consultas dos usuários. A loja de exemplo oferece suporte aos seguintes modelos de embedding:

  • text-embedding-005

  • text-multilingual-embedding-002

  Não é possível mudar um modelo de incorporação depois de criar a instância da loja de exemplo. Se você quiser usar outro modelo de incorporação, crie outra loja de exemplo. Para mais informações sobre embeddings de texto, consulte Usar embeddings de texto.

• Reutilizar uma instância de Exemplos armazenados: as instâncias de Exemplos armazenados foram projetadas para serem usadas por vários agentes. Assim, você pode acessar os exemplos armazenados em vários aplicativos de LLM. Não é possível mudar o modelo de embedding ao reutilizar uma instância do Example Store.

Pré-requisitos

Antes de usar os exemplos de Python nesta página, instale e inicialize o SDK da Vertex AI para Python no seu ambiente local.

1. Execute o seguinte comando para instalar o SDK da Vertex AI para Python na Example Store.

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

2. Use o exemplo de código abaixo para importar e inicializar o SDK da Example Store.

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

   Substitua:

   • PROJECT_ID: o ID do projeto.

   • LOCATION: sua região. Somente us-central1 é aceito.

Criar uma instância de loja de exemplo

Use os exemplos a seguir para criar uma instância de loja de exemplo para um projeto e local especificados. A criação de uma instância da loja de exemplo leva alguns 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"
    }
  }
}

Reutilizar uma instância do Example Store

Use o exemplo a seguir para reutilizar uma instância da loja de exemplo para um projeto e local especificados.

import vertexai
from vertexai.preview import example_stores

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

example_store = example_stores.ExampleStore(
    "EXAMPLE_STORE_NAME")

A seguir

• Faça upload de exemplos para a instância da loja de exemplo.