REST Resource: projects.locations.collections

Ressource: Sammlung

Nachricht zur Beschreibung des Collection-Objekts

JSON-Darstellung
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "schema": {
    object
  },
  "vectorSchema": {
    string: {
      object (VectorField)
    },
    ...
  },
  "dataSchema": {
    object
  }
}
Felder
name

string

Kennung. Name der Ressource

displayName

string

Optional. Vom Nutzer angegebener Anzeigename der Sammlung

description

string

Optional. Vom Nutzer angegebene Beschreibung der Sammlung

createTime

string (Timestamp format)

Nur Ausgabe. [Nur Ausgabe] Zeitstempel der Erstellung

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

updateTime

string (Timestamp format)

Nur Ausgabe. [Nur Ausgabe] Zeitstempel der Aktualisierung

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Optional. Labels als Schlüssel/Wert-Paare.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

schema
(deprecated)

object (Struct format)

Optional. Verworfen: JSON-Schema für Daten. Verwenden Sie stattdessen „dataSchema“.

vectorSchema

map (key: string, value: object (VectorField))

Optional. Schema für Vektorfelder. Nur Vektorfelder in diesem Schema sind durchsuchbar. Feldnamen dürfen nur alphanumerische Zeichen, Unterstriche und Bindestriche enthalten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

dataSchema

object (Struct format)

Optional. JSON-Schema für Daten. Feldnamen dürfen nur alphanumerische Zeichen, Unterstriche und Bindestriche enthalten.

VectorField

Nachricht, die ein Vektorfeld beschreibt.

JSON-Darstellung
{

  // Union field vector_type_config can be only one of the following:
  "denseVector": {
    object (DenseVectorField)
  },
  "sparseVector": {
    object (SparseVectorField)
  }
  // End of list of possible types for union field vector_type_config.
}
Felder
Union-Feld vector_type_config. Konfiguration des Vektortyps. Für vector_type_config ist nur einer der folgenden Werte zulässig:
denseVector

object (DenseVectorField)

Vektorfeld mit hoher Dichte.

sparseVector

object (SparseVectorField)

Dünn besetztes Vektorfeld.

DenseVectorField

Nachricht, die ein dichtes Vektorfeld beschreibt.

JSON-Darstellung
{
  "dimensions": integer,
  "vertexEmbeddingConfig": {
    object (VertexEmbeddingConfig)
  }
}
Felder
dimensions

integer

Dimensionalität des Vektorfelds.

vertexEmbeddingConfig

object (VertexEmbeddingConfig)

Optional. Konfiguration zum Generieren von Einbettungen für das Vektorfeld. Wenn nicht angegeben, muss das Einbettungsfeld im DataObject ausgefüllt sein.

VertexEmbeddingConfig

Nachricht, die die Konfiguration zum Generieren von Einbettungen für ein Vektorfeld mit der Vertex AI Embeddings API beschreibt.

JSON-Darstellung
{
  "modelId": string,
  "textTemplate": string,
  "taskType": enum (EmbeddingTaskType)
}
Felder
modelId

string

Erforderlich. Erforderlich: ID des zu verwendenden Einbettungsmodells. Eine Liste der unterstützten Modelle finden Sie unter https://cloud.google.com/vertex-ai/generative-ai/docs/learn/models#embeddings-models.

textTemplate

string

Erforderlich. Erforderlich: Textvorlage für die Eingabe des Modells. Die Vorlage muss mindestens einen Verweis auf Felder im DataObject enthalten, z.B.: „Filmtitel: {title} ---- Filminhalt: {plot}“.

taskType

enum (EmbeddingTaskType)

Erforderlich. Erforderlich: Aufgabentyp für die Einbettungen.

EmbeddingTaskType

Stellt die Aufgabe dar, für die die Einbettungen verwendet werden.

Enums
EMBEDDING_TASK_TYPE_UNSPECIFIED Nicht angegebener Aufgabentyp.
RETRIEVAL_QUERY Gibt an, dass der angegebene Text eine Anfrage in einer Such-/Abrufeinstellung ist.
RETRIEVAL_DOCUMENT Gibt an, dass der angegebene Text ein Dokument aus dem durchsuchten Korpus ist.
SEMANTIC_SIMILARITY Gibt an, dass der angegebene Text für STS verwendet wird.
CLASSIFICATION Gibt an, dass der angegebene Text klassifiziert wird.
CLUSTERING Gibt an, dass die Einbettungen für das Clustering verwendet werden.
QUESTION_ANSWERING Gibt an, dass die Einbettungen für die Beantwortung von Fragen verwendet werden.
FACT_VERIFICATION Gibt an, dass die Einbettungen für die Faktenprüfung verwendet werden.
CODE_RETRIEVAL_QUERY Gibt an, dass die Einbettungen für den Codeabruf verwendet werden.

SparseVectorField

Dieser Typ hat keine Felder.

Nachricht, die ein dünnbesetztes Vektorfeld beschreibt.

Methoden

create

Erstellt eine neue Sammlung in einem bestimmten Projekt und an einem bestimmten Standort.

delete

Löscht eine einzelne Sammlung.

exportDataObjects

Startet einen langwierigen Vorgang zum Exportieren von DataObjects aus einer Sammlung.

get

Ruft Details zu einer einzelnen Sammlung ab.

importDataObjects

Startet einen langwierigen Vorgang zum Importieren von DataObjects in eine Sammlung.

list

Listet Sammlungen in einem bestimmten Projekt und an einem bestimmten Standort auf.

patch

Aktualisiert die Parameter einer einzelnen Sammlung.