As of January 1, 2020 this library no longer supports Python 2 on the latest released version. Library versions released prior to that date will continue to be available. For more information please visit Python 2 support on Google Cloud.

Types for Google Cloud Dialogflowcx v3beta1 API

class google.cloud.dialogflowcx_v3beta1.types.Action(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Action performed by end user or Dialogflow agent in the conversation.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

user_utterance

Optional. Agent obtained a message from the customer.

This field is a member of oneof action.

Type

google.cloud.dialogflowcx_v3beta1.types.UserUtterance

agent_utterance

Optional. Action performed by the agent as a message.

This field is a member of oneof action.

Type

google.cloud.dialogflowcx_v3beta1.types.AgentUtterance

tool_use

Optional. Action performed on behalf of the agent by calling a plugin tool.

This field is a member of oneof action.

Type

google.cloud.dialogflowcx_v3beta1.types.ToolUse

playbook_invocation

Optional. Action performed on behalf of the agent by invoking a child playbook.

This field is a member of oneof action.

Type

google.cloud.dialogflowcx_v3beta1.types.PlaybookInvocation

flow_invocation

Optional. Action performed on behalf of the agent by invoking a CX flow.

This field is a member of oneof action.

Type

google.cloud.dialogflowcx_v3beta1.types.FlowInvocation

class google.cloud.dialogflowcx_v3beta1.types.AdvancedSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Hierarchical advanced settings for agent/flow/page/fulfillment/parameter. Settings exposed at lower level overrides the settings exposed at higher level. Overriding occurs at the sub-setting level. For example, the playback_interruption_settings at fulfillment level only overrides the playback_interruption_settings at the agent level, leaving other settings at the agent level unchanged.

DTMF settings does not override each other. DTMF settings set at different levels define DTMF detections running in parallel.

Hierarchy: Agent->Flow->Page->Fulfillment/Parameter.

audio_export_gcs_destination

If present, incoming audio is exported by Dialogflow to the configured Google Cloud Storage destination. Exposed at the following levels:

• Agent level

• Flow level

Type

google.cloud.dialogflowcx_v3beta1.types.GcsDestination

speech_settings

Settings for speech to text detection. Exposed at the following levels:

• Agent level

• Flow level

• Page level

• Parameter level

Type

google.cloud.dialogflowcx_v3beta1.types.AdvancedSettings.SpeechSettings

dtmf_settings

Settings for DTMF. Exposed at the following levels:

• Agent level

• Flow level

• Page level

• Parameter level.

Type

google.cloud.dialogflowcx_v3beta1.types.AdvancedSettings.DtmfSettings

logging_settings

Settings for logging. Settings for Dialogflow History, Contact Center messages, StackDriver logs, and speech logging. Exposed at the following levels:

• Agent level.

Type

google.cloud.dialogflowcx_v3beta1.types.AdvancedSettings.LoggingSettings

class DtmfSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Define behaviors for DTMF (dual tone multi frequency).

enabled

If true, incoming audio is processed for DTMF (dual tone multi frequency) events. For example, if the caller presses a button on their telephone keypad and DTMF processing is enabled, Dialogflow will detect the event (e.g. a “3” was pressed) in the incoming audio and pass the event to the bot to drive business logic (e.g. when 3 is pressed, return the account balance).

Type

bool

max_digits

Max length of DTMF digits.

Type

int

finish_digit

The digit that terminates a DTMF digit sequence.

Type

str

interdigit_timeout_duration

Interdigit timeout setting for matching dtmf input to regex.

Type

google.protobuf.duration_pb2.Duration

endpointing_timeout_duration

Endpoint timeout setting for matching dtmf input to regex.

Type

google.protobuf.duration_pb2.Duration

class LoggingSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Define behaviors on logging.

enable_stackdriver_logging

Enables Google Cloud Logging.

Type

bool

enable_interaction_logging

Enables DF Interaction logging.

Type

bool

enable_consent_based_redaction

Enables consent-based end-user input redaction, if true, a pre-defined session parameter $session.params.conversation-redaction will be used to determine if the utterance should be redacted.

Type

bool

class SpeechSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Define behaviors of speech to text detection.

endpointer_sensitivity

Sensitivity of the speech model that detects the end of speech. Scale from 0 to 100.

Type

int

no_speech_timeout

Timeout before detecting no speech.

Type

google.protobuf.duration_pb2.Duration

use_timeout_based_endpointing

Use timeout based endpointing, interpreting endpointer sensitivy as seconds of timeout value.

Type

bool

models

Mapping from language to Speech-to-Text model. The mapped Speech-to-Text model will be selected for requests from its corresponding language. For more information, see Speech models.

Type

MutableMapping[str, str]

class ModelsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class google.cloud.dialogflowcx_v3beta1.types.Agent(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Agents are best described as Natural Language Understanding (NLU) modules that transform user requests into actionable data. You can include agents in your app, product, or service to determine user intent and respond to the user in a natural way.

After you create an agent, you can add [Intents][google.cloud.dialogflow.cx.v3beta1.Intent], [Entity Types][google.cloud.dialogflow.cx.v3beta1.EntityType], [Flows][google.cloud.dialogflow.cx.v3beta1.Flow], [Fulfillments][google.cloud.dialogflow.cx.v3beta1.Fulfillment], [Webhooks][google.cloud.dialogflow.cx.v3beta1.Webhook], [TransitionRouteGroups][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroup] and so on to manage the conversation flows.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

name

The unique identifier of the agent. Required for the [Agents.UpdateAgent][google.cloud.dialogflow.cx.v3beta1.Agents.UpdateAgent] method. [Agents.CreateAgent][google.cloud.dialogflow.cx.v3beta1.Agents.CreateAgent] populates the name automatically. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

display_name

Required. The human-readable name of the agent, unique within the location.

Type

str

default_language_code

Required. Immutable. The default language of the agent as a language tag. See Language Support for a list of the currently supported language codes. This field cannot be set by the [Agents.UpdateAgent][google.cloud.dialogflow.cx.v3beta1.Agents.UpdateAgent] method.

Type

str

supported_language_codes

The list of all languages supported by the agent (except for the default_language_code).

Type

MutableSequence[str]

time_zone

Required. The time zone of the agent from the time zone database, e.g., America/New_York, Europe/Paris.

Type

str

description

The description of the agent. The maximum length is 500 characters. If exceeded, the request is rejected.

Type

str

avatar_uri

The URI of the agent’s avatar. Avatars are used throughout the Dialogflow console and in the self-hosted Web Demo integration.

Type

str

speech_to_text_settings

Speech recognition related settings.

Type

google.cloud.dialogflowcx_v3beta1.types.SpeechToTextSettings

start_flow

Name of the start flow in this agent. A start flow will be automatically created when the agent is created, and can only be deleted by deleting the agent. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>. Currently only the default start flow with id “00000000-0000-0000-0000-000000000000” is allowed.

This field is a member of oneof session_entry_resource.

Type

str

start_playbook

Name of the start playbook in this agent. A start playbook will be automatically created when the agent is created, and can only be deleted by deleting the agent. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>. Currently only the default playbook with id “00000000-0000-0000-0000-000000000000” is allowed.

This field is a member of oneof session_entry_resource.

Type

str

security_settings

Name of the [SecuritySettings][google.cloud.dialogflow.cx.v3beta1.SecuritySettings] reference for the agent. Format: projects/<ProjectID>/locations/<LocationID>/securitySettings/<SecuritySettingsID>.

Type

str

enable_stackdriver_logging

Indicates if stackdriver logging is enabled for the agent. Please use [agent.advanced_settings][google.cloud.dialogflow.cx.v3beta1.AdvancedSettings.LoggingSettings] instead.

Type

bool

enable_spell_correction

Indicates if automatic spell correction is enabled in detect intent requests.

Type

bool

enable_multi_language_training

Optional. Enable training multi-lingual models for this agent. These models will be trained on all the languages supported by the agent.

Type

bool

locked

Indicates whether the agent is locked for changes. If the agent is locked, modifications to the agent will be rejected except for [RestoreAgent][].

Type

bool

advanced_settings

Hierarchical advanced settings for this agent. The settings exposed at the lower level overrides the settings exposed at the higher level.

Type

google.cloud.dialogflowcx_v3beta1.types.AdvancedSettings

git_integration_settings

Git integration settings for this agent.

Type

google.cloud.dialogflowcx_v3beta1.types.Agent.GitIntegrationSettings

bigquery_export_settings

Optional. The BigQuery export settings for this agent. The conversation data will be exported to BigQuery tables if it is enabled. By default, BigQuery export settings will not be exported with agent. You need to set [include_bigquery_export_settings][google.cloud.dialogflow.cx.v3beta1.ExportAgentRequest.include_bigquery_export_settings] to include it in the exported agent.

Type

google.cloud.dialogflowcx_v3beta1.types.BigQueryExportSettings

text_to_speech_settings

Settings on instructing the speech synthesizer on how to generate the output audio content.

Type

google.cloud.dialogflowcx_v3beta1.types.TextToSpeechSettings

gen_app_builder_settings

Gen App Builder-related agent-level settings.

This field is a member of oneof _gen_app_builder_settings.

Type

google.cloud.dialogflowcx_v3beta1.types.Agent.GenAppBuilderSettings

answer_feedback_settings

Optional. Answer feedback collection settings.

Type

google.cloud.dialogflowcx_v3beta1.types.Agent.AnswerFeedbackSettings

personalization_settings

Optional. Settings for end user personalization.

Type

google.cloud.dialogflowcx_v3beta1.types.Agent.PersonalizationSettings

client_certificate_settings

Optional. Settings for custom client certificates.

Type

google.cloud.dialogflowcx_v3beta1.types.Agent.ClientCertificateSettings

class AnswerFeedbackSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for answer feedback collection.

enable_answer_feedback

Optional. If enabled, end users will be able to provide [answer feedback][google.cloud.dialogflow.cx.v3beta1.AnswerFeedback] to Dialogflow responses. Feature works only if interaction logging is enabled in the Dialogflow agent.

Type

bool

class ClientCertificateSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for custom client certificates.

ssl_certificate

Required. The ssl certificate encoded in PEM format. This string must include the begin header and end footer lines.

Type

str

private_key

Required. The name of the SecretManager secret version resource storing the private key encoded in PEM format. Format: projects/{project}/secrets/{secret}/versions/{version}

Type

str

passphrase

Optional. The name of the SecretManager secret version resource storing the passphrase. ‘passphrase’ should be left unset if the private key is not encrypted. Format: projects/{project}/secrets/{secret}/versions/{version}

Type

str

class GenAppBuilderSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for Gen App Builder.

engine

Required. The full name of the Gen App Builder engine related to this agent if there is one. Format: projects/{Project ID}/locations/{Location ID}/collections/{Collection ID}/engines/{Engine ID}

Type

str

class GitIntegrationSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for connecting to Git repository for an agent.

github_settings

GitHub settings.

This field is a member of oneof git_settings.

Type

google.cloud.dialogflowcx_v3beta1.types.Agent.GitIntegrationSettings.GithubSettings

class GithubSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings of integration with GitHub.

display_name

The unique repository display name for the GitHub repository.

Type

str

repository_uri

The GitHub repository URI related to the agent.

Type

str

tracking_branch

The branch of the GitHub repository tracked for this agent.

Type

str

access_token

The access token used to authenticate the access to the GitHub repository.

Type

str

branches

A list of branches configured to be used from Dialogflow.

Type

MutableSequence[str]

class PersonalizationSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for end user personalization.

default_end_user_metadata

Optional. Default end user metadata, used when processing DetectIntent requests. Recommended to be filled as a template instead of hard-coded value, for example { “age”: “$session.params.age” }. The data will be merged with the [QueryParameters.end_user_metadata][google.cloud.dialogflow.cx.v3beta1.QueryParameters.end_user_metadata] in [DetectIntentRequest.query_params][google.cloud.dialogflow.cx.v3beta1.DetectIntentRequest.query_params] during query processing.

Type

google.protobuf.struct_pb2.Struct

class google.cloud.dialogflowcx_v3beta1.types.AgentUtterance(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

AgentUtterance represents one message sent by the agent.

text

Required. Message content in text.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.AgentValidationResult(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Agents.GetAgentValidationResult][google.cloud.dialogflow.cx.v3beta1.Agents.GetAgentValidationResult].

name

The unique identifier of the agent validation result. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/validationResult.

Type

str

flow_validation_results

Contains all flow validation results.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.FlowValidationResult]

class google.cloud.dialogflowcx_v3beta1.types.AnswerFeedback(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Stores information about feedback provided by users about a response.

rating

Optional. Rating from user for the specific Dialogflow response.

Type

google.cloud.dialogflowcx_v3beta1.types.AnswerFeedback.Rating

rating_reason

Optional. In case of thumbs down rating provided, users can optionally provide context about the rating.

Type

google.cloud.dialogflowcx_v3beta1.types.AnswerFeedback.RatingReason

custom_rating

Optional. Custom rating from the user about the provided answer, with maximum length of 1024 characters. For example, client could use a customized JSON object to indicate the rating.

Type

str

class Rating(value)

Bases: proto.enums.Enum

Represents thumbs up/down rating provided by user about a response.

Values:

RATING_UNSPECIFIED (0):

Rating not specified.

THUMBS_UP (1):

Thumbs up feedback from user.

THUMBS_DOWN (2):

Thumbs down feedback from user.

class RatingReason(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Stores extra information about why users provided thumbs down rating.

reason_labels

Optional. Custom reason labels for thumbs down rating provided by the user. The maximum number of labels allowed is 10 and the maximum length of a single label is 128 characters.

Type

MutableSequence[str]

feedback

Optional. Additional feedback about the rating. This field can be populated without choosing a predefined reason.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.AudioEncoding(value)

Bases: proto.enums.Enum

Audio encoding of the audio content sent in the conversational query request. Refer to the Cloud Speech API documentation for more details.

Values:

AUDIO_ENCODING_UNSPECIFIED (0):

Not specified.

AUDIO_ENCODING_LINEAR_16 (1):

Uncompressed 16-bit signed little-endian samples (Linear PCM).

AUDIO_ENCODING_FLAC (2):

`FLAC <https://xiph.org/flac/documentation.html>`__ (Free Lossless Audio Codec) is the recommended encoding because it is lossless (therefore recognition is not compromised) and requires only about half the bandwidth of LINEAR16. FLAC stream encoding supports 16-bit and 24-bit samples, however, not all fields in STREAMINFO are supported.

AUDIO_ENCODING_MULAW (3):

8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.

AUDIO_ENCODING_AMR (4):

Adaptive Multi-Rate Narrowband codec. sample_rate_hertz must be 8000.

AUDIO_ENCODING_AMR_WB (5):

Adaptive Multi-Rate Wideband codec. sample_rate_hertz must be 16000.

AUDIO_ENCODING_OGG_OPUS (6):

Opus encoded audio frames in Ogg container (OggOpus). sample_rate_hertz must be 16000.

AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE (7):

Although the use of lossy encodings is not recommended, if a very low bitrate encoding is required, OGG_OPUS is highly preferred over Speex encoding. The Speex encoding supported by Dialogflow API has a header byte in each block, as in MIME type audio/x-speex-with-header-byte. It is a variant of the RTP Speex encoding defined in RFC 5574. The stream is a sequence of blocks, one block per RTP packet. Each block starts with a byte containing the length of the block, in bytes, followed by one or more frames of Speex data, padded to an integral number of bytes (octets) as specified in RFC 5574. In other words, each RTP header is replaced with a single byte containing the block length. Only Speex wideband is supported. sample_rate_hertz must be 16000.

AUDIO_ENCODING_ALAW (8):

8-bit samples that compand 13-bit audio samples using G.711 PCMU/a-law.

class google.cloud.dialogflowcx_v3beta1.types.AudioInput(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the natural speech audio to be processed.

config

Required. Instructs the speech recognizer how to process the speech audio.

Type

google.cloud.dialogflowcx_v3beta1.types.InputAudioConfig

audio

The natural language speech audio to be processed. A single request can contain up to 2 minutes of speech audio data. The [transcribed text][google.cloud.dialogflow.cx.v3beta1.QueryResult.transcript] cannot contain more than 256 bytes.

For non-streaming audio detect intent, both config and audio must be provided. For streaming audio detect intent, config must be provided in the first request and audio must be provided in all following requests.

Type

bytes

class google.cloud.dialogflowcx_v3beta1.types.BargeInConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Configuration of the barge-in behavior. Barge-in instructs the API to return a detected utterance at a proper time while the client is playing back the response audio from a previous request. When the client sees the utterance, it should stop the playback and immediately get ready for receiving the responses for the current request.

The barge-in handling requires the client to start streaming audio input as soon as it starts playing back the audio from the previous response. The playback is modeled into two phases:

• No barge-in phase: which goes first and during which speech detection should not be carried out.

• Barge-in phase: which follows the no barge-in phase and during which the API starts speech detection and may inform the client that an utterance has been detected. Note that no-speech event is not expected in this phase.

The client provides this configuration in terms of the durations of those two phases. The durations are measured in terms of the audio length from the the start of the input audio.

No-speech event is a response with END_OF_UTTERANCE without any transcript following up.

no_barge_in_duration

Duration that is not eligible for barge-in at the beginning of the input audio.

Type

google.protobuf.duration_pb2.Duration

total_duration

Total duration for the playback at the beginning of the input audio.

Type

google.protobuf.duration_pb2.Duration

class google.cloud.dialogflowcx_v3beta1.types.BatchDeleteTestCasesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TestCases.BatchDeleteTestCases][google.cloud.dialogflow.cx.v3beta1.TestCases.BatchDeleteTestCases].

parent

Required. The agent to delete test cases from. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

names

Required. Format of test case names: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/testCases/<TestCaseID>.

Type

MutableSequence[str]

class google.cloud.dialogflowcx_v3beta1.types.BatchRunTestCasesMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metadata returned for the [TestCases.BatchRunTestCases][google.cloud.dialogflow.cx.v3beta1.TestCases.BatchRunTestCases] long running operation.

errors

The test errors.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TestError]

class google.cloud.dialogflowcx_v3beta1.types.BatchRunTestCasesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TestCases.BatchRunTestCases][google.cloud.dialogflow.cx.v3beta1.TestCases.BatchRunTestCases].

parent

Required. Agent name. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

environment

Optional. If not set, draft environment is assumed. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

test_cases

Required. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/testCases/<TestCaseID>.

Type

MutableSequence[str]

class google.cloud.dialogflowcx_v3beta1.types.BatchRunTestCasesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [TestCases.BatchRunTestCases][google.cloud.dialogflow.cx.v3beta1.TestCases.BatchRunTestCases].

results

The test case results. The detailed [conversation turns][google.cloud.dialogflow.cx.v3beta1.TestCaseResult.conversation_turns] are empty in this response.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TestCaseResult]

class google.cloud.dialogflowcx_v3beta1.types.BigQueryExportSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The settings of BigQuery export.

enabled

The field to indicate whether the BigQuery export is enabled.

Type

bool

bigquery_table

The BigQuery table to export. Format: projects/<ProjectID>/datasets/<DatasetID>/tables/<TableID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.BoostSpec(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Boost specification to boost certain documents. A copy of google.cloud.discoveryengine.v1main.BoostSpec, field documentation is available at https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1alpha/BoostSpec

condition_boost_specs

Optional. Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.BoostSpec.ConditionBoostSpec]

class ConditionBoostSpec(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Boost applies to documents which match a condition.

condition

Optional. An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. Examples:

• To boost documents with document ID “doc_1” or “doc_2”, and color “Red” or “Blue”:

  • (id: ANY(“doc_1”, “doc_2”)) AND (color: ANY(“Red”,”Blue”))

Type

str

boost

Optional. Strength of the condition boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0.

Setting to 1.0 gives the document a big promotion. However, it does not necessarily mean that the boosted document will be the top result at all times, nor that other documents will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant documents.

Setting to -1.0 gives the document a big demotion. However, results that are deeply relevant might still be shown. The document will have an upstream battle to get a fairly high ranking, but it is not blocked out completely.

Setting to 0.0 means no boost applied. The boosting condition is ignored.

Type

float

boost_control_spec

Optional. Complex specification for custom ranking based on customer defined attribute value.

Type

google.cloud.dialogflowcx_v3beta1.types.BoostSpec.ConditionBoostSpec.BoostControlSpec

class BoostControlSpec(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above.

field_name

Optional. The name of the field whose value will be used to determine the boost amount.

Type

str

attribute_type

Optional. The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).

Type

google.cloud.dialogflowcx_v3beta1.types.BoostSpec.ConditionBoostSpec.BoostControlSpec.AttributeType

interpolation_type

Optional. The interpolation type to be applied to connect the control points listed below.

Type

google.cloud.dialogflowcx_v3beta1.types.BoostSpec.ConditionBoostSpec.BoostControlSpec.InterpolationType

control_points

Optional. The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.BoostSpec.ConditionBoostSpec.BoostControlSpec.ControlPoint]

class AttributeType(value)

Bases: proto.enums.Enum

The attribute(or function) for which the custom ranking is to be applied.

Values:

ATTRIBUTE_TYPE_UNSPECIFIED (0):

Unspecified AttributeType.

NUMERICAL (1):

The value of the numerical field will be used to dynamically update the boost amount. In this case, the attribute_value (the x value) of the control point will be the actual value of the numerical field for which the boost_amount is specified.

FRESHNESS (2):

For the freshness use case the attribute value will be the duration between the current time and the date in the datetime field specified. The value must be formatted as an XSD dayTimeDuration value (a restricted subset of an ISO 8601 duration value). The pattern for this is: [nD][T[nH][nM][nS]]. E.g. 5D, 3DT12H30M, T24H.

class ControlPoint(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).

attribute_value

Optional. Can be one of:

1. The numerical field value.

2. The duration spec for freshness: The value must be formatted as an XSD dayTimeDuration value (a restricted subset of an ISO 8601 duration value). The pattern for this is: [nD][T[nH][nM][nS]].

Type

str

boost_amount

Optional. The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.

Type

float

class InterpolationType(value)

Bases: proto.enums.Enum

The interpolation type to be applied. Default will be linear (Piecewise Linear).

Values:

INTERPOLATION_TYPE_UNSPECIFIED (0):

Interpolation type is unspecified. In this case, it defaults to Linear.

LINEAR (1):

Piecewise linear interpolation will be applied.

class google.cloud.dialogflowcx_v3beta1.types.BoostSpecs(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Boost specifications for data stores.

data_stores

Optional. Data Stores where the boosting configuration is applied. The full names of the referenced data stores. Formats: projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store} `projects/{project}/locations/{location}/dataStores/{data_store}

Type

MutableSequence[str]

spec

Optional. A list of boosting specifications.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.BoostSpec]

class google.cloud.dialogflowcx_v3beta1.types.CalculateCoverageRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TestCases.CalculateCoverage][google.cloud.dialogflow.cx.v3beta1.TestCases.CalculateCoverage].

agent

Required. The agent to calculate coverage for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

type_

Required. The type of coverage requested.

Type

google.cloud.dialogflowcx_v3beta1.types.CalculateCoverageRequest.CoverageType

class CoverageType(value)

Bases: proto.enums.Enum

The type of coverage score requested.

Values:

COVERAGE_TYPE_UNSPECIFIED (0):

Should never be used.

INTENT (1):

Intent coverage.

PAGE_TRANSITION (2):

Page transition coverage.

TRANSITION_ROUTE_GROUP (3):

Transition route group coverage.

class google.cloud.dialogflowcx_v3beta1.types.CalculateCoverageResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [TestCases.CalculateCoverage][google.cloud.dialogflow.cx.v3beta1.TestCases.CalculateCoverage].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

agent

The agent to calculate coverage for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

intent_coverage

Intent coverage.

This field is a member of oneof coverage_type.

Type

google.cloud.dialogflowcx_v3beta1.types.IntentCoverage

transition_coverage

Transition (excluding transition route groups) coverage.

This field is a member of oneof coverage_type.

Type

google.cloud.dialogflowcx_v3beta1.types.TransitionCoverage

route_group_coverage

Transition route group coverage.

This field is a member of oneof coverage_type.

Type

google.cloud.dialogflowcx_v3beta1.types.TransitionRouteGroupCoverage

class google.cloud.dialogflowcx_v3beta1.types.Changelog(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Changelogs represents a change made to a given agent.

name

The unique identifier of the changelog. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/changelogs/<ChangelogID>.

Type

str

user_email

Email address of the authenticated user.

Type

str

display_name

The affected resource display name of the change.

Type

str

action

The action of the change.

Type

str

type_

The affected resource type.

Type

str

resource

The affected resource name of the change.

Type

str

create_time

The timestamp of the change.

Type

google.protobuf.timestamp_pb2.Timestamp

language_code

The affected language code of the change.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.CloudConversationDebuggingInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Cloud conversation info for easier debugging. It will get populated in StreamingDetectIntentResponse or StreamingAnalyzeContentResponse when the flag enable_debugging_info is set to true in corresponding requests.

audio_data_chunks

Number of input audio data chunks in streaming requests.

Type

int

result_end_time_offset

Time offset of the end of speech utterance relative to the beginning of the first audio chunk.

Type

google.protobuf.duration_pb2.Duration

first_audio_duration

Duration of first audio chunk.

Type

google.protobuf.duration_pb2.Duration

single_utterance

Whether client used single utterance mode.

Type

bool

speech_partial_results_end_times

Time offsets of the speech partial results relative to the beginning of the stream.

Type

MutableSequence[google.protobuf.duration_pb2.Duration]

speech_final_results_end_times

Time offsets of the speech final results (is_final=true) relative to the beginning of the stream.

Type

MutableSequence[google.protobuf.duration_pb2.Duration]

partial_responses

Total number of partial responses.

Type

int

speaker_id_passive_latency_ms_offset

Time offset of Speaker ID stream close time relative to the Speech stream close time in milliseconds. Only meaningful for conversations involving passive verification.

Type

int

bargein_event_triggered

Whether a barge-in event is triggered in this request.

Type

bool

speech_single_utterance

Whether speech uses single utterance mode.

Type

bool

dtmf_partial_results_times

Time offsets of the DTMF partial results relative to the beginning of the stream.

Type

MutableSequence[google.protobuf.duration_pb2.Duration]

dtmf_final_results_times

Time offsets of the DTMF final results relative to the beginning of the stream.

Type

MutableSequence[google.protobuf.duration_pb2.Duration]

single_utterance_end_time_offset

Time offset of the end-of-single-utterance signal relative to the beginning of the stream.

Type

google.protobuf.duration_pb2.Duration

no_speech_timeout

No speech timeout settings for the stream.

Type

google.protobuf.duration_pb2.Duration

endpointing_timeout

Speech endpointing timeout settings for the stream.

Type

google.protobuf.duration_pb2.Duration

is_input_text

Whether the streaming terminates with an injected text query.

Type

bool

client_half_close_time_offset

Client half close time in terms of input audio duration.

Type

google.protobuf.duration_pb2.Duration

client_half_close_streaming_time_offset

Client half close time in terms of API streaming duration.

Type

google.protobuf.duration_pb2.Duration

class google.cloud.dialogflowcx_v3beta1.types.CompareVersionsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Versions.CompareVersions][google.cloud.dialogflow.cx.v3beta1.Versions.CompareVersions].

base_version

Required. Name of the base flow version to compare with the target version. Use version ID 0 to indicate the draft version of the specified flow.

Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>.

Type

str

target_version

Required. Name of the target flow version to compare with the base version. Use version ID 0 to indicate the draft version of the specified flow. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>.

Type

str

language_code

The language to compare the flow versions for.

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.CompareVersionsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Versions.CompareVersions][google.cloud.dialogflow.cx.v3beta1.Versions.CompareVersions].

base_version_content_json

JSON representation of the base version content.

Type

str

target_version_content_json

JSON representation of the target version content.

Type

str

compare_time

The timestamp when the two version compares.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.dialogflowcx_v3beta1.types.ContinuousTestResult(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a result from running a test case in an agent environment.

name

The resource name for the continuous test result. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/continuousTestResults/<ContinuousTestResultID>.

Type

str

result

The result of this continuous test run, i.e. whether all the tests in this continuous test run pass or not.

Type

google.cloud.dialogflowcx_v3beta1.types.ContinuousTestResult.AggregatedTestResult

test_case_results

A list of individual test case results names in this continuous test run.

Type

MutableSequence[str]

run_time

Time when the continuous testing run starts.

Type

google.protobuf.timestamp_pb2.Timestamp

class AggregatedTestResult(value)

Bases: proto.enums.Enum

The overall result for a continuous test run in an agent environment.

Values:

AGGREGATED_TEST_RESULT_UNSPECIFIED (0):

Not specified. Should never be used.

PASSED (1):

All the tests passed.

FAILED (2):

At least one test did not pass.

class google.cloud.dialogflowcx_v3beta1.types.Conversation(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a conversation.

name

Identifier. The identifier of the conversation. If conversation ID is reused, interactions happened later than 48 hours of the conversation’s create time will be ignored. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/conversations/<ConversationID>

Type

str

type_

The type of the conversation.

Type

google.cloud.dialogflowcx_v3beta1.types.Conversation.Type

language_code

The language of the conversation, which is the language of the first request in the conversation.

Type

str

start_time

Start time of the conversation, which is the time of the first request of the conversation.

Type

google.protobuf.timestamp_pb2.Timestamp

duration

Duration of the conversation.

Type

google.protobuf.duration_pb2.Duration

metrics

Conversation metrics.

Type

google.cloud.dialogflowcx_v3beta1.types.Conversation.Metrics

intents

All the matched [Intent][google.cloud.dialogflow.cx.v3beta1.Intent] in the conversation. Only name and display_name are filled in this message.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Intent]

flows

All the [Flow][google.cloud.dialogflow.cx.v3beta1.Flow] the conversation has went through. Only name and display_name are filled in this message.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Flow]

pages

All the [Page][google.cloud.dialogflow.cx.v3beta1.Page] the conversation has went through. Only name and display_name are filled in this message.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Page]

interactions

Interactions of the conversation. Only populated for GetConversation and empty for ListConversations.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Conversation.Interaction]

environment

Environment of the conversation. Only name and display_name are filled in this message.

Type

google.cloud.dialogflowcx_v3beta1.types.Environment

flow_versions

Flow versions used in the conversation.

Type

MutableMapping[str, int]

class FlowVersionsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class Interaction(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents an interaction between an end user and a Dialogflow CX agent using V3 (Streaming)DetectIntent API, or an interaction between an end user and a Dialogflow CX agent using V2 (Streaming)AnalyzeContent API.

request

The request of the interaction.

Type

google.cloud.dialogflowcx_v3beta1.types.DetectIntentRequest

response

The final response of the interaction.

Type

google.cloud.dialogflowcx_v3beta1.types.DetectIntentResponse

partial_responses

The partial responses of the interaction. Empty if there is no partial response in the interaction. See the [partial response documentation][https://cloud.google.com/dialogflow/cx/docs/concept/fulfillment#queue].

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.DetectIntentResponse]

request_utterances

The input text or the transcript of the input audio in the request.

Type

str

response_utterances

The output text or the transcript of the output audio in the responses. If multiple output messages are returned, they will be concatenated into one.

Type

str

create_time

The time that the interaction was created.

Type

google.protobuf.timestamp_pb2.Timestamp

missing_transition

Missing transition predicted for the interaction. This field is set only if the interaction match type was no-match.

Type

google.cloud.dialogflowcx_v3beta1.types.Conversation.Interaction.MissingTransition

class MissingTransition(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Information collected for DF CX agents in case NLU predicted an intent that was filtered out as being inactive which may indicate a missing transition and/or absent functionality.

intent_display_name

Name of the intent that could have triggered.

Type

str

score

Score of the above intent. The higher it is the more likely a transition was missed on a given page.

Type

float

class Metrics(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents metrics for the conversation.

interaction_count

The number of interactions in the conversation.

Type

int

input_audio_duration

Duration of all the input’s audio in the conversation.

Type

google.protobuf.duration_pb2.Duration

output_audio_duration

Duration of all the output’s audio in the conversation.

Type

google.protobuf.duration_pb2.Duration

max_webhook_latency

Maximum latency of the [Webhook][google.cloud.dialogflow.cx.v3beta1.Webhook] calls in the conversation.

Type

google.protobuf.duration_pb2.Duration

has_end_interaction

A signal that indicates the interaction with the Dialogflow agent has ended. If any response has the [ResponseMessage.end_interaction][google.cloud.dialogflow.cx.v3beta1.ResponseMessage.end_interaction] signal, this is set to true.

Type

bool

has_live_agent_handoff

Hands off conversation to a human agent. If any response has the [ResponseMessage.live_agent_handoff][google.cloud.dialogflow.cx.v3beta1.ResponseMessage.live_agent_handoff]signal, this is set to true.

Type

bool

average_match_confidence

The average confidence all of the [Match][google.cloud.dialogflow.cx.v3beta1.Match] in the conversation. Values range from 0.0 (completely uncertain) to 1.0 (completely certain).

Type

float

query_input_count

Query input counts.

Type

google.cloud.dialogflowcx_v3beta1.types.Conversation.Metrics.QueryInputCount

match_type_count

Match type counts.

Type

google.cloud.dialogflowcx_v3beta1.types.Conversation.Metrics.MatchTypeCount

class MatchTypeCount(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Count by [Match.MatchType][google.cloud.dialogflow.cx.v3beta1.Match.MatchType] of the matches in the conversation.

unspecified_count

The number of matches with type [Match.MatchType.MATCH_TYPE_UNSPECIFIED][google.cloud.dialogflow.cx.v3beta1.Match.MatchType.MATCH_TYPE_UNSPECIFIED].

Type

int

intent_count

The number of matches with type [Match.MatchType.INTENT][google.cloud.dialogflow.cx.v3beta1.Match.MatchType.INTENT].

Type

int

direct_intent_count

The number of matches with type [Match.MatchType.DIRECT_INTENT][google.cloud.dialogflow.cx.v3beta1.Match.MatchType.DIRECT_INTENT].

Type

int

parameter_filling_count

The number of matches with type [Match.MatchType.PARAMETER_FILLING][google.cloud.dialogflow.cx.v3beta1.Match.MatchType.PARAMETER_FILLING].

Type

int

no_match_count

The number of matches with type [Match.MatchType.NO_MATCH][google.cloud.dialogflow.cx.v3beta1.Match.MatchType.NO_MATCH].

Type

int

no_input_count

The number of matches with type [Match.MatchType.NO_INPUT][google.cloud.dialogflow.cx.v3beta1.Match.MatchType.NO_INPUT].

Type

int

event_count

The number of matches with type [Match.MatchType.EVENT][google.cloud.dialogflow.cx.v3beta1.Match.MatchType.EVENT].

Type

int

class QueryInputCount(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Count by types of [QueryInput][google.cloud.dialogflow.cx.v3beta1.QueryInput] of the requests in the conversation.

text_count

The number of [TextInput][google.cloud.dialogflow.cx.v3beta1.TextInput] in the conversation.

Type

int

intent_count

The number of [IntentInput][google.cloud.dialogflow.cx.v3beta1.IntentInput] in the conversation.

Type

int

audio_count

The number of [AudioInput][google.cloud.dialogflow.cx.v3beta1.AudioInput] in the conversation.

Type

int

event_count

The number of [EventInput][google.cloud.dialogflow.cx.v3beta1.EventInput] in the conversation.

Type

int

dtmf_count

The number of [DtmfInput][google.cloud.dialogflow.cx.v3beta1.DtmfInput] in the conversation.

Type

int

class Type(value)

Bases: proto.enums.Enum

Represents the type of a conversation.

Values:

TYPE_UNSPECIFIED (0):

Not specified. This value should never be used.

AUDIO (1):

Audio conversation. A conversation is classified as an audio conversation if any request has STT input audio or any response has TTS output audio.

TEXT (2):

Text conversation. A conversation is classified as a text conversation if any request has text input and no request has STT input audio and no response has TTS output audio.

UNDETERMINED (3):

Default conversation type for a conversation. A conversation is classified as undetermined if none of the requests contain text or audio input (eg. event or intent input).

class google.cloud.dialogflowcx_v3beta1.types.ConversationTurn(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

One interaction between a human and virtual agent. The human provides some input and the virtual agent provides a response.

user_input

The user input.

Type

google.cloud.dialogflowcx_v3beta1.types.ConversationTurn.UserInput

virtual_agent_output

The virtual agent output.

Type

google.cloud.dialogflowcx_v3beta1.types.ConversationTurn.VirtualAgentOutput

class UserInput(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The input from the human user.

input

Supports [text input][google.cloud.dialogflow.cx.v3beta1.QueryInput.text], [event input][google.cloud.dialogflow.cx.v3beta1.QueryInput.event], [dtmf input][google.cloud.dialogflow.cx.v3beta1.QueryInput.dtmf] in the test case.

Type

google.cloud.dialogflowcx_v3beta1.types.QueryInput

injected_parameters

Parameters that need to be injected into the conversation during intent detection.

Type

google.protobuf.struct_pb2.Struct

is_webhook_enabled

If webhooks should be allowed to trigger in response to the user utterance. Often if parameters are injected, webhooks should not be enabled.

Type

bool

enable_sentiment_analysis

Whether sentiment analysis is enabled.

Type

bool

class VirtualAgentOutput(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The output from the virtual agent.

session_parameters

The session parameters available to the bot at this point.

Type

google.protobuf.struct_pb2.Struct

differences

Output only. If this is part of a [result conversation turn][TestCaseResult.conversation_turns], the list of differences between the original run and the replay for this output, if any.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TestRunDifference]

diagnostic_info

Required. Input only. The diagnostic [info][Session.DetectIntentResponse.QueryResult.diagnostic_info] output for the turn. Required to calculate the testing coverage.

Type

google.protobuf.struct_pb2.Struct

triggered_intent

The [Intent][google.cloud.dialogflow.cx.v3beta1.Intent] that triggered the response. Only name and displayName will be set.

Type

google.cloud.dialogflowcx_v3beta1.types.Intent

current_page

The [Page][google.cloud.dialogflow.cx.v3beta1.Page] on which the utterance was spoken. Only name and displayName will be set.

Type

google.cloud.dialogflowcx_v3beta1.types.Page

text_responses

The [text][google.cloud.dialogflow.cx.v3beta1.ResponseMessage.Text] responses from the agent for the turn.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ResponseMessage.Text]

status

Response error from the agent in the test result. If set, other output is empty.

Type

google.rpc.status_pb2.Status

class google.cloud.dialogflowcx_v3beta1.types.CreateAgentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Agents.CreateAgent][google.cloud.dialogflow.cx.v3beta1.Agents.CreateAgent].

parent

Required. The location to create a agent for. Format: projects/<ProjectID>/locations/<LocationID>.

Type

str

agent

Required. The agent to create.

Type

google.cloud.dialogflowcx_v3beta1.types.Agent

class google.cloud.dialogflowcx_v3beta1.types.CreateEntityTypeRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [EntityTypes.CreateEntityType][google.cloud.dialogflow.cx.v3beta1.EntityTypes.CreateEntityType].

parent

Required. The agent to create a entity type for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

entity_type

Required. The entity type to create.

Type

google.cloud.dialogflowcx_v3beta1.types.EntityType

language_code

The language of the following fields in entity_type:

• EntityType.entities.value

• EntityType.entities.synonyms

• EntityType.excluded_phrases.value

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.CreateEnvironmentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Environments.CreateEnvironment][google.cloud.dialogflow.cx.v3beta1.Environments.CreateEnvironment].

parent

Required. The [Agent][google.cloud.dialogflow.cx.v3beta1.Agent] to create an [Environment][google.cloud.dialogflow.cx.v3beta1.Environment] for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

environment

Required. The environment to create.

Type

google.cloud.dialogflowcx_v3beta1.types.Environment

class google.cloud.dialogflowcx_v3beta1.types.CreateExampleRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Examples.CreateExample][google.cloud.dialogflow.cx.v3beta1.Examples.CreateExample].

parent

Required. The playbook to create an example for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>.

Type

str

example

Required. The example to create.

Type

google.cloud.dialogflowcx_v3beta1.types.Example

class google.cloud.dialogflowcx_v3beta1.types.CreateExperimentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Experiments.CreateExperiment][google.cloud.dialogflow.cx.v3beta1.Experiments.CreateExperiment].

parent

Required. The [Agent][google.cloud.dialogflow.cx.v3beta1.Agent] to create an [Environment][google.cloud.dialogflow.cx.v3beta1.Environment] for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

experiment

Required. The experiment to create.

Type

google.cloud.dialogflowcx_v3beta1.types.Experiment

class google.cloud.dialogflowcx_v3beta1.types.CreateFlowRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Flows.CreateFlow][google.cloud.dialogflow.cx.v3beta1.Flows.CreateFlow].

parent

Required. The agent to create a flow for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

flow

Required. The flow to create.

Type

google.cloud.dialogflowcx_v3beta1.types.Flow

language_code

The language of the following fields in flow:

• Flow.event_handlers.trigger_fulfillment.messages

• Flow.event_handlers.trigger_fulfillment.conditional_cases

• Flow.transition_routes.trigger_fulfillment.messages

• Flow.transition_routes.trigger_fulfillment.conditional_cases

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.CreateGeneratorRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Generators.CreateGenerator][google.cloud.dialogflow.cx.v3beta1.Generators.CreateGenerator].

parent

Required. The agent to create a generator for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

generator

Required. The generator to create.

Type

google.cloud.dialogflowcx_v3beta1.types.Generator

language_code

The language to create generators for the following fields:

• Generator.prompt_text.text If not specified, the agent’s default language is used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.CreateIntentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Intents.CreateIntent][google.cloud.dialogflow.cx.v3beta1.Intents.CreateIntent].

parent

Required. The agent to create an intent for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

intent

Required. The intent to create.

Type

google.cloud.dialogflowcx_v3beta1.types.Intent

language_code

The language of the following fields in intent:

• Intent.training_phrases.parts.text

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.CreatePageRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Pages.CreatePage][google.cloud.dialogflow.cx.v3beta1.Pages.CreatePage].

parent

Required. The flow to create a page for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Type

str

page

Required. The page to create.

Type

google.cloud.dialogflowcx_v3beta1.types.Page

language_code

The language of the following fields in page:

• Page.entry_fulfillment.messages

• Page.entry_fulfillment.conditional_cases

• Page.event_handlers.trigger_fulfillment.messages

• Page.event_handlers.trigger_fulfillment.conditional_cases

• Page.form.parameters.fill_behavior.initial_prompt_fulfillment.messages

Page.form.parameters.fill_behavior.initial_prompt_fulfillment.conditional_cases

• Page.form.parameters.fill_behavior.reprompt_event_handlers.messages

Page.form.parameters.fill_behavior.reprompt_event_handlers.conditional_cases

• Page.transition_routes.trigger_fulfillment.messages

• Page.transition_routes.trigger_fulfillment.conditional_cases

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.CreatePlaybookRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Playbooks.CreatePlaybook][google.cloud.dialogflow.cx.v3beta1.Playbooks.CreatePlaybook].

parent

Required. The agent to create a playbook for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

playbook

Required. The playbook to create.

Type

google.cloud.dialogflowcx_v3beta1.types.Playbook

class google.cloud.dialogflowcx_v3beta1.types.CreatePlaybookVersionRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Playbooks.CreatePlaybookVersion][google.cloud.dialogflow.cx.v3beta1.Playbooks.CreatePlaybookVersion].

parent

Required. The playbook to create a version for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>.

Type

str

playbook_version

Required. The playbook version to create.

Type

google.cloud.dialogflowcx_v3beta1.types.PlaybookVersion

class google.cloud.dialogflowcx_v3beta1.types.CreateSecuritySettingsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [SecuritySettings.CreateSecuritySettings][].

parent

Required. The location to create an [SecuritySettings][google.cloud.dialogflow.cx.v3beta1.SecuritySettings] for. Format: projects/<ProjectID>/locations/<LocationID>.

Type

str

security_settings

Required. The security settings to create.

Type

google.cloud.dialogflowcx_v3beta1.types.SecuritySettings

class google.cloud.dialogflowcx_v3beta1.types.CreateSessionEntityTypeRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [SessionEntityTypes.CreateSessionEntityType][google.cloud.dialogflow.cx.v3beta1.SessionEntityTypes.CreateSessionEntityType].

parent

Required. The session to create a session entity type for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>. If Environment ID is not specified, we assume default ‘draft’ environment.

Type

str

session_entity_type

Required. The session entity type to create.

Type

google.cloud.dialogflowcx_v3beta1.types.SessionEntityType

class google.cloud.dialogflowcx_v3beta1.types.CreateTestCaseRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TestCases.CreateTestCase][google.cloud.dialogflow.cx.v3beta1.TestCases.CreateTestCase].

parent

Required. The agent to create the test case for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

test_case

Required. The test case to create.

Type

google.cloud.dialogflowcx_v3beta1.types.TestCase

class google.cloud.dialogflowcx_v3beta1.types.CreateToolRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Tools.CreateTool][google.cloud.dialogflow.cx.v3beta1.Tools.CreateTool].

parent

Required. The agent to create a Tool for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

tool

Required. The Tool to be created.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool

class google.cloud.dialogflowcx_v3beta1.types.CreateTransitionRouteGroupRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TransitionRouteGroups.CreateTransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroups.CreateTransitionRouteGroup].

parent

Required. The flow to create an [TransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroup] for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID> for agent-level groups.

Type

str

transition_route_group

Required. The transition route group to create.

Type

google.cloud.dialogflowcx_v3beta1.types.TransitionRouteGroup

language_code

The language of the following fields in TransitionRouteGroup:

• TransitionRouteGroup.transition_routes.trigger_fulfillment.messages

TransitionRouteGroup.transition_routes.trigger_fulfillment.conditional_cases

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.CreateVersionOperationMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metadata associated with the long running operation for [Versions.CreateVersion][google.cloud.dialogflow.cx.v3beta1.Versions.CreateVersion].

version

Name of the created version. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.CreateVersionRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Versions.CreateVersion][google.cloud.dialogflow.cx.v3beta1.Versions.CreateVersion].

parent

Required. The [Flow][google.cloud.dialogflow.cx.v3beta1.Flow] to create an [Version][google.cloud.dialogflow.cx.v3beta1.Version] for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Type

str

version

Required. The version to create.

Type

google.cloud.dialogflowcx_v3beta1.types.Version

class google.cloud.dialogflowcx_v3beta1.types.CreateWebhookRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Webhooks.CreateWebhook][google.cloud.dialogflow.cx.v3beta1.Webhooks.CreateWebhook].

parent

Required. The agent to create a webhook for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

webhook

Required. The webhook to create.

Type

google.cloud.dialogflowcx_v3beta1.types.Webhook

class google.cloud.dialogflowcx_v3beta1.types.DataStoreConnection(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A data store connection. It represents a data store in Discovery Engine and the type of the contents it contains.

data_store_type

The type of the connected data store.

Type

google.cloud.dialogflowcx_v3beta1.types.DataStoreType

data_store

The full name of the referenced data store. Formats: projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store} projects/{project}/locations/{location}/dataStores/{data_store}

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Data store connection feature output signals. Might be only partially field if processing stop before the final answer. Reasons for this can be, but are not limited to: empty UCS search results, positive RAI check outcome, grounding failure, …

rewriter_model_call_signals

Optional. Diagnostic info related to the rewriter model call.

Type

google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals.RewriterModelCallSignals

rewritten_query

Optional. Rewritten string query used for search.

Type

str

search_snippets

Optional. Search snippets included in the answer generation prompt.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals.SearchSnippet]

answer_generation_model_call_signals

Optional. Diagnostic info related to the answer generation model call.

Type

google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals.AnswerGenerationModelCallSignals

answer

Optional. The final compiled answer.

Type

str

answer_parts

Optional. Answer parts with relevant citations. Concatenation of texts should add up the answer (not counting whitespaces).

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals.AnswerPart]

cited_snippets

Optional. Snippets cited by the answer generation model from the most to least relevant.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals.CitedSnippet]

grounding_signals

Optional. Grounding signals.

Type

google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals.GroundingSignals

safety_signals

Optional. Safety check result.

Type

google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals.SafetySignals

class AnswerGenerationModelCallSignals(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Diagnostic info related to the answer generation model call.

rendered_prompt

Prompt as sent to the model.

Type

str

model_output

Output of the generative model.

Type

str

model

Name of the generative model. For example, “gemini-ultra”, “gemini-pro”, “gemini-1.5-flash” etc. Defaults to “Other” if the model is unknown.

Type

str

class AnswerPart(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Answer part with citation.

text

Substring of the answer.

Type

str

supporting_indices

Citations for this answer part. Indices of search_snippets.

Type

MutableSequence[int]

class CitedSnippet(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Snippet cited by the answer generation model.

search_snippet

Details of the snippet.

Type

google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals.SearchSnippet

snippet_index

Index of the snippet in search_snippets field.

Type

int

class GroundingSignals(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Grounding signals.

decision

Represents the decision of the grounding check.

Type

google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals.GroundingSignals.GroundingDecision

score

Grounding score bucket setting.

Type

google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals.GroundingSignals.GroundingScoreBucket

class GroundingDecision(value)

Bases: proto.enums.Enum

Represents the decision of the grounding check.

Values:

GROUNDING_DECISION_UNSPECIFIED (0):

Decision not specified.

ACCEPTED_BY_GROUNDING (1):

Grounding have accepted the answer.

REJECTED_BY_GROUNDING (2):

Grounding have rejected the answer.

class GroundingScoreBucket(value)

Bases: proto.enums.Enum

Grounding score buckets.

Values:

GROUNDING_SCORE_BUCKET_UNSPECIFIED (0):

Score not specified.

VERY_LOW (1):

We have very low confidence that the answer is grounded.

LOW (3):

We have low confidence that the answer is grounded.

MEDIUM (4):

We have medium confidence that the answer is grounded.

HIGH (5):

We have high confidence that the answer is grounded.

VERY_HIGH (6):

We have very high confidence that the answer is grounded.

class RewriterModelCallSignals(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Diagnostic info related to the rewriter model call.

rendered_prompt

Prompt as sent to the model.

Type

str

model_output

Output of the generative model.

Type

str

model

Name of the generative model. For example, “gemini-ultra”, “gemini-pro”, “gemini-1.5-flash” etc. Defaults to “Other” if the model is unknown.

Type

str

class SafetySignals(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Safety check results.

decision

Safety decision.

Type

google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals.SafetySignals.SafetyDecision

banned_phrase_match

Specifies banned phrase match subject.

Type

google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals.SafetySignals.BannedPhraseMatch

matched_banned_phrase

The matched banned phrase if there was a match.

Type

str

class BannedPhraseMatch(value)

Bases: proto.enums.Enum

Specifies banned phrase match subject.

Values:

BANNED_PHRASE_MATCH_UNSPECIFIED (0):

No banned phrase check was executed.

BANNED_PHRASE_MATCH_NONE (1):

All banned phrase checks led to no match.

BANNED_PHRASE_MATCH_QUERY (2):

A banned phrase matched the query.

BANNED_PHRASE_MATCH_RESPONSE (3):

A banned phrase matched the response.

class SafetyDecision(value)

Bases: proto.enums.Enum

Safety decision. All kinds of check are incorporated into this final decision, including banned phrases check.

Values:

SAFETY_DECISION_UNSPECIFIED (0):

Decision not specified.

ACCEPTED_BY_SAFETY_CHECK (1):

No manual or automatic safety check fired.

REJECTED_BY_SAFETY_CHECK (2):

One ore more safety checks fired.

class SearchSnippet(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Search snippet details.

document_title

Title of the enclosing document.

Type

str

document_uri

Uri for the document. Present if specified for the document.

Type

str

text

Text included in the prompt.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DataStoreType(value)

Bases: proto.enums.Enum

Type of a data store. Determines how search is performed in the data store.

Values:

DATA_STORE_TYPE_UNSPECIFIED (0):

Not specified. This value indicates that the data store type is not specified, so it will not be used during search.

PUBLIC_WEB (1):

A data store that contains public web content.

UNSTRUCTURED (2):

A data store that contains unstructured private data.

STRUCTURED (3):

A data store that contains structured data (for example FAQ).

class google.cloud.dialogflowcx_v3beta1.types.DeleteAgentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Agents.DeleteAgent][google.cloud.dialogflow.cx.v3beta1.Agents.DeleteAgent].

name

Required. The name of the agent to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DeleteConversationRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Conversations.DeleteConversation][].

name

Required. The name of the conversation. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/conversations/<ConversationID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DeleteEntityTypeRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [EntityTypes.DeleteEntityType][google.cloud.dialogflow.cx.v3beta1.EntityTypes.DeleteEntityType].

name

Required. The name of the entity type to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/entityTypes/<EntityTypeID>.

Type

str

force

This field has no effect for entity type not being used. For entity types that are used by intents or pages:

• If force is set to false, an error will be returned with message indicating the referencing resources.

• If force is set to true, Dialogflow will remove the entity type, as well as any references to the entity type (i.e. Page [parameter][google.cloud.dialogflow.cx.v3beta1.Form.Parameter] of the entity type will be changed to ‘@sys.any’ and intent [parameter][google.cloud.dialogflow.cx.v3beta1.Intent.Parameter] of the entity type will be removed).

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.DeleteEnvironmentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Environments.DeleteEnvironment][google.cloud.dialogflow.cx.v3beta1.Environments.DeleteEnvironment].

name

Required. The name of the [Environment][google.cloud.dialogflow.cx.v3beta1.Environment] to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DeleteExampleRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Examples.DeleteExample][google.cloud.dialogflow.cx.v3beta1.Examples.DeleteExample].

name

Required. The name of the example to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>/examples/<ExampleID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DeleteExperimentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Experiments.DeleteExperiment][google.cloud.dialogflow.cx.v3beta1.Experiments.DeleteExperiment].

name

Required. The name of the [Environment][google.cloud.dialogflow.cx.v3beta1.Environment] to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/experiments/<ExperimentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DeleteFlowRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Flows.DeleteFlow][google.cloud.dialogflow.cx.v3beta1.Flows.DeleteFlow].

name

Required. The name of the flow to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Type

str

force

This field has no effect for flows with no incoming transitions. For flows with incoming transitions:

• If force is set to false, an error will be returned with message indicating the incoming transitions.

• If force is set to true, Dialogflow will remove the flow, as well as any transitions to the flow (i.e. [Target flow][EventHandler.target_flow] in event handlers or [Target flow][TransitionRoute.target_flow] in transition routes that point to this flow will be cleared).

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.DeleteGeneratorRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Generators.DeleteGenerator][google.cloud.dialogflow.cx.v3beta1.Generators.DeleteGenerator].

name

Required. The name of the generator to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/generators/<GeneratorID>.

Type

str

force

This field has no effect for generators not being used. For generators that are used by pages/flows/transition route groups:

• If force is set to false, an error will be returned with message indicating the referenced resources.

• If force is set to true, Dialogflow will remove the generator, as well as any references to the generator (i.e. [Generator][Fulfillment.generator]) in fulfillments.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.DeleteIntentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Intents.DeleteIntent][google.cloud.dialogflow.cx.v3beta1.Intents.DeleteIntent].

name

Required. The name of the intent to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/intents/<IntentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DeletePageRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Pages.DeletePage][google.cloud.dialogflow.cx.v3beta1.Pages.DeletePage].

name

Required. The name of the page to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/Flows/<flowID>/pages/<PageID>.

Type

str

force

This field has no effect for pages with no incoming transitions. For pages with incoming transitions:

• If force is set to false, an error will be returned with message indicating the incoming transitions.

• If force is set to true, Dialogflow will remove the page, as well as any transitions to the page (i.e. [Target page][EventHandler.target_page] in event handlers or [Target page][TransitionRoute.target_page] in transition routes that point to this page will be cleared).

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.DeletePlaybookRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Playbooks.DeletePlaybook][google.cloud.dialogflow.cx.v3beta1.Playbooks.DeletePlaybook].

name

Required. The name of the playbook to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DeletePlaybookVersionRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Playbooks.DeletePlaybookVersion][google.cloud.dialogflow.cx.v3beta1.Playbooks.DeletePlaybookVersion].

name

Required. The name of the playbook version to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>/versions/<VersionID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DeleteSecuritySettingsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [SecuritySettings.DeleteSecuritySettings][].

name

Required. The name of the [SecuritySettings][google.cloud.dialogflow.cx.v3beta1.SecuritySettings] to delete. Format: projects/<ProjectID>/locations/<LocationID>/securitySettings/<SecuritySettingsID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DeleteSessionEntityTypeRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [SessionEntityTypes.DeleteSessionEntityType][google.cloud.dialogflow.cx.v3beta1.SessionEntityTypes.DeleteSessionEntityType].

name

Required. The name of the session entity type to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID>/entityTypes/<EntityTypeID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>/entityTypes/<EntityTypeID>. If Environment ID is not specified, we assume default ‘draft’ environment.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DeleteToolRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Tools.DeleteTool][google.cloud.dialogflow.cx.v3beta1.Tools.DeleteTool].

name

Required. The name of the Tool to be deleted. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/tools/<ToolID>.

Type

str

force

This field has no effect for Tools not being used. For Tools that are used:

• If force is set to false, an error will be returned with message indicating the referenced resources.

• If force is set to true, Dialogflow will remove the tool, as well as any references to the tool.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.DeleteTransitionRouteGroupRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TransitionRouteGroups.DeleteTransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroups.DeleteTransitionRouteGroup].

name

Required. The name of the [TransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroup] to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/transitionRouteGroups/<TransitionRouteGroupID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/transitionRouteGroups/<TransitionRouteGroupID>.

Type

str

force

This field has no effect for transition route group that no page is using. If the transition route group is referenced by any page:

• If force is set to false, an error will be returned with message indicating pages that reference the transition route group.

• If force is set to true, Dialogflow will remove the transition route group, as well as any reference to it.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.DeleteVersionRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Versions.DeleteVersion][google.cloud.dialogflow.cx.v3beta1.Versions.DeleteVersion].

name

Required. The name of the [Version][google.cloud.dialogflow.cx.v3beta1.Version] to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DeleteWebhookRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Webhooks.DeleteWebhook][google.cloud.dialogflow.cx.v3beta1.Webhooks.DeleteWebhook].

name

Required. The name of the webhook to delete. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/webhooks/<WebhookID>.

Type

str

force

This field has no effect for webhook not being used. For webhooks that are used by pages/flows/transition route groups:

• If force is set to false, an error will be returned with message indicating the referenced resources.

• If force is set to true, Dialogflow will remove the webhook, as well as any references to the webhook (i.e. [Webhook][google.cloud.dialogflow.cx.v3beta1.Fulfillment.webhook] and [tag][google.cloud.dialogflow.cx.v3beta1.Fulfillment.tag]in fulfillments that point to this webhook will be removed).

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.DeployFlowMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metadata returned for the [Environments.DeployFlow][google.cloud.dialogflow.cx.v3beta1.Environments.DeployFlow] long running operation.

test_errors

Errors of running deployment tests.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TestError]

class google.cloud.dialogflowcx_v3beta1.types.DeployFlowRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Environments.DeployFlow][google.cloud.dialogflow.cx.v3beta1.Environments.DeployFlow].

environment

Required. The environment to deploy the flow to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

flow_version

Required. The flow version to deploy. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.DeployFlowResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Environments.DeployFlow][google.cloud.dialogflow.cx.v3beta1.Environments.DeployFlow].

environment

The updated environment where the flow is deployed.

Type

google.cloud.dialogflowcx_v3beta1.types.Environment

deployment

The name of the flow version deployment. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/deployments/<DeploymentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.Deployment(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a deployment in an environment. A deployment happens when a flow version configured to be active in the environment. You can configure running pre-deployment steps, e.g. running validation test cases, experiment auto-rollout, etc.

name

The name of the deployment. Format:

projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/deployments/<DeploymentID>.

Type

str

flow_version

The name of the flow version for this deployment. Format:

projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VerionID>.

Type

str

state

The current state of the deployment.

Type

google.cloud.dialogflowcx_v3beta1.types.Deployment.State

result

Result of the deployment.

Type

google.cloud.dialogflowcx_v3beta1.types.Deployment.Result

start_time

Start time of this deployment.

Type

google.protobuf.timestamp_pb2.Timestamp

end_time

End time of this deployment.

Type

google.protobuf.timestamp_pb2.Timestamp

class Result(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Result of the deployment.

deployment_test_results

Results of test cases running before the deployment. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/testCases/<TestCaseID>/results/<TestCaseResultID>.

Type

MutableSequence[str]

experiment

The name of the experiment triggered by this deployment. Format:

projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/experiments/<ExperimentID>.

Type

str

class State(value)

Bases: proto.enums.Enum

The state of the deployment.

Values:

STATE_UNSPECIFIED (0):

State unspecified.

RUNNING (1):

The deployment is running.

SUCCEEDED (2):

The deployment succeeded.

FAILED (3):

The deployment failed.

class google.cloud.dialogflowcx_v3beta1.types.DetectIntentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request to detect user’s intent.

session

Required. The name of the session this query is sent to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>. If Environment ID is not specified, we assume default ‘draft’ environment. It’s up to the API caller to choose an appropriate Session ID. It can be a random number or some type of session identifiers (preferably hashed). The length of the Session ID must not exceed 36 characters.

For more information, see the sessions guide.

Note: Always use agent versions for production traffic. See Versions and environments.

Type

str

query_params

The parameters of this query.

Type

google.cloud.dialogflowcx_v3beta1.types.QueryParameters

query_input

Required. The input specification.

Type

google.cloud.dialogflowcx_v3beta1.types.QueryInput

output_audio_config

Instructs the speech synthesizer how to generate the output audio.

Type

google.cloud.dialogflowcx_v3beta1.types.OutputAudioConfig

class google.cloud.dialogflowcx_v3beta1.types.DetectIntentResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The message returned from the DetectIntent method.

response_id

Output only. The unique identifier of the response. It can be used to locate a response in the training example set or for reporting issues.

Type

str

query_result

The result of the conversational query.

Type

google.cloud.dialogflowcx_v3beta1.types.QueryResult

output_audio

The audio data bytes encoded as specified in the request. Note: The output audio is generated based on the values of default platform text responses found in the [query_result.response_messages][google.cloud.dialogflow.cx.v3beta1.QueryResult.response_messages] field. If multiple default text responses exist, they will be concatenated when generating audio. If no default platform text responses exist, the generated audio content will be empty.

In some scenarios, multiple output audio fields may be present in the response structure. In these cases, only the top-most-level audio output has content.

Type

bytes

output_audio_config

The config used by the speech synthesizer to generate the output audio.

Type

google.cloud.dialogflowcx_v3beta1.types.OutputAudioConfig

response_type

Response type.

Type

google.cloud.dialogflowcx_v3beta1.types.DetectIntentResponse.ResponseType

allow_cancellation

Indicates whether the partial response can be cancelled when a later response arrives. e.g. if the agent specified some music as partial response, it can be cancelled.

Type

bool

class ResponseType(value)

Bases: proto.enums.Enum

Represents different DetectIntentResponse types.

Values:

RESPONSE_TYPE_UNSPECIFIED (0):

Not specified. This should never happen.

PARTIAL (1):

Partial response. e.g. Aggregated responses in a Fulfillment that enables return_partial_response can be returned as partial response. WARNING: partial response is not eligible for barge-in.

FINAL (2):

Final response.

class google.cloud.dialogflowcx_v3beta1.types.DtmfInput(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the input for dtmf event.

digits

The dtmf digits.

Type

str

finish_digit

The finish digit (if any).

Type

str

class google.cloud.dialogflowcx_v3beta1.types.EntityType(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Entities are extracted from user input and represent parameters that are meaningful to your application. For example, a date range, a proper name such as a geographic location or landmark, and so on. Entities represent actionable data for your application.

When you define an entity, you can also include synonyms that all map to that entity. For example, “soft drink”, “soda”, “pop”, and so on.

There are three types of entities:

• System - entities that are defined by the Dialogflow API for common data types such as date, time, currency, and so on. A system entity is represented by the EntityType type.

• Custom - entities that are defined by you that represent actionable data that is meaningful to your application. For example, you could define a pizza.sauce entity for red or white pizza sauce, a pizza.cheese entity for the different types of cheese on a pizza, a pizza.topping entity for different toppings, and so on. A custom entity is represented by the EntityType type.

• User - entities that are built for an individual user such as favorites, preferences, playlists, and so on. A user entity is represented by the [SessionEntityType][google.cloud.dialogflow.cx.v3beta1.SessionEntityType] type.

For more information about entity types, see the Dialogflow documentation.

name

The unique identifier of the entity type. Required for [EntityTypes.UpdateEntityType][google.cloud.dialogflow.cx.v3beta1.EntityTypes.UpdateEntityType]. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/entityTypes/<EntityTypeID>.

Type

str

display_name

Required. The human-readable name of the entity type, unique within the agent.

Type

str

kind

Required. Indicates the kind of entity type.

Type

google.cloud.dialogflowcx_v3beta1.types.EntityType.Kind

auto_expansion_mode

Indicates whether the entity type can be automatically expanded.

Type

google.cloud.dialogflowcx_v3beta1.types.EntityType.AutoExpansionMode

entities

The collection of entity entries associated with the entity type.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.EntityType.Entity]

excluded_phrases

Collection of exceptional words and phrases that shouldn’t be matched. For example, if you have a size entity type with entry giant(an adjective), you might consider adding giants(a noun) as an exclusion. If the kind of entity type is KIND_MAP, then the phrases specified by entities and excluded phrases should be mutually exclusive.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.EntityType.ExcludedPhrase]

enable_fuzzy_extraction

Enables fuzzy entity extraction during classification.

Type

bool

redact

Indicates whether parameters of the entity type should be redacted in log. If redaction is enabled, page parameters and intent parameters referring to the entity type will be replaced by parameter name during logging.

Type

bool

class AutoExpansionMode(value)

Bases: proto.enums.Enum

Represents different entity type expansion modes. Automated expansion allows an agent to recognize values that have not been explicitly listed in the entity (for example, new kinds of shopping list items).

Values:

AUTO_EXPANSION_MODE_UNSPECIFIED (0):

Auto expansion disabled for the entity.

AUTO_EXPANSION_MODE_DEFAULT (1):

Allows an agent to recognize values that have not been explicitly listed in the entity.

class Entity(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

An entity entry for an associated entity type.

value

Required. The primary value associated with this entity entry. For example, if the entity type is vegetable, the value could be scallions.

For KIND_MAP entity types:

• A canonical value to be used in place of synonyms.

For KIND_LIST entity types:

• A string that can contain references to other entity types (with or without aliases).

Type

str

synonyms

Required. A collection of value synonyms. For example, if the entity type is vegetable, and value is scallions, a synonym could be green onions.

For KIND_LIST entity types:

• This collection must contain exactly one synonym equal to value.

Type

MutableSequence[str]

class ExcludedPhrase(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

An excluded entity phrase that should not be matched.

value

Required. The word or phrase to be excluded.

Type

str

class Kind(value)

Bases: proto.enums.Enum

Represents kinds of entities.

Values:

KIND_UNSPECIFIED (0):

Not specified. This value should be never used.

KIND_MAP (1):

Map entity types allow mapping of a group of synonyms to a canonical value.

KIND_LIST (2):

List entity types contain a set of entries that do not map to canonical values. However, list entity types can contain references to other entity types (with or without aliases).

KIND_REGEXP (3):

Regexp entity types allow to specify regular expressions in entries values.

class google.cloud.dialogflowcx_v3beta1.types.Environment(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents an environment for an agent. You can create multiple versions of your agent and publish them to separate environments. When you edit an agent, you are editing the draft agent. At any point, you can save the draft agent as an agent version, which is an immutable snapshot of your agent. When you save the draft agent, it is published to the default environment. When you create agent versions, you can publish them to custom environments. You can create a variety of custom environments for testing, development, production, etc.

name

The name of the environment. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

display_name

Required. The human-readable name of the environment (unique in an agent). Limit of 64 characters.

Type

str

description

The human-readable description of the environment. The maximum length is 500 characters. If exceeded, the request is rejected.

Type

str

version_configs

A list of configurations for flow versions. You should include version configs for all flows that are reachable from [Start Flow][Agent.start_flow] in the agent. Otherwise, an error will be returned.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Environment.VersionConfig]

update_time

Output only. Update time of this environment.

Type

google.protobuf.timestamp_pb2.Timestamp

test_cases_config

The test cases config for continuous tests of this environment.

Type

google.cloud.dialogflowcx_v3beta1.types.Environment.TestCasesConfig

webhook_config

The webhook configuration for this environment.

Type

google.cloud.dialogflowcx_v3beta1.types.Environment.WebhookConfig

class TestCasesConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The configuration for continuous tests.

test_cases

A list of test case names to run. They should be under the same agent. Format of each test case name: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/testCases/<TestCaseID>

Type

MutableSequence[str]

enable_continuous_run

Whether to run test cases in [TestCasesConfig.test_cases][google.cloud.dialogflow.cx.v3beta1.Environment.TestCasesConfig.test_cases] periodically. Default false. If set to true, run once a day.

Type

bool

enable_predeployment_run

Whether to run test cases in [TestCasesConfig.test_cases][google.cloud.dialogflow.cx.v3beta1.Environment.TestCasesConfig.test_cases] before deploying a flow version to the environment. Default false.

Type

bool

class VersionConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Configuration for the version.

version

Required. Both flow and playbook versions are supported. Format for flow version:

projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>. Format for playbook version:

projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>/versions/<VersionID>.

Type

str

class WebhookConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Configuration for webhooks.

webhook_overrides

The list of webhooks to override for the agent environment. The webhook must exist in the agent. You can override fields in [generic_web_service][google.cloud.dialogflow.cx.v3beta1.Webhook.generic_web_service] and [service_directory][google.cloud.dialogflow.cx.v3beta1.Webhook.service_directory].

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Webhook]

class google.cloud.dialogflowcx_v3beta1.types.EventHandler(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

An event handler specifies an [event][google.cloud.dialogflow.cx.v3beta1.EventHandler.event] that can be handled during a session. When the specified event happens, the following actions are taken in order:

• If there is a [trigger_fulfillment][google.cloud.dialogflow.cx.v3beta1.EventHandler.trigger_fulfillment] associated with the event, it will be called.

• If there is a [target_page][google.cloud.dialogflow.cx.v3beta1.EventHandler.target_page] associated with the event, the session will transition into the specified page.

• If there is a [target_flow][google.cloud.dialogflow.cx.v3beta1.EventHandler.target_flow] associated with the event, the session will transition into the specified flow.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

name

Output only. The unique identifier of this event handler.

Type

str

event

Required. The name of the event to handle.

Type

str

trigger_fulfillment

The fulfillment to call when the event occurs. Handling webhook errors with a fulfillment enabled with webhook could cause infinite loop. It is invalid to specify such fulfillment for a handler handling webhooks.

Type

google.cloud.dialogflowcx_v3beta1.types.Fulfillment

target_page

The target page to transition to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>.

This field is a member of oneof target.

Type

str

target_flow

The target flow to transition to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

This field is a member of oneof target.

Type

str

target_playbook

The target playbook to transition to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>.

This field is a member of oneof target.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.EventInput(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the event to trigger.

event

Name of the event.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.Example(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Example represents a sample execution of the playbook in the conversation. An example consists of a list of ordered actions performed by end user or Dialogflow agent according the playbook instructions to fulfill the task.

name

The unique identifier of the playbook example. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>/examples/<ExampleID>.

Type

str

playbook_input

Optional. The input to the playbook in the example.

Type

google.cloud.dialogflowcx_v3beta1.types.PlaybookInput

playbook_output

Optional. The output of the playbook in the example.

Type

google.cloud.dialogflowcx_v3beta1.types.PlaybookOutput

actions

Required. The ordered list of actions performed by the end user and the Dialogflow agent.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Action]

display_name

Required. The display name of the example.

Type

str

description

Optional. The high level concise description of the example. The max number of characters is 200.

Type

str

token_count

Output only. Estimated number of tokes current example takes when sent to the LLM.

Type

int

create_time

Output only. The timestamp of initial example creation.

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. Last time the example was updated.

Type

google.protobuf.timestamp_pb2.Timestamp

conversation_state

Required. Example’s output state.

Type

google.cloud.dialogflowcx_v3beta1.types.OutputState

language_code

Optional. The language code of the example. If not specified, the agent’s default language is used. Note: languages must be enabled in the agent before they can be used. Note: example’s language code is not currently used in dialogflow agents.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.Experiment(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents an experiment in an environment.

name

The name of the experiment. Format:

projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/experiments/<ExperimentID>.

Type

str

display_name

Required. The human-readable name of the experiment (unique in an environment). Limit of 64 characters.

Type

str

description

The human-readable description of the experiment.

Type

str

state

The current state of the experiment. Transition triggered by Experiments.StartExperiment: DRAFT->RUNNING. Transition triggered by Experiments.CancelExperiment: DRAFT->DONE or RUNNING->DONE.

Type

google.cloud.dialogflowcx_v3beta1.types.Experiment.State

definition

The definition of the experiment.

Type

google.cloud.dialogflowcx_v3beta1.types.Experiment.Definition

rollout_config

The configuration for auto rollout. If set, there should be exactly two variants in the experiment (control variant being the default version of the flow), the traffic allocation for the non-control variant will gradually increase to 100% when conditions are met, and eventually replace the control variant to become the default version of the flow.

Type

google.cloud.dialogflowcx_v3beta1.types.RolloutConfig

rollout_state

State of the auto rollout process.

Type

google.cloud.dialogflowcx_v3beta1.types.RolloutState

rollout_failure_reason

The reason why rollout has failed. Should only be set when state is ROLLOUT_FAILED.

Type

str

result

Inference result of the experiment.

Type

google.cloud.dialogflowcx_v3beta1.types.Experiment.Result

create_time

Creation time of this experiment.

Type

google.protobuf.timestamp_pb2.Timestamp

start_time

Start time of this experiment.

Type

google.protobuf.timestamp_pb2.Timestamp

end_time

End time of this experiment.

Type

google.protobuf.timestamp_pb2.Timestamp

last_update_time

Last update time of this experiment.

Type

google.protobuf.timestamp_pb2.Timestamp

experiment_length

Maximum number of days to run the experiment. If auto-rollout is not enabled, default value and maximum will be 30 days. If auto-rollout is enabled, default value and maximum will be 6 days.

Type

google.protobuf.duration_pb2.Duration

variants_history

The history of updates to the experiment variants.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.VariantsHistory]

class Definition(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Definition of the experiment.

condition

The condition defines which subset of sessions are selected for this experiment. If not specified, all sessions are eligible. E.g. “query_input.language_code=en” See the conditions reference.

Type

str

version_variants

The flow versions as the variants of this experiment.

This field is a member of oneof variants.

Type

google.cloud.dialogflowcx_v3beta1.types.VersionVariants

class Result(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The inference result which includes an objective metric to optimize and the confidence interval.

version_metrics

Version variants and metrics.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Experiment.Result.VersionMetrics]

last_update_time

The last time the experiment’s stats data was updated. Will have default value if stats have never been computed for this experiment.

Type

google.protobuf.timestamp_pb2.Timestamp

class ConfidenceInterval(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A confidence interval is a range of possible values for the experiment objective you are trying to measure.

confidence_level

The confidence level used to construct the interval, i.e. there is X% chance that the true value is within this interval.

Type

float

ratio

The percent change between an experiment metric’s value and the value for its control.

Type

float

lower_bound

Lower bound of the interval.

Type

float

upper_bound

Upper bound of the interval.

Type

float

class CountType(value)

Bases: proto.enums.Enum

types of count-based metric for Dialogflow experiment.

Values:

COUNT_TYPE_UNSPECIFIED (0):

Count type unspecified.

TOTAL_NO_MATCH_COUNT (1):

Total number of occurrences of a ‘NO_MATCH’.

TOTAL_TURN_COUNT (2):

Total number of turn counts.

AVERAGE_TURN_COUNT (3):

Average turn count in a session.

class Metric(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metric and corresponding confidence intervals.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

type_

Ratio-based metric type. Only one of type or count_type is specified in each Metric.

Type

google.cloud.dialogflowcx_v3beta1.types.Experiment.Result.MetricType

count_type

Count-based metric type. Only one of type or count_type is specified in each Metric.

Type

google.cloud.dialogflowcx_v3beta1.types.Experiment.Result.CountType

ratio

Ratio value of a metric.

This field is a member of oneof value.

Type

float

count

Count value of a metric.

This field is a member of oneof value.

Type

float

confidence_interval

The probability that the treatment is better than all other treatments in the experiment

Type

google.cloud.dialogflowcx_v3beta1.types.Experiment.Result.ConfidenceInterval

class MetricType(value)

Bases: proto.enums.Enum

Types of ratio-based metric for Dialogflow experiment.

Values:

METRIC_UNSPECIFIED (0):

Metric unspecified.

CONTAINED_SESSION_NO_CALLBACK_RATE (1):

Percentage of contained sessions without user calling back in 24 hours.

LIVE_AGENT_HANDOFF_RATE (2):

Percentage of sessions that were handed to a human agent.

CALLBACK_SESSION_RATE (3):

Percentage of sessions with the same user calling back.

ABANDONED_SESSION_RATE (4):

Percentage of sessions where user hung up.

SESSION_END_RATE (5):

Percentage of sessions reached Dialogflow ‘END_PAGE’ or ‘END_SESSION’.

class VersionMetrics(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Version variant and associated metrics.

version

The name of the flow [Version][google.cloud.dialogflow.cx.v3beta1.Version]. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>.

Type

str

metrics

The metrics and corresponding confidence intervals in the inference result.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Experiment.Result.Metric]

session_count

Number of sessions that were allocated to this version.

Type

int

class State(value)

Bases: proto.enums.Enum

The state of the experiment.

Values:

STATE_UNSPECIFIED (0):

State unspecified.

DRAFT (1):

The experiment is created but not started yet.

RUNNING (2):

The experiment is running.

DONE (3):

The experiment is done.

ROLLOUT_FAILED (4):

The experiment with auto-rollout enabled has failed.

class google.cloud.dialogflowcx_v3beta1.types.ExportAgentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Agents.ExportAgent][google.cloud.dialogflow.cx.v3beta1.Agents.ExportAgent].

name

Required. The name of the agent to export. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

agent_uri

Optional. The Google Cloud Storage URI to export the agent to. The format of this URI must be gs://<bucket-name>/<object-name>. If left unspecified, the serialized agent is returned inline.

Dialogflow performs a write operation for the Cloud Storage object on the caller’s behalf, so your request authentication must have write permissions for the object. For more information, see Dialogflow access control.

Type

str

data_format

Optional. The data format of the exported agent. If not specified, BLOB is assumed.

Type

google.cloud.dialogflowcx_v3beta1.types.ExportAgentRequest.DataFormat

environment

Optional. Environment name. If not set, draft environment is assumed. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

git_destination

Optional. The Git branch to export the agent to.

Type

google.cloud.dialogflowcx_v3beta1.types.ExportAgentRequest.GitDestination

include_bigquery_export_settings

Optional. Whether to include BigQuery Export setting.

Type

bool

class DataFormat(value)

Bases: proto.enums.Enum

Data format of the exported agent.

Values:

DATA_FORMAT_UNSPECIFIED (0):

Unspecified format.

BLOB (1):

Agent content will be exported as raw bytes.

JSON_PACKAGE (4):

Agent content will be exported in JSON Package format.

class GitDestination(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for exporting to a git branch.

tracking_branch

Tracking branch for the git push.

Type

str

commit_message

Commit message for the git push.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ExportAgentResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Agents.ExportAgent][google.cloud.dialogflow.cx.v3beta1.Agents.ExportAgent].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

agent_uri

The URI to a file containing the exported agent. This field is populated if agent_uri is specified in [ExportAgentRequest][google.cloud.dialogflow.cx.v3beta1.ExportAgentRequest].

This field is a member of oneof agent.

Type

str

agent_content

Uncompressed raw byte content for agent. This field is populated if none of agent_uri and git_destination are specified in [ExportAgentRequest][google.cloud.dialogflow.cx.v3beta1.ExportAgentRequest].

This field is a member of oneof agent.

Type

bytes

commit_sha

Commit SHA of the git push. This field is populated if git_destination is specified in [ExportAgentRequest][google.cloud.dialogflow.cx.v3beta1.ExportAgentRequest].

This field is a member of oneof agent.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ExportEntityTypesMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metadata returned for the [EntityTypes.ExportEntityTypes][google.cloud.dialogflow.cx.v3beta1.EntityTypes.ExportEntityTypes] long running operation.

class google.cloud.dialogflowcx_v3beta1.types.ExportEntityTypesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [EntityTypes.ExportEntityTypes][google.cloud.dialogflow.cx.v3beta1.EntityTypes.ExportEntityTypes].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

parent

Required. The name of the parent agent to export entity types. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

entity_types

Required. The name of the entity types to export. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/entityTypes/<EntityTypeID>.

Type

MutableSequence[str]

entity_types_uri

Optional. The Google Cloud Storage URI to export the entity types to. The format of this URI must be gs://<bucket-name>/<object-name>.

Dialogflow performs a write operation for the Cloud Storage object on the caller’s behalf, so your request authentication must have write permissions for the object. For more information, see Dialogflow access control.

This field is a member of oneof destination.

Type

str

entity_types_content_inline

Optional. The option to return the serialized entity types inline.

This field is a member of oneof destination.

Type

bool

data_format

Optional. The data format of the exported entity types. If not specified, BLOB is assumed.

Type

google.cloud.dialogflowcx_v3beta1.types.ExportEntityTypesRequest.DataFormat

language_code

Optional. The language to retrieve the entity type for. The following fields are language dependent:

• EntityType.entities.value

• EntityType.entities.synonyms

• EntityType.excluded_phrases.value

If not specified, all language dependent fields will be retrieved. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class DataFormat(value)

Bases: proto.enums.Enum

Data format of the exported entity types.

Values:

DATA_FORMAT_UNSPECIFIED (0):

Unspecified format. Treated as BLOB.

BLOB (1):

EntityTypes will be exported as raw bytes.

JSON_PACKAGE (5):

EntityTypes will be exported in JSON Package format.

class google.cloud.dialogflowcx_v3beta1.types.ExportEntityTypesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [EntityTypes.ExportEntityTypes][google.cloud.dialogflow.cx.v3beta1.EntityTypes.ExportEntityTypes].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

entity_types_uri

The URI to a file containing the exported entity types. This field is populated only if entity_types_uri is specified in [ExportEntityTypesRequest][google.cloud.dialogflow.cx.v3beta1.ExportEntityTypesRequest].

This field is a member of oneof exported_entity_types.

Type

str

entity_types_content

Uncompressed byte content for entity types. This field is populated only if entity_types_content_inline is set to true in [ExportEntityTypesRequest][google.cloud.dialogflow.cx.v3beta1.ExportEntityTypesRequest].

This field is a member of oneof exported_entity_types.

Type

google.cloud.dialogflowcx_v3beta1.types.InlineDestination

class google.cloud.dialogflowcx_v3beta1.types.ExportFlowRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Flows.ExportFlow][google.cloud.dialogflow.cx.v3beta1.Flows.ExportFlow].

name

Required. The name of the flow to export. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Type

str

flow_uri

Optional. The Google Cloud Storage URI to export the flow to. The format of this URI must be gs://<bucket-name>/<object-name>. If left unspecified, the serialized flow is returned inline.

Dialogflow performs a write operation for the Cloud Storage object on the caller’s behalf, so your request authentication must have write permissions for the object. For more information, see Dialogflow access control.

Type

str

include_referenced_flows

Optional. Whether to export flows referenced by the specified flow.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.ExportFlowResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Flows.ExportFlow][google.cloud.dialogflow.cx.v3beta1.Flows.ExportFlow].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

flow_uri

The URI to a file containing the exported flow. This field is populated only if flow_uri is specified in [ExportFlowRequest][google.cloud.dialogflow.cx.v3beta1.ExportFlowRequest].

This field is a member of oneof flow.

Type

str

flow_content

Uncompressed raw byte content for flow.

This field is a member of oneof flow.

Type

bytes

class google.cloud.dialogflowcx_v3beta1.types.ExportIntentsMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metadata returned for the [Intents.ExportIntents][google.cloud.dialogflow.cx.v3beta1.Intents.ExportIntents] long running operation.

class google.cloud.dialogflowcx_v3beta1.types.ExportIntentsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Intents.ExportIntents][google.cloud.dialogflow.cx.v3beta1.Intents.ExportIntents].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

parent

Required. The name of the parent agent to export intents. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

intents

Required. The name of the intents to export. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/intents/<IntentID>.

Type

MutableSequence[str]

intents_uri

Optional. The Google Cloud Storage URI to export the intents to. The format of this URI must be gs://<bucket-name>/<object-name>.

Dialogflow performs a write operation for the Cloud Storage object on the caller’s behalf, so your request authentication must have write permissions for the object. For more information, see Dialogflow access control.

This field is a member of oneof destination.

Type

str

intents_content_inline

Optional. The option to return the serialized intents inline.

This field is a member of oneof destination.

Type

bool

data_format

Optional. The data format of the exported intents. If not specified, BLOB is assumed.

Type

google.cloud.dialogflowcx_v3beta1.types.ExportIntentsRequest.DataFormat

class DataFormat(value)

Bases: proto.enums.Enum

Data format of the exported intents.

Values:

DATA_FORMAT_UNSPECIFIED (0):

Unspecified format. Treated as BLOB.

BLOB (1):

Intents will be exported as raw bytes.

JSON (2):

Intents will be exported in JSON format.

CSV (3):

Intents will be exported in CSV format.

class google.cloud.dialogflowcx_v3beta1.types.ExportIntentsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Intents.ExportIntents][google.cloud.dialogflow.cx.v3beta1.Intents.ExportIntents].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

intents_uri

The URI to a file containing the exported intents. This field is populated only if intents_uri is specified in [ExportIntentsRequest][google.cloud.dialogflow.cx.v3beta1.ExportIntentsRequest].

This field is a member of oneof intents.

Type

str

intents_content

Uncompressed byte content for intents. This field is populated only if intents_content_inline is set to true in [ExportIntentsRequest][google.cloud.dialogflow.cx.v3beta1.ExportIntentsRequest].

This field is a member of oneof intents.

Type

google.cloud.dialogflowcx_v3beta1.types.InlineDestination

class google.cloud.dialogflowcx_v3beta1.types.ExportTestCasesMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metadata returned for the [TestCases.ExportTestCases][google.cloud.dialogflow.cx.v3beta1.TestCases.ExportTestCases] long running operation. This message currently has no fields.

class google.cloud.dialogflowcx_v3beta1.types.ExportTestCasesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TestCases.ExportTestCases][google.cloud.dialogflow.cx.v3beta1.TestCases.ExportTestCases].

parent

Required. The agent where to export test cases from. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

gcs_uri

The Google Cloud Storage URI to export the test cases to. The format of this URI must be gs://<bucket-name>/<object-name>. If unspecified, the serialized test cases is returned inline.

Dialogflow performs a write operation for the Cloud Storage object on the caller’s behalf, so your request authentication must have write permissions for the object. For more information, see Dialogflow access control.

This field is a member of oneof destination.

Type

str

data_format

The data format of the exported test cases. If not specified, BLOB is assumed.

Type

google.cloud.dialogflowcx_v3beta1.types.ExportTestCasesRequest.DataFormat

filter

The filter expression used to filter exported test cases, see API Filtering. The expression is case insensitive and supports the following syntax:

name = [OR name = ] …

For example:

• “name = t1 OR name = t2” matches the test case with the exact resource name “t1” or “t2”.

Type

str

class DataFormat(value)

Bases: proto.enums.Enum

Data format of the exported test cases.

Values:

DATA_FORMAT_UNSPECIFIED (0):

Unspecified format.

BLOB (1):

Raw bytes.

JSON (2):

JSON format.

class google.cloud.dialogflowcx_v3beta1.types.ExportTestCasesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [TestCases.ExportTestCases][google.cloud.dialogflow.cx.v3beta1.TestCases.ExportTestCases].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

gcs_uri

The URI to a file containing the exported test cases. This field is populated only if gcs_uri is specified in [ExportTestCasesRequest][google.cloud.dialogflow.cx.v3beta1.ExportTestCasesRequest].

This field is a member of oneof destination.

Type

str

content

Uncompressed raw byte content for test cases.

This field is a member of oneof destination.

Type

bytes

class google.cloud.dialogflowcx_v3beta1.types.ExportToolsMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metadata returned for the [Tools.ExportTools][google.cloud.dialogflow.cx.v3beta1.Tools.ExportTools] long running operation.

class google.cloud.dialogflowcx_v3beta1.types.ExportToolsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Tools.ExportTools][google.cloud.dialogflow.cx.v3beta1.Tools.ExportTools].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

parent

Required. The agent to export tools from. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

tools

Required. The name of the tools to export. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/tools/<ToolID>.

Type

MutableSequence[str]

tools_uri

Optional. The Google Cloud Storage URI to export the tools to. The format of this URI must be gs://<bucket-name>/<object-name>.

Dialogflow performs a write operation for the Cloud Storage object on the caller’s behalf, so your request authentication must have write permissions for the object. For more information, see Dialogflow access control.

This field is a member of oneof destination.

Type

str

tools_content_inline

Optional. The option to return the serialized tools inline.

This field is a member of oneof destination.

Type

bool

data_format

Optional. The data format of the exported tools. If not specified, BLOB is assumed.

Type

google.cloud.dialogflowcx_v3beta1.types.ExportToolsRequest.DataFormat

class DataFormat(value)

Bases: proto.enums.Enum

Data format of the exported tools.

Values:

DATA_FORMAT_UNSPECIFIED (0):

Unspecified format. Treated as BLOB.

BLOB (1):

Tools will be exported as raw bytes.

JSON (2):

Tools will be exported in JSON format.

class google.cloud.dialogflowcx_v3beta1.types.ExportToolsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Tools.ExportTools][google.cloud.dialogflow.cx.v3beta1.Tools.ExportTools].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

tools_uri

The URI to a file containing the exported tools. This field is populated only if tools_uri is specified in [ExportToolsRequest][google.cloud.dialogflow.cx.v3beta1.ExportToolsRequest].

This field is a member of oneof tools.

Type

str

tools_content

Uncompressed byte content for tools. This field is populated only if tools_content_inline is set to true in [ExportToolsRequest][google.cloud.dialogflow.cx.v3beta1.ExportToolsRequest].

This field is a member of oneof tools.

Type

google.cloud.dialogflowcx_v3beta1.types.InlineDestination

class google.cloud.dialogflowcx_v3beta1.types.FilterSpecs(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Filter specifications for data stores.

data_stores

Optional. Data Stores where the boosting configuration is applied. The full names of the referenced data stores. Formats: projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store} `projects/{project}/locations/{location}/dataStores/{data_store}

Type

MutableSequence[str]

filter

Optional. The filter expression to be applied. Expression syntax is documented at https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax

Type

str

class google.cloud.dialogflowcx_v3beta1.types.Flow(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Flows represents the conversation flows when you build your chatbot agent. A flow consists of many pages connected by the transition routes. Conversations always start with the built-in Start Flow (with an all-0 ID). Transition routes can direct the conversation session from the current flow (parent flow) to another flow (sub flow). When the sub flow is finished, Dialogflow will bring the session back to the parent flow, where the sub flow is started.

Usually, when a transition route is followed by a matched intent, the intent will be “consumed”. This means the intent won’t activate more transition routes. However, when the followed transition route moves the conversation session into a different flow, the matched intent can be carried over and to be consumed in the target flow.

name

The unique identifier of the flow. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Type

str

display_name

Required. The human-readable name of the flow.

Type

str

description

The description of the flow. The maximum length is 500 characters. If exceeded, the request is rejected.

Type

str

transition_routes

A flow’s transition routes serve two purposes:

• They are responsible for matching the user’s first utterances in the flow.

• They are inherited by every page’s [transition routes][Page.transition_routes] and can support use cases such as the user saying “help” or “can I talk to a human?”, which can be handled in a common way regardless of the current page. Transition routes defined in the page have higher priority than those defined in the flow.

TransitionRoutes are evalauted in the following order:

• TransitionRoutes with intent specified.

• TransitionRoutes with only condition specified.

TransitionRoutes with intent specified are inherited by pages in the flow.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TransitionRoute]

event_handlers

A flow’s event handlers serve two purposes:

• They are responsible for handling events (e.g. no match, webhook errors) in the flow.

• They are inherited by every page’s [event handlers][Page.event_handlers], which can be used to handle common events regardless of the current page. Event handlers defined in the page have higher priority than those defined in the flow.

Unlike [transition_routes][google.cloud.dialogflow.cx.v3beta1.Flow.transition_routes], these handlers are evaluated on a first-match basis. The first one that matches the event get executed, with the rest being ignored.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.EventHandler]

transition_route_groups

A flow’s transition route group serve two purposes:

• They are responsible for matching the user’s first utterances in the flow.

• They are inherited by every page’s [transition route groups][Page.transition_route_groups]. Transition route groups defined in the page have higher priority than those defined in the flow.

Format:projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/transitionRouteGroups/<TransitionRouteGroupID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/transitionRouteGroups/<TransitionRouteGroupID> for agent-level groups.

Type

MutableSequence[str]

nlu_settings

NLU related settings of the flow.

Type

google.cloud.dialogflowcx_v3beta1.types.NluSettings

advanced_settings

Hierarchical advanced settings for this flow. The settings exposed at the lower level overrides the settings exposed at the higher level.

Type

google.cloud.dialogflowcx_v3beta1.types.AdvancedSettings

knowledge_connector_settings

Optional. Knowledge connector configuration.

Type

google.cloud.dialogflowcx_v3beta1.types.KnowledgeConnectorSettings

multi_language_settings

Optional. Multi-lingual agent settings for this flow.

Type

google.cloud.dialogflowcx_v3beta1.types.Flow.MultiLanguageSettings

locked

Indicates whether the flow is locked for changes. If the flow is locked, modifications to the flow will be rejected.

Type

bool

class MultiLanguageSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for multi-lingual agents.

