Method: projects.locations.extensions.query

Queries an extension with a default controller.

Endpoint

post https://{endpoint}/v1beta1/{name}:query

Where {service-endpoint} is one of the supported service endpoints.

Path parameters

name string

Required. name (identifier) of the extension; Format: projects/{project}/locations/{location}/extensions/{extension}

Request body

The request body contains data with the following structure:

Fields
contents[] object (Content)

Required. The content of the current conversation with the model.

For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.

Response body

Response message for ExtensionExecutionService.QueryExtension.

If successful, the response body contains data with the following structure:

Fields
steps[] object (Content)

Steps of extension or LLM interaction, can contain function call, function response, or text response. The last step contains the final response to the query.

failureMessage string

Failure message if any.

JSON representation
{
  "steps": [
    {
      object (Content)
    }
  ],
  "failureMessage": string
}