Package types (1.37.0)

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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

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.

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, [Entity Types][google.cloud.dialogflow.cx.v3beta1.EntityType], Flows, Fulfillments, Webhooks, TransitionRouteGroups 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

AgentUtterance represents one message sent by the agent.

The response message for Agents.GetAgentValidationResult.

Stores information about feedback provided by users about a response.

Audio encoding of the audio content sent in the conversational query request. Refer to the Cloud Speech API documentation <https://cloud.google.com/speech-to-text/docs/basics>__ for more details.

Represents the natural speech audio to be processed.

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.

The request message for TestCases.BatchDeleteTestCases.

Metadata returned for the TestCases.BatchRunTestCases long running operation.

The request message for TestCases.BatchRunTestCases.

The response message for TestCases.BatchRunTestCases.

The settings of BigQuery export.

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

Boost specifications for data stores.

The request message for TestCases.CalculateCoverage.

The response message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Changelogs represents a change made to a given agent.

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.

The request message for Versions.CompareVersions.

The response message for Versions.CompareVersions.

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

Represents a conversation.

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

The request message for Agents.CreateAgent.

The request message for EntityTypes.CreateEntityType.

The request message for Environments.CreateEnvironment.

The request message for Examples.CreateExample.

The request message for Experiments.CreateExperiment.

The request message for Flows.CreateFlow.

The request message for Generators.CreateGenerator.

The request message for Intents.CreateIntent.

The request message for Pages.CreatePage.

The request message for Playbooks.CreatePlaybook.

The request message for Playbooks.CreatePlaybookVersion.

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

The request message for SessionEntityTypes.CreateSessionEntityType.

The request message for TestCases.CreateTestCase.

The request message for Tools.CreateTool.

The request message for TransitionRouteGroups.CreateTransitionRouteGroup.

Metadata associated with the long running operation for Versions.CreateVersion.

The request message for Versions.CreateVersion.

The request message for Webhooks.CreateWebhook.

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

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, ...

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

The request message for Agents.DeleteAgent.

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

The request message for EntityTypes.DeleteEntityType.

The request message for Environments.DeleteEnvironment.

The request message for Examples.DeleteExample.

The request message for Experiments.DeleteExperiment.

The request message for Flows.DeleteFlow.

The request message for Generators.DeleteGenerator.

The request message for Intents.DeleteIntent.

The request message for Pages.DeletePage.

The request message for Playbooks.DeletePlaybook.

The request message for Playbooks.DeletePlaybookVersion.

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

The request message for SessionEntityTypes.DeleteSessionEntityType.

The request message for Tools.DeleteTool.

The request message for TransitionRouteGroups.DeleteTransitionRouteGroup.

The request message for Versions.DeleteVersion.

The request message for Webhooks.DeleteWebhook.

Metadata returned for the Environments.DeployFlow long running operation.

The request message for Environments.DeployFlow.

The response message for Environments.DeployFlow.

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.

The request to detect user's intent.

The message returned from the DetectIntent method.

Represents the input for dtmf event.

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 type.

For more information about entity types, see the Dialogflow documentation <https://cloud.google.com/dialogflow/docs/entities-overview>__.

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.

An event handler specifies an 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Represents the event to trigger.

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.

Represents an experiment in an environment.

The request message for Agents.ExportAgent.

The response message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Metadata returned for the EntityTypes.ExportEntityTypes long running operation.

The request message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

The response message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

The request message for Flows.ExportFlow.

The response message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Metadata returned for the Intents.ExportIntents long running operation.

The request message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

The response message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Metadata returned for the TestCases.ExportTestCases long running operation. This message currently has no fields.

The request message for TestCases.ExportTestCases.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

The response message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Metadata returned for the Tools.ExportTools long running operation.

The request message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

The response message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Filter specifications for data stores.

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.

The flow import strategy used for resource conflict resolution associated with an ImportFlowRequest.

Stores metadata of the invocation of a CX flow.

The response message for Flows.GetFlowValidationResult.

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. When form filling is done, the filled parameters will be written to the session.

Request of [FulfillIntent][]

Response of [FulfillIntent][]

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 or Form lifecycle. For example, when a DetectIntentRequest drives a session to enter a new page, the page's entry fulfillment can add a static response to the QueryResult in the returning DetectIntentResponse, call the webhook (for example, to load user data from a database), or both.

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

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

Settings for Generative AI.

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.

The request message for Agents.GetAgent.

The request message for Agents.GetAgentValidationResult.

