Builds conversational interfaces (for example, chatbots, and voice-powered apps and devices).
- REST Resource: v2.projects
- REST Resource: v2.projects.agent
- REST Resource: v2.projects.agent.entityTypes
- REST Resource: v2.projects.agent.entityTypes.entities
- REST Resource: v2.projects.agent.environments
- REST Resource: v2.projects.agent.environments.intents
- REST Resource: v2.projects.agent.environments.users.sessions
- REST Resource: v2.projects.agent.environments.users.sessions.contexts
- REST Resource: v2.projects.agent.environments.users.sessions.entityTypes
- REST Resource: v2.projects.agent.intents
- REST Resource: v2.projects.agent.knowledgeBases
- REST Resource: v2.projects.agent.knowledgeBases.documents
- REST Resource: v2.projects.agent.sessions
- REST Resource: v2.projects.agent.sessions.contexts
- REST Resource: v2.projects.agent.sessions.entityTypes
- REST Resource: v2.projects.agent.versions
- REST Resource: v2.projects.answerRecords
- REST Resource: v2.projects.conversationDatasets
- REST Resource: v2.projects.conversationModels
- REST Resource: v2.projects.conversationModels.evaluations
- REST Resource: v2.projects.conversationProfiles
- REST Resource: v2.projects.conversations
- REST Resource: v2.projects.conversations.messages
- REST Resource: v2.projects.conversations.participants
- REST Resource: v2.projects.conversations.participants.suggestions
- REST Resource: v2.projects.conversations.suggestions
- REST Resource: v2.projects.generators
- REST Resource: v2.projects.knowledgeBases
- REST Resource: v2.projects.knowledgeBases.documents
- REST Resource: v2.projects.locations
- REST Resource: v2.projects.locations.agent
- REST Resource: v2.projects.locations.agent.entityTypes
- REST Resource: v2.projects.locations.agent.entityTypes.entities
- REST Resource: v2.projects.locations.agent.environments
- REST Resource: v2.projects.locations.agent.environments.intents
- REST Resource: v2.projects.locations.agent.environments.users.sessions
- REST Resource: v2.projects.locations.agent.environments.users.sessions.contexts
- REST Resource: v2.projects.locations.agent.environments.users.sessions.entityTypes
- REST Resource: v2.projects.locations.agent.intents
- REST Resource: v2.projects.locations.agent.sessions
- REST Resource: v2.projects.locations.agent.sessions.contexts
- REST Resource: v2.projects.locations.agent.sessions.entityTypes
- REST Resource: v2.projects.locations.agent.versions
- REST Resource: v2.projects.locations.answerRecords
- REST Resource: v2.projects.locations.conversationDatasets
- REST Resource: v2.projects.locations.conversationModels
- REST Resource: v2.projects.locations.conversationModels.evaluations
- REST Resource: v2.projects.locations.conversationProfiles
- REST Resource: v2.projects.locations.conversations
- REST Resource: v2.projects.locations.conversations.messages
- REST Resource: v2.projects.locations.conversations.participants
- REST Resource: v2.projects.locations.conversations.participants.suggestions
- REST Resource: v2.projects.locations.conversations.suggestions
- REST Resource: v2.projects.locations.encryptionSpec
- REST Resource: v2.projects.locations.generators
- REST Resource: v2.projects.locations.knowledgeBases
- REST Resource: v2.projects.locations.knowledgeBases.documents
- REST Resource: v2.projects.locations.operations
- REST Resource: v2.projects.locations.sipTrunks
- REST Resource: v2.projects.locations.statelessSuggestion
- REST Resource: v2.projects.locations.suggestions
- REST Resource: v2.projects.operations
- REST Resource: v2.projects.suggestions
Service: dialogflow.googleapis.com
To call this service, we recommend that you use the Google-provided client libraries . If your application needs to use your own libraries to call this service, use the following information when you make the API requests.
Discovery document
A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:
Service endpoint
A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoints and all URIs below are relative to these service endpoints:
-
https://dialogflow.googleapis.com
-
https://asia-northeast1-dialogflow.googleapis.com
-
https://australia-southeast1-dialogflow.googleapis.com
-
https://europe-west1-dialogflow.googleapis.com
-
https://europe-west2-dialogflow.googleapis.com
REST Resource: v2.projects
Methods | |
---|---|
deleteAgent
|
DELETE /v2/{parent=projects/*}/agent
Deletes the specified agent. |
getAgent
|
GET /v2/{parent=projects/*}/agent
Retrieves the specified agent. |
setAgent
|
POST /v2/{agent.parent=projects/*}/agent
Creates/updates the specified agent. |
REST Resource: v2.projects.agent
Methods | |
---|---|
export
|
POST /v2/{parent=projects/*}/agent:export
Exports the specified agent to a ZIP file. |
getFulfillment
|
GET /v2/{name=projects/*/agent/fulfillment}
Retrieves the fulfillment. |
getValidationResult
|
GET /v2/{parent=projects/*}/agent/validationResult
Gets agent validation result. |
import
|
POST /v2/{parent=projects/*}/agent:import
Imports the specified agent from a ZIP file. |
restore
|
POST /v2/{parent=projects/*}/agent:restore
Restores the specified agent from a ZIP file. |
search
|
GET /v2/{parent=projects/*}/agent:search
Returns the list of agents. |
train
|
POST /v2/{parent=projects/*}/agent:train
Trains the specified agent. |
updateFulfillment
|
PATCH /v2/{fulfillment.name=projects/*/agent/fulfillment}
Updates the fulfillment. |
REST Resource: v2.projects.agent.entityTypes
Methods | |
---|---|
batchDelete
|
POST /v2/{parent=projects/*/agent}/entityTypes:batchDelete
Deletes entity types in the specified agent. |
batchUpdate
|
POST /v2/{parent=projects/*/agent}/entityTypes:batchUpdate
Updates/Creates multiple entity types in the specified agent. |
create
|
POST /v2/{parent=projects/*/agent}/entityTypes
Creates an entity type in the specified agent. |
delete
|
DELETE /v2/{name=projects/*/agent/entityTypes/*}
Deletes the specified entity type. |
get
|
GET /v2/{name=projects/*/agent/entityTypes/*}
Retrieves the specified entity type. |
list
|
GET /v2/{parent=projects/*/agent}/entityTypes
Returns the list of all entity types in the specified agent. |
patch
|
PATCH /v2/{entityType.name=projects/*/agent/entityTypes/*}
Updates the specified entity type. |
REST Resource: v2.projects.agent.entityTypes.entities
Methods | |
---|---|
batchCreate
|
POST /v2/{parent=projects/*/agent/entityTypes/*}/entities:batchCreate
Creates multiple new entities in the specified entity type. |
batchDelete
|
POST /v2/{parent=projects/*/agent/entityTypes/*}/entities:batchDelete
Deletes entities in the specified entity type. |
batchUpdate
|
POST /v2/{parent=projects/*/agent/entityTypes/*}/entities:batchUpdate
Updates or creates multiple entities in the specified entity type. |
REST Resource: v2.projects.agent.environments
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/agent}/environments
Creates an agent environment. |
delete
|
DELETE /v2/{name=projects/*/agent/environments/*}
Deletes the specified agent environment. |
get
|
GET /v2/{name=projects/*/agent/environments/*}
Retrieves the specified agent environment. |
getHistory
|
GET /v2/{parent=projects/*/agent/environments/*}/history
Gets the history of the specified environment. |
list
|
GET /v2/{parent=projects/*/agent}/environments
Returns the list of all non-default environments of the specified agent. |
patch
|
PATCH /v2/{environment.name=projects/*/agent/environments/*}
Updates the specified agent environment. |
REST Resource: v2.projects.agent.environments.intents
Methods | |
---|---|
list
|
GET /v2/{parent=projects/*/agent/environments/*}/intents
Returns the list of all intents in the specified agent. |
REST Resource: v2.projects.agent.environments.users.sessions
Methods | |
---|---|
deleteContexts
|
DELETE /v2/{parent=projects/*/agent/environments/*/users/*/sessions/*}/contexts
Deletes all active contexts in the specified session. |
detectIntent
|
POST /v2/{session=projects/*/agent/environments/*/users/*/sessions/*}:detectIntent
Processes a natural language query and returns structured, actionable data as a result. |
REST Resource: v2.projects.agent.environments.users.sessions.contexts
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/agent/environments/*/users/*/sessions/*}/contexts
Creates a context. |
delete
|
DELETE /v2/{name=projects/*/agent/environments/*/users/*/sessions/*/contexts/*}
Deletes the specified context. |
get
|
GET /v2/{name=projects/*/agent/environments/*/users/*/sessions/*/contexts/*}
Retrieves the specified context. |
list
|
GET /v2/{parent=projects/*/agent/environments/*/users/*/sessions/*}/contexts
Returns the list of all contexts in the specified session. |
patch
|
PATCH /v2/{context.name=projects/*/agent/environments/*/users/*/sessions/*/contexts/*}
Updates the specified context. |
REST Resource: v2.projects.agent.environments.users.sessions.entityTypes
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/agent/environments/*/users/*/sessions/*}/entityTypes
Creates a session entity type. |
delete
|
DELETE /v2/{name=projects/*/agent/environments/*/users/*/sessions/*/entityTypes/*}
Deletes the specified session entity type. |
get
|
GET /v2/{name=projects/*/agent/environments/*/users/*/sessions/*/entityTypes/*}
Retrieves the specified session entity type. |
list
|
GET /v2/{parent=projects/*/agent/environments/*/users/*/sessions/*}/entityTypes
Returns the list of all session entity types in the specified session. |
patch
|
PATCH /v2/{sessionEntityType.name=projects/*/agent/environments/*/users/*/sessions/*/entityTypes/*}
Updates the specified session entity type. |
REST Resource: v2.projects.agent.intents
Methods | |
---|---|
batchDelete
|
POST /v2/{parent=projects/*/agent}/intents:batchDelete
Deletes intents in the specified agent. |
batchUpdate
|
POST /v2/{parent=projects/*/agent}/intents:batchUpdate
Updates/Creates multiple intents in the specified agent. |
create
|
POST /v2/{parent=projects/*/agent}/intents
Creates an intent in the specified agent. |
delete
|
DELETE /v2/{name=projects/*/agent/intents/*}
Deletes the specified intent and its direct or indirect followup intents. |
get
|
GET /v2/{name=projects/*/agent/intents/*}
Retrieves the specified intent. |
list
|
GET /v2/{parent=projects/*/agent}/intents
Returns the list of all intents in the specified agent. |
patch
|
PATCH /v2/{intent.name=projects/*/agent/intents/*}
Updates the specified intent. |
REST Resource: v2.projects.agent.knowledgeBases
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/agent}/knowledgeBases
Creates a knowledge base. |
delete
|
DELETE /v2/{name=projects/*/agent/knowledgeBases/*}
Deletes the specified knowledge base. |
get
|
GET /v2/{name=projects/*/agent/knowledgeBases/*}
Retrieves the specified knowledge base. |
list
|
GET /v2/{parent=projects/*/agent}/knowledgeBases
Returns the list of all knowledge bases of the specified agent. |
patch
|
PATCH /v2/{knowledgeBase.name=projects/*/agent/knowledgeBases/*}
Updates the specified knowledge base. |
REST Resource: v2.projects.agent.knowledgeBases.documents
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/agent/knowledgeBases/*}/documents
Creates a new document. |
delete
|
DELETE /v2/{name=projects/*/agent/knowledgeBases/*/documents/*}
Deletes the specified document. |
get
|
GET /v2/{name=projects/*/agent/knowledgeBases/*/documents/*}
Retrieves the specified document. |
list
|
GET /v2/{parent=projects/*/agent/knowledgeBases/*}/documents
Returns the list of all documents of the knowledge base. |
patch
|
PATCH /v2/{document.name=projects/*/agent/knowledgeBases/*/documents/*}
Updates the specified document. |
reload
|
POST /v2/{name=projects/*/agent/knowledgeBases/*/documents/*}:reload
Reloads the specified document from its specified source, content_uri or content. |
REST Resource: v2.projects.agent.sessions
Methods | |
---|---|
deleteContexts
|
DELETE /v2/{parent=projects/*/agent/sessions/*}/contexts
Deletes all active contexts in the specified session. |
detectIntent
|
POST /v2/{session=projects/*/agent/sessions/*}:detectIntent
Processes a natural language query and returns structured, actionable data as a result. |
REST Resource: v2.projects.agent.sessions.contexts
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/agent/sessions/*}/contexts
Creates a context. |
delete
|
DELETE /v2/{name=projects/*/agent/sessions/*/contexts/*}
Deletes the specified context. |
get
|
GET /v2/{name=projects/*/agent/sessions/*/contexts/*}
Retrieves the specified context. |
list
|
GET /v2/{parent=projects/*/agent/sessions/*}/contexts
Returns the list of all contexts in the specified session. |
patch
|
PATCH /v2/{context.name=projects/*/agent/sessions/*/contexts/*}
Updates the specified context. |
REST Resource: v2.projects.agent.sessions.entityTypes
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/agent/sessions/*}/entityTypes
Creates a session entity type. |
delete
|
DELETE /v2/{name=projects/*/agent/sessions/*/entityTypes/*}
Deletes the specified session entity type. |
get
|
GET /v2/{name=projects/*/agent/sessions/*/entityTypes/*}
Retrieves the specified session entity type. |
list
|
GET /v2/{parent=projects/*/agent/sessions/*}/entityTypes
Returns the list of all session entity types in the specified session. |
patch
|
PATCH /v2/{sessionEntityType.name=projects/*/agent/sessions/*/entityTypes/*}
Updates the specified session entity type. |
REST Resource: v2.projects.agent.versions
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/agent}/versions
Creates an agent version. |
delete
|
DELETE /v2/{name=projects/*/agent/versions/*}
Delete the specified agent version. |
get
|
GET /v2/{name=projects/*/agent/versions/*}
Retrieves the specified agent version. |
list
|
GET /v2/{parent=projects/*/agent}/versions
Returns the list of all versions of the specified agent. |
patch
|
PATCH /v2/{version.name=projects/*/agent/versions/*}
Updates the specified agent version. |
REST Resource: v2.projects.answerRecords
Methods | |
---|---|
list
|
GET /v2/{parent=projects/*}/answerRecords
Returns the list of all answer records in the specified project in reverse chronological order. |
patch
|
PATCH /v2/{answerRecord.name=projects/*/answerRecords/*}
Updates the specified answer record. |
REST Resource: v2.projects.conversationDatasets
Methods | |
---|---|
get
|
GET /v2/{name=projects/*/conversationDatasets/*}
Retrieves the specified conversation dataset. |
importConversationData
|
POST /v2/{name=projects/*/conversationDatasets/*}:importConversationData
Import data into the specified conversation dataset. |
list
|
GET /v2/{parent=projects/*}/conversationDatasets
Returns the list of all conversation datasets in the specified project and location. |
REST Resource: v2.projects.conversationModels
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*}/conversationModels
Creates a model. |
delete
|
DELETE /v2/{name=projects/*/conversationModels/*}
Deletes a model. |
deploy
|
POST /v2/{name=projects/*/conversationModels/*}:deploy
Deploys a model. |
get
|
GET /v2/{name=projects/*/conversationModels/*}
Gets conversation model. |
list
|
GET /v2/{parent=projects/*}/conversationModels
Lists conversation models. |
undeploy
|
POST /v2/{name=projects/*/conversationModels/*}:undeploy
Undeploys a model. |
REST Resource: v2.projects.conversationModels.evaluations
Methods | |
---|---|
get
|
GET /v2/{name=projects/*/conversationModels/*/evaluations/*}
Gets an evaluation of conversation model. |
list
|
GET /v2/{parent=projects/*/conversationModels/*}/evaluations
Lists evaluations of a conversation model. |
REST Resource: v2.projects.conversationProfiles
Methods | |
---|---|
clearSuggestionFeatureConfig
|
POST /v2/{conversationProfile=projects/*/conversationProfiles/*}:clearSuggestionFeatureConfig
Clears a suggestion feature from a conversation profile for the given participant role. |
create
|
POST /v2/{parent=projects/*}/conversationProfiles
Creates a conversation profile in the specified project. |
delete
|
DELETE /v2/{name=projects/*/conversationProfiles/*}
Deletes the specified conversation profile. |
get
|
GET /v2/{name=projects/*/conversationProfiles/*}
Retrieves the specified conversation profile. |
list
|
GET /v2/{parent=projects/*}/conversationProfiles
Returns the list of all conversation profiles in the specified project. |
patch
|
PATCH /v2/{conversationProfile.name=projects/*/conversationProfiles/*}
Updates the specified conversation profile. |
setSuggestionFeatureConfig
|
POST /v2/{conversationProfile=projects/*/conversationProfiles/*}:setSuggestionFeatureConfig
Adds or updates a suggestion feature in a conversation profile. |
REST Resource: v2.projects.conversations
Methods | |
---|---|
complete
|
POST /v2/{name=projects/*/conversations/*}:complete
Completes the specified conversation. |
create
|
POST /v2/{parent=projects/*}/conversations
Creates a new conversation. |
get
|
GET /v2/{name=projects/*/conversations/*}
Retrieves the specific conversation. |
list
|
GET /v2/{parent=projects/*}/conversations
Returns the list of all conversations in the specified project. |
REST Resource: v2.projects.conversations.participants
Methods | |
---|---|
analyzeContent
|
POST /v2/{participant=projects/*/conversations/*/participants/*}:analyzeContent
Adds a text (chat, for example), or audio (phone recording, for example) message from a participant into the conversation. |
create
|
POST /v2/{parent=projects/*/conversations/*}/participants
Creates a new participant in a conversation. |
get
|
GET /v2/{name=projects/*/conversations/*/participants/*}
Retrieves a conversation participant. |
list
|
GET /v2/{parent=projects/*/conversations/*}/participants
Returns the list of all participants in the specified conversation. |
patch
|
PATCH /v2/{participant.name=projects/*/conversations/*/participants/*}
Updates the specified participant. |
REST Resource: v2.projects.conversations.participants.suggestions
Methods | |
---|---|
suggestArticles
|
POST /v2/{parent=projects/*/conversations/*/participants/*}/suggestions:suggestArticles
Gets suggested articles for a participant based on specific historical messages. |
suggestFaqAnswers
|
POST /v2/{parent=projects/*/conversations/*/participants/*}/suggestions:suggestFaqAnswers
Gets suggested faq answers for a participant based on specific historical messages. |
suggestKnowledgeAssist
|
POST /v2/{parent=projects/*/conversations/*/participants/*}/suggestions:suggestKnowledgeAssist
Gets knowledge assist suggestions based on historical messages. |
suggestSmartReplies
|
POST /v2/{parent=projects/*/conversations/*/participants/*}/suggestions:suggestSmartReplies
Gets smart replies for a participant based on specific historical messages. |
REST Resource: v2.projects.conversations.suggestions
Methods | |
---|---|
generate
|
POST /v2/{conversation=projects/*/conversations/*}/suggestions:generate
Generates all the suggestions using generators configured in the conversation profile. |
searchKnowledge
|
POST /v2/{conversation=projects/*/conversations/*}/suggestions:searchKnowledge
Get answers for the given query based on knowledge documents. |
suggestConversationSummary
|
POST /v2/{conversation=projects/*/conversations/*}/suggestions:suggestConversationSummary
Suggests summary for a conversation based on specific historical messages. |
REST Resource: v2.projects.generators
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*}/generators
Creates a generator. |
list
|
GET /v2/{parent=projects/*}/generators
Lists generators. |
REST Resource: v2.projects.knowledgeBases
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*}/knowledgeBases
Creates a knowledge base. |
delete
|
DELETE /v2/{name=projects/*/knowledgeBases/*}
Deletes the specified knowledge base. |
get
|
GET /v2/{name=projects/*/knowledgeBases/*}
Retrieves the specified knowledge base. |
list
|
GET /v2/{parent=projects/*}/knowledgeBases
Returns the list of all knowledge bases of the specified agent. |
patch
|
PATCH /v2/{knowledgeBase.name=projects/*/knowledgeBases/*}
Updates the specified knowledge base. |
REST Resource: v2.projects.knowledgeBases.documents
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/knowledgeBases/*}/documents
Creates a new document. |
delete
|
DELETE /v2/{name=projects/*/knowledgeBases/*/documents/*}
Deletes the specified document. |
export
|
POST /v2/{name=projects/*/knowledgeBases/*/documents/*}:export
Exports a smart messaging candidate document into the specified destination. |
get
|
GET /v2/{name=projects/*/knowledgeBases/*/documents/*}
Retrieves the specified document. |
import
|
POST /v2/{parent=projects/*/knowledgeBases/*}/documents:import
Creates documents by importing data from external sources. |
list
|
GET /v2/{parent=projects/*/knowledgeBases/*}/documents
Returns the list of all documents of the knowledge base. |
patch
|
PATCH /v2/{document.name=projects/*/knowledgeBases/*/documents/*}
Updates the specified document. |
reload
|
POST /v2/{name=projects/*/knowledgeBases/*/documents/*}:reload
Reloads the specified document from its specified source, content_uri or content. |
REST Resource: v2.projects.locations
Methods | |
---|---|
deleteAgent
|
DELETE /v2/{parent=projects/*/locations/*}/agent
Deletes the specified agent. |
get
|
GET /v2/{name=projects/*/locations/*}
Gets information about a location. |
getAgent
|
GET /v2/{parent=projects/*/locations/*}/agent
Retrieves the specified agent. |
getEncryptionSpec
|
GET /v2/{name=projects/*/locations/*/encryptionSpec}
Gets location-level encryption key specification. |
list
|
GET /v2/{name=projects/*}/locations
Lists information about the supported locations for this service. |
setAgent
|
POST /v2/{agent.parent=projects/*/locations/*}/agent
Creates/updates the specified agent. |
REST Resource: v2.projects.locations.agent
Methods | |
---|---|
export
|
POST /v2/{parent=projects/*/locations/*}/agent:export
Exports the specified agent to a ZIP file. |
getFulfillment
|
GET /v2/{name=projects/*/locations/*/agent/fulfillment}
Retrieves the fulfillment. |
getValidationResult
|
GET /v2/{parent=projects/*/locations/*}/agent/validationResult
Gets agent validation result. |
import
|
POST /v2/{parent=projects/*/locations/*}/agent:import
Imports the specified agent from a ZIP file. |
restore
|
POST /v2/{parent=projects/*/locations/*}/agent:restore
Restores the specified agent from a ZIP file. |
search
|
GET /v2/{parent=projects/*/locations/*}/agent:search
Returns the list of agents. |
train
|
POST /v2/{parent=projects/*/locations/*}/agent:train
Trains the specified agent. |
updateFulfillment
|
PATCH /v2/{fulfillment.name=projects/*/locations/*/agent/fulfillment}
Updates the fulfillment. |
REST Resource: v2.projects.locations.agent.entityTypes
Methods | |
---|---|
batchDelete
|
POST /v2/{parent=projects/*/locations/*/agent}/entityTypes:batchDelete
Deletes entity types in the specified agent. |
batchUpdate
|
POST /v2/{parent=projects/*/locations/*/agent}/entityTypes:batchUpdate
Updates/Creates multiple entity types in the specified agent. |
create
|
POST /v2/{parent=projects/*/locations/*/agent}/entityTypes
Creates an entity type in the specified agent. |
delete
|
DELETE /v2/{name=projects/*/locations/*/agent/entityTypes/*}
Deletes the specified entity type. |
get
|
GET /v2/{name=projects/*/locations/*/agent/entityTypes/*}
Retrieves the specified entity type. |
list
|
GET /v2/{parent=projects/*/locations/*/agent}/entityTypes
Returns the list of all entity types in the specified agent. |
patch
|
PATCH /v2/{entityType.name=projects/*/locations/*/agent/entityTypes/*}
Updates the specified entity type. |
REST Resource: v2.projects.locations.agent.entityTypes.entities
Methods | |
---|---|
batchCreate
|
POST /v2/{parent=projects/*/locations/*/agent/entityTypes/*}/entities:batchCreate
Creates multiple new entities in the specified entity type. |
batchDelete
|
POST /v2/{parent=projects/*/locations/*/agent/entityTypes/*}/entities:batchDelete
Deletes entities in the specified entity type. |
batchUpdate
|
POST /v2/{parent=projects/*/locations/*/agent/entityTypes/*}/entities:batchUpdate
Updates or creates multiple entities in the specified entity type. |
REST Resource: v2.projects.locations.agent.environments
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*/agent}/environments
Creates an agent environment. |
delete
|
DELETE /v2/{name=projects/*/locations/*/agent/environments/*}
Deletes the specified agent environment. |
get
|
GET /v2/{name=projects/*/locations/*/agent/environments/*}
Retrieves the specified agent environment. |
getHistory
|
GET /v2/{parent=projects/*/locations/*/agent/environments/*}/history
Gets the history of the specified environment. |
list
|
GET /v2/{parent=projects/*/locations/*/agent}/environments
Returns the list of all non-default environments of the specified agent. |
patch
|
PATCH /v2/{environment.name=projects/*/locations/*/agent/environments/*}
Updates the specified agent environment. |
REST Resource: v2.projects.locations.agent.environments.intents
Methods | |
---|---|
list
|
GET /v2/{parent=projects/*/locations/*/agent/environments/*}/intents
Returns the list of all intents in the specified agent. |
REST Resource: v2.projects.locations.agent.environments.users.sessions
Methods | |
---|---|
deleteContexts
|
DELETE /v2/{parent=projects/*/locations/*/agent/environments/*/users/*/sessions/*}/contexts
Deletes all active contexts in the specified session. |
detectIntent
|
POST /v2/{session=projects/*/locations/*/agent/environments/*/users/*/sessions/*}:detectIntent
Processes a natural language query and returns structured, actionable data as a result. |
REST Resource: v2.projects.locations.agent.environments.users.sessions.contexts
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*/agent/environments/*/users/*/sessions/*}/contexts
Creates a context. |
delete
|
DELETE /v2/{name=projects/*/locations/*/agent/environments/*/users/*/sessions/*/contexts/*}
Deletes the specified context. |
get
|
GET /v2/{name=projects/*/locations/*/agent/environments/*/users/*/sessions/*/contexts/*}
Retrieves the specified context. |
list
|
GET /v2/{parent=projects/*/locations/*/agent/environments/*/users/*/sessions/*}/contexts
Returns the list of all contexts in the specified session. |
patch
|
PATCH /v2/{context.name=projects/*/locations/*/agent/environments/*/users/*/sessions/*/contexts/*}
Updates the specified context. |
REST Resource: v2.projects.locations.agent.environments.users.sessions.entityTypes
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*/agent/environments/*/users/*/sessions/*}/entityTypes
Creates a session entity type. |
delete
|
DELETE /v2/{name=projects/*/locations/*/agent/environments/*/users/*/sessions/*/entityTypes/*}
Deletes the specified session entity type. |
get
|
GET /v2/{name=projects/*/locations/*/agent/environments/*/users/*/sessions/*/entityTypes/*}
Retrieves the specified session entity type. |
list
|
GET /v2/{parent=projects/*/locations/*/agent/environments/*/users/*/sessions/*}/entityTypes
Returns the list of all session entity types in the specified session. |
patch
|
PATCH /v2/{sessionEntityType.name=projects/*/locations/*/agent/environments/*/users/*/sessions/*/entityTypes/*}
Updates the specified session entity type. |
REST Resource: v2.projects.locations.agent.intents
Methods | |
---|---|
batchDelete
|
POST /v2/{parent=projects/*/locations/*/agent}/intents:batchDelete
Deletes intents in the specified agent. |
batchUpdate
|
POST /v2/{parent=projects/*/locations/*/agent}/intents:batchUpdate
Updates/Creates multiple intents in the specified agent. |
create
|
POST /v2/{parent=projects/*/locations/*/agent}/intents
Creates an intent in the specified agent. |
delete
|
DELETE /v2/{name=projects/*/locations/*/agent/intents/*}
Deletes the specified intent and its direct or indirect followup intents. |
get
|
GET /v2/{name=projects/*/locations/*/agent/intents/*}
Retrieves the specified intent. |
list
|
GET /v2/{parent=projects/*/locations/*/agent}/intents
Returns the list of all intents in the specified agent. |
patch
|
PATCH /v2/{intent.name=projects/*/locations/*/agent/intents/*}
Updates the specified intent. |
REST Resource: v2.projects.locations.agent.sessions
Methods | |
---|---|
deleteContexts
|
DELETE /v2/{parent=projects/*/locations/*/agent/sessions/*}/contexts
Deletes all active contexts in the specified session. |
detectIntent
|
POST /v2/{session=projects/*/locations/*/agent/sessions/*}:detectIntent
Processes a natural language query and returns structured, actionable data as a result. |
REST Resource: v2.projects.locations.agent.sessions.contexts
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*/agent/sessions/*}/contexts
Creates a context. |
delete
|
DELETE /v2/{name=projects/*/locations/*/agent/sessions/*/contexts/*}
Deletes the specified context. |
get
|
GET /v2/{name=projects/*/locations/*/agent/sessions/*/contexts/*}
Retrieves the specified context. |
list
|
GET /v2/{parent=projects/*/locations/*/agent/sessions/*}/contexts
Returns the list of all contexts in the specified session. |
patch
|
PATCH /v2/{context.name=projects/*/locations/*/agent/sessions/*/contexts/*}
Updates the specified context. |
REST Resource: v2.projects.locations.agent.sessions.entityTypes
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*/agent/sessions/*}/entityTypes
Creates a session entity type. |
delete
|
DELETE /v2/{name=projects/*/locations/*/agent/sessions/*/entityTypes/*}
Deletes the specified session entity type. |
get
|
GET /v2/{name=projects/*/locations/*/agent/sessions/*/entityTypes/*}
Retrieves the specified session entity type. |
list
|
GET /v2/{parent=projects/*/locations/*/agent/sessions/*}/entityTypes
Returns the list of all session entity types in the specified session. |
patch
|
PATCH /v2/{sessionEntityType.name=projects/*/locations/*/agent/sessions/*/entityTypes/*}
Updates the specified session entity type. |
REST Resource: v2.projects.locations.agent.versions
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*/agent}/versions
Creates an agent version. |
delete
|
DELETE /v2/{name=projects/*/locations/*/agent/versions/*}
Delete the specified agent version. |
get
|
GET /v2/{name=projects/*/locations/*/agent/versions/*}
Retrieves the specified agent version. |
list
|
GET /v2/{parent=projects/*/locations/*/agent}/versions
Returns the list of all versions of the specified agent. |
patch
|
PATCH /v2/{version.name=projects/*/locations/*/agent/versions/*}
Updates the specified agent version. |
REST Resource: v2.projects.locations.answerRecords
Methods | |
---|---|
list
|
GET /v2/{parent=projects/*/locations/*}/answerRecords
Returns the list of all answer records in the specified project in reverse chronological order. |
patch
|
PATCH /v2/{answerRecord.name=projects/*/locations/*/answerRecords/*}
Updates the specified answer record. |
REST Resource: v2.projects.locations.conversationDatasets
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*}/conversationDatasets
Creates a new conversation dataset. |
delete
|
DELETE /v2/{name=projects/*/locations/*/conversationDatasets/*}
Deletes the specified conversation dataset. |
get
|
GET /v2/{name=projects/*/locations/*/conversationDatasets/*}
Retrieves the specified conversation dataset. |
importConversationData
|
POST /v2/{name=projects/*/locations/*/conversationDatasets/*}:importConversationData
Import data into the specified conversation dataset. |
list
|
GET /v2/{parent=projects/*/locations/*}/conversationDatasets
Returns the list of all conversation datasets in the specified project and location. |
REST Resource: v2.projects.locations.conversationModels
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*}/conversationModels
Creates a model. |
delete
|
DELETE /v2/{name=projects/*/locations/*/conversationModels/*}
Deletes a model. |
deploy
|
POST /v2/{name=projects/*/locations/*/conversationModels/*}:deploy
Deploys a model. |
get
|
GET /v2/{name=projects/*/locations/*/conversationModels/*}
Gets conversation model. |
list
|
GET /v2/{parent=projects/*/locations/*}/conversationModels
Lists conversation models. |
undeploy
|
POST /v2/{name=projects/*/locations/*/conversationModels/*}:undeploy
Undeploys a model. |
REST Resource: v2.projects.locations.conversationModels.evaluations
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*/conversationModels/*}/evaluations
Creates evaluation of a conversation model. |
get
|
GET /v2/{name=projects/*/locations/*/conversationModels/*/evaluations/*}
Gets an evaluation of conversation model. |
list
|
GET /v2/{parent=projects/*/locations/*/conversationModels/*}/evaluations
Lists evaluations of a conversation model. |
REST Resource: v2.projects.locations.conversationProfiles
Methods | |
---|---|
clearSuggestionFeatureConfig
|
POST /v2/{conversationProfile=projects/*/locations/*/conversationProfiles/*}:clearSuggestionFeatureConfig
Clears a suggestion feature from a conversation profile for the given participant role. |
create
|
POST /v2/{parent=projects/*/locations/*}/conversationProfiles
Creates a conversation profile in the specified project. |
delete
|
DELETE /v2/{name=projects/*/locations/*/conversationProfiles/*}
Deletes the specified conversation profile. |
get
|
GET /v2/{name=projects/*/locations/*/conversationProfiles/*}
Retrieves the specified conversation profile. |
list
|
GET /v2/{parent=projects/*/locations/*}/conversationProfiles
Returns the list of all conversation profiles in the specified project. |
patch
|
PATCH /v2/{conversationProfile.name=projects/*/locations/*/conversationProfiles/*}
Updates the specified conversation profile. |
setSuggestionFeatureConfig
|
POST /v2/{conversationProfile=projects/*/locations/*/conversationProfiles/*}:setSuggestionFeatureConfig
Adds or updates a suggestion feature in a conversation profile. |
REST Resource: v2.projects.locations.conversations
Methods | |
---|---|
complete
|
POST /v2/{name=projects/*/locations/*/conversations/*}:complete
Completes the specified conversation. |
create
|
POST /v2/{parent=projects/*/locations/*}/conversations
Creates a new conversation. |
get
|
GET /v2/{name=projects/*/locations/*/conversations/*}
Retrieves the specific conversation. |
ingestContextReferences
|
POST /v2/{conversation=projects/*/locations/*/conversations/*}:ingestContextReferences
Data ingestion API. |
list
|
GET /v2/{parent=projects/*/locations/*}/conversations
Returns the list of all conversations in the specified project. |
REST Resource: v2.projects.locations.conversations.participants
Methods | |
---|---|
analyzeContent
|
POST /v2/{participant=projects/*/locations/*/conversations/*/participants/*}:analyzeContent
Adds a text (chat, for example), or audio (phone recording, for example) message from a participant into the conversation. |
create
|
POST /v2/{parent=projects/*/locations/*/conversations/*}/participants
Creates a new participant in a conversation. |
get
|
GET /v2/{name=projects/*/locations/*/conversations/*/participants/*}
Retrieves a conversation participant. |
list
|
GET /v2/{parent=projects/*/locations/*/conversations/*}/participants
Returns the list of all participants in the specified conversation. |
patch
|
PATCH /v2/{participant.name=projects/*/locations/*/conversations/*/participants/*}
Updates the specified participant. |
REST Resource: v2.projects.locations.conversations.participants.suggestions
Methods | |
---|---|
suggestArticles
|
POST /v2/{parent=projects/*/locations/*/conversations/*/participants/*}/suggestions:suggestArticles
Gets suggested articles for a participant based on specific historical messages. |
suggestFaqAnswers
|
POST /v2/{parent=projects/*/locations/*/conversations/*/participants/*}/suggestions:suggestFaqAnswers
Gets suggested faq answers for a participant based on specific historical messages. |
suggestKnowledgeAssist
|
POST /v2/{parent=projects/*/locations/*/conversations/*/participants/*}/suggestions:suggestKnowledgeAssist
Gets knowledge assist suggestions based on historical messages. |
suggestSmartReplies
|
POST /v2/{parent=projects/*/locations/*/conversations/*/participants/*}/suggestions:suggestSmartReplies
Gets smart replies for a participant based on specific historical messages. |
REST Resource: v2.projects.locations.conversations.suggestions
Methods | |
---|---|
generate
|
POST /v2/{conversation=projects/*/locations/*/conversations/*}/suggestions:generate
Generates all the suggestions using generators configured in the conversation profile. |
searchKnowledge
|
POST /v2/{conversation=projects/*/locations/*/conversations/*}/suggestions:searchKnowledge
Get answers for the given query based on knowledge documents. |
suggestConversationSummary
|
POST /v2/{conversation=projects/*/locations/*/conversations/*}/suggestions:suggestConversationSummary
Suggests summary for a conversation based on specific historical messages. |
REST Resource: v2.projects.locations.encryptionSpec
Methods | |
---|---|
initialize
|
POST /v2/{encryptionSpec.name=projects/*/locations/*/encryptionSpec}:initialize
Initializes a location-level encryption key specification. |
REST Resource: v2.projects.locations.generators
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*}/generators
Creates a generator. |
delete
|
DELETE /v2/{name=projects/*/locations/*/generators/*}
Deletes a generator. |
get
|
GET /v2/{name=projects/*/locations/*/generators/*}
Retrieves a generator. |
list
|
GET /v2/{parent=projects/*/locations/*}/generators
Lists generators. |
patch
|
PATCH /v2/{generator.name=projects/*/locations/*/generators/*}
Updates a generator. |
REST Resource: v2.projects.locations.knowledgeBases
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*}/knowledgeBases
Creates a knowledge base. |
delete
|
DELETE /v2/{name=projects/*/locations/*/knowledgeBases/*}
Deletes the specified knowledge base. |
get
|
GET /v2/{name=projects/*/locations/*/knowledgeBases/*}
Retrieves the specified knowledge base. |
list
|
GET /v2/{parent=projects/*/locations/*}/knowledgeBases
Returns the list of all knowledge bases of the specified agent. |
patch
|
PATCH /v2/{knowledgeBase.name=projects/*/locations/*/knowledgeBases/*}
Updates the specified knowledge base. |
REST Resource: v2.projects.locations.knowledgeBases.documents
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*/knowledgeBases/*}/documents
Creates a new document. |
delete
|
DELETE /v2/{name=projects/*/locations/*/knowledgeBases/*/documents/*}
Deletes the specified document. |
export
|
POST /v2/{name=projects/*/locations/*/knowledgeBases/*/documents/*}:export
Exports a smart messaging candidate document into the specified destination. |
get
|
GET /v2/{name=projects/*/locations/*/knowledgeBases/*/documents/*}
Retrieves the specified document. |
import
|
POST /v2/{parent=projects/*/locations/*/knowledgeBases/*}/documents:import
Creates documents by importing data from external sources. |
list
|
GET /v2/{parent=projects/*/locations/*/knowledgeBases/*}/documents
Returns the list of all documents of the knowledge base. |
patch
|
PATCH /v2/{document.name=projects/*/locations/*/knowledgeBases/*/documents/*}
Updates the specified document. |
reload
|
POST /v2/{name=projects/*/locations/*/knowledgeBases/*/documents/*}:reload
Reloads the specified document from its specified source, content_uri or content. |
REST Resource: v2.projects.locations.operations
Methods | |
---|---|
cancel
|
POST /v2/{name=projects/*/locations/*/operations/*}:cancel
Starts asynchronous cancellation on a long-running operation. |
get
|
GET /v2/{name=projects/*/locations/*/operations/*}
Gets the latest state of a long-running operation. |
list
|
GET /v2/{name=projects/*/locations/*}/operations
Lists operations that match the specified filter in the request. |
REST Resource: v2.projects.locations.sipTrunks
Methods | |
---|---|
create
|
POST /v2/{parent=projects/*/locations/*}/sipTrunks
Creates a SipTrunk for a specified location. |
delete
|
DELETE /v2/{name=projects/*/locations/*/sipTrunks/*}
Deletes a specified SipTrunk. |
get
|
GET /v2/{name=projects/*/locations/*/sipTrunks/*}
Retrieves the specified SipTrunk. |
list
|
GET /v2/{parent=projects/*/locations/*}/sipTrunks
Returns a list of SipTrunks in the specified location. |
patch
|
PATCH /v2/{sipTrunk.name=projects/*/locations/*/sipTrunks/*}
Updates the specified SipTrunk. |
REST Resource: v2.projects.locations.statelessSuggestion
Methods | |
---|---|
generate
|
POST /v2/{parent=projects/*/locations/*}/statelessSuggestion:generate
Generates and returns a suggestion for a conversation that does not have a resource created for it. |
REST Resource: v2.projects.locations.suggestions
Methods | |
---|---|
generateStatelessSummary
|
POST /v2/{statelessConversation.parent=projects/*/locations/*}/suggestions:generateStatelessSummary
Generates and returns a summary for a conversation that does not have a resource created for it. |
searchKnowledge
|
POST /v2/{parent=projects/*/locations/*}/suggestions:searchKnowledge
Get answers for the given query based on knowledge documents. |
REST Resource: v2.projects.operations
Methods | |
---|---|
cancel
|
POST /v2/{name=projects/*/operations/*}:cancel
Starts asynchronous cancellation on a long-running operation. |
get
|
GET /v2/{name=projects/*/operations/*}
Gets the latest state of a long-running operation. |
list
|
GET /v2/{name=projects/*}/operations
Lists operations that match the specified filter in the request. |
REST Resource: v2.projects.suggestions
Methods | |
---|---|
generateStatelessSummary
|
POST /v2/{statelessConversation.parent=projects/*}/suggestions:generateStatelessSummary
Generates and returns a summary for a conversation that does not have a resource created for it. |
searchKnowledge
|
POST /v2/{parent=projects/*}/suggestions:searchKnowledge
Get answers for the given query based on knowledge documents. |