← Back to packages

Package intrinsic_proto.catalog.v1

Service AssetCatalog

Message Asset

Message AssetDeploymentData

Message AssetFilter

Message CreateAssetRequest

Message DataDeploymentData

Message DataMetadata

Message GetAssetRequest

Message HardwareDeviceDeploymentData

Message HardwareDeviceMetadata

Message ListAssetsRequest

Message ListAssetsResponse

Message PrepareReferencedDataRequest

Message PrepareReferencedDataResponse

Message ReleaseMetadata

Message SceneObjectDeploymentData

Message ServiceDeploymentData

Message ServiceMetadata

Message SkillDeploymentData

Message UpdateReleaseMetadataRequest

Services

service AssetCatalog intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Provides access to assets in the asset catalog.

Lists (views of) assets that satisfy the specified constraints.

Adds a new version of an asset to the catalog.

The caller must have access to the organization that owns the package (asset.metadata.id_version.package) to create an asset within it. The first two elements of the package are the top-level package (eg "ai.intrinsic"). If the package does not exist, this will fail.

Updates the release metadata of the specified asset.

NOTE: If this RPC is used to remove the org-private flag on an asset, that flag CANNOT be re-added later.

Prepares a ReferencedData so that it can be included in an asset that will be released to the catalog.

The prepared form of the data to include in the asset is returned.

This RPC is streaming in order to enable referenced files to be uploaded in chunks while preparing the data. The client should begin by opening a stream and sending the ReferencedData in an initial request. If the ReferencedData references a file, then the client should then send chunks of the file data until the entire file has been sent. Finally, the client should close the stream.

Messages

message Asset intrinsic/assets/catalog/proto/v1/asset_catalog.proto

A specific version of an asset in the catalog.

Field Type Description
1 metadata intrinsic_proto.assets.Metadata

General metadata that apply to all assets.

3 deployment_data intrinsic_proto.catalog.v1.Asset.AssetDeploymentData

Asset deployment data.

5 release_metadata intrinsic_proto.catalog.v1.ReleaseMetadata

Release-related metadata about the asset.

oneof asset_specific_metadata
2 service_specific_metadata intrinsic_proto.catalog.v1.Asset.ServiceMetadata
4 data_specific_metadata intrinsic_proto.catalog.v1.Asset.DataMetadata
6 hardware_device_specific_metadata intrinsic_proto.catalog.v1.Asset.HardwareDeviceMetadata

message AssetDeploymentData (Nested in intrinsic_proto.catalog.v1.Asset ) intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
oneof asset_specific_deployment_data
1 service_specific_deployment_data intrinsic_proto.catalog.v1.Asset.ServiceDeploymentData
2 skill_specific_deployment_data intrinsic_proto.catalog.v1.Asset.SkillDeploymentData
3 data_specific_deployment_data intrinsic_proto.catalog.v1.Asset.DataDeploymentData
4 scene_object_specific_deployment_data intrinsic_proto.catalog.v1.Asset.SceneObjectDeploymentData
5 hardware_device_specific_deployment_data intrinsic_proto.catalog.v1.Asset.HardwareDeviceDeploymentData

message AssetFilter (Nested in intrinsic_proto.catalog.v1.ListAssetsRequest ) intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Used to filter returned assets.

Field Type Description
1 asset_types repeated intrinsic_proto.assets.AssetType

Filter assets by type (OR).

2 id optional string

Filter assets by exact ID. Either id or only_default must be set.

3 display_name optional string

Filter assets by display name (case-insensitive substring search).

4 asset_tag optional intrinsic_proto.assets.AssetTag

Filter assets by asset tag.

5 only_default optional bool

Only return default versions of assets.

6 provides repeated string

Filter by assets that provide all of the specified interfaces (exact match).

The nature of the interface depends on the asset type, but is always represented as a string. For example, a Data asset provides a proto of a specific type, and its "interface" is the fully qualified name of that proto. A Service can provide a gRPC service, and its "interface" is the fully qualified proto prefix of that gRPC service.

message CreateAssetRequest intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 asset intrinsic_proto.catalog.v1.Asset

The asset to create.

2 org_private optional bool

Use asset.release_metadata.org_private instead.

message DataDeploymentData (Nested in intrinsic_proto.catalog.v1.Asset ) intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 data intrinsic_proto.data.v1.DataAsset