enable_multi_language_detection

Optional. Enable multi-language detection for this flow. This can be set only if [agent level multi language setting][Agent.enable_multi_language_training] is enabled.

Type

bool

supported_response_language_codes

Optional. Agent will respond in the detected language if the detected language code is in the supported resolved languages for this flow. This will be used only if multi-language training is enabled in the [agent][google.cloud.dialogflow.cx.v3beta1.Agent.enable_multi_language_training] and multi-language detection is enabled in the [flow][google.cloud.dialogflow.cx.v3beta1.Flow.MultiLanguageSettings.enable_multi_language_detection]. The supported languages must be a subset of the languages supported by the agent.

Type

MutableSequence[str]

class google.cloud.dialogflowcx_v3beta1.types.FlowImportStrategy(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The flow import strategy used for resource conflict resolution associated with an [ImportFlowRequest][google.cloud.dialogflow.cx.v3beta1.ImportFlowRequest].

global_import_strategy

Optional. Global flow import strategy for resource conflict resolution. The import Import strategy for resource conflict resolution, applied globally throughout the flow. It will be applied for all display name conflicts in the imported content. If not specified, ‘CREATE_NEW’ is assumed.

Type

google.cloud.dialogflowcx_v3beta1.types.ImportStrategy

class google.cloud.dialogflowcx_v3beta1.types.FlowInvocation(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Stores metadata of the invocation of a CX flow.

flow

Required. The unique identifier of the flow. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Type

str

input_action_parameters

Optional. A list of input parameters for the flow.

Type

google.protobuf.struct_pb2.Struct

output_action_parameters

Optional. A list of output parameters generated by the flow invocation.

Type

google.protobuf.struct_pb2.Struct

flow_state

Required. Flow invocation’s output state.

Type

google.cloud.dialogflowcx_v3beta1.types.OutputState

class google.cloud.dialogflowcx_v3beta1.types.FlowValidationResult(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Flows.GetFlowValidationResult][google.cloud.dialogflow.cx.v3beta1.Flows.GetFlowValidationResult].

name

The unique identifier of the flow validation result. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/validationResult.

Type

str

validation_messages

Contains all validation messages.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ValidationMessage]

update_time

Last time the flow was validated.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.dialogflowcx_v3beta1.types.Form(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A form is a data model that groups related parameters that can be collected from the user. The process in which the agent prompts the user and collects parameter values from the user is called form filling. A form can be added to a [page][google.cloud.dialogflow.cx.v3beta1.Page]. When form filling is done, the filled parameters will be written to the [session][google.cloud.dialogflow.cx.v3beta1.SessionInfo.parameters].

parameters

Parameters to collect from the user.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Form.Parameter]

class Parameter(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a form parameter.

display_name

Required. The human-readable name of the parameter, unique within the form.

Type

str

required

Indicates whether the parameter is required. Optional parameters will not trigger prompts; however, they are filled if the user specifies them. Required parameters must be filled before form filling concludes.

Type

bool

entity_type

Required. The entity type of the parameter. Format: projects/-/locations/-/agents/-/entityTypes/<SystemEntityTypeID> for system entity types (for example, projects/-/locations/-/agents/-/entityTypes/sys.date), or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/entityTypes/<EntityTypeID> for developer entity types.

Type

str

is_list

Indicates whether the parameter represents a list of values.

Type

bool

fill_behavior

Required. Defines fill behavior for the parameter.

Type

google.cloud.dialogflowcx_v3beta1.types.Form.Parameter.FillBehavior

default_value

The default value of an optional parameter. If the parameter is required, the default value will be ignored.

Type

google.protobuf.struct_pb2.Value

redact

Indicates whether the parameter content should be redacted in log. If redaction is enabled, the parameter content will be replaced by parameter name during logging. Note: the parameter content is subject to redaction if either parameter level redaction or [entity type level redaction][google.cloud.dialogflow.cx.v3beta1.EntityType.redact] is enabled.

Type

bool

advanced_settings

Hierarchical advanced settings for this parameter. The settings exposed at the lower level overrides the settings exposed at the higher level.

Type

google.cloud.dialogflowcx_v3beta1.types.AdvancedSettings

class FillBehavior(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Configuration for how the filling of a parameter should be handled.

initial_prompt_fulfillment

Required. The fulfillment to provide the initial prompt that the agent can present to the user in order to fill the parameter.

Type

google.cloud.dialogflowcx_v3beta1.types.Fulfillment

reprompt_event_handlers

The handlers for parameter-level events, used to provide reprompt for the parameter or transition to a different page/flow. The supported events are:

• sys.no-match-<N>, where N can be from 1 to 6

• sys.no-match-default

• sys.no-input-<N>, where N can be from 1 to 6

• sys.no-input-default

• sys.invalid-parameter

initial_prompt_fulfillment provides the first prompt for the parameter.

If the user’s response does not fill the parameter, a no-match/no-input event will be triggered, and the fulfillment associated with the sys.no-match-1/sys.no-input-1 handler (if defined) will be called to provide a prompt. The sys.no-match-2/sys.no-input-2 handler (if defined) will respond to the next no-match/no-input event, and so on.

A sys.no-match-default or sys.no-input-default handler will be used to handle all following no-match/no-input events after all numbered no-match/no-input handlers for the parameter are consumed.

A sys.invalid-parameter handler can be defined to handle the case where the parameter values have been invalidated by webhook. For example, if the user’s response fill the parameter, however the parameter was invalidated by webhook, the fulfillment associated with the sys.invalid-parameter handler (if defined) will be called to provide a prompt.

If the event handler for the corresponding event can’t be found on the parameter, initial_prompt_fulfillment will be re-prompted.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.EventHandler]

class google.cloud.dialogflowcx_v3beta1.types.FulfillIntentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request of [FulfillIntent][]

match_intent_request

Must be same as the corresponding MatchIntent request, otherwise the behavior is undefined.

Type

google.cloud.dialogflowcx_v3beta1.types.MatchIntentRequest

match

The matched intent/event to fulfill.

Type

google.cloud.dialogflowcx_v3beta1.types.Match

output_audio_config

Instructs the speech synthesizer how to generate output audio.

Type

google.cloud.dialogflowcx_v3beta1.types.OutputAudioConfig

class google.cloud.dialogflowcx_v3beta1.types.FulfillIntentResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response of [FulfillIntent][]

response_id

Output only. The unique identifier of the response. It can be used to locate a response in the training example set or for reporting issues.

Type

str

query_result

The result of the conversational query.

Type

google.cloud.dialogflowcx_v3beta1.types.QueryResult

output_audio

The audio data bytes encoded as specified in the request. Note: The output audio is generated based on the values of default platform text responses found in the [query_result.response_messages][google.cloud.dialogflow.cx.v3beta1.QueryResult.response_messages] field. If multiple default text responses exist, they will be concatenated when generating audio. If no default platform text responses exist, the generated audio content will be empty.

In some scenarios, multiple output audio fields may be present in the response structure. In these cases, only the top-most-level audio output has content.

Type

bytes

output_audio_config

The config used by the speech synthesizer to generate the output audio.

Type

google.cloud.dialogflowcx_v3beta1.types.OutputAudioConfig

class google.cloud.dialogflowcx_v3beta1.types.Fulfillment(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A fulfillment can do one or more of the following actions at the same time:

• Generate rich message responses.

• Set parameter values.

• Call the webhook.

Fulfillments can be called at various stages in the [Page][google.cloud.dialogflow.cx.v3beta1.Page] or [Form][google.cloud.dialogflow.cx.v3beta1.Form] lifecycle. For example, when a [DetectIntentRequest][google.cloud.dialogflow.cx.v3beta1.DetectIntentRequest] drives a session to enter a new page, the page’s entry fulfillment can add a static response to the [QueryResult][google.cloud.dialogflow.cx.v3beta1.QueryResult] in the returning [DetectIntentResponse][google.cloud.dialogflow.cx.v3beta1.DetectIntentResponse], call the webhook (for example, to load user data from a database), or both.

messages

The list of rich message responses to present to the user.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ResponseMessage]

webhook

The webhook to call. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/webhooks/<WebhookID>.

Type

str

return_partial_responses

Whether Dialogflow should return currently queued fulfillment response messages in streaming APIs. If a webhook is specified, it happens before Dialogflow invokes webhook. Warning:

1) This flag only affects streaming API. Responses are still queued and returned once in non-streaming API. 2) The flag can be enabled in any fulfillment but only the first 3 partial responses will be returned. You may only want to apply it to fulfillments that have slow webhooks.

Type

bool

tag

The value of this field will be populated in the [WebhookRequest][google.cloud.dialogflow.cx.v3beta1.WebhookRequest] fulfillmentInfo.tag field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes. This field is required if webhook is specified.

Type

str

set_parameter_actions

Set parameter values before executing the webhook.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Fulfillment.SetParameterAction]

conditional_cases

Conditional cases for this fulfillment.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Fulfillment.ConditionalCases]

advanced_settings

Hierarchical advanced settings for this fulfillment. The settings exposed at the lower level overrides the settings exposed at the higher level.

Type

google.cloud.dialogflowcx_v3beta1.types.AdvancedSettings

enable_generative_fallback

If the flag is true, the agent will utilize LLM to generate a text response. If LLM generation fails, the defined [responses][google.cloud.dialogflow.cx.v3beta1.Fulfillment.messages] in the fulfillment will be respected. This flag is only useful for fulfillments associated with no-match event handlers.

Type

bool

class ConditionalCases(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A list of cascading if-else conditions. Cases are mutually exclusive. The first one with a matching condition is selected, all the rest ignored.

cases

A list of cascading if-else conditions.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Fulfillment.ConditionalCases.Case]

class Case(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Each case has a Boolean condition. When it is evaluated to be True, the corresponding messages will be selected and evaluated recursively.

condition

The condition to activate and select this case. Empty means the condition is always true. The condition is evaluated against [form parameters][Form.parameters] or [session parameters][SessionInfo.parameters].

See the conditions reference.

Type

str

case_content

A list of case content.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Fulfillment.ConditionalCases.Case.CaseContent]

class CaseContent(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The list of messages or conditional cases to activate for this case.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

message

Returned message.

This field is a member of oneof cases_or_message.

Type

google.cloud.dialogflowcx_v3beta1.types.ResponseMessage

additional_cases

Additional cases to be evaluated.

This field is a member of oneof cases_or_message.

Type

google.cloud.dialogflowcx_v3beta1.types.Fulfillment.ConditionalCases

class SetParameterAction(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Setting a parameter value.

parameter

Display name of the parameter.

Type

str

value

The new value of the parameter. A null value clears the parameter.

Type

google.protobuf.struct_pb2.Value

class google.cloud.dialogflowcx_v3beta1.types.GcsDestination(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Google Cloud Storage location for a Dialogflow operation that writes or exports objects (e.g. exported agent or transcripts) outside of Dialogflow.

uri

Required. The Google Cloud Storage URI for the exported objects. A URI is of the form: gs://bucket/object-name-or-prefix Whether a full object name, or just a prefix, its usage depends on the Dialogflow operation.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GenerativeInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the information of a query if handled by generative agent resources.

current_playbooks

The stack of [playbooks][google.cloud.dialogflow.cx.v3beta1.Playbook] that the conversation has currently entered, with the most recent one on the top.

Type

MutableSequence[str]

action_tracing_info

The actions performed by the generative playbook for the current agent response.

Type

google.cloud.dialogflowcx_v3beta1.types.Example

class google.cloud.dialogflowcx_v3beta1.types.GenerativeSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for Generative AI.

name

Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/generativeSettings.

Type

str

fallback_settings

Settings for Generative Fallback.

Type

google.cloud.dialogflowcx_v3beta1.types.GenerativeSettings.FallbackSettings

generative_safety_settings

Settings for Generative Safety.

Type

google.cloud.dialogflowcx_v3beta1.types.SafetySettings

knowledge_connector_settings

Settings for knowledge connector.

Type

google.cloud.dialogflowcx_v3beta1.types.GenerativeSettings.KnowledgeConnectorSettings

language_code

Language for this settings.

Type

str

llm_model_settings

LLM model settings.

Type

google.cloud.dialogflowcx_v3beta1.types.LlmModelSettings

class FallbackSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for Generative Fallback.

selected_prompt

Display name of the selected prompt.

Type

str

prompt_templates

Stored prompts that can be selected, for example default templates like “conservative” or “chatty”, or user defined ones.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.GenerativeSettings.FallbackSettings.PromptTemplate]

class PromptTemplate(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Prompt template.

display_name

Prompt name.

Type

str

prompt_text

Prompt text that is sent to a LLM on no-match default, placeholders are filled downstream. For example: “Here is a conversation $conversation, a response is: “.

Type

str

frozen

If the flag is true, the prompt is frozen and cannot be modified by users.

Type

bool

class KnowledgeConnectorSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for knowledge connector. These parameters are used for LLM prompt like “You are . You are a helpful and verbose <agent_identity> at , <business_description>. Your task is to help humans on <agent_scope>”.

business

Name of the company, organization or other entity that the agent represents. Used for knowledge connector LLM prompt and for knowledge search.

Type

str

agent

Name of the virtual agent. Used for LLM prompt. Can be left empty.

Type

str

agent_identity

Identity of the agent, e.g. “virtual agent”, “AI assistant”.

Type

str

business_description

Company description, used for LLM prompt, e.g. “a family company selling freshly roasted coffee beans”.

Type

str

agent_scope

Agent scope, e.g. “Example company website”, “internal Example company website for employees”, “manual of car owner”.

Type

str

disable_data_store_fallback

Whether to disable fallback to Data Store search results (in case the LLM couldn’t pick a proper answer). Per default the feature is enabled.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.Generator(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Generators contain prompt to be sent to the LLM model to generate text. The prompt can contain parameters which will be resolved before calling the model. It can optionally contain banned phrases to ensure the model responses are safe.

name

The unique identifier of the generator. Must be set for the [Generators.UpdateGenerator][google.cloud.dialogflow.cx.v3beta1.Generators.UpdateGenerator] method. [Generators.CreateGenerate][] populates the name automatically. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/generators/<GeneratorID>.

Type

str

display_name

Required. The human-readable name of the generator, unique within the agent. The prompt contains pre-defined parameters such as $conversation, $last-user-utterance, etc. populated by Dialogflow. It can also contain custom placeholders which will be resolved during fulfillment.

Type

str

prompt_text

Required. Prompt for the LLM model.

Type

google.cloud.dialogflowcx_v3beta1.types.Phrase

placeholders

Optional. List of custom placeholders in the prompt text.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Generator.Placeholder]

llm_model_settings

The LLM model settings.

Type

google.cloud.dialogflowcx_v3beta1.types.LlmModelSettings

model_parameter

Parameters passed to the LLM to configure its behavior.

Type

google.cloud.dialogflowcx_v3beta1.types.Generator.ModelParameter

class ModelParameter(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Parameters to be passed to the LLM. If not set, default values will be used.

temperature

The temperature used for sampling. Temperature sampling occurs after both topP and topK have been applied. Valid range: [0.0, 1.0] Low temperature = less random. High temperature = more random.

This field is a member of oneof _temperature.

Type

float

max_decode_steps

The maximum number of tokens to generate.

This field is a member of oneof _max_decode_steps.

Type

int

top_p

If set, only the tokens comprising the top top_p probability mass are considered. If both top_p and top_k are set, top_p will be used for further refining candidates selected with top_k. Valid range: (0.0, 1.0]. Small topP = less random. Large topP = more random.

This field is a member of oneof _top_p.

Type

float

top_k

If set, the sampling process in each step is limited to the top_k tokens with highest probabilities. Valid range: [1, 40] or 1000+. Small topK = less random. Large topK = more random.

This field is a member of oneof _top_k.

Type

int

class Placeholder(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a custom placeholder in the prompt text.

id

Unique ID used to map custom placeholder to parameters in fulfillment.

Type

str

name

Custom placeholder value in the prompt text.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetAgentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Agents.GetAgent][google.cloud.dialogflow.cx.v3beta1.Agents.GetAgent].

name

Required. The name of the agent. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetAgentValidationResultRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Agents.GetAgentValidationResult][google.cloud.dialogflow.cx.v3beta1.Agents.GetAgentValidationResult].

name

Required. The agent name. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/validationResult.

Type

str

language_code

If not specified, the agent’s default language is used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetChangelogRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Changelogs.GetChangelog][google.cloud.dialogflow.cx.v3beta1.Changelogs.GetChangelog].

name

Required. The name of the changelog to get. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/changelogs/<ChangelogID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetConversationRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Conversations.GetConversation][].

name

Required. The name of the conversation. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/conversations/<ConversationID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetDeploymentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Deployments.GetDeployment][google.cloud.dialogflow.cx.v3beta1.Deployments.GetDeployment].

name

Required. The name of the [Deployment][google.cloud.dialogflow.cx.v3beta1.Deployment]. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/deployments/<DeploymentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetEntityTypeRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [EntityTypes.GetEntityType][google.cloud.dialogflow.cx.v3beta1.EntityTypes.GetEntityType].

name

Required. The name of the entity type. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/entityTypes/<EntityTypeID>.

Type

str

language_code

The language to retrieve the entity type for. The following fields are language dependent:

• EntityType.entities.value

• EntityType.entities.synonyms

• EntityType.excluded_phrases.value

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetEnvironmentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Environments.GetEnvironment][google.cloud.dialogflow.cx.v3beta1.Environments.GetEnvironment].

name

Required. The name of the [Environment][google.cloud.dialogflow.cx.v3beta1.Environment]. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetExampleRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Examples.GetExample][google.cloud.dialogflow.cx.v3beta1.Examples.GetExample].

name

Required. The name of the example. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>/examples/<ExampleID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetExperimentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Experiments.GetExperiment][google.cloud.dialogflow.cx.v3beta1.Experiments.GetExperiment].

name

Required. The name of the [Environment][google.cloud.dialogflow.cx.v3beta1.Environment]. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/experiments/<ExperimentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetFlowRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Flows.GetFlow][google.cloud.dialogflow.cx.v3beta1.Flows.GetFlow].

name

Required. The name of the flow to get. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Type

str

language_code

The language to retrieve the flow for. The following fields are language dependent:

• Flow.event_handlers.trigger_fulfillment.messages

• Flow.event_handlers.trigger_fulfillment.conditional_cases

• Flow.transition_routes.trigger_fulfillment.messages

• Flow.transition_routes.trigger_fulfillment.conditional_cases

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetFlowValidationResultRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Flows.GetFlowValidationResult][google.cloud.dialogflow.cx.v3beta1.Flows.GetFlowValidationResult].

name

Required. The flow name. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/validationResult.

Type

str

language_code

If not specified, the agent’s default language is used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetGenerativeSettingsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request for [GetGenerativeSettings][google.cloud.dialogflow.cx.v3beta1.Agents.GetGenerativeSettings] RPC.

name

Required. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/generativeSettings.

Type

str

language_code

Required. Language code of the generative settings.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetGeneratorRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Generators.GetGenerator][google.cloud.dialogflow.cx.v3beta1.Generators.GetGenerator].

name

Required. The name of the generator. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/generators/<GeneratorID>.

Type

str

language_code

The language to list generators for.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetIntentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Intents.GetIntent][google.cloud.dialogflow.cx.v3beta1.Intents.GetIntent].

name

Required. The name of the intent. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/intents/<IntentID>.

Type

str

language_code

The language to retrieve the intent for. The following fields are language dependent:

• Intent.training_phrases.parts.text

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetPageRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Pages.GetPage][google.cloud.dialogflow.cx.v3beta1.Pages.GetPage].

name

Required. The name of the page. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>.

Type

str

language_code

The language to retrieve the page for. The following fields are language dependent:

• Page.entry_fulfillment.messages

• Page.entry_fulfillment.conditional_cases

• Page.event_handlers.trigger_fulfillment.messages

• Page.event_handlers.trigger_fulfillment.conditional_cases

• Page.form.parameters.fill_behavior.initial_prompt_fulfillment.messages

Page.form.parameters.fill_behavior.initial_prompt_fulfillment.conditional_cases

• Page.form.parameters.fill_behavior.reprompt_event_handlers.messages

Page.form.parameters.fill_behavior.reprompt_event_handlers.conditional_cases

• Page.transition_routes.trigger_fulfillment.messages

• Page.transition_routes.trigger_fulfillment.conditional_cases

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetPlaybookRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Playbooks.GetPlaybook][google.cloud.dialogflow.cx.v3beta1.Playbooks.GetPlaybook].

name

Required. The name of the playbook. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetPlaybookVersionRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Playbooks.GetPlaybookVersion][google.cloud.dialogflow.cx.v3beta1.Playbooks.GetPlaybookVersion].

name

Required. The name of the playbook version. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>/versions/<VersionID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetSecuritySettingsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [SecuritySettingsService.GetSecuritySettings][google.cloud.dialogflow.cx.v3beta1.SecuritySettingsService.GetSecuritySettings].

name

Required. Resource name of the settings. Format: projects/<ProjectID>/locations/<LocationID>/securitySettings/<securitysettingsID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetSessionEntityTypeRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [SessionEntityTypes.GetSessionEntityType][google.cloud.dialogflow.cx.v3beta1.SessionEntityTypes.GetSessionEntityType].

name

Required. The name of the session entity type. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID>/entityTypes/<EntityTypeID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>/entityTypes/<EntityTypeID>. If Environment ID is not specified, we assume default ‘draft’ environment.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetTestCaseRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TestCases.GetTestCase][google.cloud.dialogflow.cx.v3beta1.TestCases.GetTestCase].

name

Required. The name of the testcase. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/testCases/<TestCaseID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetTestCaseResultRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TestCases.GetTestCaseResult][google.cloud.dialogflow.cx.v3beta1.TestCases.GetTestCaseResult].

name

Required. The name of the testcase. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/testCases/<TestCaseID>/results/<TestCaseResultID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetToolRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Tools.GetTool][google.cloud.dialogflow.cx.v3beta1.Tools.GetTool].

name

Required. The name of the Tool. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/tools/<ToolID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetTransitionRouteGroupRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TransitionRouteGroups.GetTransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroups.GetTransitionRouteGroup].

name

Required. The name of the [TransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroup]. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/transitionRouteGroups/<TransitionRouteGroupID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/transitionRouteGroups/<TransitionRouteGroupID>.

Type

str

language_code

The language to retrieve the transition route group for. The following fields are language dependent:

• TransitionRouteGroup.transition_routes.trigger_fulfillment.messages

TransitionRouteGroup.transition_routes.trigger_fulfillment.conditional_cases

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetVersionRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Versions.GetVersion][google.cloud.dialogflow.cx.v3beta1.Versions.GetVersion].

name

Required. The name of the [Version][google.cloud.dialogflow.cx.v3beta1.Version]. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.GetWebhookRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Webhooks.GetWebhook][google.cloud.dialogflow.cx.v3beta1.Webhooks.GetWebhook].

name

Required. The name of the webhook. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/webhooks/<WebhookID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ImportEntityTypesMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metadata returned for the [EntityTypes.ImportEntityTypes][google.cloud.dialogflow.cx.v3beta1.EntityTypes.ImportEntityTypes] long running operation.

class google.cloud.dialogflowcx_v3beta1.types.ImportEntityTypesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [EntityTypes.ImportEntityTypes][google.cloud.dialogflow.cx.v3beta1.EntityTypes.ImportEntityTypes].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

parent

Required. The agent to import the entity types into. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

entity_types_uri

The Google Cloud Storage URI to import entity types from. The format of this URI must be gs://<bucket-name>/<object-name>.

Dialogflow performs a read operation for the Cloud Storage object on the caller’s behalf, so your request authentication must have read permissions for the object. For more information, see Dialogflow access control.

This field is a member of oneof entity_types.

Type

str

entity_types_content

Uncompressed byte content of entity types.

This field is a member of oneof entity_types.

Type

google.cloud.dialogflowcx_v3beta1.types.InlineSource

merge_option

Required. Merge option for importing entity types.

Type

google.cloud.dialogflowcx_v3beta1.types.ImportEntityTypesRequest.MergeOption

target_entity_type

Optional. The target entity type to import into. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/entity_types/<EntityTypeID>. If set, there should be only one entity type included in [entity_types][google.cloud.dialogflow.cx.v3beta1.ImportEntityTypesRequest.entity_types], of which the type should match the type of the target entity type. All [entities][google.cloud.dialogflow.cx.v3beta1.EntityType.entities] in the imported entity type will be added to the target entity type.

Type

str

class MergeOption(value)

Bases: proto.enums.Enum

Merge option when display name conflicts exist during import.

Values:

MERGE_OPTION_UNSPECIFIED (0):

Unspecified. If used, system uses REPORT_CONFLICT as default.

REPLACE (1):

Replace the original entity type in the agent with the new entity type when display name conflicts exist.

MERGE (2):

Merge the original entity type with the new entity type when display name conflicts exist.

RENAME (3):

Create new entity types with new display names to differentiate them from the existing entity types when display name conflicts exist.

REPORT_CONFLICT (4):

Report conflict information if display names conflict is detected. Otherwise, import entity types.

KEEP (5):

Keep the original entity type and discard the conflicting new entity type when display name conflicts exist.

class google.cloud.dialogflowcx_v3beta1.types.ImportEntityTypesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [EntityTypes.ImportEntityTypes][google.cloud.dialogflow.cx.v3beta1.EntityTypes.ImportEntityTypes].

entity_types

The unique identifier of the imported entity types. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/entity_types/<EntityTypeID>.

Type

MutableSequence[str]

conflicting_resources

Info which resources have conflicts when [REPORT_CONFLICT][ImportEntityTypesResponse.REPORT_CONFLICT] merge_option is set in ImportEntityTypesRequest.

Type

google.cloud.dialogflowcx_v3beta1.types.ImportEntityTypesResponse.ConflictingResources

class ConflictingResources(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Conflicting resources detected during the import process. Only filled when [REPORT_CONFLICT][ImportEntityTypesResponse.REPORT_CONFLICT] is set in the request and there are conflicts in the display names.

entity_type_display_names

Display names of conflicting entity types.

Type

MutableSequence[str]

entity_display_names

Display names of conflicting entities.

Type

MutableSequence[str]

class google.cloud.dialogflowcx_v3beta1.types.ImportFlowRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Flows.ImportFlow][google.cloud.dialogflow.cx.v3beta1.Flows.ImportFlow].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

parent

Required. The agent to import the flow into. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

flow_uri

The Google Cloud Storage URI to import flow from. The format of this URI must be gs://<bucket-name>/<object-name>.

Dialogflow performs a read operation for the Cloud Storage object on the caller’s behalf, so your request authentication must have read permissions for the object. For more information, see Dialogflow access control.

This field is a member of oneof flow.

Type

str

flow_content

Uncompressed raw byte content for flow.

This field is a member of oneof flow.

Type

bytes

import_option

Flow import mode. If not specified, KEEP is assumed.

Type

google.cloud.dialogflowcx_v3beta1.types.ImportFlowRequest.ImportOption

flow_import_strategy

Optional. Specifies the import strategy used when resolving resource conflicts.

Type

google.cloud.dialogflowcx_v3beta1.types.FlowImportStrategy

class ImportOption(value)

Bases: proto.enums.Enum

Import option.

Values:

IMPORT_OPTION_UNSPECIFIED (0):

Unspecified. Treated as KEEP.

KEEP (1):

Always respect settings in exported flow content. It may cause a import failure if some settings (e.g. custom NLU) are not supported in the agent to import into.

FALLBACK (2):

Fallback to default settings if some settings are not supported in the agent to import into. E.g. Standard NLU will be used if custom NLU is not available.

class google.cloud.dialogflowcx_v3beta1.types.ImportFlowResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Flows.ImportFlow][google.cloud.dialogflow.cx.v3beta1.Flows.ImportFlow].

flow

The unique identifier of the new flow. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ImportIntentsMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metadata returned for the [Intents.ImportIntents][google.cloud.dialogflow.cx.v3beta1.Intents.ImportIntents] long running operation.

class google.cloud.dialogflowcx_v3beta1.types.ImportIntentsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Intents.ImportIntents][google.cloud.dialogflow.cx.v3beta1.Intents.ImportIntents].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

parent

Required. The agent to import the intents into. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

intents_uri

The Google Cloud Storage URI to import intents from. The format of this URI must be gs://<bucket-name>/<object-name>.

Dialogflow performs a read operation for the Cloud Storage object on the caller’s behalf, so your request authentication must have read permissions for the object. For more information, see Dialogflow access control.

This field is a member of oneof intents.

Type

str

intents_content

Uncompressed byte content of intents.

This field is a member of oneof intents.

Type

google.cloud.dialogflowcx_v3beta1.types.InlineSource

merge_option

Merge option for importing intents. If not specified, REJECT is assumed.

Type

google.cloud.dialogflowcx_v3beta1.types.ImportIntentsRequest.MergeOption

class MergeOption(value)

Bases: proto.enums.Enum

Merge option when display name conflicts exist during import.

Values:

MERGE_OPTION_UNSPECIFIED (0):

Unspecified. Should not be used.

REJECT (1):

DEPRECATED: Please use [REPORT_CONFLICT][ImportIntentsRequest.REPORT_CONFLICT] instead. Fail the request if there are intents whose display names conflict with the display names of intents in the agent.

REPLACE (2):

Replace the original intent in the agent with the new intent when display name conflicts exist.

MERGE (3):

Merge the original intent with the new intent when display name conflicts exist.

RENAME (4):

Create new intents with new display names to differentiate them from the existing intents when display name conflicts exist.

REPORT_CONFLICT (5):

Report conflict information if display names conflict is detected. Otherwise, import intents.

KEEP (6):

Keep the original intent and discard the conflicting new intent when display name conflicts exist.

class google.cloud.dialogflowcx_v3beta1.types.ImportIntentsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Intents.ImportIntents][google.cloud.dialogflow.cx.v3beta1.Intents.ImportIntents].

intents

The unique identifier of the imported intents. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/intents/<IntentID>.

Type

MutableSequence[str]

conflicting_resources

Info which resources have conflicts when [REPORT_CONFLICT][ImportIntentsResponse.REPORT_CONFLICT] merge_option is set in ImportIntentsRequest.

Type

google.cloud.dialogflowcx_v3beta1.types.ImportIntentsResponse.ConflictingResources

class ConflictingResources(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Conflicting resources detected during the import process. Only filled when [REPORT_CONFLICT][ImportIntentsResponse.REPORT_CONFLICT] is set in the request and there are conflicts in the display names.

intent_display_names

Display names of conflicting intents.

Type

MutableSequence[str]

entity_display_names

Display names of conflicting entities.

Type

MutableSequence[str]

class google.cloud.dialogflowcx_v3beta1.types.ImportStrategy(value)

Bases: proto.enums.Enum

Import strategies for the conflict resolution of resources (i.e. intents, entities, and webhooks) with identical display names during import operations.

Values:

IMPORT_STRATEGY_UNSPECIFIED (0):

Unspecified. Treated as ‘CREATE_NEW’.

IMPORT_STRATEGY_CREATE_NEW (1):

Create a new resource with a numeric suffix appended to the end of the existing display name.

IMPORT_STRATEGY_REPLACE (2):

Replace existing resource with incoming resource in the content to be imported.

IMPORT_STRATEGY_KEEP (3):

Keep existing resource and discard incoming resource in the content to be imported.

IMPORT_STRATEGY_MERGE (4):

Combine existing and incoming resources when a conflict is encountered.

IMPORT_STRATEGY_THROW_ERROR (5):

Throw error if a conflict is encountered.

class google.cloud.dialogflowcx_v3beta1.types.ImportTestCasesMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metadata returned for the [TestCases.ImportTestCases][google.cloud.dialogflow.cx.v3beta1.TestCases.ImportTestCases] long running operation.

errors

Errors for failed test cases.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TestCaseError]

class google.cloud.dialogflowcx_v3beta1.types.ImportTestCasesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TestCases.ImportTestCases][google.cloud.dialogflow.cx.v3beta1.TestCases.ImportTestCases].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

parent

Required. The agent to import test cases to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

gcs_uri

The Google Cloud Storage URI to import test cases from. The format of this URI must be gs://<bucket-name>/<object-name>.

Dialogflow performs a read operation for the Cloud Storage object on the caller’s behalf, so your request authentication must have read permissions for the object. For more information, see Dialogflow access control.

This field is a member of oneof source.

Type

str

content

Uncompressed raw byte content for test cases.

This field is a member of oneof source.

Type

bytes

class google.cloud.dialogflowcx_v3beta1.types.ImportTestCasesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [TestCases.ImportTestCases][google.cloud.dialogflow.cx.v3beta1.TestCases.ImportTestCases].

names

The unique identifiers of the new test cases. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/testCases/<TestCaseID>.

Type

MutableSequence[str]

class google.cloud.dialogflowcx_v3beta1.types.InlineDestination(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Inline destination for a Dialogflow operation that writes or exports objects (e.g. [intents][google.cloud.dialogflow.cx.v3beta1.Intent]) outside of Dialogflow.

content

Output only. The uncompressed byte content for the objects. Only populated in responses.

Type

bytes

class google.cloud.dialogflowcx_v3beta1.types.InlineSource(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Inline source for a Dialogflow operation that reads or imports objects (e.g. [intents][google.cloud.dialogflow.cx.v3beta1.Intent]) into Dialogflow.

content

The uncompressed byte content for the objects.

Type

bytes

class google.cloud.dialogflowcx_v3beta1.types.InputAudioConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Instructs the speech recognizer on how to process the audio content.

audio_encoding

Required. Audio encoding of the audio content to process.

Type

google.cloud.dialogflowcx_v3beta1.types.AudioEncoding

sample_rate_hertz

Sample rate (in Hertz) of the audio content sent in the query. Refer to Cloud Speech API documentation for more details.

Type

int

enable_word_info

Optional. If true, Dialogflow returns [SpeechWordInfo][google.cloud.dialogflow.cx.v3beta1.SpeechWordInfo] in [StreamingRecognitionResult][google.cloud.dialogflow.cx.v3beta1.StreamingRecognitionResult] with information about the recognized speech words, e.g. start and end time offsets. If false or unspecified, Speech doesn’t return any word-level information.

Type

bool

phrase_hints

Optional. A list of strings containing words and phrases that the speech recognizer should recognize with higher likelihood.

See the Cloud Speech documentation for more details.

Type

MutableSequence[str]

model

Optional. Which Speech model to select for the given request. For more information, see Speech models.

Type

str

model_variant

Optional. Which variant of the [Speech model][google.cloud.dialogflow.cx.v3beta1.InputAudioConfig.model] to use.

Type

google.cloud.dialogflowcx_v3beta1.types.SpeechModelVariant

single_utterance

Optional. If false (default), recognition does not cease until the client closes the stream. If true, the recognizer will detect a single spoken utterance in input audio. Recognition ceases when it detects the audio’s voice has stopped or paused. In this case, once a detected intent is received, the client should close the stream and start a new request with a new stream as needed. Note: This setting is relevant only for streaming methods.

Type

bool

barge_in_config

Configuration of barge-in behavior during the streaming of input audio.

Type

google.cloud.dialogflowcx_v3beta1.types.BargeInConfig

opt_out_conformer_model_migration

If true, the request will opt out for STT conformer model migration. This field will be deprecated once force migration takes place in June 2024. Please refer to Dialogflow CX Speech model migration.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.Intent(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

An intent represents a user’s intent to interact with a conversational agent. You can provide information for the Dialogflow API to use to match user input to an intent by adding training phrases (i.e., examples of user input) to your intent.

name

The unique identifier of the intent. Required for the [Intents.UpdateIntent][google.cloud.dialogflow.cx.v3beta1.Intents.UpdateIntent] method. [Intents.CreateIntent][google.cloud.dialogflow.cx.v3beta1.Intents.CreateIntent] populates the name automatically. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/intents/<IntentID>.

Type

str

display_name

Required. The human-readable name of the intent, unique within the agent.

Type

str

training_phrases

The collection of training phrases the agent is trained on to identify the intent.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Intent.TrainingPhrase]

parameters

The collection of parameters associated with the intent.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Intent.Parameter]

priority

The priority of this intent. Higher numbers represent higher priorities.

• If the supplied value is unspecified or 0, the service translates the value to 500,000, which corresponds to the Normal priority in the console.

• If the supplied value is negative, the intent is ignored in runtime detect intent requests.

Type

int

is_fallback

Indicates whether this is a fallback intent. Currently only default fallback intent is allowed in the agent, which is added upon agent creation. Adding training phrases to fallback intent is useful in the case of requests that are mistakenly matched, since training phrases assigned to fallback intents act as negative examples that triggers no-match event.

Type

bool

labels

The key/value metadata to label an intent. Labels can contain lowercase letters, digits and the symbols ‘-’ and ‘_’. International characters are allowed, including letters from unicase alphabets. Keys must start with a letter. Keys and values can be no longer than 63 characters and no more than 128 bytes.

Prefix “sys-” is reserved for Dialogflow defined labels. Currently allowed Dialogflow defined labels include:

• sys-head

• sys-contextual The above labels do not require value. “sys-head” means the intent is a head intent. “sys-contextual” means the intent is a contextual intent.

Type

MutableMapping[str, str]

description

Human readable description for better understanding an intent like its scope, content, result etc. Maximum character limit: 140 characters.

Type

str

class LabelsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class Parameter(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents an intent parameter.

id

Required. The unique identifier of the parameter. This field is used by [training phrases][google.cloud.dialogflow.cx.v3beta1.Intent.TrainingPhrase] to annotate their [parts][google.cloud.dialogflow.cx.v3beta1.Intent.TrainingPhrase.Part].

Type

str

entity_type

Required. The entity type of the parameter. Format: projects/-/locations/-/agents/-/entityTypes/<SystemEntityTypeID> for system entity types (for example, projects/-/locations/-/agents/-/entityTypes/sys.date), or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/entityTypes/<EntityTypeID> for developer entity types.

Type

str

is_list

Indicates whether the parameter represents a list of values.

Type

bool

redact

Indicates whether the parameter content should be redacted in log. If redaction is enabled, the parameter content will be replaced by parameter name during logging. Note: the parameter content is subject to redaction if either parameter level redaction or [entity type level redaction][google.cloud.dialogflow.cx.v3beta1.EntityType.redact] is enabled.

Type

bool

class TrainingPhrase(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents an example that the agent is trained on to identify the intent.

id

Output only. The unique identifier of the training phrase.

Type

str

parts

Required. The ordered list of training phrase parts. The parts are concatenated in order to form the training phrase.

Note: The API does not automatically annotate training phrases like the Dialogflow Console does.

Note: Do not forget to include whitespace at part boundaries, so the training phrase is well formatted when the parts are concatenated.

If the training phrase does not need to be annotated with parameters, you just need a single part with only the [Part.text][google.cloud.dialogflow.cx.v3beta1.Intent.TrainingPhrase.Part.text] field set.

If you want to annotate the training phrase, you must create multiple parts, where the fields of each part are populated in one of two ways:

• Part.text is set to a part of the phrase that has no parameters.

• Part.text is set to a part of the phrase that you want to annotate, and the parameter_id field is set.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Intent.TrainingPhrase.Part]

repeat_count

Indicates how many times this example was added to the intent.

Type

int

class Part(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a part of a training phrase.

text

Required. The text for this part.

Type

str

parameter_id

The [parameter][google.cloud.dialogflow.cx.v3beta1.Intent.Parameter] used to annotate this part of the training phrase. This field is required for annotated parts of the training phrase.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.IntentCoverage(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Intent coverage represents the percentage of all possible intents in the agent that are triggered in any of a parent’s test cases.

intents

The list of Intents present in the agent

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.IntentCoverage.Intent]

coverage_score

The percent of intents in the agent that are covered.

Type

float

class Intent(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The agent’s intent.

intent

The intent full resource name

Type

str

covered

Whether the intent is covered by at least one of the agent’s test cases.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.IntentInput(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the intent to trigger programmatically rather than as a result of natural language processing.

intent

Required. The unique identifier of the intent. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/intents/<IntentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.IntentView(value)

Bases: proto.enums.Enum

Represents the options for views of an intent. An intent can be a sizable object. Therefore, we provide a resource view that does not return training phrases in the response.

Values:

INTENT_VIEW_UNSPECIFIED (0):

Not specified. Treated as INTENT_VIEW_FULL.

INTENT_VIEW_PARTIAL (1):

Training phrases field is not populated in the response.

INTENT_VIEW_FULL (2):

All fields are populated.

class google.cloud.dialogflowcx_v3beta1.types.KnowledgeConnectorSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

enabled

Whether Knowledge Connector is enabled or not.

Type

bool

trigger_fulfillment

The fulfillment to be triggered.

When the answers from the Knowledge Connector are selected by Dialogflow, you can utitlize the request scoped parameter $request.knowledge.answers (contains up to the 5 highest confidence answers) and $request.knowledge.questions (contains the corresponding questions) to construct the fulfillment.

Type

google.cloud.dialogflowcx_v3beta1.types.Fulfillment

target_page

The target page to transition to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>.

This field is a member of oneof target.

Type

str

target_flow

The target flow to transition to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

This field is a member of oneof target.

Type

str

data_store_connections

Optional. List of related data store connections.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.DataStoreConnection]

class google.cloud.dialogflowcx_v3beta1.types.LanguageInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the language information of the request.

input_language_code

The language code specified in the original [request][google.cloud.dialogflow.cx.v3beta1.QueryInput.language_code].

Type

str

resolved_language_code

The language code detected for this request based on the user conversation.

Type

str

confidence_score

The confidence score of the detected language between 0 and 1.

Type

float

class google.cloud.dialogflowcx_v3beta1.types.ListAgentsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Agents.ListAgents][google.cloud.dialogflow.cx.v3beta1.Agents.ListAgents].

parent

Required. The location to list all agents for. Format: projects/<ProjectID>/locations/<LocationID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListAgentsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Agents.ListAgents][google.cloud.dialogflow.cx.v3beta1.Agents.ListAgents].

agents

The list of agents. There will be a maximum number of items returned based on the page_size field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Agent]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListChangelogsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Changelogs.ListChangelogs][google.cloud.dialogflow.cx.v3beta1.Changelogs.ListChangelogs].

parent

Required. The agent containing the changelogs. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

filter

The filter string. Supports filter by user_email, resource, type and create_time. Some examples:

1. By user email: user_email = “someone@google.com”

2. By resource name: resource = “projects/123/locations/global/agents/456/flows/789”

3. By resource display name: display_name = “my agent”

4. By action: action = “Create”

5. By type: type = “flows”

6. By create time. Currently predicates on create_time and create_time_epoch_seconds are supported: create_time_epoch_seconds > 1551790877 AND create_time <= 2017-01-15T01:30:15.01Z

7. Combination of above filters: resource = “projects/123/locations/global/agents/456/flows/789” AND user_email = “someone@google.com” AND create_time <= 2017-01-15T01:30:15.01Z

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListChangelogsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Changelogs.ListChangelogs][google.cloud.dialogflow.cx.v3beta1.Changelogs.ListChangelogs].

changelogs

The list of changelogs. There will be a maximum number of items returned based on the page_size field in the request. The changelogs will be ordered by timestamp.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Changelog]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListContinuousTestResultsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Environments.ListContinuousTestResults][google.cloud.dialogflow.cx.v3beta1.Environments.ListContinuousTestResults].

parent

Required. The environment to list results for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListContinuousTestResultsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Environments.ListTestCaseResults][].

continuous_test_results

The list of continuous test results.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ContinuousTestResult]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListConversationsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Conversations.ListConversations][].

parent

Required. The agent to list all conversations for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

filter

Optional. The filter string. Supports filter by create_time, metrics.has_end_interaction, metrics.has_live_agent_handoff, intents.display_name, pages.display_name and flows.display_name. Timestamps expect an [RFC-3339][https://datatracker.ietf.org/doc/html/rfc3339] formatted string (e.g. 2012-04-21T11:30:00-04:00). UTC offsets are supported. Some examples:

1. By create time: create_time > “2022-04-21T11:30:00-04:00”

2. By intent display name: intents.display_name : “billing”

3. By end interaction signal: metrics.has_end_interaction = true

Type

str

page_size

Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

Optional. The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListConversationsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Conversations.ListConversations][].

conversations

The list of conversations. There will be a maximum number of items returned based on the [page_size][google.cloud.dialogflow.cx.v3beta1.ListConversationsRequest.page_size] field. The returned conversations will be sorted by start_time in descending order (newest conversation first).

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Conversation]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListDeploymentsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Deployments.ListDeployments][google.cloud.dialogflow.cx.v3beta1.Deployments.ListDeployments].

parent

Required. The [Environment][google.cloud.dialogflow.cx.v3beta1.Environment] to list all environments for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 20 and at most 100.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListDeploymentsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Deployments.ListDeployments][google.cloud.dialogflow.cx.v3beta1.Deployments.ListDeployments].

deployments

The list of deployments. There will be a maximum number of items returned based on the page_size field in the request. The list may in some cases be empty or contain fewer entries than page_size even if this isn’t the last page.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Deployment]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListEntityTypesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [EntityTypes.ListEntityTypes][google.cloud.dialogflow.cx.v3beta1.EntityTypes.ListEntityTypes].

parent

Required. The agent to list all entity types for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

language_code

The language to list entity types for. The following fields are language dependent:

• EntityType.entities.value

• EntityType.entities.synonyms

• EntityType.excluded_phrases.value

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListEntityTypesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [EntityTypes.ListEntityTypes][google.cloud.dialogflow.cx.v3beta1.EntityTypes.ListEntityTypes].

entity_types

The list of entity types. There will be a maximum number of items returned based on the page_size field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.EntityType]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListEnvironmentsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Environments.ListEnvironments][google.cloud.dialogflow.cx.v3beta1.Environments.ListEnvironments].

parent

Required. The [Agent][google.cloud.dialogflow.cx.v3beta1.Agent] to list all environments for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 20 and at most 100.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListEnvironmentsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Environments.ListEnvironments][google.cloud.dialogflow.cx.v3beta1.Environments.ListEnvironments].

environments

The list of environments. There will be a maximum number of items returned based on the page_size field in the request. The list may in some cases be empty or contain fewer entries than page_size even if this isn’t the last page.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Environment]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListExamplesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Examples.ListExamples][google.cloud.dialogflow.cx.v3beta1.Examples.ListExamples].

parent

Required. The playbook to list the examples from. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>.

Type

str

page_size

Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

Optional. The [next_page_token][ListExampleResponse.next_page_token] value returned from a previous list request.

Type

str

language_code

Optional. The language to list examples for. If not specified, list all examples under the playbook. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListExamplesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Examples.ListExamples][google.cloud.dialogflow.cx.v3beta1.Examples.ListExamples].

examples

The list of examples. There will be a maximum number of items returned based on the [page_size][google.cloud.dialogflow.cx.v3beta1.ListExamplesRequest.page_size] field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Example]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListExperimentsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Experiments.ListExperiments][google.cloud.dialogflow.cx.v3beta1.Experiments.ListExperiments].

parent

Required. The [Environment][google.cloud.dialogflow.cx.v3beta1.Environment] to list all environments for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 20 and at most 100.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListExperimentsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Experiments.ListExperiments][google.cloud.dialogflow.cx.v3beta1.Experiments.ListExperiments].

experiments

The list of experiments. There will be a maximum number of items returned based on the page_size field in the request. The list may in some cases be empty or contain fewer entries than page_size even if this isn’t the last page.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Experiment]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListFlowsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Flows.ListFlows][google.cloud.dialogflow.cx.v3beta1.Flows.ListFlows].

parent

Required. The agent containing the flows. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

language_code

The language to list flows for. The following fields are language dependent:

• Flow.event_handlers.trigger_fulfillment.messages

• Flow.event_handlers.trigger_fulfillment.conditional_cases

• Flow.transition_routes.trigger_fulfillment.messages

• Flow.transition_routes.trigger_fulfillment.conditional_cases

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListFlowsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Flows.ListFlows][google.cloud.dialogflow.cx.v3beta1.Flows.ListFlows].

flows

The list of flows. There will be a maximum number of items returned based on the page_size field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Flow]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListGeneratorsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Generators.ListGenerators][google.cloud.dialogflow.cx.v3beta1.Generators.ListGenerators].

parent

Required. The agent to list all generators for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

language_code

The language to list generators for.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListGeneratorsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Generators.ListGenerators][google.cloud.dialogflow.cx.v3beta1.Generators.ListGenerators].

generators

The list of generators. There will be a maximum number of items returned based on the page_size field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Generator]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListIntentsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Intents.ListIntents][google.cloud.dialogflow.cx.v3beta1.Intents.ListIntents].

parent

Required. The agent to list all intents for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

language_code

The language to list intents for. The following fields are language dependent:

• Intent.training_phrases.parts.text

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

intent_view

The resource view to apply to the returned intent.

Type

google.cloud.dialogflowcx_v3beta1.types.IntentView

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListIntentsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Intents.ListIntents][google.cloud.dialogflow.cx.v3beta1.Intents.ListIntents].

intents

The list of intents. There will be a maximum number of items returned based on the page_size field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Intent]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListPagesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Pages.ListPages][google.cloud.dialogflow.cx.v3beta1.Pages.ListPages].

parent

Required. The flow to list all pages for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Type

str

language_code

The language to list pages for. The following fields are language dependent:

• Page.entry_fulfillment.messages

• Page.entry_fulfillment.conditional_cases

• Page.event_handlers.trigger_fulfillment.messages

• Page.event_handlers.trigger_fulfillment.conditional_cases

• Page.form.parameters.fill_behavior.initial_prompt_fulfillment.messages

Page.form.parameters.fill_behavior.initial_prompt_fulfillment.conditional_cases

• Page.form.parameters.fill_behavior.reprompt_event_handlers.messages

Page.form.parameters.fill_behavior.reprompt_event_handlers.conditional_cases

• Page.transition_routes.trigger_fulfillment.messages

• Page.transition_routes.trigger_fulfillment.conditional_cases

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListPagesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Pages.ListPages][google.cloud.dialogflow.cx.v3beta1.Pages.ListPages].

pages

The list of pages. There will be a maximum number of items returned based on the page_size field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Page]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListPlaybookVersionsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Playbooks.ListPlaybookVersions][google.cloud.dialogflow.cx.v3beta1.Playbooks.ListPlaybookVersions].

parent

Required. The playbook to list versions for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>.

Type

str

page_size

Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

Optional. The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListPlaybookVersionsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Playbooks.ListPlaybookVersions][google.cloud.dialogflow.cx.v3beta1.Playbooks.ListPlaybookVersions].

playbook_versions

The list of playbook version. There will be a maximum number of items returned based on the page_size field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.PlaybookVersion]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListPlaybooksRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Playbooks.ListPlaybooks][google.cloud.dialogflow.cx.v3beta1.Playbooks.ListPlaybooks].

parent

Required. The agent to list playbooks from. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListPlaybooksResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Playbooks.ListPlaybooks][google.cloud.dialogflow.cx.v3beta1.Playbooks.ListPlaybooks].

playbooks

The list of playbooks. There will be a maximum number of items returned based on the page_size field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Playbook]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListSecuritySettingsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [SecuritySettings.ListSecuritySettings][].

parent

Required. The location to list all security settings for. Format: projects/<ProjectID>/locations/<LocationID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 20 and at most 100.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListSecuritySettingsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [SecuritySettings.ListSecuritySettings][].

security_settings

The list of security settings.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.SecuritySettings]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListSessionEntityTypesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [SessionEntityTypes.ListSessionEntityTypes][google.cloud.dialogflow.cx.v3beta1.SessionEntityTypes.ListSessionEntityTypes].

parent

Required. The session to list all session entity types from. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>. If Environment ID is not specified, we assume default ‘draft’ environment.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListSessionEntityTypesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [SessionEntityTypes.ListSessionEntityTypes][google.cloud.dialogflow.cx.v3beta1.SessionEntityTypes.ListSessionEntityTypes].

session_entity_types

The list of session entity types. There will be a maximum number of items returned based on the page_size field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.SessionEntityType]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListTestCaseResultsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TestCases.ListTestCaseResults][google.cloud.dialogflow.cx.v3beta1.TestCases.ListTestCaseResults].

parent

Required. The test case to list results for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/testCases/<TestCaseID>. Specify a - as a wildcard for TestCase ID to list results across multiple test cases.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

filter

The filter expression used to filter test case results. See API Filtering.

The expression is case insensitive. Only ‘AND’ is supported for logical operators. The supported syntax is listed below in detail:

[AND ] … [AND latest]

The supported fields and operators are: field operator environment =, IN (Use value draft for draft environment) test_time >, <

latest only returns the latest test result in all results for each test case.

Examples:

• “environment=draft AND latest” matches the latest test result for each test case in the draft environment.

• “environment IN (e1,e2)” matches any test case results with an environment resource name of either “e1” or “e2”.

• “test_time > 1602540713” matches any test case results with test time later than a unix timestamp in seconds 1602540713.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListTestCaseResultsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [TestCases.ListTestCaseResults][google.cloud.dialogflow.cx.v3beta1.TestCases.ListTestCaseResults].

test_case_results

The list of test case results.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TestCaseResult]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListTestCasesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TestCases.ListTestCases][google.cloud.dialogflow.cx.v3beta1.TestCases.ListTestCases].

parent

Required. The agent to list all pages for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 20. Note that when TestCaseView = FULL, the maximum page size allowed is 20. When TestCaseView = BASIC, the maximum page size allowed is 500.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

view

Specifies whether response should include all fields or just the metadata.

Type

google.cloud.dialogflowcx_v3beta1.types.ListTestCasesRequest.TestCaseView

class TestCaseView(value)

Bases: proto.enums.Enum

Specifies how much test case information to include in the response.

Values:

TEST_CASE_VIEW_UNSPECIFIED (0):

The default / unset value. The API will default to the BASIC view.

BASIC (1):

Include basic metadata about the test case, but not the conversation turns. This is the default value.

FULL (2):

Include everything.

class google.cloud.dialogflowcx_v3beta1.types.ListTestCasesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [TestCases.ListTestCases][google.cloud.dialogflow.cx.v3beta1.TestCases.ListTestCases].

test_cases

The list of test cases. There will be a maximum number of items returned based on the page_size field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TestCase]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListToolsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Tools.ListTools][google.cloud.dialogflow.cx.v3beta1.Tools.ListTools].

parent

Required. The agent to list the Tools from. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListToolsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Tools.ListTools][google.cloud.dialogflow.cx.v3beta1.Tools.ListTools].

tools

The list of Tools. There will be a maximum number of items returned based on the page_size field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Tool]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListTransitionRouteGroupsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TransitionRouteGroups.ListTransitionRouteGroups][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroups.ListTransitionRouteGroups].

parent

Required. The flow to list all transition route groups for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID> or `projects//locations//agents/.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

language_code

The language to list transition route groups for. The following fields are language dependent:

• TransitionRouteGroup.transition_routes.trigger_fulfillment.messages

TransitionRouteGroup.transition_routes.trigger_fulfillment.conditional_cases

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListTransitionRouteGroupsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [TransitionRouteGroups.ListTransitionRouteGroups][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroups.ListTransitionRouteGroups].

transition_route_groups

The list of transition route groups. There will be a maximum number of items returned based on the page_size field in the request. The list may in some cases be empty or contain fewer entries than page_size even if this isn’t the last page.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TransitionRouteGroup]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListVersionsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Versions.ListVersions][google.cloud.dialogflow.cx.v3beta1.Versions.ListVersions].

parent

Required. The [Flow][google.cloud.dialogflow.cx.v3beta1.Flow] to list all versions for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 20 and at most 100.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListVersionsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Versions.ListVersions][google.cloud.dialogflow.cx.v3beta1.Versions.ListVersions].

versions

A list of versions. There will be a maximum number of items returned based on the page_size field in the request. The list may in some cases be empty or contain fewer entries than page_size even if this isn’t the last page.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Version]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListWebhooksRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Webhooks.ListWebhooks][google.cloud.dialogflow.cx.v3beta1.Webhooks.ListWebhooks].

parent

Required. The agent to list all webhooks for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ListWebhooksResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Webhooks.ListWebhooks][google.cloud.dialogflow.cx.v3beta1.Webhooks.ListWebhooks].

webhooks

The list of webhooks. There will be a maximum number of items returned based on the page_size field in the request.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Webhook]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.LlmModelSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for LLM models.

model

The selected LLM model.

Type

str

prompt_text

The custom prompt to use.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.LoadVersionRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Versions.LoadVersion][google.cloud.dialogflow.cx.v3beta1.Versions.LoadVersion].

name

Required. The [Version][google.cloud.dialogflow.cx.v3beta1.Version] to be loaded to draft flow. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>.

Type

str

allow_override_agent_resources

This field is used to prevent accidental overwrite of other agent resources, which can potentially impact other flow’s behavior. If allow_override_agent_resources is false, conflicted agent-level resources will not be overridden (i.e. intents, entities, webhooks).

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.LookupEnvironmentHistoryRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Environments.LookupEnvironmentHistory][google.cloud.dialogflow.cx.v3beta1.Environments.LookupEnvironmentHistory].

name

Required. Resource name of the environment to look up the history for. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

page_size

The maximum number of items to return in a single page. By default 100 and at most 1000.

Type

int

page_token

The next_page_token value returned from a previous list request.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.LookupEnvironmentHistoryResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Environments.LookupEnvironmentHistory][google.cloud.dialogflow.cx.v3beta1.Environments.LookupEnvironmentHistory].

environments

Represents a list of snapshots for an environment. Time of the snapshots is stored in [update_time][google.cloud.dialogflow.cx.v3beta1.Environment.update_time].

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Environment]

next_page_token

Token to retrieve the next page of results, or empty if there are no more results in the list.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.Match(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents one match result of [MatchIntent][].

intent

The [Intent][google.cloud.dialogflow.cx.v3beta1.Intent] that matched the query. Some, not all fields are filled in this message, including but not limited to: name and display_name. Only filled for [INTENT][google.cloud.dialogflow.cx.v3beta1.Match.MatchType] match type.

Type

google.cloud.dialogflowcx_v3beta1.types.Intent

event

The event that matched the query. Filled for [EVENT][google.cloud.dialogflow.cx.v3beta1.Match.MatchType], [NO_MATCH][google.cloud.dialogflow.cx.v3beta1.Match.MatchType] and [NO_INPUT][google.cloud.dialogflow.cx.v3beta1.Match.MatchType] match types.

Type

str

parameters

The collection of parameters extracted from the query.

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.

Type

google.protobuf.struct_pb2.Struct

resolved_input

Final text input which was matched during MatchIntent. This value can be different from original input sent in request because of spelling correction or other processing.

Type

str

match_type

Type of this [Match][google.cloud.dialogflow.cx.v3beta1.Match].

Type

google.cloud.dialogflowcx_v3beta1.types.Match.MatchType

confidence

The confidence of this match. Values range from 0.0 (completely uncertain) to 1.0 (completely certain). This value is for informational purpose only and is only used to help match the best intent within the classification threshold. This value may change for the same end-user expression at any time due to a model retraining or change in implementation.

Type

float

class MatchType(value)

Bases: proto.enums.Enum

Type of a Match.

Values:

MATCH_TYPE_UNSPECIFIED (0):

Not specified. Should never be used.

INTENT (1):

The query was matched to an intent.

DIRECT_INTENT (2):

The query directly triggered an intent.

PARAMETER_FILLING (3):

The query was used for parameter filling.

NO_MATCH (4):

No match was found for the query.

NO_INPUT (5):

Indicates an empty query.

EVENT (6):

The query directly triggered an event.

KNOWLEDGE_CONNECTOR (8):

The query was matched to a Knowledge Connector answer.

PLAYBOOK (9):

The query was handled by a [Playbook][google.cloud.dialogflow.cx.v3beta1.Playbook].

class google.cloud.dialogflowcx_v3beta1.types.MatchIntentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request of [MatchIntent][].

session

Required. The name of the session this query is sent to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>. If Environment ID is not specified, we assume default ‘draft’ environment. It’s up to the API caller to choose an appropriate Session ID. It can be a random number or some type of session identifiers (preferably hashed). The length of the Session ID must not exceed 36 characters.

For more information, see the sessions guide.

Type

str

query_params

The parameters of this query.

Type

google.cloud.dialogflowcx_v3beta1.types.QueryParameters

query_input

Required. The input specification.

Type

google.cloud.dialogflowcx_v3beta1.types.QueryInput

persist_parameter_changes

Persist session parameter changes from query_params.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.MatchIntentResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response of [MatchIntent][].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

text

If [natural language text][google.cloud.dialogflow.cx.v3beta1.TextInput] was provided as input, this field will contain a copy of the text.

This field is a member of oneof query.

Type

str

trigger_intent

If an [intent][google.cloud.dialogflow.cx.v3beta1.IntentInput] was provided as input, this field will contain a copy of the intent identifier. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/intents/<IntentID>.

This field is a member of oneof query.

Type

str

transcript

If [natural language speech audio][google.cloud.dialogflow.cx.v3beta1.AudioInput] was provided as input, this field will contain the transcript for the audio.

This field is a member of oneof query.

Type

str

trigger_event

If an [event][google.cloud.dialogflow.cx.v3beta1.EventInput] was provided as input, this field will contain a copy of the event name.

This field is a member of oneof query.

Type

str

matches

Match results, if more than one, ordered descendingly by the confidence we have that the particular intent matches the query.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Match]

current_page

The current [Page][google.cloud.dialogflow.cx.v3beta1.Page]. Some, not all fields are filled in this message, including but not limited to name and display_name.

Type

google.cloud.dialogflowcx_v3beta1.types.Page

class google.cloud.dialogflowcx_v3beta1.types.NluSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings related to NLU.

model_type

Indicates the type of NLU model.

Type

google.cloud.dialogflowcx_v3beta1.types.NluSettings.ModelType

classification_threshold

To filter out false positive results and still get variety in matched natural language inputs for your agent, you can tune the machine learning classification threshold. If the returned score value is less than the threshold value, then a no-match event will be triggered. The score values range from 0.0 (completely uncertain) to 1.0 (completely certain). If set to 0.0, the default of 0.3 is used. You can set a separate classification threshold for the flow in each language enabled for the agent.

Type

float

model_training_mode

Indicates NLU model training mode.

Type

google.cloud.dialogflowcx_v3beta1.types.NluSettings.ModelTrainingMode

class ModelTrainingMode(value)

Bases: proto.enums.Enum

NLU model training mode.

Values:

MODEL_TRAINING_MODE_UNSPECIFIED (0):

Not specified. MODEL_TRAINING_MODE_AUTOMATIC will be used.

MODEL_TRAINING_MODE_AUTOMATIC (1):

NLU model training is automatically triggered when a flow gets modified. User can also manually trigger model training in this mode.

MODEL_TRAINING_MODE_MANUAL (2):

User needs to manually trigger NLU model training. Best for large flows whose models take long time to train.

class ModelType(value)

Bases: proto.enums.Enum

NLU model type.

Values:

MODEL_TYPE_UNSPECIFIED (0):

Not specified. MODEL_TYPE_STANDARD will be used.

MODEL_TYPE_STANDARD (1):

Use standard NLU model.

MODEL_TYPE_ADVANCED (3):

Use advanced NLU model.

class google.cloud.dialogflowcx_v3beta1.types.OutputAudioConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Instructs the speech synthesizer how to generate the output audio content.

audio_encoding

Required. Audio encoding of the synthesized audio content.

Type

google.cloud.dialogflowcx_v3beta1.types.OutputAudioEncoding

sample_rate_hertz

Optional. The synthesis sample rate (in hertz) for this audio. If not provided, then the synthesizer will use the default sample rate based on the audio encoding. If this is different from the voice’s natural sample rate, then the synthesizer will honor this request by converting to the desired sample rate (which might result in worse audio quality).

Type

int

synthesize_speech_config

Optional. Configuration of how speech should be synthesized. If not specified, [Agent.text_to_speech_settings][google.cloud.dialogflow.cx.v3beta1.Agent.text_to_speech_settings] is applied.

Type

google.cloud.dialogflowcx_v3beta1.types.SynthesizeSpeechConfig

class google.cloud.dialogflowcx_v3beta1.types.OutputAudioEncoding(value)

Bases: proto.enums.Enum

Audio encoding of the output audio format in Text-To-Speech.

Values:

OUTPUT_AUDIO_ENCODING_UNSPECIFIED (0):

Not specified.

OUTPUT_AUDIO_ENCODING_LINEAR_16 (1):

Uncompressed 16-bit signed little-endian samples (Linear PCM). Audio content returned as LINEAR16 also contains a WAV header.

OUTPUT_AUDIO_ENCODING_MP3 (2):

MP3 audio at 32kbps.

OUTPUT_AUDIO_ENCODING_MP3_64_KBPS (4):

MP3 audio at 64kbps.

OUTPUT_AUDIO_ENCODING_OGG_OPUS (3):

Opus encoded audio wrapped in an ogg container. The result will be a file which can be played natively on Android, and in browsers (at least Chrome and Firefox). The quality of the encoding is considerably higher than MP3 while using approximately the same bitrate.

OUTPUT_AUDIO_ENCODING_MULAW (5):

8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.

OUTPUT_AUDIO_ENCODING_ALAW (6):

8-bit samples that compand 13-bit audio samples using G.711 PCMU/a-law.

class google.cloud.dialogflowcx_v3beta1.types.OutputState(value)

Bases: proto.enums.Enum

Output state.

Values:

OUTPUT_STATE_UNSPECIFIED (0):

Unspecified output.

OUTPUT_STATE_OK (1):

Succeeded.

OUTPUT_STATE_CANCELLED (2):

Cancelled.

OUTPUT_STATE_FAILED (3):

Failed.

OUTPUT_STATE_ESCALATED (4):

Escalated.

OUTPUT_STATE_PENDING (5):

Pending.

class google.cloud.dialogflowcx_v3beta1.types.Page(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A Dialogflow CX conversation (session) can be described and visualized as a state machine. The states of a CX session are represented by pages.

For each flow, you define many pages, where your combined pages can handle a complete conversation on the topics the flow is designed for. At any given moment, exactly one page is the current page, the current page is considered active, and the flow associated with that page is considered active. Every flow has a special start page. When a flow initially becomes active, the start page page becomes the current page. For each conversational turn, the current page will either stay the same or transition to another page.

You configure each page to collect information from the end-user that is relevant for the conversational state represented by the page.

For more information, see the Page guide.

name

The unique identifier of the page. Required for the [Pages.UpdatePage][google.cloud.dialogflow.cx.v3beta1.Pages.UpdatePage] method. [Pages.CreatePage][google.cloud.dialogflow.cx.v3beta1.Pages.CreatePage] populates the name automatically. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>.

Type

str

display_name

Required. The human-readable name of the page, unique within the flow.

Type

str

description

The description of the page. The maximum length is 500 characters.

Type

str

entry_fulfillment

The fulfillment to call when the session is entering the page.

Type

google.cloud.dialogflowcx_v3beta1.types.Fulfillment

form

The form associated with the page, used for collecting parameters relevant to the page.

Type

google.cloud.dialogflowcx_v3beta1.types.Form

transition_route_groups

Ordered list of [TransitionRouteGroups][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroup] added to the page. Transition route groups must be unique within a page. If the page links both flow-level transition route groups and agent-level transition route groups, the flow-level ones will have higher priority and will be put before the agent-level ones.

• If multiple transition routes within a page scope refer to the same intent, then the precedence order is: page’s transition route -> page’s transition route group -> flow’s transition routes.

• If multiple transition route groups within a page contain the same intent, then the first group in the ordered list takes precedence.

Format:projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/transitionRouteGroups/<TransitionRouteGroupID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/transitionRouteGroups/<TransitionRouteGroupID> for agent-level groups.

Type

MutableSequence[str]

transition_routes

A list of transitions for the transition rules of this page. They route the conversation to another page in the same flow, or another flow.

When we are in a certain page, the TransitionRoutes are evalauted in the following order:

• TransitionRoutes defined in the page with intent specified.

• TransitionRoutes defined in the [transition route groups][google.cloud.dialogflow.cx.v3beta1.Page.transition_route_groups] with intent specified.

• TransitionRoutes defined in flow with intent specified.

• TransitionRoutes defined in the [transition route groups][google.cloud.dialogflow.cx.v3beta1.Flow.transition_route_groups] with intent specified.

• TransitionRoutes defined in the page with only condition specified.

• TransitionRoutes defined in the [transition route groups][google.cloud.dialogflow.cx.v3beta1.Page.transition_route_groups] with only condition specified.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TransitionRoute]

event_handlers

Handlers associated with the page to handle events such as webhook errors, no match or no input.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.EventHandler]

advanced_settings

Hierarchical advanced settings for this page. The settings exposed at the lower level overrides the settings exposed at the higher level.

Type

google.cloud.dialogflowcx_v3beta1.types.AdvancedSettings

knowledge_connector_settings

Optional. Knowledge connector configuration.

Type

google.cloud.dialogflowcx_v3beta1.types.KnowledgeConnectorSettings

class google.cloud.dialogflowcx_v3beta1.types.PageInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents page information communicated to and from the webhook.

current_page

Always present for [WebhookRequest][google.cloud.dialogflow.cx.v3beta1.WebhookRequest]. Ignored for [WebhookResponse][google.cloud.dialogflow.cx.v3beta1.WebhookResponse]. The unique identifier of the current page. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>.

Type

str

display_name

Always present for [WebhookRequest][google.cloud.dialogflow.cx.v3beta1.WebhookRequest]. Ignored for [WebhookResponse][google.cloud.dialogflow.cx.v3beta1.WebhookResponse]. The display name of the current page.

Type

str

form_info

Optional for both [WebhookRequest][google.cloud.dialogflow.cx.v3beta1.WebhookRequest] and [WebhookResponse][google.cloud.dialogflow.cx.v3beta1.WebhookResponse]. Information about the form.

Type

google.cloud.dialogflowcx_v3beta1.types.PageInfo.FormInfo

class FormInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents form information.

parameter_info

Optional for both [WebhookRequest][google.cloud.dialogflow.cx.v3beta1.WebhookRequest] and [WebhookResponse][google.cloud.dialogflow.cx.v3beta1.WebhookResponse]. The parameters contained in the form. Note that the webhook cannot add or remove any form parameter.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.PageInfo.FormInfo.ParameterInfo]

class ParameterInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents parameter information.

display_name

Always present for [WebhookRequest][google.cloud.dialogflow.cx.v3beta1.WebhookRequest]. Required for [WebhookResponse][google.cloud.dialogflow.cx.v3beta1.WebhookResponse]. The human-readable name of the parameter, unique within the form. This field cannot be modified by the webhook.

Type

str

required

Optional for both [WebhookRequest][google.cloud.dialogflow.cx.v3beta1.WebhookRequest] and [WebhookResponse][google.cloud.dialogflow.cx.v3beta1.WebhookResponse]. Indicates whether the parameter is required. Optional parameters will not trigger prompts; however, they are filled if the user specifies them. Required parameters must be filled before form filling concludes.

Type

bool

state

Always present for [WebhookRequest][google.cloud.dialogflow.cx.v3beta1.WebhookRequest]. Required for [WebhookResponse][google.cloud.dialogflow.cx.v3beta1.WebhookResponse]. The state of the parameter. This field can be set to [INVALID][google.cloud.dialogflow.cx.v3beta1.PageInfo.FormInfo.ParameterInfo.ParameterState.INVALID] by the webhook to invalidate the parameter; other values set by the webhook will be ignored.

Type

google.cloud.dialogflowcx_v3beta1.types.PageInfo.FormInfo.ParameterInfo.ParameterState

value

Optional for both [WebhookRequest][google.cloud.dialogflow.cx.v3beta1.WebhookRequest] and [WebhookResponse][google.cloud.dialogflow.cx.v3beta1.WebhookResponse]. The value of the parameter. This field can be set by the webhook to change the parameter value.

Type

google.protobuf.struct_pb2.Value

just_collected

Optional for [WebhookRequest][google.cloud.dialogflow.cx.v3beta1.WebhookRequest]. Ignored for [WebhookResponse][google.cloud.dialogflow.cx.v3beta1.WebhookResponse]. Indicates if the parameter value was just collected on the last conversation turn.

Type

bool

class ParameterState(value)

Bases: proto.enums.Enum

Represents the state of a parameter.

Values:

PARAMETER_STATE_UNSPECIFIED (0):

Not specified. This value should be never used.

EMPTY (1):

Indicates that the parameter does not have a value.

INVALID (2):

Indicates that the parameter value is invalid. This field can be used by the webhook to invalidate the parameter and ask the server to collect it from the user again.

FILLED (3):

Indicates that the parameter has a value.

class google.cloud.dialogflowcx_v3beta1.types.ParameterDefinition(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Defines the properties of a parameter. Used to define parameters used in the agent and the input / output parameters for each fulfillment. (– Next Id: 4 –) (– api-linter: core::0123::resource-annotation=disabled aip.dev/not-precedent: ParameterDefinition is not an exposed resource. –)

name

Name of parameter.

Type

str

type_

Type of parameter.

Type

google.cloud.dialogflowcx_v3beta1.types.ParameterDefinition.ParameterType

description

Human-readable description of the parameter. Limited to 300 characters.

Type

str

class ParameterType(value)

Bases: proto.enums.Enum

Parameter types are used for validation. These types are consistent with [google.protobuf.Value][].

Values:

PARAMETER_TYPE_UNSPECIFIED (0):

Not specified. No validation will be performed.

STRING (1):

Represents any string value.

NUMBER (2):

Represents any number value.

BOOLEAN (3):

Represents a boolean value.

NULL (4):

Represents a null value.

OBJECT (5):

Represents any object value.

LIST (6):

Represents a repeated value.

class google.cloud.dialogflowcx_v3beta1.types.Phrase(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Text input which can be used for prompt or banned phrases.

text

Required. Text input which can be used for prompt or banned phrases.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.Playbook(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Playbook is the basic building block to instruct the LLM how to execute a certain task.

A playbook consists of a goal to accomplish, an optional list of step by step instructions (the step instruction may refers to name of the custom or default plugin tools to use) to perform the task, a list of contextual input data to be passed in at the beginning of the invoked, and a list of output parameters to store the playbook result.

name

The unique identifier of the playbook. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>.

Type

str

display_name

Required. The human-readable name of the playbook, unique within an agent.

Type

str

goal

Required. High level description of the goal the playbook intend to accomplish.

Type

str

input_parameter_definitions

Optional. Defined structured input parameters for this playbook.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ParameterDefinition]

output_parameter_definitions

Optional. Defined structured output parameters for this playbook.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ParameterDefinition]

instruction

Instruction to accomplish target goal.

Type

google.cloud.dialogflowcx_v3beta1.types.Playbook.Instruction

token_count

Output only. Estimated number of tokes current playbook takes when sent to the LLM.

Type

int

create_time

Output only. The timestamp of initial playbook creation.

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. Last time the playbook version was updated.

Type

google.protobuf.timestamp_pb2.Timestamp

referenced_playbooks

Output only. The resource name of other playbooks referenced by the current playbook in the instructions.

Type

MutableSequence[str]

referenced_flows

Output only. The resource name of flows referenced by the current playbook in the instructions.

Type

MutableSequence[str]

referenced_tools

Optional. The resource name of tools referenced by the current playbook in the instructions. If not provided explicitly, they are will be implied using the tool being referenced in goal and steps.

Type

MutableSequence[str]

llm_model_settings

Optional. Llm model settings for the playbook.

Type

google.cloud.dialogflowcx_v3beta1.types.LlmModelSettings

class Instruction(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Message of the Instruction of the playbook.

steps

Ordered list of step by step execution instructions to accomplish target goal.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Playbook.Step]

class Step(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Message of single step execution.

text

Step instruction in text format.

This field is a member of oneof instruction.

Type

str

steps

Sub-processing needed to execute the current step.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Playbook.Step]

class google.cloud.dialogflowcx_v3beta1.types.PlaybookInput(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Input of the playbook.

preceding_conversation_summary

Optional. Summary string of the preceding conversation for the child playbook invocation.

Type

str

action_parameters

Optional. A list of input parameters for the action.

Type

google.protobuf.struct_pb2.Struct

class google.cloud.dialogflowcx_v3beta1.types.PlaybookInvocation(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Stores metadata of the invocation of a child playbook.

playbook

Required. The unique identifier of the playbook. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>.

Type

str

playbook_input

Optional. Input of the child playbook invocation.

Type

google.cloud.dialogflowcx_v3beta1.types.PlaybookInput

playbook_output

Optional. Output of the child playbook invocation.

Type

google.cloud.dialogflowcx_v3beta1.types.PlaybookOutput

playbook_state

Required. Playbook invocation’s output state.

Type

google.cloud.dialogflowcx_v3beta1.types.OutputState

class google.cloud.dialogflowcx_v3beta1.types.PlaybookOutput(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Output of the playbook.

execution_summary

Optional. Summary string of the execution result of the child playbook.

Type

str

action_parameters

Optional. A Struct object of output parameters for the action.

Type

google.protobuf.struct_pb2.Struct

class google.cloud.dialogflowcx_v3beta1.types.PlaybookVersion(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Playbook version is a snapshot of the playbook at certain timestamp.

name

The unique identifier of the playbook version. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>/versions/<VersionID>.

Type

str

description

Optional. The description of the playbook version.

Type

str

playbook

Output only. Snapshot of the playbook when the playbook version is created.

Type

google.cloud.dialogflowcx_v3beta1.types.Playbook

examples

Output only. Snapshot of the examples belonging to the playbook when the playbook version is created.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Example]

update_time

Output only. Last time the playbook version was created or modified.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.dialogflowcx_v3beta1.types.QueryInput(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the query input. It can contain one of:

1. A conversational query in the form of text.

2. An intent query that specifies which intent to trigger.

3. Natural language speech audio to be processed.

4. An event to be triggered.

5. DTMF digits to invoke an intent and fill in parameter value.

6. The results of a tool executed by the client.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

text

The natural language text to be processed.

This field is a member of oneof input.

Type

google.cloud.dialogflowcx_v3beta1.types.TextInput

intent

The intent to be triggered.

This field is a member of oneof input.

Type

google.cloud.dialogflowcx_v3beta1.types.IntentInput

audio

The natural language speech audio to be processed.

This field is a member of oneof input.

Type

google.cloud.dialogflowcx_v3beta1.types.AudioInput

event

The event to be triggered.

This field is a member of oneof input.

Type

google.cloud.dialogflowcx_v3beta1.types.EventInput

dtmf

The DTMF event to be handled.

This field is a member of oneof input.

Type

google.cloud.dialogflowcx_v3beta1.types.DtmfInput

tool_call_result

The results of a tool executed by the client.

This field is a member of oneof input.

Type

google.cloud.dialogflowcx_v3beta1.types.ToolCallResult

language_code

Required. The language of the input. See Language Support for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.QueryParameters(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the parameters of a conversational query.

time_zone

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.

Type

str

geo_location

The geo location of this conversational query.

Type

google.type.latlng_pb2.LatLng

session_entity_types

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.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.SessionEntityType]

payload

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"
 }
}

Type

google.protobuf.struct_pb2.Struct

parameters

Additional parameters to be put into [session parameters][SessionInfo.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.

Type

google.protobuf.struct_pb2.Struct

current_page

The unique identifier of the [page][google.cloud.dialogflow.cx.v3beta1.Page] to override the [current page][QueryResult.current_page] in the session. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>.

If current_page is specified, the previous state of the session will be ignored by Dialogflow, including the [previous page][QueryResult.current_page] and the [previous session parameters][QueryResult.parameters]. In most cases, [current_page][google.cloud.dialogflow.cx.v3beta1.QueryParameters.current_page] and [parameters][google.cloud.dialogflow.cx.v3beta1.QueryParameters.parameters] should be configured together to direct a session to a specific state.

Type

str

disable_webhook

Whether to disable webhook calls for this request.

Type

bool

analyze_query_text_sentiment

Configures whether sentiment analysis should be performed. If not provided, sentiment analysis is not performed.

Type

bool

webhook_headers

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.

Type

MutableMapping[str, str]

flow_versions

A list of flow versions to override for the request. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>.

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.

Type

MutableSequence[str]

current_playbook

Optional. Start the session with the specified [playbook][google.cloud.dialogflow.cx.v3beta1.Playbook]. You can only specify the playbook at the beginning of the session. Otherwise, an error will be thrown.

Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>.

Type

str

llm_model_settings

Optional. Use the specified LLM model settings for processing the request.

Type

google.cloud.dialogflowcx_v3beta1.types.LlmModelSettings

channel

The channel which this query is for.

If specified, only the [ResponseMessage][google.cloud.dialogflow.cx.v3beta1.ResponseMessage] associated with the channel will be returned. If no [ResponseMessage][google.cloud.dialogflow.cx.v3beta1.ResponseMessage] is associated with the channel, it falls back to the [ResponseMessage][google.cloud.dialogflow.cx.v3beta1.ResponseMessage] with unspecified channel.

If unspecified, the [ResponseMessage][google.cloud.dialogflow.cx.v3beta1.ResponseMessage] with unspecified channel will be returned.

Type

str

session_ttl

Optional. Configure lifetime of the Dialogflow session. 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.

Type

google.protobuf.duration_pb2.Duration

end_user_metadata

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"}
  ]
}

Type

google.protobuf.struct_pb2.Struct

search_config

Optional. Search configuration for UCS search queries.

Type

google.cloud.dialogflowcx_v3beta1.types.SearchConfig

populate_data_store_connection_signals

Optional. If set to true and data stores are involved in serving the request then DetectIntentResponse.query_result.data_store_connection_signals will be filled with data that can help evaluations.

Type

bool

class WebhookHeadersEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class google.cloud.dialogflowcx_v3beta1.types.QueryResult(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the result of a conversational query.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

text

If [natural language text][google.cloud.dialogflow.cx.v3beta1.TextInput] was provided as input, this field will contain a copy of the text.

This field is a member of oneof query.

Type

str

trigger_intent

If an [intent][google.cloud.dialogflow.cx.v3beta1.IntentInput] was provided as input, this field will contain a copy of the intent identifier. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/intents/<IntentID>.

This field is a member of oneof query.

Type

str

transcript

If [natural language speech audio][google.cloud.dialogflow.cx.v3beta1.AudioInput] was provided as input, this field will contain the transcript for the audio.

This field is a member of oneof query.

Type

str

trigger_event

If an [event][google.cloud.dialogflow.cx.v3beta1.EventInput] was provided as input, this field will contain the name of the event.

This field is a member of oneof query.

Type

str

dtmf

If a [DTMF][google.cloud.dialogflow.cx.v3beta1.DtmfInput] was provided as input, this field will contain a copy of the [DtmfInput][google.cloud.dialogflow.cx.v3beta1.DtmfInput].

This field is a member of oneof query.

Type

google.cloud.dialogflowcx_v3beta1.types.DtmfInput

language_code

The language that was triggered during intent detection. See Language Support for a list of the currently supported language codes.

Type

str

parameters

The collected [session parameters][google.cloud.dialogflow.cx.v3beta1.SessionInfo.parameters].

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.

Type

google.protobuf.struct_pb2.Struct

response_messages

The list of rich messages returned to the client. Responses vary from simple text messages to more sophisticated, structured payloads used to drive complex logic.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ResponseMessage]

webhook_ids

The list of webhook ids in the order of call sequence.

Type

MutableSequence[str]

webhook_display_names

The list of webhook display names in the order of call sequence.

Type

MutableSequence[str]

webhook_latencies

The list of webhook latencies in the order of call sequence.

Type

MutableSequence[google.protobuf.duration_pb2.Duration]

webhook_tags

The list of webhook tags in the order of call sequence.

Type

MutableSequence[str]

webhook_statuses

The list of webhook call status in the order of call sequence.

Type

MutableSequence[google.rpc.status_pb2.Status]

webhook_payloads

The list of webhook payload in [WebhookResponse.payload][google.cloud.dialogflow.cx.v3beta1.WebhookResponse.payload], in the order of call sequence. If some webhook call fails or doesn’t return any payload, an empty Struct would be used instead.

Type

MutableSequence[google.protobuf.struct_pb2.Struct]

current_page

The current [Page][google.cloud.dialogflow.cx.v3beta1.Page]. Some, not all fields are filled in this message, including but not limited to name and display_name.

Type

google.cloud.dialogflowcx_v3beta1.types.Page

current_flow

The current [Flow][google.cloud.dialogflow.cx.v3beta1.Flow]. Some, not all fields are filled in this message, including but not limited to name and display_name.

Type

google.cloud.dialogflowcx_v3beta1.types.Flow

intent

The [Intent][google.cloud.dialogflow.cx.v3beta1.Intent] that matched the conversational query. Some, not all fields are filled in this message, including but not limited to: name and display_name. This field is deprecated, please use [QueryResult.match][google.cloud.dialogflow.cx.v3beta1.QueryResult.match] instead.

Type

google.cloud.dialogflowcx_v3beta1.types.Intent

intent_detection_confidence

The intent detection confidence. Values range from 0.0 (completely uncertain) to 1.0 (completely certain). This value is for informational purpose only and is only used to help match the best intent within the classification threshold. This value may change for the same end-user expression at any time due to a model retraining or change in implementation. This field is deprecated, please use [QueryResult.match][google.cloud.dialogflow.cx.v3beta1.QueryResult.match] instead.

Type

float

match

Intent match result, could be an intent or an event.

Type

google.cloud.dialogflowcx_v3beta1.types.Match

diagnostic_info

The free-form diagnostic info. For example, this field could contain webhook call latency. The fields of this data can change without notice, so you should not write code that depends on its structure.

One of the fields is called “Alternative Matched Intents”, which may aid with debugging. The following describes these intent results:

• The list is empty if no intent was matched to end-user input.

• Only intents that are referenced in the currently active flow are included.

• The matched intent is included.

• Other intents that could have matched end-user input, but did not match because they are referenced by intent routes that are out of scope, are included.

• Other intents referenced by intent routes in scope that matched end-user input, but had a lower confidence score.

Type

google.protobuf.struct_pb2.Struct

generative_info

The information of a query if handled by generative agent resources.

Type

google.cloud.dialogflowcx_v3beta1.types.GenerativeInfo

sentiment_analysis_result

The sentiment analyss result, which depends on [analyze_query_text_sentiment] [google.cloud.dialogflow.cx.v3beta1.QueryParameters.analyze_query_text_sentiment], specified in the request.

Type

google.cloud.dialogflowcx_v3beta1.types.SentimentAnalysisResult

advanced_settings

Returns the current advanced settings including IVR settings. Even though the operations configured by these settings are performed by Dialogflow, the client may need to perform special logic at the moment. For example, if Dialogflow exports audio to Google Cloud Storage, then the client may need to wait for the resulting object to appear in the bucket before proceeding.

Type

google.cloud.dialogflowcx_v3beta1.types.AdvancedSettings

allow_answer_feedback

Indicates whether the Thumbs up/Thumbs down rating controls are need to be shown for the response in the Dialogflow Messenger widget.

Type

bool

data_store_connection_signals

Optional. Data store connection feature output signals. Filled only when data stores are involved in serving the query and DetectIntentRequest.populate_data_store_connection_signals is set to true in the request.

Type

google.cloud.dialogflowcx_v3beta1.types.DataStoreConnectionSignals

class google.cloud.dialogflowcx_v3beta1.types.ResourceName(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Resource name and display name.

name

Name.

Type

str

display_name

Display name.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ResponseMessage(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a response message that can be returned by a conversational agent.

Response messages are also used for output audio synthesis. The approach is as follows:

• If at least one OutputAudioText response is present, then all OutputAudioText responses are linearly concatenated, and the result is used for output audio synthesis.

• If the OutputAudioText responses are a mixture of text and SSML, then the concatenated result is treated as SSML; otherwise, the result is treated as either text or SSML as appropriate. The agent designer should ideally use either text or SSML consistently throughout the bot design.

• Otherwise, all Text responses are linearly concatenated, and the result is used for output audio synthesis.

This approach allows for more sophisticated user experience scenarios, where the text displayed to the user may differ from what is heard.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

text

Returns a text response.

This field is a member of oneof message.

Type

google.cloud.dialogflowcx_v3beta1.types.ResponseMessage.Text

payload

Returns a response containing a custom, platform-specific payload.

This field is a member of oneof message.

Type

google.protobuf.struct_pb2.Struct

conversation_success

Indicates that the conversation succeeded.

This field is a member of oneof message.

Type

google.cloud.dialogflowcx_v3beta1.types.ResponseMessage.ConversationSuccess

output_audio_text

A text or ssml response that is preferentially used for TTS output audio synthesis, as described in the comment on the ResponseMessage message.

This field is a member of oneof message.

Type

google.cloud.dialogflowcx_v3beta1.types.ResponseMessage.OutputAudioText

live_agent_handoff

Hands off conversation to a human agent.

This field is a member of oneof message.

Type

google.cloud.dialogflowcx_v3beta1.types.ResponseMessage.LiveAgentHandoff

end_interaction

Output only. A signal that indicates the interaction with the Dialogflow agent has ended. This message is generated by Dialogflow only when the conversation reaches END_SESSION page. It is not supposed to be defined by the user.

It’s guaranteed that there is at most one such message in each response.

This field is a member of oneof message.

Type

google.cloud.dialogflowcx_v3beta1.types.ResponseMessage.EndInteraction

play_audio

Signal that the client should play an audio clip hosted at a client-specific URI. Dialogflow uses this to construct [mixed_audio][google.cloud.dialogflow.cx.v3beta1.ResponseMessage.mixed_audio]. However, Dialogflow itself does not try to read or process the URI in any way.

This field is a member of oneof message.

Type

google.cloud.dialogflowcx_v3beta1.types.ResponseMessage.PlayAudio

mixed_audio

Output only. An audio response message composed of both the synthesized Dialogflow agent responses and responses defined via [play_audio][google.cloud.dialogflow.cx.v3beta1.ResponseMessage.play_audio]. This message is generated by Dialogflow only and not supposed to be defined by the user.

This field is a member of oneof message.

Type

google.cloud.dialogflowcx_v3beta1.types.ResponseMessage.MixedAudio

telephony_transfer_call

A signal that the client should transfer the phone call connected to this agent to a third-party endpoint.

This field is a member of oneof message.

Type

google.cloud.dialogflowcx_v3beta1.types.ResponseMessage.TelephonyTransferCall

knowledge_info_card

Represents info card for knowledge answers, to be better rendered in Dialogflow Messenger.

This field is a member of oneof message.

Type

google.cloud.dialogflowcx_v3beta1.types.ResponseMessage.KnowledgeInfoCard

tool_call

Returns the definition of a tool call that should be executed by the client.

This field is a member of oneof message.

Type

google.cloud.dialogflowcx_v3beta1.types.ToolCall

channel

The channel which the response is associated with. Clients can specify the channel via [QueryParameters.channel][google.cloud.dialogflow.cx.v3beta1.QueryParameters.channel], and only associated channel response will be returned.

Type

str

class ConversationSuccess(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Indicates that the conversation succeeded, i.e., the bot handled the issue that the customer talked to it about.

Dialogflow only uses this to determine which conversations should be counted as successful and doesn’t process the metadata in this message in any way. Note that Dialogflow also considers conversations that get to the conversation end page as successful even if they don’t return [ConversationSuccess][google.cloud.dialogflow.cx.v3beta1.ResponseMessage.ConversationSuccess].

You may set this, for example:

• In the [entry_fulfillment][google.cloud.dialogflow.cx.v3beta1.Page.entry_fulfillment] of a [Page][google.cloud.dialogflow.cx.v3beta1.Page] if entering the page indicates that the conversation succeeded.

• In a webhook response when you determine that you handled the customer issue.

metadata

Custom metadata. Dialogflow doesn’t impose any structure on this.

Type

google.protobuf.struct_pb2.Struct

class EndInteraction(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Indicates that interaction with the Dialogflow agent has ended. This message is generated by Dialogflow only and not supposed to be defined by the user.

class KnowledgeInfoCard(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents info card response. If the response contains generative knowledge prediction, Dialogflow will return a payload with Infobot Messenger compatible info card.

Otherwise, the info card response is skipped.

class LiveAgentHandoff(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Indicates that the conversation should be handed off to a live agent.

Dialogflow only uses this to determine which conversations were handed off to a human agent for measurement purposes. What else to do with this signal is up to you and your handoff procedures.

You may set this, for example:

• In the [entry_fulfillment][google.cloud.dialogflow.cx.v3beta1.Page.entry_fulfillment] of a [Page][google.cloud.dialogflow.cx.v3beta1.Page] if entering the page indicates something went extremely wrong in the conversation.

• In a webhook response when you determine that the customer issue can only be handled by a human.

metadata

Custom metadata for your handoff procedure. Dialogflow doesn’t impose any structure on this.

Type

google.protobuf.struct_pb2.Struct

class MixedAudio(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents an audio message that is composed of both segments synthesized from the Dialogflow agent prompts and ones hosted externally at the specified URIs. The external URIs are specified via [play_audio][google.cloud.dialogflow.cx.v3beta1.ResponseMessage.play_audio]. This message is generated by Dialogflow only and not supposed to be defined by the user.

segments

Segments this audio response is composed of.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ResponseMessage.MixedAudio.Segment]

class Segment(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents one segment of audio.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

audio

Raw audio synthesized from the Dialogflow agent’s response using the output config specified in the request.

This field is a member of oneof content.

Type

bytes

uri

Client-specific URI that points to an audio clip accessible to the client. Dialogflow does not impose any validation on it.

This field is a member of oneof content.

Type

str

allow_playback_interruption

Output only. Whether the playback of this segment can be interrupted by the end user’s speech and the client should then start the next Dialogflow request.

Type

bool

class OutputAudioText(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A text or ssml response that is preferentially used for TTS output audio synthesis, as described in the comment on the ResponseMessage message.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

text

The raw text to be synthesized.

This field is a member of oneof source.

Type

str

ssml

The SSML text to be synthesized. For more information, see SSML.

This field is a member of oneof source.

Type

str

allow_playback_interruption

Output only. Whether the playback of this message can be interrupted by the end user’s speech and the client can then starts the next Dialogflow request.

Type

bool

class PlayAudio(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Specifies an audio clip to be played by the client as part of the response.

audio_uri

Required. URI of the audio clip. Dialogflow does not impose any validation on this value. It is specific to the client that reads it.

Type

str

allow_playback_interruption

Output only. Whether the playback of this message can be interrupted by the end user’s speech and the client can then starts the next Dialogflow request.

Type

bool

class TelephonyTransferCall(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the signal that telles the client to transfer the phone call connected to the agent to a third-party endpoint.

phone_number

Transfer the call to a phone number in E.164 format.

This field is a member of oneof endpoint.

Type

str

class Text(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The text response message.

text

Required. A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.

Type

MutableSequence[str]

allow_playback_interruption

Output only. Whether the playback of this message can be interrupted by the end user’s speech and the client can then starts the next Dialogflow request.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.RestoreAgentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Agents.RestoreAgent][google.cloud.dialogflow.cx.v3beta1.Agents.RestoreAgent].

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

name

Required. The name of the agent to restore into. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

agent_uri

The Google Cloud Storage URI to restore agent from. The format of this URI must be gs://<bucket-name>/<object-name>.

Dialogflow performs a read operation for the Cloud Storage object on the caller’s behalf, so your request authentication must have read permissions for the object. For more information, see Dialogflow access control.

This field is a member of oneof agent.

Type

str

agent_content

Uncompressed raw byte content for agent.

This field is a member of oneof agent.

Type

bytes

git_source

Setting for restoring from a git branch

This field is a member of oneof agent.

Type

google.cloud.dialogflowcx_v3beta1.types.RestoreAgentRequest.GitSource

restore_option

Agent restore mode. If not specified, KEEP is assumed.

Type

google.cloud.dialogflowcx_v3beta1.types.RestoreAgentRequest.RestoreOption

class GitSource(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for restoring from a git branch

tracking_branch

tracking branch for the git pull

Type

str

class RestoreOption(value)

Bases: proto.enums.Enum

Restore option.

Values:

RESTORE_OPTION_UNSPECIFIED (0):

Unspecified. Treated as KEEP.

KEEP (1):

Always respect the settings from the exported agent file. It may cause a restoration failure if some settings (e.g. model type) are not supported in the target agent.

FALLBACK (2):

Fallback to default settings if some settings are not supported in the target agent.

class google.cloud.dialogflowcx_v3beta1.types.RolloutConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The configuration for auto rollout.

rollout_steps

Steps to roll out a flow version. Steps should be sorted by percentage in ascending order.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.RolloutConfig.RolloutStep]

rollout_condition

The conditions that are used to evaluate the success of a rollout step. If not specified, all rollout steps will proceed to the next one unless failure conditions are met. E.g. “containment_rate > 60% AND callback_rate < 20%”. See the conditions reference.

Type

str

failure_condition

The conditions that are used to evaluate the failure of a rollout step. If not specified, no rollout steps will fail. E.g. “containment_rate < 10% OR average_turn_count < 3”. See the conditions reference.

Type

str

class RolloutStep(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A single rollout step with specified traffic allocation.

display_name

The name of the rollout step;

Type

str

traffic_percent

The percentage of traffic allocated to the flow version of this rollout step. (0%, 100%].

Type

int

min_duration

The minimum time that this step should last. Should be longer than 1 hour. If not set, the default minimum duration for each step will be 1 hour.

Type

google.protobuf.duration_pb2.Duration

class google.cloud.dialogflowcx_v3beta1.types.RolloutState(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

State of the auto-rollout process.

step

Display name of the current auto rollout step.

Type

str

step_index

Index of the current step in the auto rollout steps list.

Type

int

start_time

Start time of the current step.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.dialogflowcx_v3beta1.types.RunContinuousTestMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metadata returned for the [Environments.RunContinuousTest][google.cloud.dialogflow.cx.v3beta1.Environments.RunContinuousTest] long running operation.

errors

The test errors.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TestError]

class google.cloud.dialogflowcx_v3beta1.types.RunContinuousTestRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Environments.RunContinuousTest][google.cloud.dialogflow.cx.v3beta1.Environments.RunContinuousTest].

environment

Required. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.RunContinuousTestResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [Environments.RunContinuousTest][google.cloud.dialogflow.cx.v3beta1.Environments.RunContinuousTest].

continuous_test_result

The result for a continuous test run.

Type

google.cloud.dialogflowcx_v3beta1.types.ContinuousTestResult

class google.cloud.dialogflowcx_v3beta1.types.RunTestCaseMetadata(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Metadata returned for the [TestCases.RunTestCase][google.cloud.dialogflow.cx.v3beta1.TestCases.RunTestCase] long running operation. This message currently has no fields.

class google.cloud.dialogflowcx_v3beta1.types.RunTestCaseRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TestCases.RunTestCase][google.cloud.dialogflow.cx.v3beta1.TestCases.RunTestCase].

name

Required. Format of test case name to run: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/testCases/<TestCaseID>.

Type

str

environment

Optional. Environment name. If not set, draft environment is assumed. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.RunTestCaseResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for [TestCases.RunTestCase][google.cloud.dialogflow.cx.v3beta1.TestCases.RunTestCase].

result

The result.

Type

google.cloud.dialogflowcx_v3beta1.types.TestCaseResult

class google.cloud.dialogflowcx_v3beta1.types.SafetySettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for Generative Safety.

default_banned_phrase_match_strategy

Optional. Default phrase match strategy for banned phrases.

Type

google.cloud.dialogflowcx_v3beta1.types.SafetySettings.PhraseMatchStrategy

banned_phrases

Banned phrases for generated text.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.SafetySettings.Phrase]

class Phrase(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Text input which can be used for prompt or banned phrases.

text

Required. Text input which can be used for prompt or banned phrases.

Type

str

language_code

Required. Language code of the phrase.

Type

str

class PhraseMatchStrategy(value)

Bases: proto.enums.Enum

Strategy for matching phrases.

Values:

PHRASE_MATCH_STRATEGY_UNSPECIFIED (0):

Unspecified, defaults to PARTIAL_MATCH.

PARTIAL_MATCH (1):

Text that contains the phrase as a substring will be matched, e.g. “foo” will match “afoobar”.

WORD_MATCH (2):

Text that contains the tokenized words of the phrase will be matched, e.g. “foo” will match “a foo bar” and “foo bar”, but not “foobar”.

class google.cloud.dialogflowcx_v3beta1.types.SearchConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Search configuration for UCS search queries.

boost_specs

Optional. Boosting configuration for the datastores.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.BoostSpecs]

filter_specs

Optional. Filter configuration for the datastores.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.FilterSpecs]

class google.cloud.dialogflowcx_v3beta1.types.SecuritySettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the settings related to security issues, such as data redaction and data retention. It may take hours for updates on the settings to propagate to all the related components and take effect.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

name

Resource name of the settings. Required for the [SecuritySettingsService.UpdateSecuritySettings][google.cloud.dialogflow.cx.v3beta1.SecuritySettingsService.UpdateSecuritySettings] method. [SecuritySettingsService.CreateSecuritySettings][google.cloud.dialogflow.cx.v3beta1.SecuritySettingsService.CreateSecuritySettings] populates the name automatically. Format: projects/<ProjectID>/locations/<LocationID>/securitySettings/<SecuritySettingsID>.

Type

str

display_name

Required. The human-readable name of the security settings, unique within the location.

Type

str

redaction_strategy

Strategy that defines how we do redaction.

Type

google.cloud.dialogflowcx_v3beta1.types.SecuritySettings.RedactionStrategy

redaction_scope

Defines the data for which Dialogflow applies redaction. Dialogflow does not redact data that it does not have access to – for example, Cloud logging.

Type

google.cloud.dialogflowcx_v3beta1.types.SecuritySettings.RedactionScope

inspect_template

DLP inspect template name. Use this template to define inspect base settings.

The DLP Inspect Templates Reader role is needed on the Dialogflow service identity service account (has the form service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com) for your agent’s project.

If empty, we use the default DLP inspect config.

The template name will have one of the following formats: projects/<ProjectID>/locations/<LocationID>/inspectTemplates/<TemplateID> OR organizations/<OrganizationID>/locations/<LocationID>/inspectTemplates/<TemplateID>

Note: inspect_template must be located in the same region as the SecuritySettings.

Type

str

deidentify_template

DLP deidentify template name. Use this template to define de-identification configuration for the content.

The DLP De-identify Templates Reader role is needed on the Dialogflow service identity service account (has the form service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com) for your agent’s project.

If empty, Dialogflow replaces sensitive info with [redacted] text.

The template name will have one of the following formats: projects/<ProjectID>/locations/<LocationID>/deidentifyTemplates/<TemplateID> OR organizations/<OrganizationID>/locations/<LocationID>/deidentifyTemplates/<TemplateID>

Note: deidentify_template must be located in the same region as the SecuritySettings.

Type

str

retention_window_days

Retains data in interaction logging for the specified number of days. This does not apply to Cloud logging, which is owned by the user - not Dialogflow. User must set a value lower than Dialogflow’s default 365d TTL (30 days for Agent Assist traffic), higher value will be ignored and use default. Setting a value higher than that has no effect. A missing value or setting to 0 also means we use default TTL. When data retention configuration is changed, it only applies to the data created after the change; the TTL of existing data created before the change stays intact.

This field is a member of oneof data_retention.

Type

int

retention_strategy

Specifies the retention behavior defined by [SecuritySettings.RetentionStrategy][google.cloud.dialogflow.cx.v3beta1.SecuritySettings.RetentionStrategy].

This field is a member of oneof data_retention.

Type

google.cloud.dialogflowcx_v3beta1.types.SecuritySettings.RetentionStrategy

purge_data_types

List of types of data to remove when retention settings triggers purge.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.SecuritySettings.PurgeDataType]

audio_export_settings

Controls audio export settings for post-conversation analytics when ingesting audio to conversations via [Participants.AnalyzeContent][] or [Participants.StreamingAnalyzeContent][].

If [retention_strategy][google.cloud.dialogflow.cx.v3beta1.SecuritySettings.retention_strategy] is set to REMOVE_AFTER_CONVERSATION or [audio_export_settings.gcs_bucket][] is empty, audio export is disabled.

If audio export is enabled, audio is recorded and saved to [audio_export_settings.gcs_bucket][], subject to retention policy of [audio_export_settings.gcs_bucket][].

This setting won’t effect audio input for implicit sessions via [Sessions.DetectIntent][google.cloud.dialogflow.cx.v3beta1.Sessions.DetectIntent] or [Sessions.StreamingDetectIntent][google.cloud.dialogflow.cx.v3beta1.Sessions.StreamingDetectIntent].

Type

google.cloud.dialogflowcx_v3beta1.types.SecuritySettings.AudioExportSettings

insights_export_settings

Controls conversation exporting settings to Insights after conversation is completed.

If [retention_strategy][google.cloud.dialogflow.cx.v3beta1.SecuritySettings.retention_strategy] is set to REMOVE_AFTER_CONVERSATION, Insights export is disabled no matter what you configure here.

Type

google.cloud.dialogflowcx_v3beta1.types.SecuritySettings.InsightsExportSettings

class AudioExportSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for exporting audio.

gcs_bucket

Cloud Storage bucket to export audio record to. Setting this field would grant the Storage Object Creator role to the Dialogflow Service Agent. API caller that tries to modify this field should have the permission of storage.buckets.setIamPolicy.

Type

str

audio_export_pattern

Filename pattern for exported audio.

Type

str

enable_audio_redaction

Enable audio redaction if it is true. Note that this only redacts end-user audio data; Synthesised audio from the virtual agent is not redacted.

Type

bool

audio_format

File format for exported audio file. Currently only in telephony recordings.

Type

google.cloud.dialogflowcx_v3beta1.types.SecuritySettings.AudioExportSettings.AudioFormat

store_tts_audio

Whether to store TTS audio. By default, TTS audio from the virtual agent is not exported.

Type

bool

class AudioFormat(value)

Bases: proto.enums.Enum

File format for exported audio file. Currently only in telephony recordings.

Values:

AUDIO_FORMAT_UNSPECIFIED (0):

Unspecified. Do not use.

MULAW (1):

G.711 mu-law PCM with 8kHz sample rate.

MP3 (2):

MP3 file format.

OGG (3):

OGG Vorbis.

class InsightsExportSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings for exporting conversations to Insights.

enable_insights_export

If enabled, we will automatically exports conversations to Insights and Insights runs its analyzers.

Type

bool

class PurgeDataType(value)

Bases: proto.enums.Enum

Type of data we purge after retention settings triggers purge.

Values:

PURGE_DATA_TYPE_UNSPECIFIED (0):

Unspecified. Do not use.

DIALOGFLOW_HISTORY (1):

Dialogflow history. This does not include Cloud logging, which is owned by the user - not Dialogflow.

class RedactionScope(value)

Bases: proto.enums.Enum

Defines what types of data to redact.

Values:

REDACTION_SCOPE_UNSPECIFIED (0):

Don’t redact any kind of data.

REDACT_DISK_STORAGE (2):

On data to be written to disk or similar devices that are capable of holding data even if power is disconnected. This includes data that are temporarily saved on disk.

class RedactionStrategy(value)

Bases: proto.enums.Enum

Defines how we redact data.

Values:

REDACTION_STRATEGY_UNSPECIFIED (0):

Do not redact.

REDACT_WITH_SERVICE (1):

Call redaction service to clean up the data to be persisted.

class RetentionStrategy(value)

Bases: proto.enums.Enum

Defines how long we retain persisted data that contains sensitive info.

Values:

RETENTION_STRATEGY_UNSPECIFIED (0):

Retains the persisted data with Dialogflow’s internal default 365d TTLs.

REMOVE_AFTER_CONVERSATION (1):

Removes data when the conversation ends. If there is no [Conversation][google.cloud.dialogflow.cx.v3beta1.Conversation] explicitly established, a default conversation ends when the corresponding Dialogflow session ends.

class google.cloud.dialogflowcx_v3beta1.types.SentimentAnalysisResult(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The result of sentiment analysis. Sentiment analysis inspects user input and identifies the prevailing subjective opinion, especially to determine a user’s attitude as positive, negative, or neutral.

score

Sentiment score between -1.0 (negative sentiment) and 1.0 (positive sentiment).

Type

float

magnitude

A non-negative number in the [0, +inf) range, which represents the absolute magnitude of sentiment, regardless of score (positive or negative).

Type

float

class google.cloud.dialogflowcx_v3beta1.types.SessionEntityType(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Session entity types are referred to as User entity types and are entities that are built for an individual user such as favorites, preferences, playlists, and so on.

You can redefine a session entity type at the session level to extend or replace a [custom entity type][google.cloud.dialogflow.cx.v3beta1.EntityType] at the user session level (we refer to the entity types defined at the agent level as “custom entity types”).

Note: session entity types apply to all queries, regardless of the language.

For more information about entity types, see the Dialogflow documentation.

name

Required. The unique identifier of the session entity type. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID>/entityTypes/<EntityTypeID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>/entityTypes/<EntityTypeID>. If Environment ID is not specified, we assume default ‘draft’ environment.

Type

str

entity_override_mode

Required. Indicates whether the additional data should override or supplement the custom entity type definition.

Type

google.cloud.dialogflowcx_v3beta1.types.SessionEntityType.EntityOverrideMode

entities

Required. The collection of entities to override or supplement the custom entity type.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.EntityType.Entity]

class EntityOverrideMode(value)

Bases: proto.enums.Enum

The types of modifications for the session entity type.

Values:

ENTITY_OVERRIDE_MODE_UNSPECIFIED (0):

Not specified. This value should be never used.

ENTITY_OVERRIDE_MODE_OVERRIDE (1):

The collection of session entities overrides the collection of entities in the corresponding custom entity type.

ENTITY_OVERRIDE_MODE_SUPPLEMENT (2):

The collection of session entities extends the collection of entities in the corresponding custom entity type.

Note: Even in this override mode calls to ListSessionEntityTypes, GetSessionEntityType, CreateSessionEntityType and UpdateSessionEntityType only return the additional entities added in this session entity type. If you want to get the supplemented list, please call [EntityTypes.GetEntityType][google.cloud.dialogflow.cx.v3beta1.EntityTypes.GetEntityType] on the custom entity type and merge.

class google.cloud.dialogflowcx_v3beta1.types.SessionInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents session information communicated to and from the webhook.

session

Always present for [WebhookRequest][google.cloud.dialogflow.cx.v3beta1.WebhookRequest]. Ignored for [WebhookResponse][google.cloud.dialogflow.cx.v3beta1.WebhookResponse]. The unique identifier of the [session][google.cloud.dialogflow.cx.v3beta1.DetectIntentRequest.session]. This field can be used by the webhook to identify a session. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID> if environment is specified.

Type

str

parameters

Optional for [WebhookRequest][google.cloud.dialogflow.cx.v3beta1.WebhookRequest]. Optional for [WebhookResponse][google.cloud.dialogflow.cx.v3beta1.WebhookResponse]. All parameters collected from forms and intents during the session. Parameters can be created, updated, or removed by the webhook. To remove a parameter from the session, the webhook should explicitly set the parameter value to null in [WebhookResponse][google.cloud.dialogflow.cx.v3beta1.WebhookResponse]. The map is keyed by parameters’ display names.

Type

MutableMapping[str, google.protobuf.struct_pb2.Value]

class ParametersEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class google.cloud.dialogflowcx_v3beta1.types.SpeechModelVariant(value)

Bases: proto.enums.Enum

Variant of the specified [Speech model][google.cloud.dialogflow.cx.v3beta1.InputAudioConfig.model] to use.

See the Cloud Speech documentation for which models have different variants. For example, the “phone_call” model has both a standard and an enhanced variant. When you use an enhanced model, you will generally receive higher quality results than for a standard model.

Values:

SPEECH_MODEL_VARIANT_UNSPECIFIED (0):

No model variant specified. In this case Dialogflow defaults to USE_BEST_AVAILABLE.

USE_BEST_AVAILABLE (1):

Use the best available variant of the [Speech model][InputAudioConfig.model] that the caller is eligible for.

USE_STANDARD (2):

Use standard model variant even if an enhanced model is available. See the Cloud Speech documentation for details about enhanced models.

USE_ENHANCED (3):

Use an enhanced model variant:

• If an enhanced variant does not exist for the given [model][google.cloud.dialogflow.cx.v3beta1.InputAudioConfig.model] and request language, Dialogflow falls back to the standard variant.

  The Cloud Speech documentation describes which models have enhanced variants.

class google.cloud.dialogflowcx_v3beta1.types.SpeechToTextSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings related to speech recognition.

enable_speech_adaptation

Whether to use speech adaptation for speech recognition.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.SpeechWordInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Information for a word recognized by the speech recognizer.

word

The word this info is for.

Type

str

start_offset

Time offset relative to the beginning of the audio that corresponds to the start of the spoken word. This is an experimental feature and the accuracy of the time offset can vary.

Type

google.protobuf.duration_pb2.Duration

end_offset

Time offset relative to the beginning of the audio that corresponds to the end of the spoken word. This is an experimental feature and the accuracy of the time offset can vary.

Type

google.protobuf.duration_pb2.Duration

confidence

The Speech confidence between 0.0 and 1.0 for this word. A higher number indicates an estimated greater likelihood that the recognized word is correct. The default of 0.0 is a sentinel value indicating that confidence was not set.

This field is not guaranteed to be fully stable over time for the same audio input. Users should also not rely on it to always be provided.

Type

float

class google.cloud.dialogflowcx_v3beta1.types.SsmlVoiceGender(value)

Bases: proto.enums.Enum

Gender of the voice as described in SSML voice element.

Values:

SSML_VOICE_GENDER_UNSPECIFIED (0):

An unspecified gender, which means that the client doesn’t care which gender the selected voice will have.

SSML_VOICE_GENDER_MALE (1):

A male voice.

SSML_VOICE_GENDER_FEMALE (2):

A female voice.

SSML_VOICE_GENDER_NEUTRAL (3):

A gender-neutral voice.

class google.cloud.dialogflowcx_v3beta1.types.StartExperimentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Experiments.StartExperiment][google.cloud.dialogflow.cx.v3beta1.Experiments.StartExperiment].

name

Required. Resource name of the experiment to start. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/experiments/<ExperimentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.StopExperimentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Experiments.StopExperiment][google.cloud.dialogflow.cx.v3beta1.Experiments.StopExperiment].

name

Required. Resource name of the experiment to stop. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/experiments/<ExperimentID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.StreamingDetectIntentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The top-level message sent by the client to the [Sessions.StreamingDetectIntent][google.cloud.dialogflow.cx.v3beta1.Sessions.StreamingDetectIntent] method.

Multiple request messages should be sent in order:

1. The first message must contain [session][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.session], [query_input][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.query_input] plus optionally [query_params][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.query_params]. If the client wants to receive an audio response, it should also contain [output_audio_config][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.output_audio_config].

2. If [query_input][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.query_input] was set to [query_input.audio.config][google.cloud.dialogflow.cx.v3beta1.AudioInput.config], all subsequent messages must contain [query_input.audio.audio][google.cloud.dialogflow.cx.v3beta1.AudioInput.audio] to continue with Speech recognition. If you decide to rather detect an intent from text input after you already started Speech recognition, please send a message with [query_input.text][google.cloud.dialogflow.cx.v3beta1.QueryInput.text].

   However, note that:

   • Dialogflow will bill you for the audio duration so far.

   • Dialogflow discards all Speech recognition results in favor of the input text.

   • Dialogflow will use the language code from the first message.

After you sent all input, you must half-close or abort the request stream.

session

The name of the session this query is sent to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>. If Environment ID is not specified, we assume default ‘draft’ environment. It’s up to the API caller to choose an appropriate Session ID. It can be a random number or some type of session identifiers (preferably hashed). The length of the Session ID must not exceed 36 characters. Note: session must be set in the first request.

For more information, see the sessions guide.

Note: Always use agent versions for production traffic. See Versions and environments.

Type

str

query_params

The parameters of this query.

Type

google.cloud.dialogflowcx_v3beta1.types.QueryParameters

query_input

Required. The input specification.

Type

google.cloud.dialogflowcx_v3beta1.types.QueryInput

output_audio_config

Instructs the speech synthesizer how to generate the output audio.

Type

google.cloud.dialogflowcx_v3beta1.types.OutputAudioConfig

enable_partial_response

Enable partial detect intent response. If this flag is not enabled, response stream still contains only one final DetectIntentResponse even if some Fulfillments in the agent have been configured to return partial responses.

Type

bool

enable_debugging_info

If true, StreamingDetectIntentResponse.debugging_info will get populated.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.StreamingDetectIntentResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The top-level message returned from the [StreamingDetectIntent][google.cloud.dialogflow.cx.v3beta1.Sessions.StreamingDetectIntent] method.

Multiple response messages (N) can be returned in order.

The first (N-1) responses set either the recognition_result or detect_intent_response field, depending on the request:

• If the StreamingDetectIntentRequest.query_input.audio field was set, and the StreamingDetectIntentRequest.enable_partial_response field was false, the recognition_result field is populated for each of the (N-1) responses. See the [StreamingRecognitionResult][google.cloud.dialogflow.cx.v3beta1.StreamingRecognitionResult] message for details about the result message sequence.

• If the StreamingDetectIntentRequest.enable_partial_response field was true, the detect_intent_response field is populated for each of the (N-1) responses, where 1 <= N <= 4. These responses set the [DetectIntentResponse.response_type][google.cloud.dialogflow.cx.v3beta1.DetectIntentResponse.response_type] field to PARTIAL.

For the final Nth response message, the detect_intent_response is fully populated, and [DetectIntentResponse.response_type][google.cloud.dialogflow.cx.v3beta1.DetectIntentResponse.response_type] is set to FINAL.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

recognition_result

The result of speech recognition.

This field is a member of oneof response.

Type

google.cloud.dialogflowcx_v3beta1.types.StreamingRecognitionResult

detect_intent_response

The response from detect intent.

This field is a member of oneof response.

Type

google.cloud.dialogflowcx_v3beta1.types.DetectIntentResponse

debugging_info

Debugging info that would get populated when StreamingDetectIntentRequest.enable_debugging_info is set to true.

Type

google.cloud.dialogflowcx_v3beta1.types.CloudConversationDebuggingInfo

class google.cloud.dialogflowcx_v3beta1.types.StreamingRecognitionResult(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Contains a speech recognition result corresponding to a portion of the audio that is currently being processed or an indication that this is the end of the single requested utterance.

While end-user audio is being processed, Dialogflow sends a series of results. Each result may contain a transcript value. A transcript represents a portion of the utterance. While the recognizer is processing audio, transcript values may be interim values or finalized values. Once a transcript is finalized, the is_final value is set to true and processing continues for the next transcript.

If StreamingDetectIntentRequest.query_input.audio.config.single_utterance was true, and the recognizer has completed processing audio, the message_type value is set to `END_OF_SINGLE_UTTERANCE and the following (last) result contains the last finalized transcript.

