# Dialogflow API . projects . locations

## Instance Methods

Returns the agent Resource.

Returns the operations Resource.

Deletes the specified agent.

Retrieves the specified agent.

Creates/updates the specified agent.

### Method Details

`deleteAgent(parent, x__xgafv=None)`

    Deletes the specified agent.

    Args:
      parent: string, Required. The project that the agent to delete is associated with.
    Format: `projects/<Project ID>`. (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A generic empty message that you can re-use to avoid defining duplicated
          # empty messages in your APIs. A typical example is to use it as the request
          # or the response type of an API method. For instance:
          #
          #     service Foo {
          #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
          #     }
          #
          # The JSON representation for `Empty` is empty JSON object `{}`.
      }

`getAgent(parent, x__xgafv=None)`

    Retrieves the specified agent.

    Args:
      parent: string, Required. The project that the agent to fetch is associated with.
    Format: `projects/<Project ID>`. (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A Dialogflow agent is a virtual agent that handles conversations with your
            # end-users. It is a natural language understanding module that understands the
            # nuances of human language. Dialogflow translates end-user text or audio
            # during a conversation to structured data that your apps and services can
            # understand. You design and build a Dialogflow agent to handle the types of
            # conversations required for your system.
            #
            # For more information about agents, see the
            # [Agent guide](https://cloud.google.com/dialogflow/docs/agents-overview).
          "displayName": "A String", # Required. The name of this agent.
          "timeZone": "A String", # Required. The time zone of this agent from the
              # [time zone database](https://www.iana.org/time-zones), e.g.,
              # America/New_York, Europe/Paris.
          "parent": "A String", # Required. The project of this agent.
              # Format: `projects/<Project ID>`.
          "classificationThreshold": 3.14, # Optional. 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 fallback intent will be triggered or, if there
              # are no fallback intents defined, no intent 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.
          "defaultLanguageCode": "A String", # Required. The default language of the agent as a language tag. See
              # [Language
              # Support](https://cloud.google.com/dialogflow/docs/reference/language)
              # for a list of the currently supported language codes. This field cannot be
              # set by the `Update` method.
          "enableLogging": True or False, # Optional. Determines whether this agent should log conversation queries.
          "description": "A String", # Optional. The description of this agent.
              # The maximum length is 500 characters. If exceeded, the request is rejected.
          "apiVersion": "A String", # Optional. API version displayed in Dialogflow console. If not specified,
              # V2 API is assumed. Clients are free to query different service endpoints
              # for different API versions. However, bots connectors and webhook calls will
              # follow the specified API version.
          "tier": "A String", # Optional. The agent tier. If not specified, TIER_STANDARD is assumed.
          "avatarUri": "A String", # Optional. The URI of the agent's avatar.
              # Avatars are used throughout the Dialogflow console and in the self-hosted
              # [Web
              # Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo)
              # integration.
          "matchMode": "A String", # Optional. Determines how intents are detected from user queries.
          "supportedLanguageCodes": [ # Optional. The list of all languages supported by this agent (except for the
              # `default_language_code`).
            "A String",
          ],
        }