The request message for Changelogs.GetChangelog.

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

The request message for Deployments.GetDeployment.

The request message for EntityTypes.GetEntityType.

The request message for Environments.GetEnvironment.

The request message for Examples.GetExample.

The request message for Experiments.GetExperiment.

The response message for Flows.GetFlow.

The request message for Flows.GetFlowValidationResult.

Request for GetGenerativeSettings RPC.

The request message for Generators.GetGenerator.

The request message for Intents.GetIntent.

The request message for Pages.GetPage.

The request message for Playbooks.GetPlaybook.

The request message for Playbooks.GetPlaybookVersion.

The request message for SecuritySettingsService.GetSecuritySettings.

The request message for SessionEntityTypes.GetSessionEntityType.

The request message for TestCases.GetTestCase.

The request message for TestCases.GetTestCaseResult.

The request message for Tools.GetTool.

The request message for TransitionRouteGroups.GetTransitionRouteGroup.

The request message for Versions.GetVersion.

The request message for Webhooks.GetWebhook.

Metadata returned for the EntityTypes.ImportEntityTypes long running operation.

The request message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

The response message for EntityTypes.ImportEntityTypes.

The request message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

The response message for Flows.ImportFlow.

Metadata returned for the Intents.ImportIntents long running operation.

The request message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

The response message for Intents.ImportIntents.

Import strategies for the conflict resolution of resources (i.e. intents, entities, and webhooks) with identical display names during import operations.

Metadata returned for the TestCases.ImportTestCases long running operation.

The request message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

The response message for TestCases.ImportTestCases.

Inline destination for a Dialogflow operation that writes or exports objects (e.g. intents) outside of Dialogflow.

Inline source for a Dialogflow operation that reads or imports objects (e.g. intents) into Dialogflow.

Instructs the speech recognizer on how to process the audio content.

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.

Intent coverage represents the percentage of all possible intents in the agent that are triggered in any of a parent's test cases.

Represents the intent to trigger programmatically rather than as a result of natural language processing.

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.

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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Represents the language information of the request.

The request message for Agents.ListAgents.

The response message for Agents.ListAgents.

The request message for Changelogs.ListChangelogs.

The response message for Changelogs.ListChangelogs.

The request message for Environments.ListContinuousTestResults.

The response message for [Environments.ListTestCaseResults][].

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

The response message for [Conversations.ListConversations][].

The request message for Deployments.ListDeployments.

The response message for Deployments.ListDeployments.

The request message for EntityTypes.ListEntityTypes.

The response message for EntityTypes.ListEntityTypes.

The request message for Environments.ListEnvironments.

The response message for Environments.ListEnvironments.

The request message for Examples.ListExamples.

The response message for Examples.ListExamples.

The request message for Experiments.ListExperiments.

The response message for Experiments.ListExperiments.

The request message for Flows.ListFlows.

The response message for Flows.ListFlows.

The request message for Generators.ListGenerators.

The response message for Generators.ListGenerators.

The request message for Intents.ListIntents.

The response message for Intents.ListIntents.

The request message for Pages.ListPages.

The response message for Pages.ListPages.

The request message for Playbooks.ListPlaybookVersions.

The response message for Playbooks.ListPlaybookVersions.

The request message for Playbooks.ListPlaybooks.

The response message for Playbooks.ListPlaybooks.

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

The response message for [SecuritySettings.ListSecuritySettings][].

The request message for SessionEntityTypes.ListSessionEntityTypes.

The response message for SessionEntityTypes.ListSessionEntityTypes.

The request message for TestCases.ListTestCaseResults.

The response message for TestCases.ListTestCaseResults.

The request message for TestCases.ListTestCases.

The response message for TestCases.ListTestCases.

The request message for Tools.ListTools.

The response message for Tools.ListTools.

The request message for TransitionRouteGroups.ListTransitionRouteGroups.

The response message for TransitionRouteGroups.ListTransitionRouteGroups.

The request message for Versions.ListVersions.

The response message for Versions.ListVersions.

The request message for Webhooks.ListWebhooks.

The response message for Webhooks.ListWebhooks.

Settings for LLM models.

The request message for Versions.LoadVersion.

The request message for Environments.LookupEnvironmentHistory.

The response message for Environments.LookupEnvironmentHistory.

Represents one match result of [MatchIntent][].

Request of [MatchIntent][].

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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Settings related to NLU.

Instructs the speech synthesizer how to generate the output audio content.

Audio encoding of the output audio format in Text-To-Speech.

