Beispiel-Shop-Instanz erstellen oder wiederverwenden

Auf dieser Seite wird beschrieben, wie Sie eine neue Example Store-Instanz erstellen oder eine vorhandene wiederverwenden. Sie können Ihre Beispiele in einem Example Store speichern, wenn Sie Ihre LLM-Anwendung entwickeln, und sie dynamisch abrufen, um sie in Ihren LLM-Prompts zu verwenden.

Wenn Sie ein LLM oder einen Agenten mit Beispielen für Schnellerstellungen trainieren möchten, müssen Sie zuerst eine Example Store-Instanz für Ihr Projekt und Ihren Standort erstellen oder wiederverwenden und dann Beispiele hochladen.

Für jedes Projekt und jeden Standort können Sie maximal 50 Example Store-Instanzen haben. Nachdem Sie eine Example Store-Instanz erstellt haben, können Sie sie für mehrere LLM-Anwendungen und ‑Agents freigeben.

Es gibt zwei Möglichkeiten, eine Example Store-Instanz bereitzustellen:

• Neue Example Store-Instanz erstellen: Wenn Sie eine neue Example Store-Instanz erstellen, müssen Sie das Einbettungsmodell angeben, das Example Store verwendet, um zu ermitteln, welche Beispiele für die Anfragen der Nutzer relevant sind. Example Store unterstützt die folgenden Einbettungsmodelle:

  • text-embedding-005

  • text-multilingual-embedding-002

  Sie können ein Einbettungsmodell nicht mehr ändern, nachdem Sie die Example Store-Instanz erstellt haben. Wenn Sie ein anderes Einbettungsmodell verwenden möchten, müssen Sie einen weiteren Beispielspeicher erstellen. Weitere Informationen zu Texteinbettungen finden Sie unter Texteinbettungen abrufen.

• Vorhandene Example Store-Instanz wiederverwenden: Example Store-Instanzen sind für die Verwendung durch mehrere Agents konzipiert. Sie können also in allen LLM-Anwendungen auf die gespeicherten Beispiele zugreifen. Wenn Sie eine vorhandene Example Store-Instanz wiederverwenden, können Sie das Einbettungsmodell nicht ändern.

Vorbereitung

Bevor Sie die Python-Beispiele auf dieser Seite verwenden, installieren und initialisieren Sie das Vertex AI SDK für Python in Ihrer lokalen Python-Umgebung.

1. Führen Sie den folgenden Befehl aus, um das Vertex AI SDK für Python für Example Store zu installieren.

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

2. Verwenden Sie das folgende Codebeispiel, um das SDK für Example Store zu importieren und zu initialisieren.

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

   Ersetzen Sie Folgendes:

   • PROJECT_ID: Ihre Projekt-ID.

   • LOCATION: Ihre Region. Nur us-central1 wird unterstützt.

Example Store-Instanz erstellen

Verwenden Sie die folgenden Beispiele, um eine Example Store-Instanz für ein bestimmtes Projekt und einen bestimmten Standort zu erstellen. Das Erstellen einer Example Store-Instanz dauert einige Minuten.

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"
    }
  }
}

Vorhandene Example Store-Instanz wiederverwenden

Verwenden Sie das folgende Beispiel, um eine vorhandene Beispielshop-Instanz für ein bestimmtes Projekt und einen bestimmten Standort wiederzuverwenden.

import vertexai
from vertexai.preview import example_stores

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

example_store = example_stores.ExampleStore(
    "EXAMPLE_STORE_NAME")

Nächste Schritte

• Beispiele in die Example Store-Instanz hochladen