contexts

Creates, updates, deletes, gets or lists a contexts resource.

Overview

Name	contexts
Type	Resource
Id	google.aiplatform.contexts

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	Immutable. The resource name of the Context.
createTime	string (google-datetime)	Output only. Timestamp when this Context was created.
description	string	Description of the Context
displayName	string	User provided display name of the Context. May be up to 128 Unicode characters.
etag	string	An eTag used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
labels	object	The labels with user-defined metadata to organize your Contexts. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Context (System labels are excluded).
metadata	object	Properties of the Context. Top level metadata keys' heading and trailing spaces will be trimmed. The size of this field should not exceed 200KB.
parentContexts	array	Output only. A list of resource names of Contexts that are parents of this Context. A Context may have at most 10 parent_contexts.
schemaTitle	string	The title of the schema describing the metadata. Schema title and version is expected to be registered in earlier Create Schema calls. And both are used together as unique identifiers to identify schemas within the local metadata store.
schemaVersion	string	The version of the schema in schema_name to use. Schema title and version is expected to be registered in earlier Create Schema calls. And both are used together as unique identifiers to identify schemas within the local metadata store.
updateTime	string (google-datetime)	Output only. Timestamp when this Context was last updated.

list

Name	Datatype	Description
name	string	Immutable. The resource name of the Context.
createTime	string (google-datetime)	Output only. Timestamp when this Context was created.
description	string	Description of the Context
displayName	string	User provided display name of the Context. May be up to 128 Unicode characters.
etag	string	An eTag used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
labels	object	The labels with user-defined metadata to organize your Contexts. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Context (System labels are excluded).
metadata	object	Properties of the Context. Top level metadata keys' heading and trailing spaces will be trimmed. The size of this field should not exceed 200KB.
parentContexts	array	Output only. A list of resource names of Contexts that are parents of this Context. A Context may have at most 10 parent_contexts.
schemaTitle	string	The title of the schema describing the metadata. Schema title and version is expected to be registered in earlier Create Schema calls. And both are used together as unique identifiers to identify schemas within the local metadata store.
schemaVersion	string	The version of the schema in schema_name to use. Schema title and version is expected to be registered in earlier Create Schema calls. And both are used together as unique identifiers to identify schemas within the local metadata store.
updateTime	string (google-datetime)	Output only. Timestamp when this Context was last updated.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, metadataStoresId, contextsId		Retrieves a specific Context.
list	select	projectsId, locationsId, metadataStoresId	filter, orderBy, pageSize, pageToken	Lists Contexts on the MetadataStore.
create	insert	projectsId, locationsId, metadataStoresId	contextId	Creates a Context associated with a MetadataStore.
patch	update	projectsId, locationsId, metadataStoresId, contextsId	allowMissing, updateMask	Updates a stored Context.
delete	delete	projectsId, locationsId, metadataStoresId, contextsId	etag, force	Deletes a stored Context.
add_context_artifacts_and_executions	exec	projectsId, locationsId, metadataStoresId, contextsId		Adds a set of Artifacts and Executions to a Context. If any of the Artifacts or Executions have already been added to a Context, they are simply skipped.
add_context_children	exec	projectsId, locationsId, metadataStoresId, contextsId		Adds a set of Contexts as children to a parent Context. If any of the child Contexts have already been added to the parent Context, they are simply skipped. If this call would create a cycle or cause any Context to have more than 10 parents, the request will fail with an INVALID_ARGUMENT error.
purge	exec	projectsId, locationsId, metadataStoresId		Purges Contexts.
remove_context_children	exec	projectsId, locationsId, metadataStoresId, contextsId		Remove a set of children contexts from a parent Context. If any of the child Contexts were NOT added to the parent Context, they are simply skipped.
retrieve_contexts	exec	projectsId, locationsId		Retrieves relevant contexts for a query.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
contextsId	string
locationsId	string
metadataStoresId	string
projectsId	string
allowMissing	boolean
contextId	string
etag	string
filter	string
force	boolean
orderBy	string
pageSize	integer (int32)
pageToken	string
updateMask	string (google-fieldmask)

SELECT examples

get

Retrieves a specific Context.

SELECT
name,
createTime,
description,
displayName,
etag,
labels,
metadata,
parentContexts,
schemaTitle,
schemaVersion,
updateTime
FROM google.aiplatform.contexts
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND metadataStoresId = '{{ metadataStoresId }}' -- required
AND contextsId = '{{ contextsId }}' -- required
;

list

Lists Contexts on the MetadataStore.

SELECT
name,
createTime,
description,
displayName,
etag,
labels,
metadata,
parentContexts,
schemaTitle,
schemaVersion,
updateTime
FROM google.aiplatform.contexts
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND metadataStoresId = '{{ metadataStoresId }}' -- required
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}'
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

INSERT examples

create

Creates a Context associated with a MetadataStore.

INSERT INTO google.aiplatform.contexts (
data__description,
data__displayName,
data__etag,
data__labels,
data__metadata,
data__name,
data__schemaTitle,
data__schemaVersion,
projectsId,
locationsId,
metadataStoresId,
contextId
)
SELECT 
'{{ description }}',
'{{ displayName }}',
'{{ etag }}',
'{{ labels }}',
'{{ metadata }}',
'{{ name }}',
'{{ schemaTitle }}',
'{{ schemaVersion }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ metadataStoresId }}',
'{{ contextId }}'
RETURNING
name,
createTime,
description,
displayName,
etag,
labels,
metadata,
parentContexts,
schemaTitle,
schemaVersion,
updateTime
;

Manifest

# Description fields are for documentation purposes
- name: contexts
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the contexts resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the contexts resource.
  - name: metadataStoresId
    value: "{{ metadataStoresId }}"
    description: Required parameter for the contexts resource.
  - name: description
    value: "{{ description }}"
    description: |
      Description of the Context
  - name: displayName
    value: "{{ displayName }}"
    description: |
      User provided display name of the Context. May be up to 128 Unicode characters.
  - name: etag
    value: "{{ etag }}"
    description: |
      An eTag used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
  - name: labels
    value: "{{ labels }}"
    description: |
      The labels with user-defined metadata to organize your Contexts. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Context (System labels are excluded).
  - name: metadata
    value: "{{ metadata }}"
    description: |
      Properties of the Context. Top level metadata keys' heading and trailing spaces will be trimmed. The size of this field should not exceed 200KB.
  - name: name
    value: "{{ name }}"
    description: |
      Immutable. The resource name of the Context.
  - name: schemaTitle
    value: "{{ schemaTitle }}"
    description: |
      The title of the schema describing the metadata. Schema title and version is expected to be registered in earlier Create Schema calls. And both are used together as unique identifiers to identify schemas within the local metadata store.
  - name: schemaVersion
    value: "{{ schemaVersion }}"
    description: |
      The version of the schema in schema_name to use. Schema title and version is expected to be registered in earlier Create Schema calls. And both are used together as unique identifiers to identify schemas within the local metadata store.
  - name: contextId
    value: "{{ contextId }}"

UPDATE examples

patch

Updates a stored Context.

UPDATE google.aiplatform.contexts
SET 
data__description = '{{ description }}',
data__displayName = '{{ displayName }}',
data__etag = '{{ etag }}',
data__labels = '{{ labels }}',
data__metadata = '{{ metadata }}',
data__name = '{{ name }}',
data__schemaTitle = '{{ schemaTitle }}',
data__schemaVersion = '{{ schemaVersion }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND metadataStoresId = '{{ metadataStoresId }}' --required
AND contextsId = '{{ contextsId }}' --required
AND allowMissing = {{ allowMissing}}
AND updateMask = '{{ updateMask}}'
RETURNING
name,
createTime,
description,
displayName,
etag,
labels,
metadata,
parentContexts,
schemaTitle,
schemaVersion,
updateTime;

DELETE examples

delete

Deletes a stored Context.

DELETE FROM google.aiplatform.contexts
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND metadataStoresId = '{{ metadataStoresId }}' --required
AND contextsId = '{{ contextsId }}' --required
AND etag = '{{ etag }}'
AND force = '{{ force }}'
;

Lifecycle Methods

add_context_artifacts_and_executions

Adds a set of Artifacts and Executions to a Context. If any of the Artifacts or Executions have already been added to a Context, they are simply skipped.

EXEC google.aiplatform.contexts.add_context_artifacts_and_executions 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@metadataStoresId='{{ metadataStoresId }}' --required, 
@contextsId='{{ contextsId }}' --required 
@@json=
'{
"artifacts": "{{ artifacts }}", 
"executions": "{{ executions }}"
}'
;

add_context_children

Adds a set of Contexts as children to a parent Context. If any of the child Contexts have already been added to the parent Context, they are simply skipped. If this call would create a cycle or cause any Context to have more than 10 parents, the request will fail with an INVALID_ARGUMENT error.

EXEC google.aiplatform.contexts.add_context_children 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@metadataStoresId='{{ metadataStoresId }}' --required, 
@contextsId='{{ contextsId }}' --required 
@@json=
'{
"childContexts": "{{ childContexts }}"
}'
;

purge

Purges Contexts.

EXEC google.aiplatform.contexts.purge 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@metadataStoresId='{{ metadataStoresId }}' --required 
@@json=
'{
"filter": "{{ filter }}", 
"force": {{ force }}
}'
;

remove_context_children

Remove a set of children contexts from a parent Context. If any of the child Contexts were NOT added to the parent Context, they are simply skipped.

EXEC google.aiplatform.contexts.remove_context_children 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@metadataStoresId='{{ metadataStoresId }}' --required, 
@contextsId='{{ contextsId }}' --required 
@@json=
'{
"childContexts": "{{ childContexts }}"
}'
;

retrieve_contexts

Retrieves relevant contexts for a query.

EXEC google.aiplatform.contexts.retrieve_contexts 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required 
@@json=
'{
"query": "{{ query }}", 
"vertexRagStore": "{{ vertexRagStore }}"
}'
;