Google Cloud Ai Platform V1 Client - Class Tool (1.34.0)

Reference documentation and code samples for the Google Cloud Ai Platform V1 Client class Tool.

Tool details that the model may use to generate response.

A Tool is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model. A Tool object should contain exactly one type of Tool (e.g FunctionDeclaration, Retrieval or GoogleSearchRetrieval).

Generated from protobuf message google.cloud.aiplatform.v1.Tool

Namespace

Google \ Cloud \ AIPlatform \ V1

Methods

__construct

Constructor.

Parameters
Name
Description
data
array

Optional. Data for populating the Message object.

↳ function_declarations
array< FunctionDeclaration >

Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 128 function declarations can be provided.

↳ retrieval
Retrieval

Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation.

↳ google_search
Tool\GoogleSearch

Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google.

↳ google_search_retrieval
GoogleSearchRetrieval

Optional. GoogleSearchRetrieval tool type. Specialized retrieval tool that is powered by Google search.

↳ google_maps
GoogleMaps

Optional. GoogleMaps tool type. Tool to support Google Maps in Model.

↳ enterprise_web_search
EnterpriseWebSearch

Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance.

↳ code_execution
Tool\CodeExecution

Optional. CodeExecution tool type. Enables the model to execute code as part of generation.

↳ url_context
UrlContext

Optional. Tool to support URL context retrieval.

↳ computer_use
Tool\ComputerUse

Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations.

getFunctionDeclarations

Optional. Function tool type.

One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 128 function declarations can be provided.

Returns
Type
Description

setFunctionDeclarations

Optional. Function tool type.

One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 128 function declarations can be provided.

Parameter
Name
Description
var
Returns
Type
Description
$this

getRetrieval

Optional. Retrieval tool type.

System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation.

Returns
Type
Description
Retrieval |null

hasRetrieval

clearRetrieval

setRetrieval

Optional. Retrieval tool type.

System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation.

Parameter
Name
Description
var
Returns
Type
Description
$this

getGoogleSearch

Optional. GoogleSearch tool type.

Tool to support Google Search in Model. Powered by Google.

Returns
Type
Description

hasGoogleSearch

clearGoogleSearch

setGoogleSearch

Optional. GoogleSearch tool type.

Tool to support Google Search in Model. Powered by Google.

Parameter
Name
Description
Returns
Type
Description
$this

getGoogleSearchRetrieval

Optional. GoogleSearchRetrieval tool type.

Specialized retrieval tool that is powered by Google search.

Returns
Type
Description

hasGoogleSearchRetrieval

clearGoogleSearchRetrieval

setGoogleSearchRetrieval

Optional. GoogleSearchRetrieval tool type.

Specialized retrieval tool that is powered by Google search.

Parameter
Name
Description
Returns
Type
Description
$this

getGoogleMaps

Optional. GoogleMaps tool type.

Tool to support Google Maps in Model.

Returns
Type
Description
GoogleMaps |null

hasGoogleMaps

clearGoogleMaps

setGoogleMaps

Optional. GoogleMaps tool type.

Tool to support Google Maps in Model.

Parameter
Name
Description
Returns
Type
Description
$this

getEnterpriseWebSearch

Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance.

Returns
Type
Description

hasEnterpriseWebSearch

clearEnterpriseWebSearch

setEnterpriseWebSearch

Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance.

Parameter
Name
Description
Returns
Type
Description
$this

getCodeExecution

Optional. CodeExecution tool type.

Enables the model to execute code as part of generation.

Returns
Type
Description

hasCodeExecution

clearCodeExecution

setCodeExecution

Optional. CodeExecution tool type.

Enables the model to execute code as part of generation.

Parameter
Name
Description
Returns
Type
Description
$this

getUrlContext

Optional. Tool to support URL context retrieval.

Returns
Type
Description
UrlContext |null

hasUrlContext

clearUrlContext

setUrlContext

Optional. Tool to support URL context retrieval.

Parameter
Name
Description
Returns
Type
Description
$this

getComputerUse

Optional. Tool to support the model interacting directly with the computer.

If enabled, it automatically populates computer-use specific Function Declarations.

Returns
Type
Description

hasComputerUse

clearComputerUse

setComputerUse

Optional. Tool to support the model interacting directly with the computer.

If enabled, it automatically populates computer-use specific Function Declarations.

Parameter
Name
Description
Returns
Type
Description
$this
Design a Mobile Site
View Site in Mobile | Classic
Share by: