toolsets
Creates, updates, deletes, gets or lists a toolsets resource.
Overview
| Name | toolsets |
| Type | Resource |
| Id | google.ces.toolsets |
Fields
The following fields are returned by SELECT queries:
- get
- list
| Name | Datatype | Description |
|---|---|---|
name | string | Identifier. The unique identifier of the toolset. Format: projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset} |
connectorToolset | object | Optional. A toolset that generates tools from an Integration Connectors Connection. (id: ConnectorToolset) |
createTime | string (google-datetime) | Output only. Timestamp when the toolset was created. |
description | string | Optional. The description of the toolset. |
displayName | string | Optional. The display name of the toolset. Must be unique within the same app. |
etag | string | ETag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes. |
executionType | string | Optional. The execution type of the tools in the toolset. (EXECUTION_TYPE_UNSPECIFIED, SYNCHRONOUS, ASYNCHRONOUS) |
mcpToolset | object | Optional. A toolset that contains a list of tools that are offered by the MCP server. (id: McpToolset) |
openApiToolset | object | Optional. A toolset that contains a list of tools that are defined by an OpenAPI schema. (id: OpenApiToolset) |
timeout | string (google-duration) | Optional. The timeout for the toolset execution. If not set, the default timeout is 30 seconds for SYNCHRONOUS toolsets and 60 seconds for ASYNCHRONOUS toolsets. |
toolFakeConfig | object | Optional. Configuration for tools behavior in fake mode. (id: ToolFakeConfig) |
updateTime | string (google-datetime) | Output only. Timestamp when the toolset was last updated. |
| Name | Datatype | Description |
|---|---|---|
name | string | Identifier. The unique identifier of the toolset. Format: projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset} |
connectorToolset | object | Optional. A toolset that generates tools from an Integration Connectors Connection. (id: ConnectorToolset) |
createTime | string (google-datetime) | Output only. Timestamp when the toolset was created. |
description | string | Optional. The description of the toolset. |
displayName | string | Optional. The display name of the toolset. Must be unique within the same app. |
etag | string | ETag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes. |
executionType | string | Optional. The execution type of the tools in the toolset. (EXECUTION_TYPE_UNSPECIFIED, SYNCHRONOUS, ASYNCHRONOUS) |
mcpToolset | object | Optional. A toolset that contains a list of tools that are offered by the MCP server. (id: McpToolset) |
openApiToolset | object | Optional. A toolset that contains a list of tools that are defined by an OpenAPI schema. (id: OpenApiToolset) |
timeout | string (google-duration) | Optional. The timeout for the toolset execution. If not set, the default timeout is 30 seconds for SYNCHRONOUS toolsets and 60 seconds for ASYNCHRONOUS toolsets. |
toolFakeConfig | object | Optional. Configuration for tools behavior in fake mode. (id: ToolFakeConfig) |
updateTime | string (google-datetime) | Output only. Timestamp when the toolset was last updated. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | projectsId, locationsId, appsId, toolsetsId | Gets details of the specified toolset. | |
list | select | projectsId, locationsId, appsId | filter, orderBy, pageSize, pageToken | Lists toolsets in the given app. |
create | insert | projectsId, locationsId, appsId | toolsetId | Creates a new toolset in the given app. |
patch | update | projectsId, locationsId, appsId, toolsetsId | updateMask | Updates the specified toolset. |
delete | delete | projectsId, locationsId, appsId, toolsetsId | force, etag | Deletes the specified toolset. |
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 |
|---|---|---|
appsId | string | |
locationsId | string | |
projectsId | string | |
toolsetsId | string | |
etag | string | |
filter | string | |
force | boolean | |
orderBy | string | |
pageSize | integer (int32) | |
pageToken | string | |
toolsetId | string | |
updateMask | string (google-fieldmask) |
SELECT examples
- get
- list
Gets details of the specified toolset.
SELECT
name,
connectorToolset,
createTime,
description,
displayName,
etag,
executionType,
mcpToolset,
openApiToolset,
timeout,
toolFakeConfig,
updateTime
FROM google.ces.toolsets
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND appsId = '{{ appsId }}' -- required
AND toolsetsId = '{{ toolsetsId }}' -- required
;
Lists toolsets in the given app.
SELECT
name,
connectorToolset,
createTime,
description,
displayName,
etag,
executionType,
mcpToolset,
openApiToolset,
timeout,
toolFakeConfig,
updateTime
FROM google.ces.toolsets
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND appsId = '{{ appsId }}' -- required
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}'
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;
INSERT examples
- create
- Manifest
Creates a new toolset in the given app.
INSERT INTO google.ces.toolsets (
data__name,
data__displayName,
data__mcpToolset,
data__timeout,
data__description,
data__connectorToolset,
data__toolFakeConfig,
data__etag,
data__executionType,
data__openApiToolset,
projectsId,
locationsId,
appsId,
toolsetId
)
SELECT
'{{ name }}',
'{{ displayName }}',
'{{ mcpToolset }}',
'{{ timeout }}',
'{{ description }}',
'{{ connectorToolset }}',
'{{ toolFakeConfig }}',
'{{ etag }}',
'{{ executionType }}',
'{{ openApiToolset }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ appsId }}',
'{{ toolsetId }}'
RETURNING
name,
connectorToolset,
createTime,
description,
displayName,
etag,
executionType,
mcpToolset,
openApiToolset,
timeout,
toolFakeConfig,
updateTime
;
# Description fields are for documentation purposes
- name: toolsets
props:
- name: projectsId
value: "{{ projectsId }}"
description: Required parameter for the toolsets resource.
- name: locationsId
value: "{{ locationsId }}"
description: Required parameter for the toolsets resource.
- name: appsId
value: "{{ appsId }}"
description: Required parameter for the toolsets resource.
- name: name
value: "{{ name }}"
description: |
Identifier. The unique identifier of the toolset. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}`
- name: displayName
value: "{{ displayName }}"
description: |
Optional. The display name of the toolset. Must be unique within the same app.
- name: mcpToolset
description: |
Optional. A toolset that contains a list of tools that are offered by the MCP server.
value:
serverAddress: "{{ serverAddress }}"
customHeaders: "{{ customHeaders }}"
tlsConfig:
caCerts:
- displayName: "{{ displayName }}"
cert: "{{ cert }}"
serviceDirectoryConfig:
service: "{{ service }}"
apiAuthentication:
bearerTokenConfig:
token: "{{ token }}"
serviceAccountAuthConfig:
serviceAccount: "{{ serviceAccount }}"
scopes:
- "{{ scopes }}"
apiKeyConfig:
keyName: "{{ keyName }}"
requestLocation: "{{ requestLocation }}"
apiKeySecretVersion: "{{ apiKeySecretVersion }}"
oauthConfig:
tokenEndpoint: "{{ tokenEndpoint }}"
oauthGrantType: "{{ oauthGrantType }}"
clientId: "{{ clientId }}"
clientSecretVersion: "{{ clientSecretVersion }}"
scopes:
- "{{ scopes }}"
serviceAgentIdTokenAuthConfig: "{{ serviceAgentIdTokenAuthConfig }}"
toolOverrides:
- descriptionOverride: "{{ descriptionOverride }}"
snapshot:
description: "{{ description }}"
inputSchema:
type: "{{ type }}"
minimum: {{ minimum }}
items:
type: "{{ type }}"
minimum: {{ minimum }}
items: "{{ items }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties: "{{ additionalProperties }}"
title: "{{ title }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf:
- type: "{{ type }}"
minimum: {{ minimum }}
items:
type: "{{ type }}"
minimum: {{ minimum }}
items: "{{ items }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties: "{{ additionalProperties }}"
title: "{{ title }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties:
type: "{{ type }}"
minimum: {{ minimum }}
items: "{{ items }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties: "{{ additionalProperties }}"
title: "{{ title }}"
title: "{{ title }}"
enum:
- "{{ enum }}"
required:
- "{{ required }}"
properties: "{{ properties }}"
prefixItems:
- type: "{{ type }}"
minimum: {{ minimum }}
items:
type: "{{ type }}"
minimum: {{ minimum }}
items: "{{ items }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties: "{{ additionalProperties }}"
title: "{{ title }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties:
type: "{{ type }}"
minimum: {{ minimum }}
items: "{{ items }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties: "{{ additionalProperties }}"
title: "{{ title }}"
title: "{{ title }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties:
type: "{{ type }}"
minimum: {{ minimum }}
items: "{{ items }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties: "{{ additionalProperties }}"
title: "{{ title }}"
title: "{{ title }}"
outputSchema:
type: "{{ type }}"
minimum: {{ minimum }}
items:
type: "{{ type }}"
minimum: {{ minimum }}
items: "{{ items }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties: "{{ additionalProperties }}"
title: "{{ title }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf:
- type: "{{ type }}"
minimum: {{ minimum }}
items:
type: "{{ type }}"
minimum: {{ minimum }}
items: "{{ items }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties: "{{ additionalProperties }}"
title: "{{ title }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties:
type: "{{ type }}"
minimum: {{ minimum }}
items: "{{ items }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties: "{{ additionalProperties }}"
title: "{{ title }}"
title: "{{ title }}"
enum:
- "{{ enum }}"
required:
- "{{ required }}"
properties: "{{ properties }}"
prefixItems:
- type: "{{ type }}"
minimum: {{ minimum }}
items:
type: "{{ type }}"
minimum: {{ minimum }}
items: "{{ items }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties: "{{ additionalProperties }}"
title: "{{ title }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties:
type: "{{ type }}"
minimum: {{ minimum }}
items: "{{ items }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties: "{{ additionalProperties }}"
title: "{{ title }}"
title: "{{ title }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties:
type: "{{ type }}"
minimum: {{ minimum }}
items: "{{ items }}"
nullable: {{ nullable }}
maximum: {{ maximum }}
description: "{{ description }}"
default: "{{ default }}"
ref: "{{ ref }}"
minItems: "{{ minItems }}"
anyOf: "{{ anyOf }}"
enum: "{{ enum }}"
required: "{{ required }}"
properties: "{{ properties }}"
prefixItems: "{{ prefixItems }}"
defs: "{{ defs }}"
maxItems: "{{ maxItems }}"
uniqueItems: {{ uniqueItems }}
additionalProperties: "{{ additionalProperties }}"
title: "{{ title }}"
title: "{{ title }}"
tool: "{{ tool }}"
nameOverride: "{{ nameOverride }}"
- name: timeout
value: "{{ timeout }}"
description: |
Optional. The timeout for the toolset execution. If not set, the default timeout is 30 seconds for `SYNCHRONOUS` toolsets and 60 seconds for `ASYNCHRONOUS` toolsets.
- name: description
value: "{{ description }}"
description: |
Optional. The description of the toolset.
- name: connectorToolset
description: |
Optional. A toolset that generates tools from an Integration Connectors Connection.
value:
connection: "{{ connection }}"
authConfig:
oauth2AuthCodeConfig:
oauthToken: "{{ oauthToken }}"
oauth2JwtBearerConfig:
issuer: "{{ issuer }}"
subject: "{{ subject }}"
clientKey: "{{ clientKey }}"
connectorActions:
- inputFields: "{{ inputFields }}"
connectionActionId: "{{ connectionActionId }}"
entityOperation:
operation: "{{ operation }}"
entityId: "{{ entityId }}"
outputFields: "{{ outputFields }}"
- name: toolFakeConfig
description: |
Optional. Configuration for tools behavior in fake mode.
value:
codeBlock:
pythonCode: "{{ pythonCode }}"
enableFakeMode: {{ enableFakeMode }}
- name: etag
value: "{{ etag }}"
description: |
ETag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes.
- name: executionType
value: "{{ executionType }}"
description: |
Optional. The execution type of the tools in the toolset.
valid_values: ['EXECUTION_TYPE_UNSPECIFIED', 'SYNCHRONOUS', 'ASYNCHRONOUS']
- name: openApiToolset
description: |
Optional. A toolset that contains a list of tools that are defined by an OpenAPI schema.
value:
serviceDirectoryConfig:
service: "{{ service }}"
tlsConfig:
caCerts:
- displayName: "{{ displayName }}"
cert: "{{ cert }}"
url: "{{ url }}"
apiAuthentication:
bearerTokenConfig:
token: "{{ token }}"
serviceAccountAuthConfig:
serviceAccount: "{{ serviceAccount }}"
scopes:
- "{{ scopes }}"
apiKeyConfig:
keyName: "{{ keyName }}"
requestLocation: "{{ requestLocation }}"
apiKeySecretVersion: "{{ apiKeySecretVersion }}"
oauthConfig:
tokenEndpoint: "{{ tokenEndpoint }}"
oauthGrantType: "{{ oauthGrantType }}"
clientId: "{{ clientId }}"
clientSecretVersion: "{{ clientSecretVersion }}"
scopes:
- "{{ scopes }}"
serviceAgentIdTokenAuthConfig: "{{ serviceAgentIdTokenAuthConfig }}"
openApiSchema: "{{ openApiSchema }}"
ignoreUnknownFields: {{ ignoreUnknownFields }}
- name: toolsetId
value: "{{ toolsetId }}"
UPDATE examples
- patch
Updates the specified toolset.
UPDATE google.ces.toolsets
SET
data__name = '{{ name }}',
data__displayName = '{{ displayName }}',
data__mcpToolset = '{{ mcpToolset }}',
data__timeout = '{{ timeout }}',
data__description = '{{ description }}',
data__connectorToolset = '{{ connectorToolset }}',
data__toolFakeConfig = '{{ toolFakeConfig }}',
data__etag = '{{ etag }}',
data__executionType = '{{ executionType }}',
data__openApiToolset = '{{ openApiToolset }}'
WHERE
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND appsId = '{{ appsId }}' --required
AND toolsetsId = '{{ toolsetsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
connectorToolset,
createTime,
description,
displayName,
etag,
executionType,
mcpToolset,
openApiToolset,
timeout,
toolFakeConfig,
updateTime;
DELETE examples
- delete
Deletes the specified toolset.
DELETE FROM google.ces.toolsets
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND appsId = '{{ appsId }}' --required
AND toolsetsId = '{{ toolsetsId }}' --required
AND force = '{{ force }}'
AND etag = '{{ etag }}'
;