`setAgent(parent, body=None, updateMask=None, x__xgafv=None)`

    Creates/updates the specified agent.

    Args:
      parent: string, Required. The project of this agent.
    Format: `projects/<Project ID>`. (required)
      body: object, The request body.
        The object takes the form of:

    { # A Dialogflow agent is a virtual agent that handles conversations with your
          # end-users. It is a natural language understanding module that understands the
          # nuances of human language. Dialogflow translates end-user text or audio
          # during a conversation to structured data that your apps and services can
          # understand. You design and build a Dialogflow agent to handle the types of
          # conversations required for your system.
          #
          # For more information about agents, see the
          # [Agent guide](https://cloud.google.com/dialogflow/docs/agents-overview).
        "displayName": "A String", # Required. The name of this agent.
        "timeZone": "A String", # Required. The time zone of this agent from the
            # [time zone database](https://www.iana.org/time-zones), e.g.,
            # America/New_York, Europe/Paris.
        "parent": "A String", # Required. The project of this agent.
            # Format: `projects/<Project ID>`.
        "classificationThreshold": 3.14, # Optional. 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 fallback intent will be triggered or, if there
            # are no fallback intents defined, no intent 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.
        "defaultLanguageCode": "A String", # Required. The default language of the agent as a language tag. See
            # [Language
            # Support](https://cloud.google.com/dialogflow/docs/reference/language)
            # for a list of the currently supported language codes. This field cannot be
            # set by the `Update` method.
        "enableLogging": True or False, # Optional. Determines whether this agent should log conversation queries.
        "description": "A String", # Optional. The description of this agent.
            # The maximum length is 500 characters. If exceeded, the request is rejected.
        "apiVersion": "A String", # Optional. API version displayed in Dialogflow console. If not specified,
            # V2 API is assumed. Clients are free to query different service endpoints
            # for different API versions. However, bots connectors and webhook calls will
            # follow the specified API version.
        "tier": "A String", # Optional. The agent tier. If not specified, TIER_STANDARD is assumed.
        "avatarUri": "A String", # Optional. The URI of the agent's avatar.
            # Avatars are used throughout the Dialogflow console and in the self-hosted
            # [Web
            # Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo)
            # integration.
        "matchMode": "A String", # Optional. Determines how intents are detected from user queries.
        "supportedLanguageCodes": [ # Optional. The list of all languages supported by this agent (except for the
            # `default_language_code`).
          "A String",
        ],
      }

      updateMask: string, Optional. The mask to control which fields get updated.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A Dialogflow agent is a virtual agent that handles conversations with your
            # end-users. It is a natural language understanding module that understands the
            # nuances of human language. Dialogflow translates end-user text or audio
            # during a conversation to structured data that your apps and services can
            # understand. You design and build a Dialogflow agent to handle the types of
            # conversations required for your system.
            #
            # For more information about agents, see the
            # [Agent guide](https://cloud.google.com/dialogflow/docs/agents-overview).
          "displayName": "A String", # Required. The name of this agent.
          "timeZone": "A String", # Required. The time zone of this agent from the
              # [time zone database](https://www.iana.org/time-zones), e.g.,
              # America/New_York, Europe/Paris.
          "parent": "A String", # Required. The project of this agent.
              # Format: `projects/<Project ID>`.
          "classificationThreshold": 3.14, # Optional. 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 fallback intent will be triggered or, if there
              # are no fallback intents defined, no intent 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.
          "defaultLanguageCode": "A String", # Required. The default language of the agent as a language tag. See
              # [Language
              # Support](https://cloud.google.com/dialogflow/docs/reference/language)
              # for a list of the currently supported language codes. This field cannot be
              # set by the `Update` method.
          "enableLogging": True or False, # Optional. Determines whether this agent should log conversation queries.
          "description": "A String", # Optional. The description of this agent.
              # The maximum length is 500 characters. If exceeded, the request is rejected.
          "apiVersion": "A String", # Optional. API version displayed in Dialogflow console. If not specified,
              # V2 API is assumed. Clients are free to query different service endpoints
              # for different API versions. However, bots connectors and webhook calls will
              # follow the specified API version.
          "tier": "A String", # Optional. The agent tier. If not specified, TIER_STANDARD is assumed.
          "avatarUri": "A String", # Optional. The URI of the agent's avatar.
              # Avatars are used throughout the Dialogflow console and in the self-hosted
              # [Web
              # Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo)
              # integration.
          "matchMode": "A String", # Optional. Determines how intents are detected from user queries.
          "supportedLanguageCodes": [ # Optional. The list of all languages supported by this agent (except for the
              # `default_language_code`).
            "A String",
          ],
        }