Agent Platform API . projects . locations . skills . revisions

Instance Methods

close()

Close httplib2 connections.

get(name, x__xgafv=None)

Get a Skill Revision.

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List Skill Revisions for a Skill.

list_next()

Retrieves the next page of results.

Method Details

close()
Close httplib2 connections.
get(name, x__xgafv=None)
Get a Skill Revision.

Args:
  name: string, Required. The resource name of the Skill Revision to retrieve. Format: `projects/{project}/locations/{location}/skills/{skill}/revisions/{revision}` (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A revision of a Skill.
  "createTime": "A String", # Output only. Timestamp when this Skill Revision was created.
  "name": "A String", # Identifier. The resource name of the Skill Revision. Format: `projects/{project}/locations/{location}/skills/{skill}/revisions/{revision}`
  "skill": { # A skill. # Output only. The state of the Skill at this revision. TODO(b/503772996) Use a different proto for skill data included in skill revision
    "compatibility": "A String", # Optional. Specifies the compatibility of the Skill. Indicates environment requirements (intended product, system packages, network access, etc.). This should align with `compatibility` in the `SKILL.md` file.
    "createTime": "A String", # Output only. Timestamp when this Skill was created.
    "description": "A String", # Required. Describes the Skill. Should describe both what the skill does and when to use it. Should include specific keywords that help agents identify relevant tasks. This should align with `description` in the `SKILL.md` file.
    "displayName": "A String", # Required. Provides the display name of the Skill. This should align with `name` in the `SKILL.md` file.
    "labels": { # The labels with user-defined metadata to organize Skills.
      "a_key": "A String",
    },
    "license": "A String", # Optional. Specifies the license of the Skill. This should be an SPDX license identifier (e.g., "MIT", "Apache-2.0"). See https://spdx.org/licenses/. This should align with `license` in the `SKILL.md` file.
    "name": "A String", # Identifier. The resource name of the Skill. Format: `projects/{project}/locations/{location}/skills/{skill}`
    "sha256": "A String", # Output only. The SHA256 checksum of the zipped filesystem.
    "skillSource": "A String", # Output only. The source of the Skill.
    "state": "A String", # Output only. The state of the Skill.
    "updateTime": "A String", # Output only. Timestamp when this Skill was most recently updated.
    "zippedFilesystem": "A String", # Required. Provides the zipped filesystem of the Skill. This should contain the `SKILL.md` file at the root of the zip and optional directories for scripts, references, and assets. Directory should align with the directory structure specified at https://agentskills.io/specification#directory-structure.
  },
  "state": "A String", # Output only. The state of the Skill Revision.
}
list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)
List Skill Revisions for a Skill.

Args:
  parent: string, Required. The resource name of the Skill to list revisions for. Format: `projects/{project}/locations/{location}/skills/{skill}` (required)
  filter: string, Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields (equality match only): * `labels`
  pageSize: integer, Optional. The standard list page size.
  pageToken: string, Optional. The standard list page token.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response message for SkillRegistryService.ListSkillRevisions.
  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
  "skillRevisions": [ # The list of Skill Revisions in the request page.
    { # A revision of a Skill.
      "createTime": "A String", # Output only. Timestamp when this Skill Revision was created.
      "name": "A String", # Identifier. The resource name of the Skill Revision. Format: `projects/{project}/locations/{location}/skills/{skill}/revisions/{revision}`
      "skill": { # A skill. # Output only. The state of the Skill at this revision. TODO(b/503772996) Use a different proto for skill data included in skill revision
        "compatibility": "A String", # Optional. Specifies the compatibility of the Skill. Indicates environment requirements (intended product, system packages, network access, etc.). This should align with `compatibility` in the `SKILL.md` file.
        "createTime": "A String", # Output only. Timestamp when this Skill was created.
        "description": "A String", # Required. Describes the Skill. Should describe both what the skill does and when to use it. Should include specific keywords that help agents identify relevant tasks. This should align with `description` in the `SKILL.md` file.
        "displayName": "A String", # Required. Provides the display name of the Skill. This should align with `name` in the `SKILL.md` file.
        "labels": { # The labels with user-defined metadata to organize Skills.
          "a_key": "A String",
        },
        "license": "A String", # Optional. Specifies the license of the Skill. This should be an SPDX license identifier (e.g., "MIT", "Apache-2.0"). See https://spdx.org/licenses/. This should align with `license` in the `SKILL.md` file.
        "name": "A String", # Identifier. The resource name of the Skill. Format: `projects/{project}/locations/{location}/skills/{skill}`
        "sha256": "A String", # Output only. The SHA256 checksum of the zipped filesystem.
        "skillSource": "A String", # Output only. The source of the Skill.
        "state": "A String", # Output only. The state of the Skill.
        "updateTime": "A String", # Output only. Timestamp when this Skill was most recently updated.
        "zippedFilesystem": "A String", # Required. Provides the zipped filesystem of the Skill. This should contain the `SKILL.md` file at the root of the zip and optional directories for scripts, references, and assets. Directory should align with the directory structure specified at https://agentskills.io/specification#directory-structure.
      },
      "state": "A String", # Output only. The state of the Skill Revision.
    },
  ],
}
list_next()
Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.