The complete end-user utterance is determined by concatenating the finalized transcript values received for the series of results.

In the following example, single utterance is enabled. In the case where single utterance is not enabled, result 7 would not occur.

Num | transcript              | message_type            | is_final
--- | ----------------------- | ----------------------- | --------
1   | "tube"                  | TRANSCRIPT              | false
2   | "to be a"               | TRANSCRIPT              | false
3   | "to be"                 | TRANSCRIPT              | false
4   | "to be or not to be"    | TRANSCRIPT              | true
5   | "that's"                | TRANSCRIPT              | false
6   | "that is                | TRANSCRIPT              | false
7   | unset                   | END_OF_SINGLE_UTTERANCE | unset
8   | " that is the question" | TRANSCRIPT              | true

Concatenating the finalized transcripts with is_final set to true, the complete utterance becomes “to be or not to be that is the question”.

message_type

Type of the result message.

Type

google.cloud.dialogflowcx_v3beta1.types.StreamingRecognitionResult.MessageType

transcript

Transcript text representing the words that the user spoke. Populated if and only if message_type = TRANSCRIPT.

Type

str

is_final

If false, the StreamingRecognitionResult represents an interim result that may change. If true, the recognizer will not return any further hypotheses about this piece of the audio. May only be populated for message_type = TRANSCRIPT.

Type

bool

confidence

The Speech confidence between 0.0 and 1.0 for the current portion of audio. A higher number indicates an estimated greater likelihood that the recognized words are correct. The default of 0.0 is a sentinel value indicating that confidence was not set.

This field is typically only provided if is_final is true and you should not rely on it being accurate or even set.

Type

float

stability

An estimate of the likelihood that the speech recognizer will not change its guess about this interim recognition result:

• If the value is unspecified or 0.0, Dialogflow didn’t compute the stability. In particular, Dialogflow will only provide stability for TRANSCRIPT results with is_final = false.

• Otherwise, the value is in (0.0, 1.0] where 0.0 means completely unstable and 1.0 means completely stable.

Type

float

speech_word_info

Word-specific information for the words recognized by Speech in [transcript][google.cloud.dialogflow.cx.v3beta1.StreamingRecognitionResult.transcript]. Populated if and only if message_type = TRANSCRIPT and [InputAudioConfig.enable_word_info] is set.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.SpeechWordInfo]

speech_end_offset

Time offset of the end of this Speech recognition result relative to the beginning of the audio. Only populated for message_type = TRANSCRIPT.

Type

google.protobuf.duration_pb2.Duration

language_code

Detected language code for the transcript.

Type

str

class MessageType(value)

Bases: proto.enums.Enum

Type of the response message.

Values:

MESSAGE_TYPE_UNSPECIFIED (0):

Not specified. Should never be used.

TRANSCRIPT (1):

Message contains a (possibly partial) transcript.

END_OF_SINGLE_UTTERANCE (2):

This event indicates that the server has detected the end of the user’s speech utterance and expects no additional speech. Therefore, the server will not process additional audio (although it may subsequently return additional results). The client should stop sending additional audio data, half-close the gRPC connection, and wait for any additional results until the server closes the gRPC connection. This message is only sent if [single_utterance][google.cloud.dialogflow.cx.v3beta1.InputAudioConfig.single_utterance] was set to true, and is not used otherwise.

class google.cloud.dialogflowcx_v3beta1.types.SubmitAnswerFeedbackRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request to set the feedback for a bot answer.

session

Required. The name of the session the feedback was sent to.

Type

str

response_id

Required. ID of the response to update its feedback. This is the same as DetectIntentResponse.response_id.

Type

str

answer_feedback

Required. Feedback provided for a bot answer.

Type

google.cloud.dialogflowcx_v3beta1.types.AnswerFeedback

update_mask

Optional. The mask to control which fields to update. If the mask is not present, all fields will be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.SynthesizeSpeechConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Configuration of how speech should be synthesized.

speaking_rate

Optional. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal native speed supported by the specific voice. 2.0 is twice as fast, and 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed. Any other values < 0.25 or > 4.0 will return an error.

Type

float

pitch

Optional. Speaking pitch, in the range [-20.0, 20.0]. 20 means increase 20 semitones from the original pitch. -20 means decrease 20 semitones from the original pitch.

Type

float

volume_gain_db

Optional. Volume gain (in dB) of the normal native volume supported by the specific voice, in the range [-96.0, 16.0]. If unset, or set to a value of 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB) will play at approximately half the amplitude of the normal native signal amplitude. A value of +6.0 (dB) will play at approximately twice the amplitude of the normal native signal amplitude. We strongly recommend not to exceed +10 (dB) as there’s usually no effective increase in loudness for any value greater than that.

Type

float

effects_profile_id

Optional. An identifier which selects ‘audio effects’ profiles that are applied on (post synthesized) text to speech. Effects are applied on top of each other in the order they are given.

Type

MutableSequence[str]

voice

Optional. The desired voice of the synthesized audio.

Type

google.cloud.dialogflowcx_v3beta1.types.VoiceSelectionParams

class google.cloud.dialogflowcx_v3beta1.types.TestCase(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a test case.

name

The unique identifier of the test case. [TestCases.CreateTestCase][google.cloud.dialogflow.cx.v3beta1.TestCases.CreateTestCase] will populate the name automatically. Otherwise use format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/testCases/<TestCaseID>.

Type

str

tags

Tags are short descriptions that users may apply to test cases for organizational and filtering purposes. Each tag should start with “#” and has a limit of 30 characters.

Type

MutableSequence[str]

display_name

Required. The human-readable name of the test case, unique within the agent. Limit of 200 characters.

Type

str

notes

Additional freeform notes about the test case. Limit of 400 characters.

Type

str

test_config

Config for the test case.

Type

google.cloud.dialogflowcx_v3beta1.types.TestConfig

test_case_conversation_turns

The conversation turns uttered when the test case was created, in chronological order. These include the canonical set of agent utterances that should occur when the agent is working properly.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ConversationTurn]

creation_time

Output only. When the test was created.

Type

google.protobuf.timestamp_pb2.Timestamp

last_test_result

The latest test result.

Type

google.cloud.dialogflowcx_v3beta1.types.TestCaseResult

class google.cloud.dialogflowcx_v3beta1.types.TestCaseError(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Error info for importing a test.

test_case

The test case.

Type

google.cloud.dialogflowcx_v3beta1.types.TestCase

status

The status associated with the test case.

Type

google.rpc.status_pb2.Status

class google.cloud.dialogflowcx_v3beta1.types.TestCaseResult(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a result from running a test case in an agent environment.

name

The resource name for the test case result. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/testCases/<TestCaseID>/results/<TestCaseResultID>.

Type

str

environment

Environment where the test was run. If not set, it indicates the draft environment.

Type

str

conversation_turns

The conversation turns uttered during the test case replay in chronological order.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ConversationTurn]

test_result

Whether the test case passed in the agent environment.

Type

google.cloud.dialogflowcx_v3beta1.types.TestResult

test_time

The time that the test was run.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.dialogflowcx_v3beta1.types.TestConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents configurations for a test case.

tracking_parameters

Session parameters to be compared when calculating differences.

Type

MutableSequence[str]

flow

Flow name to start the test case with. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Only one of flow and page should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.

Type

str

page

The [page][google.cloud.dialogflow.cx.v3beta1.Page] to start the test case with. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>.

Only one of flow and page should be set to indicate the starting point of the test case. If neither is set, the test case will start with start page on the default start flow.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.TestError(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Error info for running a test.

test_case

The test case resource name.

Type

str

status

The status associated with the test.

Type

google.rpc.status_pb2.Status

test_time

The timestamp when the test was completed.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.dialogflowcx_v3beta1.types.TestResult(value)

Bases: proto.enums.Enum

The test result for a test case and an agent environment.

Values:

TEST_RESULT_UNSPECIFIED (0):

Not specified. Should never be used.

PASSED (1):

The test passed.

FAILED (2):

The test did not pass.

class google.cloud.dialogflowcx_v3beta1.types.TestRunDifference(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The description of differences between original and replayed agent output.

type_

The type of diff.

Type

google.cloud.dialogflowcx_v3beta1.types.TestRunDifference.DiffType

description

A human readable description of the diff, showing the actual output vs expected output.

Type

str

class DiffType(value)

Bases: proto.enums.Enum

What part of the message replay differs from the test case.

Values:

DIFF_TYPE_UNSPECIFIED (0):

Should never be used.

INTENT (1):

The intent.

PAGE (2):

The page.

PARAMETERS (3):

The parameters.

UTTERANCE (4):

The message utterance.

FLOW (5):

The flow.

class google.cloud.dialogflowcx_v3beta1.types.TextInput(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the natural language text to be processed.

text

Required. The UTF-8 encoded natural language text to be processed.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.TextToSpeechSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings related to speech synthesizing.

synthesize_speech_configs

Configuration of how speech should be synthesized, mapping from language (https://cloud.google.com/dialogflow/cx/docs/reference/language) to SynthesizeSpeechConfig.

These settings affect:

• The phone gateway synthesize configuration set via [Agent.text_to_speech_settings][google.cloud.dialogflow.cx.v3beta1.Agent.text_to_speech_settings].

• How speech is synthesized when invoking [session][google.cloud.dialogflow.cx.v3beta1.Sessions] APIs. [Agent.text_to_speech_settings][google.cloud.dialogflow.cx.v3beta1.Agent.text_to_speech_settings] only applies if [OutputAudioConfig.synthesize_speech_config][google.cloud.dialogflow.cx.v3beta1.OutputAudioConfig.synthesize_speech_config] is not specified.

Type

MutableMapping[str, google.cloud.dialogflowcx_v3beta1.types.SynthesizeSpeechConfig]

class SynthesizeSpeechConfigsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class google.cloud.dialogflowcx_v3beta1.types.Tool(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A tool provides a list of actions which are available to the [Playbook][google.cloud.dialogflow.cx.v3beta1.Playbook] to attain its goal. A Tool consists of a description of the tool’s usage and a specification of the tool which contains the schema and authentication information.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

name

The unique identifier of the Tool. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/tools/<ToolID>.

Type

str

display_name

Required. The human-readable name of the Tool, unique within an agent.

Type

str

description

Required. High level description of the Tool and its usage.

Type

str

open_api_spec

OpenAPI specification of the Tool.

This field is a member of oneof specification.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.OpenApiTool

data_store_spec

Data store search tool specification.

This field is a member of oneof specification.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.DataStoreTool

extension_spec

Vertex extension tool specification.

This field is a member of oneof specification.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.ExtensionTool

function_spec

Client side executed function specification.

This field is a member of oneof specification.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.FunctionTool

tool_type

Output only. The tool type.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.ToolType

class Authentication(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Authentication information required for API calls

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

api_key_config

Config for API key auth.

This field is a member of oneof auth_config.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.Authentication.ApiKeyConfig

oauth_config

Config for OAuth.

This field is a member of oneof auth_config.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.Authentication.OAuthConfig

service_agent_auth_config

Config for Diglogflow service agent auth.

This field is a member of oneof auth_config.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.Authentication.ServiceAgentAuthConfig

bearer_token_config

Config for bearer token auth.

This field is a member of oneof auth_config.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.Authentication.BearerTokenConfig

class ApiKeyConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Config for authentication with API key.

key_name

Required. The parameter name or the header name of the API key. E.g., If the API request is “https://example.com/act?X-Api-Key=<API KEY>”, “X-Api-Key” would be the parameter name.

Type

str

api_key

Required. The API key.

Type

str

request_location

Required. Key location in the request.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.Authentication.RequestLocation

class BearerTokenConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Config for authentication using bearer token.

token

Required. The text token appended to the text Bearer to the request Authorization header. Session parameters reference can be used to pass the token dynamically, e.g. $session.params.parameter-id.

Type

str

class OAuthConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Config for authentication with OAuth.

oauth_grant_type

Required. OAuth grant types.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.Authentication.OAuthConfig.OauthGrantType

client_id

Required. The client ID from the OAuth provider.

Type

str

client_secret

Required. The client secret from the OAuth provider.

Type

str

token_endpoint

Required. The token endpoint in the OAuth provider to exchange for an access token.

Type

str

scopes

Optional. The OAuth scopes to grant.

Type

MutableSequence[str]

class OauthGrantType(value)

Bases: proto.enums.Enum

OAuth grant types. Only client credential grant is supported.

Values:

OAUTH_GRANT_TYPE_UNSPECIFIED (0):

Default value. This value is unused.

CLIENT_CREDENTIAL (1):

Represents the client credential flow.

class RequestLocation(value)

Bases: proto.enums.Enum

The location of the API key in the request.

Values:

REQUEST_LOCATION_UNSPECIFIED (0):

Default value. This value is unused.

HEADER (1):

Represents the key in http header.

QUERY_STRING (2):

Represents the key in query string.

class ServiceAgentAuthConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Config for auth using Diglogflow service agent.

service_agent_auth

Optional. Indicate the auth token type generated from the Diglogflow service agent. The generated token is sent in the Authorization header.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.Authentication.ServiceAgentAuthConfig.ServiceAgentAuth

class ServiceAgentAuth(value)

Bases: proto.enums.Enum

Indicate the auth token type generated from the Diglogflow service agent.

Values:

SERVICE_AGENT_AUTH_UNSPECIFIED (0):

Service agent auth type unspecified. Default to ID_TOKEN.

ID_TOKEN (1):

Use ID token generated from service agent. This can be used to access Cloud Function and Cloud Run after you grant Invoker role to service-<PROJECT-NUMBER>@gcp-sa-dialogflow.iam.gserviceaccount.com.

ACCESS_TOKEN (2):

Use access token generated from service agent. This can be used to access other Google Cloud APIs after you grant required roles to service-<PROJECT-NUMBER>@gcp-sa-dialogflow.iam.gserviceaccount.com.

class DataStoreTool(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A DataStoreTool is a way to provide specifications needed to search a list of data stores.

data_store_connections

Required. List of data stores to search.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.DataStoreConnection]

fallback_prompt

Required. Fallback prompt configurations to use.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.DataStoreTool.FallbackPrompt

class FallbackPrompt(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A FallbackPrompt is a way to provide specifications for the Data Store fallback prompt when generating responses.

class ExtensionTool(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

An ExtensionTool is a way to use Vertex Extensions as a tool.

name

Required. The full name of the referenced vertex extension. Formats: projects/{project}/locations/{location}/extensions/{extension}

Type

str

class FunctionTool(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A Function tool describes the functions to be invoked on the client side.

input_schema

Optional. The JSON schema is encapsulated in a [google.protobuf.Struct][google.protobuf.Struct] to describe the input of the function. This input is a JSON object that contains the function’s parameters as properties of the object.

Type

google.protobuf.struct_pb2.Struct

output_schema

Optional. The JSON schema is encapsulated in a [google.protobuf.Struct][google.protobuf.Struct] to describe the output of the function. This output is a JSON object that contains the function’s parameters as properties of the object.

Type

google.protobuf.struct_pb2.Struct

class OpenApiTool(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

An OpenAPI tool is a way to provide the Tool specifications in the Open API schema format.

text_schema

Required. The OpenAPI schema specified as a text.

This field is a member of oneof schema.

Type

str

authentication

Optional. Authentication information required by the API.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.Authentication

tls_config

Optional. TLS configuration for the HTTPS verification.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.TLSConfig

service_directory_config

Optional. Service Directory configuration.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool.ServiceDirectoryConfig

class ServiceDirectoryConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Configuration for tools using Service Directory.

service

Required. The name of Service Directory service. Format: projects/<ProjectID>/locations/<LocationID>/namespaces/<NamespaceID>/services/<ServiceID>. LocationID of the service directory must be the same as the location of the agent.

Type

str

class TLSConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The TLS configuration.

ca_certs

Required. Specifies a list of allowed custom CA certificates for HTTPS verification.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.Tool.TLSConfig.CACert]

class CACert(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The CA certificate.

display_name

Required. The name of the allowed custom CA certificates. This can be used to disambiguate the custom CA certificates.

Type

str

cert

Required. The allowed custom CA certificates (in DER format) for HTTPS verification. This overrides the default SSL trust store. If this is empty or unspecified, Dialogflow will use Google’s default trust store to verify certificates. N.B. Make sure the HTTPS server certificates are signed with “subject alt name”. For instance a certificate can be self-signed using the following command:

openssl x509
-req -days 200 -in example.com.csr \
-signkey example.com.key \
-out example.com.crt \
-extfile <(printf
"\nsubjectAltName='DNS:www.example.com'")

Type

bytes

class ToolType(value)

Bases: proto.enums.Enum

Represents the type of the tool.

Values:

TOOL_TYPE_UNSPECIFIED (0):

Default value. This value is unused.

CUSTOMIZED_TOOL (1):

Customer provided tool.

BUILTIN_TOOL (2):

First party built-in tool created by Dialogflow which cannot be modified.

class google.cloud.dialogflowcx_v3beta1.types.ToolCall(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a call of a specific tool’s action with the specified inputs.

tool

The [tool][Tool] associated with this call. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/tools/<Tool ID>.

Type

str

action

The name of the tool’s action associated with this call.

Type

str

input_parameters

The action’s input parameters.

Type

google.protobuf.struct_pb2.Struct

class google.cloud.dialogflowcx_v3beta1.types.ToolCallResult(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The result of calling a tool’s action that has been executed by the client.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

tool

The [tool][Tool] associated with this call. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/tools/<Tool ID>.

Type

str

action

The name of the tool’s action associated with this call.

Type

str

error

The tool call’s error.

This field is a member of oneof result.

Type

google.cloud.dialogflowcx_v3beta1.types.ToolCallResult.Error

output_parameters

The tool call’s output parameters.

This field is a member of oneof result.

Type

google.protobuf.struct_pb2.Struct

class Error(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

An error produced by the tool call.

message

The error message of the function.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ToolUse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Stores metadata of the invocation of an action supported by a tool.

tool

Required. The [tool][google.cloud.dialogflow.cx.v3beta1.Tool] that should be used. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/tools/<ToolID>.

Type

str

action

Optional. Name of the action to be called during the tool use.

Type

str

input_action_parameters

Optional. A list of input parameters for the action.

Type

google.protobuf.struct_pb2.Struct

output_action_parameters

Optional. A list of output parameters generated by the action.

Type

google.protobuf.struct_pb2.Struct

class google.cloud.dialogflowcx_v3beta1.types.TrainFlowRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Flows.TrainFlow][google.cloud.dialogflow.cx.v3beta1.Flows.TrainFlow].

name

Required. The flow to train. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.TransitionCoverage(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Transition coverage represents the percentage of all possible page transitions (page-level transition routes and event handlers, excluding transition route groups) present within any of a parent’s test cases.

transitions

The list of Transitions present in the agent.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TransitionCoverage.Transition]

coverage_score

The percent of transitions in the agent that are covered.

Type

float

class Transition(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A transition in a page.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

source

The start node of a transition.

Type

google.cloud.dialogflowcx_v3beta1.types.TransitionCoverage.TransitionNode

index

The index of a transition in the transition list. Starting from 0.

Type

int

target

The end node of a transition.

Type

google.cloud.dialogflowcx_v3beta1.types.TransitionCoverage.TransitionNode

covered

Whether the transition is covered by at least one of the agent’s test cases.

Type

bool

transition_route

Intent route or condition route.

This field is a member of oneof detail.

Type

google.cloud.dialogflowcx_v3beta1.types.TransitionRoute

event_handler

Event handler.

This field is a member of oneof detail.

Type

google.cloud.dialogflowcx_v3beta1.types.EventHandler

class TransitionNode(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The source or target of a transition.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

page

Indicates a transition to a [Page][google.cloud.dialogflow.cx.v3beta1.Page]. Only some fields such as name and displayname will be set.

This field is a member of oneof kind.

Type

google.cloud.dialogflowcx_v3beta1.types.Page

flow

Indicates a transition to a [Flow][google.cloud.dialogflow.cx.v3beta1.Flow]. Only some fields such as name and displayname will be set.

This field is a member of oneof kind.

Type

google.cloud.dialogflowcx_v3beta1.types.Flow

class google.cloud.dialogflowcx_v3beta1.types.TransitionRoute(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A transition route specifies a [intent][google.cloud.dialogflow.cx.v3beta1.Intent] that can be matched and/or a data condition that can be evaluated during a session. When a specified transition is matched, the following actions are taken in order:

• If there is a [trigger_fulfillment][google.cloud.dialogflow.cx.v3beta1.TransitionRoute.trigger_fulfillment] associated with the transition, it will be called.

• If there is a [target_page][google.cloud.dialogflow.cx.v3beta1.TransitionRoute.target_page] associated with the transition, the session will transition into the specified page.

• If there is a [target_flow][google.cloud.dialogflow.cx.v3beta1.TransitionRoute.target_flow] associated with the transition, the session will transition into the specified flow.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

name

Output only. The unique identifier of this transition route.

Type

str

description

Optional. The description of the transition route. The maximum length is 500 characters.

Type

str

intent

The unique identifier of an [Intent][google.cloud.dialogflow.cx.v3beta1.Intent]. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/intents/<IntentID>. Indicates that the transition can only happen when the given intent is matched. At least one of intent or condition must be specified. When both intent and condition are specified, the transition can only happen when both are fulfilled.

Type

str

condition

The condition to evaluate against [form parameters][google.cloud.dialogflow.cx.v3beta1.Form.parameters] or [session parameters][google.cloud.dialogflow.cx.v3beta1.SessionInfo.parameters].

See the conditions reference. At least one of intent or condition must be specified. When both intent and condition are specified, the transition can only happen when both are fulfilled.

Type

str

trigger_fulfillment

The fulfillment to call when the condition is satisfied. At least one of trigger_fulfillment and target must be specified. When both are defined, trigger_fulfillment is executed first.

Type

google.cloud.dialogflowcx_v3beta1.types.Fulfillment

target_page

The target page to transition to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>.

This field is a member of oneof target.

Type

str

target_flow

The target flow to transition to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

This field is a member of oneof target.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.TransitionRouteGroup(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A TransitionRouteGroup represents a group of [TransitionRoutes][google.cloud.dialogflow.cx.v3beta1.TransitionRoute] to be used by a [Page][google.cloud.dialogflow.cx.v3beta1.Page].

name

The unique identifier of the transition route group. [TransitionRouteGroups.CreateTransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroups.CreateTransitionRouteGroup] populates the name automatically. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/transitionRouteGroups/<TransitionRouteGroupID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/transitionRouteGroups/<TransitionRouteGroupID> for agent-level groups.

Type

str

display_name

Required. The human-readable name of the transition route group, unique within the flow. The display name can be no longer than 30 characters.

Type

str

transition_routes

Transition routes associated with the [TransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroup].

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TransitionRoute]

class google.cloud.dialogflowcx_v3beta1.types.TransitionRouteGroupCoverage(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Transition route group coverage represents the percentage of all possible transition routes present within any of a parent’s test cases. The results are grouped by the transition route group.

coverages

Transition route group coverages.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TransitionRouteGroupCoverage.Coverage]

coverage_score

The percent of transition routes in all the transition route groups that are covered.

Type

float

class Coverage(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Coverage result message for one transition route group.

route_group

Transition route group metadata. Only name and displayName will be set.

Type

google.cloud.dialogflowcx_v3beta1.types.TransitionRouteGroup

transitions

The list of transition routes and coverage in the transition route group.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.TransitionRouteGroupCoverage.Coverage.Transition]

coverage_score

The percent of transition routes in the transition route group that are covered.

Type

float

class Transition(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A transition coverage in a transition route group.

transition_route

Intent route or condition route.

Type

google.cloud.dialogflowcx_v3beta1.types.TransitionRoute

covered

Whether the transition route is covered by at least one of the agent’s test cases.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.UpdateAgentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Agents.UpdateAgent][google.cloud.dialogflow.cx.v3beta1.Agents.UpdateAgent].

agent

Required. The agent to update.

Type

google.cloud.dialogflowcx_v3beta1.types.Agent

update_mask

The mask to control which fields get updated. If the mask is not present, all fields will be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateEntityTypeRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [EntityTypes.UpdateEntityType][google.cloud.dialogflow.cx.v3beta1.EntityTypes.UpdateEntityType].

entity_type

Required. The entity type to update.

Type

google.cloud.dialogflowcx_v3beta1.types.EntityType

language_code

The language of the following fields in entity_type:

• EntityType.entities.value

• EntityType.entities.synonyms

• EntityType.excluded_phrases.value

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

update_mask

The mask to control which fields get updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateEnvironmentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Environments.UpdateEnvironment][google.cloud.dialogflow.cx.v3beta1.Environments.UpdateEnvironment].

environment

Required. The environment to update.

Type

google.cloud.dialogflowcx_v3beta1.types.Environment

update_mask

Required. The mask to control which fields get updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateExampleRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Examples.UpdateExample][google.cloud.dialogflow.cx.v3beta1.Examples.UpdateExample].

example

Required. The example to update.

Type

google.cloud.dialogflowcx_v3beta1.types.Example

update_mask

Optional. The mask to control which fields get updated. If the mask is not present, all fields will be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateExperimentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Experiments.UpdateExperiment][google.cloud.dialogflow.cx.v3beta1.Experiments.UpdateExperiment].

experiment

Required. The experiment to update.

Type

google.cloud.dialogflowcx_v3beta1.types.Experiment

update_mask

Required. The mask to control which fields get updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateFlowRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Flows.UpdateFlow][google.cloud.dialogflow.cx.v3beta1.Flows.UpdateFlow].

flow

Required. The flow to update.

Type

google.cloud.dialogflowcx_v3beta1.types.Flow

update_mask

The mask to control which fields get updated. If the mask is not present, all fields will be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

language_code

The language of the following fields in flow:

• Flow.event_handlers.trigger_fulfillment.messages

• Flow.event_handlers.trigger_fulfillment.conditional_cases

• Flow.transition_routes.trigger_fulfillment.messages

• Flow.transition_routes.trigger_fulfillment.conditional_cases

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.UpdateGenerativeSettingsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request for [UpdateGenerativeSettings][google.cloud.dialogflow.cx.v3beta1.Agents.UpdateGenerativeSettings] RPC.

generative_settings

Required. Generative settings to update.

Type

google.cloud.dialogflowcx_v3beta1.types.GenerativeSettings

update_mask

Optional. The mask to control which fields get updated. If the mask is not present, all fields will be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateGeneratorRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Generators.UpdateGenerator][google.cloud.dialogflow.cx.v3beta1.Generators.UpdateGenerator].

generator

Required. The generator to update.

Type

google.cloud.dialogflowcx_v3beta1.types.Generator

language_code

The language to list generators for.

Type

str

update_mask

The mask to control which fields get updated. If the mask is not present, all fields will be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateIntentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Intents.UpdateIntent][google.cloud.dialogflow.cx.v3beta1.Intents.UpdateIntent].

intent

Required. The intent to update.

Type

google.cloud.dialogflowcx_v3beta1.types.Intent

language_code

The language of the following fields in intent:

• Intent.training_phrases.parts.text

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

update_mask

The mask to control which fields get updated. If the mask is not present, all fields will be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdatePageRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Pages.UpdatePage][google.cloud.dialogflow.cx.v3beta1.Pages.UpdatePage].

page

Required. The page to update.

Type

google.cloud.dialogflowcx_v3beta1.types.Page

language_code

The language of the following fields in page:

• Page.entry_fulfillment.messages

• Page.entry_fulfillment.conditional_cases

• Page.event_handlers.trigger_fulfillment.messages

• Page.event_handlers.trigger_fulfillment.conditional_cases

• Page.form.parameters.fill_behavior.initial_prompt_fulfillment.messages

Page.form.parameters.fill_behavior.initial_prompt_fulfillment.conditional_cases

• Page.form.parameters.fill_behavior.reprompt_event_handlers.messages

Page.form.parameters.fill_behavior.reprompt_event_handlers.conditional_cases

• Page.transition_routes.trigger_fulfillment.messages

• Page.transition_routes.trigger_fulfillment.conditional_cases

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

update_mask

The mask to control which fields get updated. If the mask is not present, all fields will be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdatePlaybookRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Playbooks.UpdatePlaybook][google.cloud.dialogflow.cx.v3beta1.Playbooks.UpdatePlaybook].

playbook

Required. The playbook to update.

Type

google.cloud.dialogflowcx_v3beta1.types.Playbook

update_mask

The mask to control which fields get updated. If the mask is not present, all fields will be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateSecuritySettingsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [SecuritySettingsService.UpdateSecuritySettings][google.cloud.dialogflow.cx.v3beta1.SecuritySettingsService.UpdateSecuritySettings].

security_settings

Required. [SecuritySettings] object that contains values for each of the fields to update.

Type

google.cloud.dialogflowcx_v3beta1.types.SecuritySettings

update_mask

Required. The mask to control which fields get updated. If the mask is not present, all fields will be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateSessionEntityTypeRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [SessionEntityTypes.UpdateSessionEntityType][google.cloud.dialogflow.cx.v3beta1.SessionEntityTypes.UpdateSessionEntityType].

session_entity_type

Required. The session entity type to update. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID>/entityTypes/<EntityTypeID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>/entityTypes/<EntityTypeID>. If Environment ID is not specified, we assume default ‘draft’ environment.

Type

google.cloud.dialogflowcx_v3beta1.types.SessionEntityType

update_mask

The mask to control which fields get updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateTestCaseRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TestCases.UpdateTestCase][google.cloud.dialogflow.cx.v3beta1.TestCases.UpdateTestCase].

test_case

Required. The test case to update.

Type

google.cloud.dialogflowcx_v3beta1.types.TestCase

update_mask

Required. The mask to specify which fields should be updated. The [creationTime][google.cloud.dialogflow.cx.v3beta1.TestCase.creation_time] and [lastTestResult][google.cloud.dialogflow.cx.v3beta1.TestCase.last_test_result] cannot be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateToolRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Tools.UpdateTool][google.cloud.dialogflow.cx.v3beta1.Tools.UpdateTool].

tool

Required. The Tool to be updated.

Type

google.cloud.dialogflowcx_v3beta1.types.Tool

update_mask

The mask to control which fields get updated. If the mask is not present, all fields will be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateTransitionRouteGroupRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [TransitionRouteGroups.UpdateTransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroups.UpdateTransitionRouteGroup].

transition_route_group

Required. The transition route group to update.

Type

google.cloud.dialogflowcx_v3beta1.types.TransitionRouteGroup

update_mask

The mask to control which fields get updated.

Type

google.protobuf.field_mask_pb2.FieldMask

language_code

The language of the following fields in TransitionRouteGroup:

• TransitionRouteGroup.transition_routes.trigger_fulfillment.messages

TransitionRouteGroup.transition_routes.trigger_fulfillment.conditional_cases

If not specified, the agent’s default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.UpdateVersionRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Versions.UpdateVersion][google.cloud.dialogflow.cx.v3beta1.Versions.UpdateVersion].

version

Required. The version to update.

Type

google.cloud.dialogflowcx_v3beta1.types.Version

update_mask

Required. The mask to control which fields get updated. Currently only description and display_name can be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UpdateWebhookRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Webhooks.UpdateWebhook][google.cloud.dialogflow.cx.v3beta1.Webhooks.UpdateWebhook].

webhook

Required. The webhook to update.

Type

google.cloud.dialogflowcx_v3beta1.types.Webhook

update_mask

The mask to control which fields get updated. If the mask is not present, all fields will be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.cloud.dialogflowcx_v3beta1.types.UserUtterance(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

UserUtterance represents one message sent by the customer.

text

Required. Message content in text.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ValidateAgentRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Agents.ValidateAgent][google.cloud.dialogflow.cx.v3beta1.Agents.ValidateAgent].

name

Required. The agent to validate. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>.

Type

str

language_code

If not specified, the agent’s default language is used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ValidateFlowRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for [Flows.ValidateFlow][google.cloud.dialogflow.cx.v3beta1.Flows.ValidateFlow].

name

Required. The flow to validate. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

Type

str

language_code

If not specified, the agent’s default language is used.

Type

str

class google.cloud.dialogflowcx_v3beta1.types.ValidationMessage(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Agent/flow validation message.

resource_type

The type of the resources where the message is found.

Type

google.cloud.dialogflowcx_v3beta1.types.ValidationMessage.ResourceType

resources

The names of the resources where the message is found.

Type

MutableSequence[str]

resource_names

The resource names of the resources where the message is found.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ResourceName]

severity

Indicates the severity of the message.

Type

google.cloud.dialogflowcx_v3beta1.types.ValidationMessage.Severity

detail

The message detail.

Type

str

class ResourceType(value)

Bases: proto.enums.Enum

Resource types.

Values:

RESOURCE_TYPE_UNSPECIFIED (0):

Unspecified.

AGENT (1):

Agent.

INTENT (2):

Intent.

INTENT_TRAINING_PHRASE (8):

Intent training phrase.

INTENT_PARAMETER (9):

Intent parameter.

INTENTS (10):

Multiple intents.

INTENT_TRAINING_PHRASES (11):

Multiple training phrases.

ENTITY_TYPE (3):

Entity type.

ENTITY_TYPES (12):

Multiple entity types.

WEBHOOK (4):

Webhook.

FLOW (5):

Flow.

PAGE (6):

Page.

PAGES (13):

Multiple pages.

TRANSITION_ROUTE_GROUP (7):

Transition route group.

AGENT_TRANSITION_ROUTE_GROUP (14):

Agent transition route group.

class Severity(value)

Bases: proto.enums.Enum

Severity level.

Values:

SEVERITY_UNSPECIFIED (0):

Unspecified.

INFO (1):

The agent doesn’t follow Dialogflow best practices.

WARNING (2):

The agent may not behave as expected.

ERROR (3):

The agent may experience failures.

class google.cloud.dialogflowcx_v3beta1.types.VariantsHistory(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The history of variants update.

version_variants

The flow versions as the variants.

This field is a member of oneof variants.

Type

google.cloud.dialogflowcx_v3beta1.types.VersionVariants

update_time

Update time of the variants.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.cloud.dialogflowcx_v3beta1.types.Version(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a version of a flow.

name

Format:

projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>. Version ID is a self-increasing number generated by Dialogflow upon version creation.

Type

str

display_name

Required. The human-readable name of the version. Limit of 64 characters.

Type

str

description

The description of the version. The maximum length is 500 characters. If exceeded, the request is rejected.

Type

str

nlu_settings

Output only. The NLU settings of the flow at version creation.

Type

google.cloud.dialogflowcx_v3beta1.types.NluSettings

create_time

Output only. Create time of the version.

Type

google.protobuf.timestamp_pb2.Timestamp

state

Output only. The state of this version. This field is read-only and cannot be set by create and update methods.

Type

google.cloud.dialogflowcx_v3beta1.types.Version.State

class State(value)

Bases: proto.enums.Enum

The state of the version.

Values:

STATE_UNSPECIFIED (0):

Not specified. This value is not used.

RUNNING (1):

Version is not ready to serve (e.g. training is running).

SUCCEEDED (2):

Training has succeeded and this version is ready to serve.

FAILED (3):

Version training failed.

class google.cloud.dialogflowcx_v3beta1.types.VersionVariants(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A list of flow version variants.

variants

A list of flow version variants.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.VersionVariants.Variant]

class Variant(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A single flow version with specified traffic allocation.

version

The name of the flow version. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>.

Type

str

traffic_allocation

Percentage of the traffic which should be routed to this version of flow. Traffic allocation for a single flow must sum up to 1.0.

Type

float

is_control_group

Whether the variant is for the control group.

Type

bool

class google.cloud.dialogflowcx_v3beta1.types.VoiceSelectionParams(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Description of which voice to use for speech synthesis.

name

Optional. The name of the voice. If not set, the service will choose a voice based on the other parameters such as language_code and [ssml_gender][google.cloud.dialogflow.cx.v3beta1.VoiceSelectionParams.ssml_gender].

For the list of available voices, please refer to Supported voices and languages.

Type

str

ssml_gender

Optional. The preferred gender of the voice. If not set, the service will choose a voice based on the other parameters such as language_code and [name][google.cloud.dialogflow.cx.v3beta1.VoiceSelectionParams.name]. Note that this is only a preference, not requirement. If a voice of the appropriate gender is not available, the synthesizer should substitute a voice with a different gender rather than failing the request.

Type

google.cloud.dialogflowcx_v3beta1.types.SsmlVoiceGender

class google.cloud.dialogflowcx_v3beta1.types.Webhook(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Webhooks host the developer’s business logic. During a session, webhooks allow the developer to use the data extracted by Dialogflow’s natural language processing to generate dynamic responses, validate collected data, or trigger actions on the backend.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

name

The unique identifier of the webhook. Required for the [Webhooks.UpdateWebhook][google.cloud.dialogflow.cx.v3beta1.Webhooks.UpdateWebhook] method. [Webhooks.CreateWebhook][google.cloud.dialogflow.cx.v3beta1.Webhooks.CreateWebhook] populates the name automatically. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/webhooks/<WebhookID>.

Type

str

display_name

Required. The human-readable name of the webhook, unique within the agent.

Type

str

generic_web_service

Configuration for a generic web service.

This field is a member of oneof webhook.

Type

google.cloud.dialogflowcx_v3beta1.types.Webhook.GenericWebService

service_directory

Configuration for a Service Directory service.

This field is a member of oneof webhook.

Type

google.cloud.dialogflowcx_v3beta1.types.Webhook.ServiceDirectoryConfig

timeout

Webhook execution timeout. Execution is considered failed if Dialogflow doesn’t receive a response from webhook at the end of the timeout period. Defaults to 5 seconds, maximum allowed timeout is 30 seconds.

Type

google.protobuf.duration_pb2.Duration

disabled

Indicates whether the webhook is disabled.

Type

bool

class GenericWebService(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents configuration for a generic web service.

uri

Required. The webhook URI for receiving POST requests. It must use https protocol.

Type

str

username

The user name for HTTP Basic authentication.

Type

str

password

The password for HTTP Basic authentication.

Type

str

request_headers

The HTTP request headers to send together with webhook requests.

Type

MutableMapping[str, str]

allowed_ca_certs

Optional. Specifies a list of allowed custom CA certificates (in DER format) for HTTPS verification. This overrides the default SSL trust store. If this is empty or unspecified, Dialogflow will use Google’s default trust store to verify certificates. N.B. Make sure the HTTPS server certificates are signed with “subject alt name”. For instance a certificate can be self-signed using the following command,

openssl x509 -req -days 200 -in example.com.csr \
  -signkey example.com.key \
  -out example.com.crt \
  -extfile <(printf "\nsubjectAltName='DNS:www.example.com'")

Type

MutableSequence[bytes]

oauth_config

Optional. The OAuth configuration of the webhook. If specified, Dialogflow will initiate the OAuth client credential flow to exchange an access token from the 3rd party platform and put it in the auth header.

Type

google.cloud.dialogflowcx_v3beta1.types.Webhook.GenericWebService.OAuthConfig

service_agent_auth

Optional. Indicate the auth token type generated from the Diglogflow service agent. The generated token is sent in the Authorization header.

Type

google.cloud.dialogflowcx_v3beta1.types.Webhook.GenericWebService.ServiceAgentAuth

webhook_type

Optional. Type of the webhook.

Type

google.cloud.dialogflowcx_v3beta1.types.Webhook.GenericWebService.WebhookType

http_method

Optional. HTTP method for the flexible webhook calls. Standard webhook always uses POST.

Type

google.cloud.dialogflowcx_v3beta1.types.Webhook.GenericWebService.HttpMethod

request_body

Optional. Defines a custom JSON object as request body to send to flexible webhook.

Type

str

parameter_mapping

Optional. Maps the values extracted from specific fields of the flexible webhook response into session parameters. - Key: session parameter name - Value: field path in the webhook response

Type

MutableMapping[str, str]

class HttpMethod(value)

Bases: proto.enums.Enum

HTTP method to use when calling webhooks.

Values:

HTTP_METHOD_UNSPECIFIED (0):

HTTP method not specified.

POST (1):

HTTP POST Method.

GET (2):

HTTP GET Method.

HEAD (3):

HTTP HEAD Method.

PUT (4):

HTTP PUT Method.

DELETE (5):

HTTP DELETE Method.

PATCH (6):

HTTP PATCH Method.

OPTIONS (7):

HTTP OPTIONS Method.

class OAuthConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents configuration of OAuth client credential flow for 3rd party API authentication.

client_id

Required. The client ID provided by the 3rd party platform.

Type

str

client_secret

Required. The client secret provided by the 3rd party platform.

Type

str

token_endpoint

Required. The token endpoint provided by the 3rd party platform to exchange an access token.

Type

str

scopes

Optional. The OAuth scopes to grant.

Type

MutableSequence[str]

class ParameterMappingEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class RequestHeadersEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class ServiceAgentAuth(value)

Bases: proto.enums.Enum

Indicate the auth token type generated from the Diglogflow service agent.

Values:

SERVICE_AGENT_AUTH_UNSPECIFIED (0):

Service agent auth type unspecified. Default to ID_TOKEN.

NONE (1):

No token used.

ID_TOKEN (2):

Use ID token generated from service agent. This can be used to access Cloud Function and Cloud Run after you grant Invoker role to service-<PROJECT-NUMBER>@gcp-sa-dialogflow.iam.gserviceaccount.com.

ACCESS_TOKEN (3):

Use access token generated from service agent. This can be used to access other Google Cloud APIs after you grant required roles to service-<PROJECT-NUMBER>@gcp-sa-dialogflow.iam.gserviceaccount.com.

class WebhookType(value)

Bases: proto.enums.Enum

Represents the type of webhook configuration.

Values:

WEBHOOK_TYPE_UNSPECIFIED (0):

Default value. This value is unused.

STANDARD (1):

Represents a standard webhook.

FLEXIBLE (2):

Represents a flexible webhook.

class ServiceDirectoryConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents configuration for a Service Directory service.

service

Required. The name of Service Directory service. Format: projects/<ProjectID>/locations/<LocationID>/namespaces/<NamespaceID>/services/<ServiceID>. Location ID of the service directory must be the same as the location of the agent.

Type

str

generic_web_service

Generic Service configuration of this webhook.

Type

google.cloud.dialogflowcx_v3beta1.types.Webhook.GenericWebService

class google.cloud.dialogflowcx_v3beta1.types.WebhookRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The request message for a webhook call. The request is sent as a JSON object and the field names will be presented in camel cases.

You may see undocumented fields in an actual request. These fields are used internally by Dialogflow and should be ignored.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

detect_intent_response_id

Always present. The unique identifier of the [DetectIntentResponse][google.cloud.dialogflow.cx.v3beta1.DetectIntentResponse] that will be returned to the API caller.

Type

str

text

If [natural language text][google.cloud.dialogflow.cx.v3beta1.TextInput] was provided as input, this field will contain a copy of the text.

This field is a member of oneof query.

Type

str

trigger_intent

If an [intent][google.cloud.dialogflow.cx.v3beta1.IntentInput] was provided as input, this field will contain a copy of the intent identifier. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/intents/<IntentID>.

This field is a member of oneof query.

Type

str

transcript

If [natural language speech audio][google.cloud.dialogflow.cx.v3beta1.AudioInput] was provided as input, this field will contain the transcript for the audio.

This field is a member of oneof query.

Type

str

trigger_event

If an [event][google.cloud.dialogflow.cx.v3beta1.EventInput] was provided as input, this field will contain the name of the event.

This field is a member of oneof query.

Type

str

dtmf_digits

If [DTMF][google.cloud.dialogflow.cx.v3beta1.DtmfInput] was provided as input, this field will contain the DTMF digits.

This field is a member of oneof query.

Type

str

language_code

The language code specified in the [original request][QueryInput.language_code].

Type

str

fulfillment_info

Always present. Information about the fulfillment that triggered this webhook call.

Type

google.cloud.dialogflowcx_v3beta1.types.WebhookRequest.FulfillmentInfo

intent_info

Information about the last matched intent.

Type

google.cloud.dialogflowcx_v3beta1.types.WebhookRequest.IntentInfo

page_info

Information about page status.

Type

google.cloud.dialogflowcx_v3beta1.types.PageInfo

session_info

Information about session status.

Type

google.cloud.dialogflowcx_v3beta1.types.SessionInfo

messages

The list of rich message responses to present to the user. Webhook can choose to append or replace this list in [WebhookResponse.fulfillment_response][google.cloud.dialogflow.cx.v3beta1.WebhookResponse.fulfillment_response];

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ResponseMessage]

payload

Custom data set in [QueryParameters.payload][google.cloud.dialogflow.cx.v3beta1.QueryParameters.payload].

Type

google.protobuf.struct_pb2.Struct

sentiment_analysis_result

The sentiment analysis result of the current user request. The field is filled when sentiment analysis is configured to be enabled for the request.

Type

google.cloud.dialogflowcx_v3beta1.types.WebhookRequest.SentimentAnalysisResult

language_info

Information about the language of the request.

Type

google.cloud.dialogflowcx_v3beta1.types.LanguageInfo

class FulfillmentInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents fulfillment information communicated to the webhook.

tag

Always present. The value of the [Fulfillment.tag][google.cloud.dialogflow.cx.v3beta1.Fulfillment.tag] field will be populated in this field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes.

Type

str

class IntentInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents intent information communicated to the webhook.

last_matched_intent

Always present. The unique identifier of the last matched [intent][google.cloud.dialogflow.cx.v3beta1.Intent]. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/intents/<IntentID>.

Type

str

display_name

Always present. The display name of the last matched [intent][google.cloud.dialogflow.cx.v3beta1.Intent].

Type

str

parameters

Parameters identified as a result of intent matching. This is a map of the name of the identified parameter to the value of the parameter identified from the user’s utterance. All parameters defined in the matched intent that are identified will be surfaced here.

Type

MutableMapping[str, google.cloud.dialogflowcx_v3beta1.types.WebhookRequest.IntentInfo.IntentParameterValue]

confidence

The confidence of the matched intent. Values range from 0.0 (completely uncertain) to 1.0 (completely certain).

Type

float

class IntentParameterValue(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a value for an intent parameter.

original_value

Always present. Original text value extracted from user utterance.

Type

str

resolved_value

Always present. Structured value for the parameter extracted from user utterance.

Type

google.protobuf.struct_pb2.Value

class ParametersEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

class SentimentAnalysisResult(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents the result of sentiment analysis.

score

Sentiment score between -1.0 (negative sentiment) and 1.0 (positive sentiment).

Type

float

magnitude

A non-negative number in the [0, +inf) range, which represents the absolute magnitude of sentiment, regardless of score (positive or negative).

Type

float

class google.cloud.dialogflowcx_v3beta1.types.WebhookResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

The response message for a webhook call.

This message has oneof fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

fulfillment_response

The fulfillment response to send to the user. This field can be omitted by the webhook if it does not intend to send any response to the user.

Type

google.cloud.dialogflowcx_v3beta1.types.WebhookResponse.FulfillmentResponse

page_info

Information about page status. This field can be omitted by the webhook if it does not intend to modify page status.

Type

google.cloud.dialogflowcx_v3beta1.types.PageInfo

session_info

Information about session status. This field can be omitted by the webhook if it does not intend to modify session status.

Type

google.cloud.dialogflowcx_v3beta1.types.SessionInfo

payload

Value to append directly to [QueryResult.webhook_payloads][google.cloud.dialogflow.cx.v3beta1.QueryResult.webhook_payloads].

Type

google.protobuf.struct_pb2.Struct

target_page

The target page to transition to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>.

This field is a member of oneof transition.

Type

str

target_flow

The target flow to transition to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.

This field is a member of oneof transition.

Type

str

class FulfillmentResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Represents a fulfillment response to the user.

messages

The list of rich message responses to present to the user.

Type

MutableSequence[google.cloud.dialogflowcx_v3beta1.types.ResponseMessage]

merge_behavior

Merge behavior for messages.

Type

google.cloud.dialogflowcx_v3beta1.types.WebhookResponse.FulfillmentResponse.MergeBehavior

class MergeBehavior(value)

Bases: proto.enums.Enum

Defines merge behavior for messages.

Values:

MERGE_BEHAVIOR_UNSPECIFIED (0):

Not specified. APPEND will be used.

APPEND (1):

messages will be appended to the list of messages waiting to be sent to the user.

REPLACE (2):

messages will replace the list of messages waiting to be sent to the user.