agents

Creates, updates, deletes, gets or lists an agents resource.

Overview

Name	agents
Type	Resource
Id	google.dialogflow.agents

Fields

The following fields are returned by SELECT queries:

projects_locations_agents_get

Name	Datatype	Description
name	string
advancedSettings	object	(id: GoogleCloudDialogflowCxV3AdvancedSettings)
answerFeedbackSettings	object	(id: GoogleCloudDialogflowCxV3AgentAnswerFeedbackSettings)
avatarUri	string
clientCertificateSettings	object	(id: GoogleCloudDialogflowCxV3AgentClientCertificateSettings)
defaultLanguageCode	string
description	string
displayName	string
enableMultiLanguageTraining	boolean
enableSpellCorrection	boolean
enableStackdriverLogging	boolean
genAppBuilderSettings	object	(id: GoogleCloudDialogflowCxV3AgentGenAppBuilderSettings)
gitIntegrationSettings	object	(id: GoogleCloudDialogflowCxV3AgentGitIntegrationSettings)
locked	boolean
personalizationSettings	object	(id: GoogleCloudDialogflowCxV3AgentPersonalizationSettings)
satisfiesPzi	boolean
satisfiesPzs	boolean
securitySettings	string
speechToTextSettings	object	(id: GoogleCloudDialogflowCxV3SpeechToTextSettings)
startFlow	string
startPlaybook	string
supportedLanguageCodes	array
textToSpeechSettings	object	(id: GoogleCloudDialogflowCxV3TextToSpeechSettings)
timeZone	string

projects_locations_agents_list

Name	Datatype	Description
name	string
advancedSettings	object	(id: GoogleCloudDialogflowCxV3AdvancedSettings)
answerFeedbackSettings	object	(id: GoogleCloudDialogflowCxV3AgentAnswerFeedbackSettings)
avatarUri	string
clientCertificateSettings	object	(id: GoogleCloudDialogflowCxV3AgentClientCertificateSettings)
defaultLanguageCode	string
description	string
displayName	string
enableMultiLanguageTraining	boolean
enableSpellCorrection	boolean
enableStackdriverLogging	boolean
genAppBuilderSettings	object	(id: GoogleCloudDialogflowCxV3AgentGenAppBuilderSettings)
gitIntegrationSettings	object	(id: GoogleCloudDialogflowCxV3AgentGitIntegrationSettings)
locked	boolean
personalizationSettings	object	(id: GoogleCloudDialogflowCxV3AgentPersonalizationSettings)
satisfiesPzi	boolean
satisfiesPzs	boolean
securitySettings	string
speechToTextSettings	object	(id: GoogleCloudDialogflowCxV3SpeechToTextSettings)
startFlow	string
startPlaybook	string
supportedLanguageCodes	array
textToSpeechSettings	object	(id: GoogleCloudDialogflowCxV3TextToSpeechSettings)
timeZone	string

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
projects_locations_agents_get	select	projectsId, locationsId, agentsId
projects_locations_agents_list	select	projectsId, locationsId	pageSize, pageToken
projects_locations_agents_create	insert	projectsId, locationsId
projects_locations_agents_patch	update	projectsId, locationsId, agentsId	updateMask
projects_locations_agents_delete	delete	projectsId, locationsId, agentsId
projects_locations_agents_export	exec	projectsId, locationsId, agentsId
projects_locations_agents_restore	exec	projectsId, locationsId, agentsId
projects_locations_agents_validate	exec	projectsId, locationsId, agentsId

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
agentsId	string
locationsId	string
projectsId	string
pageSize	integer (int32)
pageToken	string
updateMask	string (google-fieldmask)

SELECT examples

projects_locations_agents_get

Successful response

SELECT
name,
advancedSettings,
answerFeedbackSettings,
avatarUri,
clientCertificateSettings,
defaultLanguageCode,
description,
displayName,
enableMultiLanguageTraining,
enableSpellCorrection,
enableStackdriverLogging,
genAppBuilderSettings,
gitIntegrationSettings,
locked,
personalizationSettings,
satisfiesPzi,
satisfiesPzs,
securitySettings,
speechToTextSettings,
startFlow,
startPlaybook,
supportedLanguageCodes,
textToSpeechSettings,
timeZone
FROM google.dialogflow.agents
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND agentsId = '{{ agentsId }}' -- required
;

projects_locations_agents_list

Successful response

SELECT
name,
advancedSettings,
answerFeedbackSettings,
avatarUri,
clientCertificateSettings,
defaultLanguageCode,
description,
displayName,
enableMultiLanguageTraining,
enableSpellCorrection,
enableStackdriverLogging,
genAppBuilderSettings,
gitIntegrationSettings,
locked,
personalizationSettings,
satisfiesPzi,
satisfiesPzs,
securitySettings,
speechToTextSettings,
startFlow,
startPlaybook,
supportedLanguageCodes,
textToSpeechSettings,
timeZone
FROM google.dialogflow.agents
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

INSERT examples

projects_locations_agents_create

No description available.

INSERT INTO google.dialogflow.agents (
data__advancedSettings,
data__answerFeedbackSettings,
data__avatarUri,
data__clientCertificateSettings,
data__defaultLanguageCode,
data__description,
data__displayName,
data__enableMultiLanguageTraining,
data__enableSpellCorrection,
data__enableStackdriverLogging,
data__genAppBuilderSettings,
data__gitIntegrationSettings,
data__locked,
data__name,
data__personalizationSettings,
data__securitySettings,
data__speechToTextSettings,
data__startFlow,
data__startPlaybook,
data__supportedLanguageCodes,
data__textToSpeechSettings,
data__timeZone,
projectsId,
locationsId
)
SELECT 
'{{ advancedSettings }}',
'{{ answerFeedbackSettings }}',
'{{ avatarUri }}',
'{{ clientCertificateSettings }}',
'{{ defaultLanguageCode }}',
'{{ description }}',
'{{ displayName }}',
{{ enableMultiLanguageTraining }},
{{ enableSpellCorrection }},
{{ enableStackdriverLogging }},
'{{ genAppBuilderSettings }}',
'{{ gitIntegrationSettings }}',
{{ locked }},
'{{ name }}',
'{{ personalizationSettings }}',
'{{ securitySettings }}',
'{{ speechToTextSettings }}',
'{{ startFlow }}',
'{{ startPlaybook }}',
'{{ supportedLanguageCodes }}',
'{{ textToSpeechSettings }}',
'{{ timeZone }}',
'{{ projectsId }}',
'{{ locationsId }}'
RETURNING
name,
advancedSettings,
answerFeedbackSettings,
avatarUri,
clientCertificateSettings,
defaultLanguageCode,
description,
displayName,
enableMultiLanguageTraining,
enableSpellCorrection,
enableStackdriverLogging,
genAppBuilderSettings,
gitIntegrationSettings,
locked,
personalizationSettings,
satisfiesPzi,
satisfiesPzs,
securitySettings,
speechToTextSettings,
startFlow,
startPlaybook,
supportedLanguageCodes,
textToSpeechSettings,
timeZone
;

Manifest

# Description fields are for documentation purposes
- name: agents
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the agents resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the agents resource.
  - name: advancedSettings
    value:
      audioExportGcsDestination:
        uri: "{{ uri }}"
      dtmfSettings:
        enabled: {{ enabled }}
        endpointingTimeoutDuration: "{{ endpointingTimeoutDuration }}"
        finishDigit: "{{ finishDigit }}"
        interdigitTimeoutDuration: "{{ interdigitTimeoutDuration }}"
        maxDigits: {{ maxDigits }}
      loggingSettings:
        enableConsentBasedRedaction: {{ enableConsentBasedRedaction }}
        enableInteractionLogging: {{ enableInteractionLogging }}
        enableStackdriverLogging: {{ enableStackdriverLogging }}
      speechSettings:
        endpointerSensitivity: {{ endpointerSensitivity }}
        models: "{{ models }}"
        noSpeechTimeout: "{{ noSpeechTimeout }}"
        useTimeoutBasedEndpointing: {{ useTimeoutBasedEndpointing }}
  - name: answerFeedbackSettings
    value:
      enableAnswerFeedback: {{ enableAnswerFeedback }}
  - name: avatarUri
    value: "{{ avatarUri }}"
  - name: clientCertificateSettings
    value:
      passphrase: "{{ passphrase }}"
      privateKey: "{{ privateKey }}"
      sslCertificate: "{{ sslCertificate }}"
  - name: defaultLanguageCode
    value: "{{ defaultLanguageCode }}"
  - name: description
    value: "{{ description }}"
  - name: displayName
    value: "{{ displayName }}"
  - name: enableMultiLanguageTraining
    value: {{ enableMultiLanguageTraining }}
  - name: enableSpellCorrection
    value: {{ enableSpellCorrection }}
  - name: enableStackdriverLogging
    value: {{ enableStackdriverLogging }}
  - name: genAppBuilderSettings
    value:
      engine: "{{ engine }}"
  - name: gitIntegrationSettings
    value:
      githubSettings:
        accessToken: "{{ accessToken }}"
        branches:
          - "{{ branches }}"
        displayName: "{{ displayName }}"
        repositoryUri: "{{ repositoryUri }}"
        trackingBranch: "{{ trackingBranch }}"
  - name: locked
    value: {{ locked }}
  - name: name
    value: "{{ name }}"
  - name: personalizationSettings
    value:
      defaultEndUserMetadata: "{{ defaultEndUserMetadata }}"
  - name: securitySettings
    value: "{{ securitySettings }}"
  - name: speechToTextSettings
    value:
      enableSpeechAdaptation: {{ enableSpeechAdaptation }}
  - name: startFlow
    value: "{{ startFlow }}"
  - name: startPlaybook
    value: "{{ startPlaybook }}"
  - name: supportedLanguageCodes
    value:
      - "{{ supportedLanguageCodes }}"
  - name: textToSpeechSettings
    value:
      synthesizeSpeechConfigs: "{{ synthesizeSpeechConfigs }}"
  - name: timeZone
    value: "{{ timeZone }}"