Output state.

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 <https://cloud.google.com/dialogflow/cx/docs/concept/page>__.

Represents page information communicated to and from the webhook.

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. --)

Text input which can be used for prompt or banned phrases.

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.

Input of the playbook.

Stores metadata of the invocation of a child playbook.

Output of the playbook.

Playbook version is a snapshot of the playbook at certain timestamp.

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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Represents the parameters of a conversational query.

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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Resource name and display name.

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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

The request message for 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

The configuration for auto rollout.

State of the auto-rollout process.

Metadata returned for the Environments.RunContinuousTest long running operation.

The request message for Environments.RunContinuousTest.

The response message for Environments.RunContinuousTest.

Metadata returned for the TestCases.RunTestCase long running operation. This message currently has no fields.

The request message for TestCases.RunTestCase.

The response message for TestCases.RunTestCase.

Settings for Generative Safety.

Search configuration for UCS search queries.

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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

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.

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 <https://cloud.google.com/dialogflow/docs/entities-overview>__.

Represents session information communicated to and from the webhook.

Variant of the specified [Speech model][google.cloud.dialogflow.cx.v3beta1.InputAudioConfig.model] to use.

See the Cloud Speech documentation <https://cloud.google.com/speech-to-text/docs/enhanced-models>__ 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.

    -  If an enhanced variant does not exist for the given
       <xref uid="google.cloud.dialogflow.cx.v3beta1.InputAudioConfig.model">model</xref>
       and request language, Dialogflow falls back to the
       standard variant.

       The `Cloud Speech
       documentation <https://cloud.google.com/speech-to-text/docs/enhanced-models>`__
       describes which models have enhanced variants.

Settings related to speech recognition.

Information for a word recognized by the speech recognizer.

Gender of the voice as described in SSML voice element <https://www.w3.org/TR/speech-synthesis11/#edef_voice>__.

The request message for Experiments.StartExperiment.

The request message for Experiments.StopExperiment.

The top-level message sent by the client to the Sessions.StreamingDetectIntent method.

Multiple request messages should be sent in order:

1. The first message must contain session, query_input plus optionally query_params. If the client wants to receive an audio response, it should also contain output_audio_config.

2. If query_input was set to query_input.audio.config, all subsequent messages must contain query_input.audio.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.

   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.

The top-level message returned from the 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 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 field to PARTIAL.

For the final Nth response message, the detect_intent_response is fully populated, and 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

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.

::

Concatenating the finalized transcripts with is_final set to true, the complete utterance becomes "to be or not to be that is the question".

The request to set the feedback for a bot answer.

Configuration of how speech should be synthesized.

Represents a test case.

Error info for importing a test.

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

Represents configurations for a test case.

Error info for running a test.

The test result for a test case and an agent environment.

The description of differences between original and replayed agent output.

Represents the natural language text to be processed.

Settings related to speech synthesizing.

A tool provides a list of actions which are available to the 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Represents a call of a specific tool's action with the specified inputs.

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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Stores metadata of the invocation of an action supported by a tool.

The request message for Flows.TrainFlow.

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.

A transition route specifies a 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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

A TransitionRouteGroup represents a group of [TransitionRoutes][google.cloud.dialogflow.cx.v3beta1.TransitionRoute] to be used by a Page.

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.

The request message for Agents.UpdateAgent.

The request message for EntityTypes.UpdateEntityType.

The request message for Environments.UpdateEnvironment.

The request message for Examples.UpdateExample.

The request message for Experiments.UpdateExperiment.

The request message for Flows.UpdateFlow.

Request for UpdateGenerativeSettings RPC.

The request message for Generators.UpdateGenerator.

The request message for Intents.UpdateIntent.

The request message for Pages.UpdatePage.

The request message for Playbooks.UpdatePlaybook.

The request message for SecuritySettingsService.UpdateSecuritySettings.

The request message for SessionEntityTypes.UpdateSessionEntityType.

The request message for TestCases.UpdateTestCase.

The request message for Tools.UpdateTool.

The request message for TransitionRouteGroups.UpdateTransitionRouteGroup.

The request message for Versions.UpdateVersion.

The request message for Webhooks.UpdateWebhook.

UserUtterance represents one message sent by the customer.

The request message for Agents.ValidateAgent.

The request message for Flows.ValidateFlow.

Agent/flow validation message.

The history of variants update.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Represents a version of a flow.

A list of flow version variants.

Description of which voice to use for speech synthesis.

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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

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.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields