Reference documentation and code samples for the Google Cloud Dialogflow Cx V3 Client class QueryParameters.
Represents the parameters of a conversational query.
Generated from protobuf message google.cloud.dialogflow.cx.v3.QueryParameters
Namespace
Google \ Cloud \ Dialogflow \ Cx \ V3Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ time_zone
string
The time zone of this conversational query from the time zone database , e.g., America/New_York, Europe/Paris. If not provided, the time zone specified in the agent is used.
↳ geo_location
↳ session_entity_types
array< Google\Cloud\Dialogflow\Cx\V3\SessionEntityType
>
Additional session entity types to replace or extend developer entity types with. The entity synonyms apply to all languages and persist for the session of this query.
↳ payload
Google\Protobuf\Struct
This field can be used to pass custom data into the webhook associated with the agent. Arbitrary JSON objects are supported. Some integrations that query a Dialogflow agent may provide additional information in the payload. In particular, for the Dialogflow Phone Gateway integration, this field has the form: { "telephony": { "caller_id": "+18558363987" } }
↳ parameters
Google\Protobuf\Struct
Additional parameters to be put into session parameters . To remove a parameter from the session, clients should explicitly set the parameter value to null. You can reference the session parameters in the agent with the following format: $session.params.parameter-id. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.
↳ current_page
string
The unique identifier of the page
to override the current page
in the session. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/pages/<Page ID>
. If current_page
is specified, the previous state of the session will be ignored by Dialogflow, including the previous page
and the previous session parameters
. In most cases, current_page
and parameters
should be configured together to direct a session to a specific state.
↳ disable_webhook
bool
Whether to disable webhook calls for this request.
↳ analyze_query_text_sentiment
bool
Configures whether sentiment analysis should be performed. If not provided, sentiment analysis is not performed.
↳ webhook_headers
array| Google\Protobuf\Internal\MapField
This field can be used to pass HTTP headers for a webhook call. These headers will be sent to webhook along with the headers that have been configured through Dialogflow web console. The headers defined within this field will overwrite the headers configured through Dialogflow console if there is a conflict. Header names are case-insensitive. Google's specified headers are not allowed. Including: "Host", "Content-Length", "Connection", "From", "User-Agent", "Accept-Encoding", "If-Modified-Since", "If-None-Match", "X-Forwarded-For", etc.
↳ flow_versions
array
A list of flow versions to override for the request. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/versions/<Version ID>
. If version 1 of flow X is included in this list, the traffic of flow X will go through version 1 regardless of the version configuration in the environment. Each flow can have at most one version specified in this list.
↳ channel
string
The channel which this query is for. If specified, only the ResponseMessage associated with the channel will be returned. If no ResponseMessage is associated with the channel, it falls back to the ResponseMessage with unspecified channel. If unspecified, the ResponseMessage with unspecified channel will be returned.
↳ session_ttl
Google\Protobuf\Duration
Optional. Sets Dialogflow session life time. By default, a Dialogflow session remains active and its data is stored for 30 minutes after the last request is sent for the session. This value should be no longer than 1 day.
↳ end_user_metadata
Google\Protobuf\Struct
Optional. Information about the end-user to improve the relevance and accuracy of generative answers. This will be interpreted and used by a language model, so, for good results, the data should be self-descriptive, and in a simple structure. Example: json { "subscription plan": "Business Premium Plus", "devices owned": [ {"model": "Google Pixel 7"}, {"model": "Google Pixel Tablet"} ] }
↳ search_config
getTimeZone
The time zone of this conversational query from the time zone database , e.g., America/New_York, Europe/Paris. If not provided, the time zone specified in the agent is used.
string
setTimeZone
The time zone of this conversational query from the time zone database , e.g., America/New_York, Europe/Paris. If not provided, the time zone specified in the agent is used.
var
string
$this
getGeoLocation
The geo location of this conversational query.
hasGeoLocation
clearGeoLocation
setGeoLocation
The geo location of this conversational query.
$this
getSessionEntityTypes
Additional session entity types to replace or extend developer entity types with. The entity synonyms apply to all languages and persist for the session of this query.
setSessionEntityTypes
Additional session entity types to replace or extend developer entity types with. The entity synonyms apply to all languages and persist for the session of this query.
$this
getPayload
This field can be used to pass custom data into the webhook associated with the agent. Arbitrary JSON objects are supported.
Some integrations that query a Dialogflow agent may provide additional information in the payload. In particular, for the Dialogflow Phone Gateway integration, this field has the form:
{
"telephony": {
"caller_id": "+18558363987"
}
}
hasPayload
clearPayload
setPayload
This field can be used to pass custom data into the webhook associated with the agent. Arbitrary JSON objects are supported.
Some integrations that query a Dialogflow agent may provide additional information in the payload. In particular, for the Dialogflow Phone Gateway integration, this field has the form:
{
"telephony": {
"caller_id": "+18558363987"
}
}
$this
getParameters
Additional parameters to be put into session parameters . To remove a parameter from the session, clients should explicitly set the parameter value to null.
You can reference the session parameters in the agent with the following format: $session.params.parameter-id. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs:
- MapKey type: string
- MapKey value: parameter name
- MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map.
- MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.
hasParameters
clearParameters
setParameters
Additional parameters to be put into session parameters . To remove a parameter from the session, clients should explicitly set the parameter value to null.
You can reference the session parameters in the agent with the following format: $session.params.parameter-id. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs:
- MapKey type: string
- MapKey value: parameter name
- MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map.
- MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.
$this
getCurrentPage
The unique identifier of the page to override the current page in the session.
Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent
ID>/flows/<Flow ID>/pages/<Page ID>
.
If current_page
is specified, the previous state of the session will be
ignored by Dialogflow, including the previous
page
and the previous session
parameters
.
In most cases, current_page
and parameters
should be configured together to direct a session to a specific state.
string
setCurrentPage
The unique identifier of the page to override the current page in the session.
Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent
ID>/flows/<Flow ID>/pages/<Page ID>
.
If current_page
is specified, the previous state of the session will be
ignored by Dialogflow, including the previous
page
and the previous session
parameters
.
In most cases, current_page
and parameters
should be configured together to direct a session to a specific state.
var
string
$this
getDisableWebhook
Whether to disable webhook calls for this request.
bool
setDisableWebhook
Whether to disable webhook calls for this request.
var
bool
$this
getAnalyzeQueryTextSentiment
Configures whether sentiment analysis should be performed. If not provided, sentiment analysis is not performed.
bool
setAnalyzeQueryTextSentiment
Configures whether sentiment analysis should be performed. If not provided, sentiment analysis is not performed.
var
bool
$this
getWebhookHeaders
This field can be used to pass HTTP headers for a webhook call. These headers will be sent to webhook along with the headers that have been configured through Dialogflow web console. The headers defined within this field will overwrite the headers configured through Dialogflow console if there is a conflict. Header names are case-insensitive.
Google's specified headers are not allowed. Including: "Host", "Content-Length", "Connection", "From", "User-Agent", "Accept-Encoding", "If-Modified-Since", "If-None-Match", "X-Forwarded-For", etc.
setWebhookHeaders
This field can be used to pass HTTP headers for a webhook call. These headers will be sent to webhook along with the headers that have been configured through Dialogflow web console. The headers defined within this field will overwrite the headers configured through Dialogflow console if there is a conflict. Header names are case-insensitive.
Google's specified headers are not allowed. Including: "Host", "Content-Length", "Connection", "From", "User-Agent", "Accept-Encoding", "If-Modified-Since", "If-None-Match", "X-Forwarded-For", etc.
$this
getFlowVersions
A list of flow versions to override for the request.
Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent
ID>/flows/<Flow ID>/versions/<Version ID>
.
If version 1 of flow X is included in this list, the traffic of
flow X will go through version 1 regardless of the version configuration in
the environment. Each flow can have at most one version specified in this
list.
setFlowVersions
A list of flow versions to override for the request.
Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent
ID>/flows/<Flow ID>/versions/<Version ID>
.
If version 1 of flow X is included in this list, the traffic of
flow X will go through version 1 regardless of the version configuration in
the environment. Each flow can have at most one version specified in this
list.
var
string[]
$this
getChannel
The channel which this query is for.
If specified, only the ResponseMessage associated with the channel will be returned. If no ResponseMessage is associated with the channel, it falls back to the ResponseMessage with unspecified channel. If unspecified, the ResponseMessage with unspecified channel will be returned.
string
setChannel
The channel which this query is for.
If specified, only the ResponseMessage associated with the channel will be returned. If no ResponseMessage is associated with the channel, it falls back to the ResponseMessage with unspecified channel. If unspecified, the ResponseMessage with unspecified channel will be returned.
var
string
$this
getSessionTtl
Optional. Sets Dialogflow session life time.
By default, a Dialogflow session remains active and its data is stored for 30 minutes after the last request is sent for the session. This value should be no longer than 1 day.
hasSessionTtl
clearSessionTtl
setSessionTtl
Optional. Sets Dialogflow session life time.
By default, a Dialogflow session remains active and its data is stored for 30 minutes after the last request is sent for the session. This value should be no longer than 1 day.
$this
getEndUserMetadata
Optional. Information about the end-user to improve the relevance and accuracy of generative answers.
This will be interpreted and used by a language model, so, for good results, the data should be self-descriptive, and in a simple structure. Example:
{
"subscription plan": "Business Premium Plus",
"devices owned": [
{"model": "Google Pixel 7"},
{"model": "Google Pixel Tablet"}
]
}
hasEndUserMetadata
clearEndUserMetadata
setEndUserMetadata
Optional. Information about the end-user to improve the relevance and accuracy of generative answers.
This will be interpreted and used by a language model, so, for good results, the data should be self-descriptive, and in a simple structure. Example:
{
"subscription plan": "Business Premium Plus",
"devices owned": [
{"model": "Google Pixel 7"},
{"model": "Google Pixel Tablet"}
]
}
$this
getSearchConfig
Optional. Search configuration for UCS search queries.
hasSearchConfig
clearSearchConfig
setSearchConfig
Optional. Search configuration for UCS search queries.
$this