message DataMetadata (Nested in intrinsic_proto.catalog.v1.Asset ) intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 proto_name string

The fully qualified proto name of the data payload.

message GetAssetRequest intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
4 view intrinsic_proto.catalog.AssetViewType

The type of view to return. Defaults to ASSET_VIEW_TYPE_BASIC.

oneof asset_id
1 id intrinsic_proto.assets.Id

The asset ID. Uses the default version of the asset.

2 id_version intrinsic_proto.assets.IdVersion

The asset ID and version.

message HardwareDeviceDeploymentData (Nested in intrinsic_proto.catalog.v1.Asset ) intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 manifest intrinsic_proto.hardware_devices.v1.ProcessedHardwareDeviceManifest

The hardware device manifest.

2 file_descriptor_set google.protobuf.FileDescriptorSet

The file descriptor set for the hardware device and all of its composed assets.

message HardwareDeviceMetadata (Nested in intrinsic_proto.catalog.v1.Asset ) intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 service_proto_prefixes repeated string

The list of gRPC service names that the hardware device exposes.

message ListAssetsRequest intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 page_size int64

Maximum number of assets to return (fewer may be returned).

If unspecified (or set to 0), defaults to 20.

The maximum value is 200; Larger values will be coerced to the maximum.

2 page_token string

A page token received from a previous ListAssets call. Provide this token to retrieve the next page of results.

When paginating, all other parameters provided to ListAssets must match the call that provided the page token.

If unspecified, up to the first page_size matching assets will be returned.

3 view intrinsic_proto.catalog.AssetViewType

The type of view to return. Defaults to ASSET_VIEW_TYPE_BASIC.

4 strict_filter optional intrinsic_proto.catalog.v1.ListAssetsRequest.AssetFilter

Filter to apply when listing assets. Required: Either id or only_default must be set.

5 order_by intrinsic_proto.assets.v1.OrderBy

Order by which to sort the assets.

6 sort_descending bool

If true, sort assets in descending order.

message ListAssetsResponse intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 assets repeated intrinsic_proto.catalog.v1.Asset

The assets that satisfied the request.

2 next_page_token string

A token that can be sent as ListAssetsRequest.page_token to retrieve the next page of results.

If this field is empty, there are no subsequent pages.

message PrepareReferencedDataRequest intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
oneof data
1 referenced_data intrinsic_proto.data.v1.ReferencedData

The ReferencedData to prepare.

2 data_chunk bytes

A chunk of the data to prepare.

message PrepareReferencedDataResponse intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 referenced_data intrinsic_proto.data.v1.ReferencedData

The prepared ReferencedData.

message ReleaseMetadata intrinsic/assets/catalog/proto/v1/release_metadata.proto

Release metadata about an asset version in the AssetCatalog.

Field Type Description
1 default bool

True if this version becomes the default version. Assets must have a default version to be browsable in the catalog. Setting a new default version unsets the previous one.

2 org_private bool

True if the released asset's visibility is restricted to members of the owning organization, overriding other permissions. Ideal for work-in-progress versions or internal test versions that are not ready for use outside of your organization.

message SceneObjectDeploymentData (Nested in intrinsic_proto.catalog.v1.Asset ) intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 manifest intrinsic_proto.scene_objects.ProcessedSceneObjectManifest

The scene object manifest.

message ServiceDeploymentData (Nested in intrinsic_proto.catalog.v1.Asset ) intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 manifest intrinsic_proto.services.ProcessedServiceManifest

The service manifest.

message ServiceMetadata (Nested in intrinsic_proto.catalog.v1.Asset ) intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 service_proto_prefixes repeated string

The list of gRPC service names that the service exposes.

message SkillDeploymentData (Nested in intrinsic_proto.catalog.v1.Asset ) intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 manifest intrinsic_proto.skills.ProcessedSkillManifest

The skill manifest

message UpdateReleaseMetadataRequest intrinsic/assets/catalog/proto/v1/asset_catalog.proto

Field Type Description
1 id_version intrinsic_proto.assets.IdVersion

The IDVersion of the asset to update.

2 release_metadata intrinsic_proto.catalog.v1.ReleaseMetadata

The release metadata to update.

3 update_mask google.protobuf.FieldMask

The list of fields to update.