UPDATE examples

projects_locations_agents_patch

No description available.

UPDATE google.dialogflow.agents
SET 
data__advancedSettings = '{{ advancedSettings }}',
data__answerFeedbackSettings = '{{ answerFeedbackSettings }}',
data__avatarUri = '{{ avatarUri }}',
data__clientCertificateSettings = '{{ clientCertificateSettings }}',
data__defaultLanguageCode = '{{ defaultLanguageCode }}',
data__description = '{{ description }}',
data__displayName = '{{ displayName }}',
data__enableMultiLanguageTraining = {{ enableMultiLanguageTraining }},
data__enableSpellCorrection = {{ enableSpellCorrection }},
data__enableStackdriverLogging = {{ enableStackdriverLogging }},
data__genAppBuilderSettings = '{{ genAppBuilderSettings }}',
data__gitIntegrationSettings = '{{ gitIntegrationSettings }}',
data__locked = {{ locked }},
data__name = '{{ name }}',
data__personalizationSettings = '{{ personalizationSettings }}',
data__securitySettings = '{{ securitySettings }}',
data__speechToTextSettings = '{{ speechToTextSettings }}',
data__startFlow = '{{ startFlow }}',
data__startPlaybook = '{{ startPlaybook }}',
data__supportedLanguageCodes = '{{ supportedLanguageCodes }}',
data__textToSpeechSettings = '{{ textToSpeechSettings }}',
data__timeZone = '{{ timeZone }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND agentsId = '{{ agentsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
advancedSettings,
answerFeedbackSettings,
avatarUri,
clientCertificateSettings,
defaultLanguageCode,
description,
displayName,
enableMultiLanguageTraining,
enableSpellCorrection,
enableStackdriverLogging,
genAppBuilderSettings,
gitIntegrationSettings,
locked,
personalizationSettings,
satisfiesPzi,
satisfiesPzs,
securitySettings,
speechToTextSettings,
startFlow,
startPlaybook,
supportedLanguageCodes,
textToSpeechSettings,
timeZone;

DELETE examples

projects_locations_agents_delete

No description available.

DELETE FROM google.dialogflow.agents
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND agentsId = '{{ agentsId }}' --required
;

Lifecycle Methods

projects_locations_agents_export

Successful response

EXEC google.dialogflow.agents.projects_locations_agents_export 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@agentsId='{{ agentsId }}' --required 
@@json=
'{
"agentUri": "{{ agentUri }}", 
"dataFormat": "{{ dataFormat }}", 
"environment": "{{ environment }}", 
"gitDestination": "{{ gitDestination }}", 
"includeBigqueryExportSettings": {{ includeBigqueryExportSettings }}
}'
;

projects_locations_agents_restore

Successful response

EXEC google.dialogflow.agents.projects_locations_agents_restore 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@agentsId='{{ agentsId }}' --required 
@@json=
'{
"agentContent": "{{ agentContent }}", 
"agentUri": "{{ agentUri }}", 
"gitSource": "{{ gitSource }}", 
"restoreOption": "{{ restoreOption }}"
}'
;

projects_locations_agents_validate

Successful response

EXEC google.dialogflow.agents.projects_locations_agents_validate 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@agentsId='{{ agentsId }}' --required 
@@json=
'{
"languageCode": "{{ languageCode }}"
}'
;