Skip to main content

toolsets

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

Overview

Nametoolsets
TypeResource
Idgoogle.ces.toolsets

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
namestringIdentifier. The unique identifier of the toolset. Format: projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}
connectorToolsetobjectOptional. A toolset that generates tools from an Integration Connectors Connection. (id: ConnectorToolset)
createTimestring (google-datetime)Output only. Timestamp when the toolset was created.
descriptionstringOptional. The description of the toolset.
displayNamestringOptional. The display name of the toolset. Must be unique within the same app.
etagstringETag 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.
executionTypestringOptional. The execution type of the tools in the toolset. (EXECUTION_TYPE_UNSPECIFIED, SYNCHRONOUS, ASYNCHRONOUS)
mcpToolsetobjectOptional. A toolset that contains a list of tools that are offered by the MCP server. (id: McpToolset)
openApiToolsetobjectOptional. A toolset that contains a list of tools that are defined by an OpenAPI schema. (id: OpenApiToolset)
timeoutstring (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.
toolFakeConfigobjectOptional. Configuration for tools behavior in fake mode. (id: ToolFakeConfig)
updateTimestring (google-datetime)Output only. Timestamp when the toolset was last updated.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectprojectsId, locationsId, appsId, toolsetsIdGets details of the specified toolset.
listselectprojectsId, locationsId, appsIdfilter, orderBy, pageSize, pageTokenLists toolsets in the given app.
createinsertprojectsId, locationsId, appsIdtoolsetIdCreates a new toolset in the given app.
patchupdateprojectsId, locationsId, appsId, toolsetsIdupdateMaskUpdates the specified toolset.
deletedeleteprojectsId, locationsId, appsId, toolsetsIdforce, etagDeletes 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.

NameDatatypeDescription
appsIdstring
locationsIdstring
projectsIdstring
toolsetsIdstring
etagstring
filterstring
forceboolean
orderBystring
pageSizeinteger (int32)
pageTokenstring
toolsetIdstring
updateMaskstring (google-fieldmask)

SELECT examples

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
;

INSERT examples

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
;

UPDATE examples

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

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 }}'
;