ondewo/nlu/agent.proto

Top

File-level comment for ondewo/nlu/agent.proto.

This file contains a single service Agents.

The most important messages is Agent and its most complicated field is configs.

Services

Agents

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, Contexts, Entity Types, Webhooks, and so on to manage the flow of a conversation and match user input to predefined intents and actions.

You can create an agent using both Dialogflow Standard Edition and Dialogflow Enterprise Edition. For details, see Dialogflow Editions.

You can save your agent for backup or versioning by exporting the agent by using the ExportAgent method. You can import a saved agent by using the ImportAgent method.

Dialogflow provides several prebuilt agents for common conversation scenarios such as determining a date and time, converting currency, and so on.

For more information about agents, see the Dialogflow documentation.

Service Methods

CreateAgent

rpc CreateAgent (CreateAgentRequest) returns (Agent)
Creates the specified agent. Examples:
grpcurl -plaintext -H 'cai-token: aimp' -d '{
  "agent": {
    "display_name": "My Pizza Bot",
    "default_language_code": "en",
    "supported_language_codes": ["en"],
    "time_zone": "Europe/Vienna",
    "nlu_platform": "ONDEWO"
  }
}' localhost:50055 ondewo.nlu.Agents.CreateAgent
{ "parent": "projects/76aaf4f3-a1f6-4fda-b4b3-351c64e65bc4/agent", "display_name": "Pizza Bot", "default_language_code": "en", "supported_language_codes": [ "en" ], "time_zone": "Europe/Vienna", "nlu_platform": "ONDEWO", "owner_id": "5aac51b8-668f-49dd-913f-cc683e56af34" }

UpdateAgent

rpc UpdateAgent (UpdateAgentRequest) returns (Agent)
Updates the specified agent. Examples:
grpcurl -plaintext -H 'cai-token: aimp' -d '{
  "agent": {
    "parent": "projects/76aaf4f3-a1f6-4fda-b4b3-351c64e65bc4/agent",
    "display_name": "Pizza Bot 2",
    "supported_language_codes": ["en", "de"]
  },
  "update_mask": {
    "paths": [
      "agent.display_name",
      "agent.supported_language_codes"
    ]
  }
}' localhost:50055 ondewo.nlu.Agents.UpdateAgent
{ "parent": "projects/76aaf4f3-a1f6-4fda-b4b3-351c64e65bc4/agent", "display_name": "Pizza Bot 2", "default_language_code": "en", "supported_language_codes": [ "en", "de" ], "time_zone": "Europe/Vienna", "nlu_platform": "ONDEWO", "owner_id": "5aac51b8-668f-49dd-913f-cc683e56af34" }

GetAgent

rpc GetAgent (GetAgentRequest) returns (Agent)
Retrieves the specified agent. Examples:
grpcurl -plaintext -H 'cai-token: aimp' -d '{
  "parent": "projects/76aaf4f3-a1f6-4fda-b4b3-351c64e65bc4/agent"
}' localhost:50055 ondewo.nlu.Agents.GetAgent
{ "parent": "projects/76aaf4f3-a1f6-4fda-b4b3-351c64e65bc4/agent", "display_name": "Pizza Bot 2", "default_language_code": "en", "supported_language_codes": [ "en", "de" ], "time_zone": "Europe/Vienna", "nlu_platform": "ONDEWO", "configs": {...}, "owner_id": "5aac51b8-668f-49dd-913f-cc683e56af34" }

DeleteAgent

rpc DeleteAgent (DeleteAgentRequest) returns (.google.protobuf.Empty)
Deletes the specified agent. Examples:
grpcurl -plaintext -H 'cai-token: aimp' -d '{
  "parent": "projects/76aaf4f3-a1f6-4fda-b4b3-351c64e65bc4/agent"
}' localhost:50055 ondewo.nlu.Agents.DeleteAgent
{}

DeleteAllAgents

rpc DeleteAllAgents (.google.protobuf.Empty) returns (.google.protobuf.Empty)
Deletes all agents in the server (for development purposes only). Examples:
grpcurl -plaintext -H 'cai-token: aimp' localhost:50055 ondewo.nlu.Agents.DeleteAllAgents
{}

ListAgents

rpc ListAgents (ListAgentsRequest) returns (ListAgentsResponse)
Lists agents in the server associated to the current user Examples:
grpcurl -plaintext -H 'cai-token: aimp' localhost:50055 ondewo.nlu.Agents.ListAgents
{ "agents_with_owners": [ { "agent": { "parent": "projects/76aaf4f3-a1f6-4fda-b4b3-351c64e65bc4/agent", "display_name": "Pizza Bot 2", "owner_id": "5aac51b8-668f-49dd-913f-cc683e56af34" }, "owner": { "user_id": "5aac51b8-668f-49dd-913f-cc683e56af34", "display_name": "admin", "server_role_id": 3, "user_email": "admin@ondewo.com" } } ], "next_page_token": "current_index-1" }

ListAgentsOfUser

rpc ListAgentsOfUser (ListAgentsRequest) returns (ListAgentsOfUserResponse)
Lists agents in the server associated to the given user Examples:
grpcurl -plaintext -H 'cai-token: aimp' localhost:50055 ondewo.nlu.Agents.ListAgentsOfUser
{ "agents_of_user_with_owners": [ { "agent_with_owner": { "agent": { "parent": "projects/76aaf4f3-a1f6-4fda-b4b3-351c64e65bc4/agent", "display_name": "Pizza Bot 2", "owner_id": "5aac51b8-668f-49dd-913f-cc683e56af34" }, "owner": { "user_id": "5aac51b8-668f-49dd-913f-cc683e56af34", "display_name": "admin", "server_role_id": 3, "user_email": "admin@ondewo.com" } }, "project_role": { "role_id": 4, "name": "ADMIN" } } ], "next_page_token": "current_index-1" }

ListAllAgents

rpc ListAllAgents (ListAgentsRequest) returns (ListAgentsResponse)
Lists all agents in the server Examples:
grpcurl -plaintext -H 'cai-token: aimp' localhost:50055 ondewo.nlu.Agents.ListAllAgents
{ "agents_with_owners": [ { "agent": { "parent": "projects/76aaf4f3-a1f6-4fda-b4b3-351c64e65bc4/agent", "display_name": "Pizza Bot 2", "owner_id": "5aac51b8-668f-49dd-913f-cc683e56af34" }, "owner": { "user_id": "5aac51b8-668f-49dd-913f-cc683e56af34", "display_name": "admin", "server_role_id": 3, "user_email": "admin@ondewo.com" } } ], "next_page_token": "current_index-1" }

AddUserToProject

rpc AddUserToProject (AddUserToProjectRequest) returns (.google.protobuf.Empty)
Adds a user with specified id to the project (agent)

RemoveUserFromProject

rpc RemoveUserFromProject (RemoveUserFromProjectRequest) returns (.google.protobuf.Empty)
Removes a user with specified id from the project (agent)

ListUsersInProject

rpc ListUsersInProject (ListUsersInProjectRequest) returns (ListUsersInProjectResponse)
Lists users in the project (agent)

GetPlatformInfo

rpc GetPlatformInfo (.google.protobuf.Empty) returns (GetPlatformInfoResponse)
Gets information from the platform
Request parameter: google.protobuf.Empty

ListProjectPermissions

rpc ListProjectPermissions (ListProjectPermissionsRequest) returns (ListProjectPermissionsResponse)
List permissions from the project (agent)

TrainAgent

rpc TrainAgent (TrainAgentRequest) returns (Operation)
Trains the specified agent. Operation <response: google.protobuf.Empty, metadata: google.protobuf.Struct>

BuildCache

rpc BuildCache (BuildCacheRequest) returns (Operation)
Builds cache for the specified agent. Operation <response: google.protobuf.Empty, metadata: google.protobuf.Struct>

ExportAgent

rpc ExportAgent (ExportAgentRequest) returns (Operation)
Exports the specified agent to a ZIP file.
Operation <response: ExportAgentResponse, metadata: google.protobuf.Struct>

ExportBenchmarkAgent

rpc ExportBenchmarkAgent (ExportBenchmarkAgentRequest) returns (Operation)
Exports the specified train agent to a ZIP file after train-test split, returns the test TrainingPhrase list.

ImportAgent

rpc ImportAgent (ImportAgentRequest) returns (Operation)
Imports the specified agent from a ZIP file.
Uploads new intents and entity types without deleting the existing ones. Intents and entity types with the same name are replaced with the new versions from ImportAgentRequest.
Operation <response: google.protobuf.Empty, metadata: google.protobuf.Struct>

MigrateAgent

rpc MigrateAgent (MigrateAgentRequest) returns (Operation)

OptimizeRankingMatch

rpc OptimizeRankingMatch (OptimizeRankingMatchRequest) returns (Operation)

RestoreAgent

rpc RestoreAgent (RestoreAgentRequest) returns (Operation)
Restores the specified agent from a ZIP file.
Replaces the current agent version with a new one. All the intents and entity types in the older version are deleted.
Operation <response: google.protobuf.Empty, metadata: google.protobuf.Struct>

GetAgentStatistics

rpc GetAgentStatistics (GetAgentStatisticsRequest) returns (GetAgentStatisticsResponse)
Gets statistics for the agent

GetSessionsStatistics

rpc GetSessionsStatistics (GetSessionsStatisticsRequest) returns (GetSessionsStatisticsResponse)

SetAgentStatus

rpc SetAgentStatus (SetAgentStatusRequest) returns (Agent)
Sets status for the agent

SetResources

rpc SetResources (SetResourcesRequest) returns (.google.protobuf.Empty)
Sets resources

DeleteResources

rpc DeleteResources (DeleteResourcesRequest) returns (.google.protobuf.Empty)
Deletes resources

ExportResources

rpc ExportResources (ExportResourcesRequest) returns (ExportResourcesResponse)
Exports resources

GetModelStatuses

rpc GetModelStatuses (GetModelStatusesRequest) returns (GetModelStatusesResponse)
Get statuses of models related to project

GetPlatformMapping

rpc GetPlatformMapping (GetPlatformMappingRequest) returns (PlatformMapping)
Get all set platform name mappings for an Agent

SetPlatformMapping

rpc SetPlatformMapping (PlatformMapping) returns (PlatformMapping)
Set platform name mappings for an Agent

GetFullTextSearchEntityType

rpc GetFullTextSearchEntityType (FullTextSearchRequest) returns (FullTextSearchResponseEntityType)
Full text search endpoint in entity types

GetFullTextSearchEntity

rpc GetFullTextSearchEntity (FullTextSearchRequest) returns (FullTextSearchResponseEntity)
Full text search endpoint in entities

GetFullTextSearchEntitySynonym

rpc GetFullTextSearchEntitySynonym (FullTextSearchRequest) returns (FullTextSearchResponseEntitySynonym)
Full text search endpoint in entity synonyms

GetFullTextSearchIntent

rpc GetFullTextSearchIntent (FullTextSearchRequest) returns (FullTextSearchResponseIntent)
Full text search endpoint in intents

GetFullTextSearchIntentContextIn

rpc GetFullTextSearchIntentContextIn (FullTextSearchRequest) returns (FullTextSearchResponseIntentContextIn)
Full text search endpoint in context ins of intents

GetFullTextSearchIntentContextOut

rpc GetFullTextSearchIntentContextOut (FullTextSearchRequest) returns (FullTextSearchResponseIntentContextOut)
Full text search endpoint in context outs of intents

GetFullTextSearchIntentUsersays

rpc GetFullTextSearchIntentUsersays (FullTextSearchRequest) returns (FullTextSearchResponseIntentUsersays)
Full text search endpoint in user says of intents

GetFullTextSearchIntentTags

rpc GetFullTextSearchIntentTags (FullTextSearchRequest) returns (FullTextSearchResponseIntentTags)
Full text search endpoint in tags of intents

GetFullTextSearchIntentResponse

rpc GetFullTextSearchIntentResponse (FullTextSearchRequest) returns (FullTextSearchResponseIntentResponse)
Full text search endpoint in responses of intents

GetFullTextSearchIntentParameters

rpc GetFullTextSearchIntentParameters (FullTextSearchRequest) returns (FullTextSearchResponseIntentParameters)
Full text search endpoint in parameters of intents

ReindexAgent

rpc ReindexAgent (ReindexAgentRequest) returns (Operation)
Force reindexing Intent and Entity data of Agent

Methods with HTTP bindings

Method Name Method Pattern Body
CreateAgent POST /v2/projects *
UpdateAgent PATCH /v2/{agent.parent=projects/*/agent} *
GetAgent GET /v2/{parent=projects/*/agent}
DeleteAgent DELETE /v2/{parent=projects/*/agent}
DeleteAllAgents DELETE /v2/projects
ListAgents GET /v2/projects
ListAgentsOfUser GET /v2/projects
ListAllAgents GET /v2/projects:all
AddUserToProject POST /v2/{parent=projects/*/agent}/users/{user_id=*} *
RemoveUserFromProject DELETE /v2/{parent=projects/*/agent}/users/{user_id=*}
ListUsersInProject GET /v2/{parent=projects/*/agent}/users
GetPlatformInfo GET /v2/version
ListProjectPermissions GET /v2/project_permissions
TrainAgent POST /v2/{parent=projects/*/agent}:train *
BuildCache POST /v2/{parent=projects/*/agent}:build_cache *
ExportAgent POST /v2/{parent=projects/*/agent}:export *
ExportBenchmarkAgent POST /v2/{parent=projects/*/agent}:export_benchmark *
ImportAgent POST /v2/{parent=projects/*/agent}:import *
MigrateAgent POST /v2/{parent=projects/*/agent}:migrate *
OptimizeRankingMatch POST /v2/{parent=projects/*/agent}:optimize_ranking_match *
RestoreAgent POST /v2/{parent=projects/*/agent}:restore *
GetAgentStatistics GET /v2/{parent=projects/*/agent}:statistics
GetSessionsStatistics GET /v2/{parent=projects/*/agent}:session_statistics
SetAgentStatus POST /v2/{parent=projects/*/agent}:status *
SetResources POST /v2/{parent=projects/*/agent}:resources *
DeleteResources DELETE /v2/{parent=projects/*/agent}:resources
ExportResources POST /v2/{parent=projects/*/agent}:resources *
Messages

AddUserToProjectRequest

Request to add user to project.

FieldTypeLabelDescription
parent string

Required. The project that the agent to train is associated with. Format:

projects/<project_uuid>

user_id string

id of the user

project_role_id uint32

ID of the project role of the user

Agent

Project/Agent messages

FieldTypeLabelDescription
parent string

Required. The project of this agent. Format:

projects/<project_uuid>/agent
Read-only in the Agent message

display_name string

Required. The name of this agent.

default_language_code string

Required. The default language of the agent as a language tag. See Language Support for a list of the currently supported language codes. This field cannot be set by the Update method.

supported_language_codes string repeated

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

time_zone string

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

nlu_platform string

Required. Specifies the format of the agent data.

configs google.protobuf.Struct

Optional. Agent configuration as OndewoConfig converted to Struct format.

owner_id string

Optional. User id of the project owner. If empty, in CreateAgent call it is set to user id in the call metadata. Read-only in the Agent message

status AgentStatus

Optional. Status of the agent Read-only in the Agent message

description string

Optional. Description of the agent.

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

AgentOfUserWithOwner

This message contains the agent of user with owner

FieldTypeLabelDescription
agent_with_owner AgentWithOwner

Required. Agent message and User message of its owner.

project_role ProjectRole

Required. The role of the user in the project in SHALLOW view (only ID and name fields are populated)

AgentSorting

Sorting order of agent

FieldTypeLabelDescription
sorting_field AgentSorting.AgentSortingField

sorting field for agent sorting

sorting_mode SortingMode

Sorting mode

AgentWithOwner

This message contains the agent with owner

FieldTypeLabelDescription
agent Agent

The agent

owner User

User who created the agent

BuildCacheRequest

The request message for Agents.TrainAgentBuildCache.

FieldTypeLabelDescription
parent string

Required. The project that the agent to build cache is associated with. Format:

projects/<project_uuid>

branch string

Name of the branch of the agent for versioning. The default branch name is develop.

CreateAgentRequest

Request to create an agent

FieldTypeLabelDescription
agent Agent

The agent

agent_view AgentView

Optional. Specify the view of the returned agent (sparse view by default)

CustomPlatformInfo

This message contains the information of custom platform

FieldTypeLabelDescription
platform Intent.Message.Platform

Required. ID of the Platform. Custom Intent.Message.Platform placeholder. Note: it will not work with non-placeholders values

display_name string

Required. Name to be displayed.

position uint32

Optional. Sorting position of the GetPlatformMappingRequest.

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

DeleteAgentRequest

Request to delete the agent

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

DeleteResourcesRequest

Request to delete resources

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

name string

Required. Name of the resource to delete.

type string

Required. Type of the resource (e.g., "audio", "image", "file").

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

ExportAgentRequest

The request message for Agents.ExportAgent.

FieldTypeLabelDescription
parent string

Required. The project that the agent to export is associated with. Format:

projects/<project_uuid>

agent_uri string

Optional. The Google Cloud Storage URI to export the agent to. Note: The URI must start with "gs://". If left unspecified, the serialized agent is returned inline.

compression_level int32

Optional. The compression level of the zip file created. Valid range 1-9; the grpc-default value 0 will be mapped to 1, other values cause an error in the request validation handler.

ExportAgentResponse

The response message for Agents.ExportAgent.

FieldTypeLabelDescription
agent_uri string

The URI to a file containing the exported agent. This field is populated only if agent_uri is specified in ExportAgentRequest.

agent_content bytes

The exported agent. Example for how to export an agent to a zip file via a command line:

curl \
  'https://dialogflow.googleapis.com/v2/projects//agent:export'\
  -X POST \
  -H 'Authorization: Bearer '$(gcloud auth print-access-token) \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --compressed \
  --data-binary '{}' \
| grep agentContent | sed -e 's/.*"agentContent": "\([^"]*\)".*/\1/' \
| base64 --decode > 

ExportBenchmarkAgentRequest

Request to export benchmark agent

FieldTypeLabelDescription
parent string

Agent related info Required. The project that the agent to export is associated with. Format:

projects/<project_uuid>

compression_level int32

Optional. The compression level of the zip file created. Valid range 1-9; the grpc-default value 0 will be mapped to 1, other values cause an error in the request validation handler.

test_size float

Train-test split related parameters, for further info, check https://scikit-learn.org/stable/modules/generated/sklearn.model_selection.train_test_split.html default values come from API definition above Optional: bigger than zero

train_size float

Optional: bigger than zero

random_state int32

Optional: random seed

ExportBenchmarkAgentResponse

Response to export benchmark agent

FieldTypeLabelDescription
agent_content bytes

Agent responses as zip file

training_phrases ExportBenchmarkAgentResponse.TrainingPhrasesEntry repeated

Key is the language code, value is the corresponding ListTrainingPhrasesResponse

ExportBenchmarkAgentResponse.TrainingPhrasesEntry

FieldTypeLabelDescription
key string

value ListTrainingPhrasesResponse

ExportResourcesRequest

Request to export resources

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

name string

Required. Name of the resource to export.

type string

Required. Type of the resource (e.g., "audio", "image", "file").

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

ExportResourcesResponse

Response to export resources

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

name string

Required. Name of the exported resource.

type string

Required. Type of the resource (e.g., "audio", "image", "file").

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

resource_file bytes

Required. The exported resource file content as bytes.

FullTextSearchRequest

This message is a request to run full text search

FieldTypeLabelDescription
parent string

Required. The project that the agent is associated with. Format:

projects/<project_uuid>/agent

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

term string

What to search for in the elastic server

page_token string

Composite string: current_index-0--page_size-10 The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

FullTextSearchResponseEntity

This message is a response of full text search of entity

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

entity_results FullTextSearchResponseEntity.EntitySearchResult repeated

List of entity search results

term string

Search term used in the query

elastic_query string

Elasticsearch query that was executed

time float

Time taken to execute the query in seconds

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

FullTextSearchResponseEntity.EntitySearchResult

Search result for an entity

FieldTypeLabelDescription
name string

Name of the entity

display_name string

Display name of the entity

entity_type_name string

Name of the entity type this entity belongs to

entity_type_display_name string

Display name of the entity type

language string

Language code of the entity

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

FullTextSearchResponseEntitySynonym

This message is a response of full text search of synonym entity

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

entity_synonym_results FullTextSearchResponseEntitySynonym.EntitySynonymSearchResult repeated

List of entity synonym search results

term string

Search term used in the query

elastic_query string

Elasticsearch query that was executed

time float

Time taken to execute the query in seconds

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

FullTextSearchResponseEntitySynonym.EntitySynonymSearchResult

Search result for an entity synonym

FieldTypeLabelDescription
name string

Name of the entity synonym

display_name string

Display name of the entity synonym

entity_type_name string

Name of the entity type

entity_type_display_name string

Display name of the entity type

entity_name string

Name of the entity this synonym belongs to

entity_display_name string

Display name of the entity

language string

Language code of the entity synonym

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

FullTextSearchResponseEntityType

This message is a response of full text search of entity type

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

entity_type_results FullTextSearchResponseEntityType.EntityTypeSearchResult repeated

List of entity type search results

term string

Search term used in the query

elastic_query string

Elasticsearch query that was executed

time float

Time taken to execute the query in seconds

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

FullTextSearchResponseEntityType.EntityTypeSearchResult

Search result for an entity type

FieldTypeLabelDescription
name string

Name of the entity type

display_name string

Display name of the entity type

language string

Language code of the entity type

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

FullTextSearchResponseIntent

This message is a response of full text search of intent

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

intent_results FullTextSearchResponseIntent.IntentSearchResult repeated

List of intent search results

term string

Search term used in the query

elastic_query string

Elasticsearch query that was executed

time float

Time taken to execute the query in seconds

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

FullTextSearchResponseIntent.IntentSearchResult

Search result for an intent

FieldTypeLabelDescription
name string

Name of the intent

display_name string

Display name of the intent

domain_name string

Domain name of the intent

tags string repeated

Tags associated with the intent

language string

Language code of the intent

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

FullTextSearchResponseIntentContextIn

This message is a response of full text search of intent with context in

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

intent_context_in_results FullTextSearchResponseIntentContextIn.IntentContextInSearchResult repeated

List of intent input context search results

term string

Search term used in the query

elastic_query string

Elasticsearch query that was executed

time float

Time taken to execute the query in seconds

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

FullTextSearchResponseIntentContextIn.IntentContextInSearchResult

Search result for an intent input context

FieldTypeLabelDescription
name string

Name of the input context

intent_name string

Name of the intent this context belongs to

intent_display_name string

Display name of the intent

tags string repeated

Tags associated with the intent

language string

Language code of the context

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

FullTextSearchResponseIntentContextOut

This message is a response of full text search of intent with context out

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

intent_context_out_results FullTextSearchResponseIntentContextOut.IntentContextOutSearchResult repeated

List of intent output context search results

term string

Search term used in the query

elastic_query string

Elasticsearch query that was executed

time float

Time taken to execute the query in seconds

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

FullTextSearchResponseIntentContextOut.IntentContextOutSearchResult

Search result for an intent output context

FieldTypeLabelDescription
name string

Name of the output context

intent_name string

Name of the intent this context belongs to

intent_display_name string

Display name of the intent

tags string repeated

Tags associated with the intent

language string

Language code of the context

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

FullTextSearchResponseIntentParameters

This message is a response of full text search of intent with parameters

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

intent_parameters_results FullTextSearchResponseIntentParameters.IntentParametersSearchResult repeated

List of intent parameter search results

term string

Search term used in the query

elastic_query string

Elasticsearch query that was executed

time float

Time taken to execute the query in seconds

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

FullTextSearchResponseIntentParameters.IntentParametersSearchResult

Search result for an intent parameter

FieldTypeLabelDescription
parameter_name string

Name of the parameter

parameter_display_name string

Display name of the parameter

intent_name string

Name of the intent this parameter belongs to

intent_display_name string

Display name of the intent

tags string repeated

Tags associated with the intent

language string

Language code of the parameter

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

FullTextSearchResponseIntentResponse

This message is a response of full text search of intent response

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

intent_response_results FullTextSearchResponseIntentResponse.IntentResponseSearchResult repeated

List of intent response search results

term string

Search term used in the query

elastic_query string

Elasticsearch query that was executed

time float

Time taken to execute the query in seconds

next_page_token string

The next_page_token is used to retrieve the next page of a returned result. The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

FullTextSearchResponseIntentResponse.IntentResponseSearchResult

Search result for an intent response

FieldTypeLabelDescription
text string

Text content of the response

platform string

Platform for which this response is intended

response_type string

Type of the response

intent_name string

Name of the intent this response belongs to

intent_display_name string

Display name of the intent

tags string repeated

Tags associated with the intent

language string

Language code of the response

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

FullTextSearchResponseIntentTags

This message is a response of full text search of intent with tags

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

intent_tags_results FullTextSearchResponseIntentTags.IntentTagsSearchResult repeated

List of intent tag search results

term string

Search term used in the query

elastic_query string

Elasticsearch query that was executed

time float

Time taken to execute the query in seconds

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

FullTextSearchResponseIntentTags.IntentTagsSearchResult

Search result for an intent tag

FieldTypeLabelDescription
name string

Name of the tag

text string

Text content of the tag

intent_name string

Name of the intent this tag belongs to

intent_display_name string

Display name of the intent

tags string repeated

Tags associated with the intent

language string

Language code of the tag

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

FullTextSearchResponseIntentUsersays

This message is a response of full text search of intent with sentence

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

intent_usersays_results FullTextSearchResponseIntentUsersays.IntentUsersaysSearchResult repeated

List of intent training phrase search results

term string

Search term used in the query

elastic_query string

Elasticsearch query that was executed

time float

Time taken to execute the query in seconds

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

FullTextSearchResponseIntentUsersays.IntentUsersaysSearchResult

Search result for an intent training phrase (user says)

FieldTypeLabelDescription
name string

Name of the training phrase

text string

Text of the training phrase

text_as_entity_types string

Text with entity types annotated

text_as_entity_values string

Text with entity values annotated

type string

Type of the training phrase part

intent_name string

Name of the intent this training phrase belongs to

intent_display_name string

Display name of the intent

tags string repeated

Tags associated with the intent

language string

Language code of the training phrase

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

GetAgentRequest

The request message for Agents.GetAgent.

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

agent_view AgentView

Optional. Specify the view of the returned agent (full view by default)

field_mask google.protobuf.FieldMask

Optional. A mask to control which fields are returned in the response.

GetAgentStatisticsRequest

Request statistics of the agent

FieldTypeLabelDescription
parent string

Required. The project to get statistics from. Format:

projects/<project_uuid>

format ReportFormat

File formats for reports

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc. the language to calculate statistics about

type ReportType

Type of reports about the domain of the agent

GetAgentStatisticsResponse

Response to get statistics of the agent

FieldTypeLabelDescription
reports bytes

Statistic info.

format ReportFormat

File formats for reports

type ReportType

Type of reports about the domain of the agent

GetModelStatusesRequest

Request to get model statuses

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agent

cache_version int32

Optional. Cache version to filter model statuses. If not specified, returns statuses for all cache versions.

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

model_name string

Optional. Model name to filter model statuses. If not specified, returns statuses for all models.

GetModelStatusesResponse

Response to get model statuses

FieldTypeLabelDescription
model_statuses ModelStatus repeated

List of model statuses matching the request filters.

GetPlatformInfoResponse

GIT information about the version of the server

FieldTypeLabelDescription
version string

version of the server build

commit_hash string

git commit hash of the server build

GetPlatformMappingRequest

Request to get platform mapping

FieldTypeLabelDescription
parent string

Required. The project that the agent is associated with. Format:

projects/<project_uuid>/agent

GetSessionsStatisticsRequest

Request of the report of the statistics about sessions

FieldTypeLabelDescription
parent string

Required. The project to get statistics from. Format:

projects/<project_uuid>

format ReportFormat

File formats for reports

type SessionsReportType

Type of reports about the domain of the agent

session_filter SessionFilter

Optional. A filter to narrow reports based on sessions

context_filters ContextFilter repeated

Optional. A filter to narrow reports based on contextual information (Coming soon! Not yet implemented)

limit int32

Optional. limit the returned number of results

group_bys string repeated

Optional. Grouping based on named properties

order_bys string repeated

Optional. Order based on named properties

field_mask google.protobuf.FieldMask

Optional. The mask to control which data fields will be added to the returned data.
Example: paths=["duration_in_s_min", "id", "session_id", "project_id"]

sql_query string

SQL Query - only usable with specific SessionsReportType such as SessionsReportType.SESSION_SQL_QUERY

GetSessionsStatisticsResponse

Report of the statistics about sessions

FieldTypeLabelDescription
reports bytes

Statistic info.

format ReportFormat

File formats for reports

type SessionsReportType

Type of reports about the domain of the agent

ImportAgentRequest

The request message for Agents.ImportAgent.

FieldTypeLabelDescription
parent string

Required. The project that the agent to import is associated with. Format:

projects/<project_uuid>

agent_uri string

The URI to a Google Cloud Storage file containing the agent to import. Note: The URI must start with "gs://".

agent_content bytes

The agent to import.
Example for how to import an agent via the command line:

curl \
  'https://dialogflow.googleapis.com/v2/projects//agent:import\
   -X POST \
   -H 'Authorization: Bearer '$(gcloud auth print-access-token) \
   -H 'Accept: application/json' \
   -H 'Content-Type: application/json' \
   --compressed \
   --data-binary "{
      'agentContent': '$(cat  | base64 -w 0)'
   }"

ListAgentsOfUserResponse

Get list of agents of user

FieldTypeLabelDescription
agents_of_user_with_owners AgentOfUserWithOwner repeated

The list of agents with their owners of the given user. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

ListAgentsRequest

Request to get the list of agents

FieldTypeLabelDescription
agent_view AgentView

Optional. Specify the view of the returned agent (full view by default)

page_token string

Optional. The next_page_token value returned from a previous list request.

sort_by_field AgentSorting

Optional. Defines the sorting of the list. Default, no sorting.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListAgentsResponse

Get list of agents

FieldTypeLabelDescription
agents_with_owners AgentWithOwner repeated

The list of agent and their owners. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

ListProjectPermissionsRequest

Project permissions

FieldTypeLabelDescription
page_token string

Optional. The next_page_token value returned from a previous list request. The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListProjectPermissionsResponse

List project permissions

FieldTypeLabelDescription
permissions string repeated

The list of project permissions. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

ListUsersInProjectRequest

Request to list users in the project

FieldTypeLabelDescription
parent string

Required. The project that the agent to train is associated with. Format:

projects/<project_uuid>

page_token string

Optional. The next_page_token value returned from a previous list request. The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListUsersInProjectResponse

List the users in a project

FieldTypeLabelDescription
users UserInProject repeated

The list of users in a project. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

MigrateAgentRequest

Request to migrate an agent

FieldTypeLabelDescription
agent_content bytes

The agent to migrate as zip file

ModelStatus

Status of model

FieldTypeLabelDescription
cache_version int32

Cache version that contains the correspondent model

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

model_name string

The model name

status_set_time google.protobuf.Timestamp

Timestamp when the status was set. Read-only field.

config string

Configuration of the model as a string.

status ModelStatus.StatusName

Current status of the model.

OptimizeRankingMatchRequest

This message is a request to run Optimize Ranking Match

FieldTypeLabelDescription
parent string

Required. The project that the agent to train is associated with. Format:

projects/<project_uuid>

language_codes string repeated

languages that should be optimized

optimization_configs RankingMatchOptimizationConfig repeated

optimization config will contain all possible optimizations, with which we will come up in the future

in_place bool

if in_place is true then the config of the agent on the server will be updated, if False then config with optimized thresholds will be returned but not updated on the server

OptimizeRankingMatchResponse

This message is a response of Optimize Ranking Match

FieldTypeLabelDescription
optimization_info google.protobuf.Struct

info about optimization

optimized_ondewo_config google.protobuf.Struct

the optimized configuration of the ondewo agent e.g., optimized parameters

PlatformMapping

This message contains the mapping of platform

FieldTypeLabelDescription
parent string

Required. The project that the agent is associated with. Format:

projects/<project_uuid>/agent

platform_info CustomPlatformInfo repeated

Required. If not set, it will set it empty.

RankingMatchOptimizationConfig

This message contains the configuration to run Optimize Ranking Match

FieldTypeLabelDescription
language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

n_splits int32

number of splits for optimization

random_seed int32

random seed number for defining the split of train and test of training phrases for optimization

initial_thresholds google.protobuf.Struct

initial thresholds are optional, if not given will be taken from the current config
example {'OndewoIntentSimilarityMatch': 0.59, 'OndewoIntentNamedSimilarityMatch': 0.39}

ReindexAgentRequest

This message is a request to reindex agent

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

branch_name string

Optional, useful for versioning reasons of the agent data

index_types FullTextSearchRequest.QueryType repeated

Optional, useful for reindexing specific indices in the future

RemoveUserFromProjectRequest

Request to remove user from the project.

FieldTypeLabelDescription
parent string

Required. The project that the agent to train is associated with. Format:

projects/<project_uuid>

user_id string

id of the user

RestoreAgentRequest

The request message for Agents.RestoreAgent.

FieldTypeLabelDescription
parent string

Required. The project that the agent to restore is associated with. Format:

projects/<project_uuid>

agent_uri string

The URI to a Google Cloud Storage file containing the agent to restore. Note: The URI must start with "gs://".

agent_content bytes

The agent to restore.
Example for how to restore an agent via the command line:

curl \
  'https://dialogflow.googleapis.com/v2/projects//agent:restore\
   -X POST \
   -H 'Authorization: Bearer '$(gcloud auth print-access-token) \
   -H 'Accept: application/json' \
   -H 'Content-Type: application/json' \
   --compressed \
   --data-binary "{
       'agentContent': '$(cat  | base64 -w 0)'
   }" \

SetAgentStatusRequest

Request to set status of the agent

FieldTypeLabelDescription
parent string

Required. The project of which to set the status. Format:

projects/<project_uuid>/agent

status AgentStatus

Required. Status of the agent

agent_view AgentView

Optional. View of the returned agent

SetResourcesRequest

Request to set resources

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

name string

Required. Name of the resource.

type string

Required. Type of the resource (e.g., "audio", "image", "file").

resource_file bytes

Required. The resource file content as bytes.

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

TrainAgentRequest

The request message for Agents.TrainAgent.

FieldTypeLabelDescription
parent string

Required. The project that the agent to train is associated with. Format:

projects/<project_uuid>

branch string

Name of the branch of the agent for versioning. The default branch name is develop.

initiation_protocol InitiationProtocol

Defines when to initiate newly created agent when training started

UpdateAgentRequest

Request to update the agent

FieldTypeLabelDescription
agent Agent

The agent

agent_view AgentView

Optional. Specify the view of the returned agent (sparse view by default)

update_mask google.protobuf.FieldMask

Optional. The mask to control which fields get updated.

UserInProject

Request to get user in project

FieldTypeLabelDescription
parent string

Required. The project that the agent to train is associated with. Format:

projects/<project_uuid>

user User

User object

role_id uint32

ID of the project role of the user

Enums

AgentSorting.AgentSortingField

Sorting field

NameNumberDescription
NO_AGENT_SORTING 0

no sorting

SORT_AGENT_BY_NAME 1

sorting by name

SORT_AGENT_BY_CREATION_DATE 2

sorting by creation date

SORT_AGENT_BY_LAST_UPDATED 3

sorting by last updated date

SORT_AGENT_BY_OWNER_NAME 4

sorting by owner, i.e. user who owns the agent which is usually the creator of the agent

AgentStatus

Type of Agent / Project status

NameNumberDescription
ACTIVE 0

If project is active, all its endpoints are active

INACTIVE 1

If project is inactive:

  • members of the project do not see the project anymore except users with project role "PROJECT_ADMIN" and users with server role "SERVER_ADMIN"
  • nothing is allowed (no endpoint) on the project except "SetAgentStatus" by PROJECT_ADMIN or SERVER_ADMIN

AgentView

Structure of agent view

NameNumberDescription
AGENT_VIEW_UNSPECIFIED 0

Unspecified agent view: the view is defined by the call:

  • CreateAgent: AGENT_VIEW_SHALLOW
  • UpdateAgent: AGENT_VIEW_SHALLOW
  • GetAgent: AGENT_VIEW_FULL
  • ListAgents: AGENT_VIEW_SHALLOW

AGENT_VIEW_FULL 1

Full agent view: populate all the fields of the Agent message including configs.

AGENT_VIEW_SHALLOW 2

Shallow agent view: populates all the fields except configs.

AGENT_VIEW_MINIMUM 3

Minimum view including only agent UUID and agent display name

FullTextSearchRequest.QueryType

Type of query

NameNumberDescription
ALL 0

Placeholder value, has to start with zero

OndewoEntityQuery 1

Query for entities

OndewoEntityTypeQuery 2

Query for entity types

OndewoEntitySynonymQuery 3

Query for entity synonyms

OndewoIntentQuery 4

Query for intents

OndewoIntentContextInQuery 5

Query for intent input contexts

OndewoIntentContextOutQuery 6

Query for intent output contexts

OndewoIntentUsersaysQuery 7

Query for intent training phrases (user says)

OndewoIntentTagsQuery 8

Query for intent tags

OndewoIntentParametersQuery 9

Query for intent parameters

OndewoIntentResponseQuery 10

Query for intent responses

InitiationProtocol

Defines when to initiate newly created agent when training started

NameNumberDescription
AS_SOON_AS_POSSIBLE 0

after cache successfully built and after each model trained the agent will be updated

WHEN_TRAINED 1

after cache successfully built and all the active models successfully trained

NEVER 2

do not initiate

ModelStatus.StatusName

Status name of the model.

NameNumberDescription
UNKNOWN 0

Unknown status

INITIALIZING 1

Model is initializing

INITIALIZED 2

Model has been initialized

LOADING_DATA 3

Model is loading data

TRAINING 4

Model is training

TESTING 5

Model is being tested

TRAINED 6

Model training is complete

ReportFormat

File formats for reports

NameNumberDescription
CSV 0

CSV (comma separated values) file format

HTML 1

HTML file format

JSON 2

JSON file format

ReportType

Type of reports about the domain of the agent

NameNumberDescription
ALL 0

will return all reports as files of specified format compressed into a single zipfile

INTENT_PER_LANGUAGE 1

statistics of the language specific part of the intent database

ENTITY_PER_LANGUAGE 2

statistics of the language specific part of the entity database

ENTITY_COLLISION 3

report on collision of the entity synonyms

INTENT_GENERAL 4

report of statistics of the general (relevant to all supported languages) part of intent database

SessionsReportType

Type of reports about the domain of the agent

NameNumberDescription
SESSIONS 0

report on sessions. Supports SessionFilter to filter

SESSION_STEPS 1

report on session steps. Supports SessionFilter to filter

SESSION_TOP_X_INTENTS 2

report top x detected intents in session. Supports SessionFilter to filter

SESSION_TOP_X_ENTITY_TYPES 3

report top x detected entity types. Supports SessionFilter to filter

SESSION_TOP_X_ENTITY_VALUES 4

report top x detected entity values Supports SessionFilter to filter

SESSION_TOP_X_USERS 5

report top x users. Supports SessionFilter to filter (Coming soon! Not yet implemented)

SESSION_TOP_X_LABELS 6

report top x labels. Supports SessionFilter to filter

SESSION_TOP_X_TAGS 7

report top x tags. Supports SessionFilter to filter

SESSION_TOP_X_PHONE_NUMBERS 8

report top x phone_numbers. Supports SessionFilter to filter (Coming soon! Not yet implemented)

SESSION_HUMAN_HANDOVERS 9

report on human handovers. Supports SessionFilter to filter (Coming soon! Not yet implemented)

SESSION_SQL_QUERY 10

report based on a query issued tables with session information. Requires to define sql_query in request. Allowed tables to query are:

  • session
  • session_context
  • session_step
  • session_step_context
  • session_step_detect_entity
  • session_step_detect_intent
  • session_step_detect_intent_context_in
  • session_step_detect_intent_context_out
  • session_step_detect_intent_context_out
  • session_step_detect_intent_label
  • session_step_detect_intent_tag
Example:
SELECT ... FROM session
SELECT ... FROM session, session_steps

SESSION_LEAST_X_INTENTS 11

report least x detected intents in session. Supports SessionFilter to filter

SESSION_LEAST_X_ENTITY_TYPES 12

report least x detected entity types. Supports SessionFilter to filter

SESSION_LEAST_X_ENTITY_VALUES 13

report least x detected entity values Supports SessionFilter to filter

SESSION_LEAST_X_USERS 14

report least x users. Supports SessionFilter to filter (Coming soon! Not yet implemented)

SESSION_LEAST_X_LABELS 15

report least x labels. Supports SessionFilter to filter

SESSION_LEAST_X_TAGS 16

report least x tags. Supports SessionFilter to filter

TOTAL_STATISTICS 17

report total numbers of e.g. sessions, session steps, etc.

ondewo/nlu/aiservices.proto

Top

Services

AiServices

The Central class defining the ondewo ai services

Service Methods

ExtractEntities

rpc ExtractEntities (ExtractEntitiesRequest) returns (ExtractEntitiesResponse)
Processes a natural language query and returns detected entities

GenerateUserSays

rpc GenerateUserSays (GenerateUserSaysRequest) returns (GenerateUserSaysResponse)
Generates a list of training phrases

GenerateResponses

rpc GenerateResponses (GenerateResponsesRequest) returns (GenerateResponsesResponse)
Generate responses from all intents using synonyms

GetAlternativeSentences

rpc GetAlternativeSentences (GetAlternativeSentencesRequest) returns (GetAlternativeSentencesResponse)
Generates alternative phrase based on original phrase

GetAlternativeTrainingPhrases

rpc GetAlternativeTrainingPhrases (GetAlternativeTrainingPhrasesRequest) returns (GetAlternativeTrainingPhrasesResponse)
Generates alternative training phrase based on original training phrase

GetSynonyms

rpc GetSynonyms (GetSynonymsRequest) returns (GetSynonymsResponse)
Generates synonyms for a certain word

ClassifyIntents

rpc ClassifyIntents (ClassifyIntentsRequest) returns (ClassifyIntentsResponse)
Preprocess text and detects intents in a sentence

ExtractEntitiesFuzzy

rpc ExtractEntitiesFuzzy (ExtractEntitiesFuzzyRequest) returns (ExtractEntitiesResponse)
Processes a natural language query and returns detected entities

LlmGenerate

rpc LlmGenerate (LlmGenerateRequest) returns (LlmGenerateResponse)
Generates a single response from a Large Language Model (LLM). This RPC method allows a client to make a request to the LLM and receive a single complete response based on the input parameters provided.

StreamingLlmGenerate

rpc StreamingLlmGenerate (LlmGenerateRequest) returns (stream StreamingLlmGenerateResponse)
Generates a response from the LLM in a streaming format. This RPC allows continuous streaming of responses from the model, which is useful for real-time applications or large outputs.

ListLlmModels

rpc ListLlmModels (ListLlmModelsRequest) returns (ListLlmModelsResponse)
Lists available Large Language Models (LLMs) for a specified CCAI service. This RPC method allows clients to retrieve metadata about all LLM models associated with a particular service within a project, including model names, descriptions, and providers.

Methods with HTTP bindings

Method Name Method Pattern Body
ExtractEntities POST /v2/{parent=projects/*/agent}/entities:extract *
GenerateUserSays POST /v2/{parent=projects/*/agent}/generate_user_says *
GenerateResponses POST /v2/{parent=projects/*/agent}/generate_responses *
GetAlternativeSentences POST /v2/{parent=projects/*/agent}/get_alternative:sentence *
GetAlternativeTrainingPhrases POST /v2/{parent=projects/*/agent}/get_alternative:training_phrases *
GetSynonyms POST /v2/{parent=projects/*/agent}/get_synonyms *
ClassifyIntents POST /v2/{parent=projects/*/agent}/classify_intent *
LlmGenerate POST /v2/{parent=projects/*/agent}/llm_generate *
ListLlmModels POST /v2/{parent=projects/*/agent}/list_llm_models *
Messages

AltSentence

This message contains an alternative sentence

FieldTypeLabelDescription
sentence string

Alternative sentence

score float

Score associated to the alternative sentence resulted

AltTrainingPhrase

This message contains an alternative training phrase

FieldTypeLabelDescription
training_phrase Intent.TrainingPhrase

Alternative training phrase

score float

Score associated to training_phrase

BertAugEnrichmentConfig

Configuration for BERT augmenter enrichment

FieldTypeLabelDescription
is_active bool

Activation flag

enrichment_factor int32

Factor of enrichment

execution_order int32

Order of augmenter execution

ClassifyIntentsRequest

The request for intent classification.

FieldTypeLabelDescription
parent string

Required. The project of this agent. Format:

projects/<project_uuid>/agent

text string

the input text

language_code string

the input language

active_contexts bool

Optional: if restrict classification result with input contexts listed in the field context_names

context_names string repeated

Optional: names of the input contexts to restrict the classification result with. Intents can only be classified if the intent's input context set is the subset of the given context set.

mode Mode

Optional: Which mode to use:

  • EXCLUSIVE - skip algorithms listed in algorithms field,
  • INCLUSIVE - run ONLY algorithms listed in algorithms field,
  • UNSPECIFIED - default mode, described in agent config

algorithms IntentAlgorithms repeated

Optional: Algorithm list

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ClassifyIntentsResponse

Response containing the intents classified in a sentence

FieldTypeLabelDescription
intents_classified IntentClassified repeated

A list of intents detected

text string

The text containing from which the intents were detected

active_contexts bool

Flag that enables the context through the conversation

context_names string repeated

The context tags associated to the intents

DataEnrichmentConfig

This message contains the configuration of data enrichment

FieldTypeLabelDescription
entity_enrichment EntityEnrichmentConfig

Entity augmenter configuration

thesaurus_enrichment ThesaurusEnrichmentConfig

Thesaurus augmenter configuration

word2vec_enrichment Word2VecEnrichmentConfig

Word2Vec augmenter configuration

word_net_enrichment WordNetAugEnrichmentConfig

WordNet augmenter configuration

gpt2_enrichment GPT2EnrichmentConfig

GPT2 augmenter configuration

glove_enrichment GloVeEnrichmentConfig

GloVe augmenter configuration

bert_enrichment BertAugEnrichmentConfig

BERT augmenter configuration

xlnet_enrichment XLNetAugEnrichmentConfig

XLNet augmenter configuration

llm_enrichment LlmEnrichmentConfig

Large language model (LLM) augmenter configuration

EntityDetected

This message contains the entity detected

FieldTypeLabelDescription
entity Intent.TrainingPhrase.Entity

The entity name that is detected

extraction_method string

The extractor name, e.g. SpacyNer

score float

The confidence score of the detected entity

EntityEnrichmentConfig

Configuration for Entity enrichment

FieldTypeLabelDescription
is_active bool

Activation flag

enrichment_factor int32

Factor of enrichment

execution_order int32

Order of augmenter execution

EntityTypeFuzzyNerConfig

Configuration for Fuzzy Entity Recognizer

FieldTypeLabelDescription
entity_type EntityType

The Entity Type

minimal_score float

Optional. Overrides the minimal score in ExtractEntitiesFuzzyRequest.

entity_values string repeated

Optional. If defined, only entity value from this list are considered.

algorithm EntityTypeFuzzyNerConfig.FuzzyNerAlgorithm

Optional. Specify the Fuzzy Ner algorithm

allow_overlaps bool

Should not use allow_overlaps here, since its default value is False

ExtractEntitiesFuzzyRequest

This message is a request to extract entities with Fuzzy Entity Recognizer

FieldTypeLabelDescription
parent string

the parent of the request Format:

projects/<project_uuid>

text string

The text to be analyzed

potential_entities EntityTypeFuzzyNerConfig repeated

Potential entities to be extracted from the text with entity-specific configs

minimal_score float

Minimal similarity score to consider entity as "matched"

allow_overlaps bool

Optional. Whether or not entities are allowed to overlap.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ExtractEntitiesRequest

The request to detect parameters.

FieldTypeLabelDescription
parent string

the parent of the request Format:

projects/<project_uuid>

text string

the input text

language_code string

the input language

intent_name string

Optional. The name of the relevant intent. Used to establish preference hierarchy for entities that correspond to intent parameters Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ExtractEntitiesResponse

This message is a response of extracting entities

FieldTypeLabelDescription
entities_detected EntityDetected repeated

A list of entities detected

text string

The text containing the entities detected

GPT2EnrichmentConfig

Configuration for GPT2 enrichment

FieldTypeLabelDescription
is_active bool

Activation flag

enrichment_factor int32

Factor of enrichment

execution_order int32

Order of augmenter execution

GenerateResponsesRequest

Request to generate responses

FieldTypeLabelDescription
language_code string

language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

parent string

the parent of the request Format:

projects/<project_uuid>

n_repeat_synonym int32

The number of synonyms desired

branch string

Git branch

drop_unknown_parameters bool

Optional. Whether to drop unknown parameters from the generated responses

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

GenerateResponsesResponse

Response containing responses

FieldTypeLabelDescription
responses string repeated

A list of responses

GenerateUserSaysRequest

Request to generate user sentences

FieldTypeLabelDescription
language_code string

language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

parent string

the parent of the request Format:

projects/<project_uuid>

n_repeat_synonym int32

The number of synonyms desired

branch string

Git branch

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

GenerateUserSaysResponse

Response containing user sentences

FieldTypeLabelDescription
user_says string repeated

A list of sampled sentences

GetAlternativeSentencesRequest

Request to get alternative sentences

FieldTypeLabelDescription
config DataEnrichmentConfig

Configuration type of the enricher

sentence string

The sentence from which it is desired to get alternative sentences

language_code string

Language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

parent string

the parent of the request Format:

projects/<project_uuid>

protected_words string repeated

Protected words in the augmentation process

words_to_change string repeated

Words to be changed in the augmentation process

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

GetAlternativeSentencesResponse

Response containing alternative sentences

FieldTypeLabelDescription
alternative_sentences AltSentence repeated

A list of alternative sentences

GetAlternativeTrainingPhrasesRequest

Request to get alternative training phrases

FieldTypeLabelDescription
config DataEnrichmentConfig

Configuration of the enricher

training_phrase Intent.TrainingPhrase

Training phrase from which an alternative one is got

intent_name string

The intent tag attached to the training phrase

language_code string

language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

parent string

the parent of the request Format:

projects/<project_uuid>

detect_entities bool

Flag to determine whether entities must or not be detected

similarity_threshold float

similarity threshold defines how similar sentences should be to drop generated training phrase as duplicate. Meaningful values of similarity_threshold are between 0.95 and 1.0

protected_words string repeated

Protected words in the augmentation process

words_to_change string repeated

Words to be changed in the augmentation process

branch string

Git branch

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

GetAlternativeTrainingPhrasesResponse

Response containing alternative training phrases

FieldTypeLabelDescription
alternative_training_phrases AltTrainingPhrase repeated

A list of alternative training phrases

GetSynonymsRequest

Request to get synonyms

FieldTypeLabelDescription
config DataEnrichmentConfig

Configuration of the enricher

word string

Word from which a synonym is got

language_code string

language code specifies the language of the request in IETF BCP 47 language tag format, e.g. de-DE, en-US, etc.

parent string

the parent of the request Format:

projects/<project_uuid>

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

GetSynonymsResponse

Response containing synonyms

FieldTypeLabelDescription
synonyms Synonym repeated

A list of synonyms

GloVeEnrichmentConfig

Configuration for GloVe enrichment

FieldTypeLabelDescription
is_active bool

Activation flag

enrichment_factor int32

Factor of enrichment

execution_order int32

Order of augmenter execution

IntentClassified

Intent classified by a certain intent classifier

FieldTypeLabelDescription
intent_name string

The unique identifier of this intent. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

intent_display_name string

The name of the intent.

classifier string

The name of the classifier that detected the intent

score float

Score associated to the detection of the intent by the classifier

ListLlmModelsRequest

The request message to list available LLM models for a specified CCAI service.

FieldTypeLabelDescription
ccai_service_name string

The CCAI service for which to list models. Format:

projects/<project_uuid>/ccai/services/<service_uuid>

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListLlmModelsResponse

The response message containing a list of available LLM models.

FieldTypeLabelDescription
llm_models LlmModel repeated

A list of LLM models associated with the specified CCAI service.
Each model in this list represents an individual language model that can
be used within the service, including details such as name, provider, and description.

LlmEnrichmentConfig

Configuration for large language model (LLM) enrichment

FieldTypeLabelDescription
is_active bool

Activation flag

enrichment_factor int32

Factor of enrichment

execution_order int32

Order of augmenter execution

ccai_service_name string

The CCAI service to be used to enrich This specifies which large language model provider and model settings will handle the request. Format:

projects/<project_uuid>/ccai/services/<service_uuid>

LlmGenerateRequest

The request message to generate a response from a Large Language Model (LLM).

FieldTypeLabelDescription
llm_generation_request google.protobuf.Struct

The request payload for the LLM, structured according to the specific requirements of the large language model provider.
The payload must fit the format expected by the specified LLM provider, as defined by

CcaiServiceProvider

ccai_service_name string

The CCAI service to be used for processing the request. This specifies which large language model provider and model settings will handle the request. Format:

projects/<project_uuid>/ccai/services/<service_uuid>

file_resources FileResource repeated

Files as input for the generation request

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

LlmGenerateResponse

The response message containing the generated output from a Large Language Model (LLM).

FieldTypeLabelDescription
llm_generation_response google.protobuf.Struct

The response data from the LLM, returned as a structured payload.
This can contain the text generation, embeddings, or other outputs based on the specific request made to the LLM provider.

file_resources FileResource repeated

Files as input for the generation request, e.g., generated pictures, audio or video

LlmModel

Represents an individual LLM model available within a CCAI service.

FieldTypeLabelDescription
name string

The resource name of the model. Format:

projects/<project_uuid>/ccai/services/<service_uuid>/model/<model_uuid>
This is a unique identifier for the model, specifying its project, service, and model ID.

display_name string

The display name of the model. This is a human-readable name used for identifying the model in other requests, such as

LlmGenerateRequest
and
StreamingLlmGenerateRequest

description string

The description of the model. Provides additional details about the model, such as its purpose, architecture, or any other relevant information.

ccai_service_name string

The resource name of the CCAI service to which the model belongs. This field links the model to its service context, helping clients understand which service hosts the model.

ccai_service_provider CcaiServiceProvider

The provider of the CCAI service that offers this model. Specifies the LLM provider (e.g., Ollama, OpenAI, Google, etc.), indicating the origin or vendor of the model.

StreamingLlmGenerateResponse

The response message for streaming generation from a Large Language Model (LLM).

FieldTypeLabelDescription
llm_generation_stream_response google.protobuf.Struct

The response data from the LLM in a streaming format, returned as a structured payload.
This response is part of a continuous stream of data from the LLM, allowing incremental results to be sent as they are generated.

Synonym

This message contains a Synonym

FieldTypeLabelDescription
synonym string

Synonym word

score int32

Score associated to the synonym resulted

ThesaurusEnrichmentConfig

Configuration for Thesaurus enrichment

FieldTypeLabelDescription
is_active bool

Activation flag

enrichment_factor int32

Factor of enrichment

execution_order int32

Order of augmenter execution

Word2VecEnrichmentConfig

Configuration for Word2Vec enrichment

FieldTypeLabelDescription
is_active bool

Activation flag

enrichment_factor int32

Factor of enrichment

execution_order int32

Order of augmenter execution

WordNetAugEnrichmentConfig

Configuration for WordNet augmenter enrichment

FieldTypeLabelDescription
is_active bool

Activation flag

enrichment_factor int32

Factor of enrichment

execution_order int32

Order of augmenter execution

XLNetAugEnrichmentConfig

Configuration for XLNet enrichment

FieldTypeLabelDescription
is_active bool

Activation flag

enrichment_factor int32

Factor of enrichment

execution_order int32

Order of augmenter execution

Enums

EntityTypeFuzzyNerConfig.FuzzyNerAlgorithm

Enum of fuzzy ner algorithms

NameNumberDescription
PREFILTER_LEVENSHTEIN 0

Levenshtein algorithm for fuzzy ner matching

LOCAL_MAXIMUM 1

local maximum

IntentAlgorithms

Type of Intent algorithm.

NameNumberDescription
OndewoIntentExactContextDetector 0

By enabling this, a specific intent is triggered if the context and the intent name in the user says is matched. This can be used for directly triggering 'quick reply' button clicks confidence is always '1.0'.

OndewoIntentExactMatch 1

exact matching' of user input to user says is used to detect the intent. Confidence is always '1.0' if an 'exact match' is found.

OndewoIntentNamedExactMatch 2

the entity synonym in the user says text is replaced by the entity and 'exact matching' of user says text is performed. Confidence is always '1.0'.

OndewoIntentSimilarityMatch 3

the algorithm computes the similarity of the user input to all user says of all intents.

OndewoIntentNamedSimilarityMatch 4

the entity synonyms in the user says are replaced by their Entity. Text similarity algorithms are then used to detect the intent.

OndewoIntentBertClassifier 7

new language representation model called BERT, which stands for Bidirectional Encoder Representations from Transformers.BERT is designed to pre-train deep bidirectional representations by jointly conditioning on both left and right context in all layers. As a result, the pre-trained BERT representations can be fine-tuned for multi-class intent detection. For details see https://arxiv.org/abs/1810.04805

OndewoIntentMetaClassifier 8

Meta classifier that combines multiple intent classification algorithms to improve accuracy

IntentExitDetector 10

Maximum number of repeated fallbacks before this algorithm exists the conversation and resets contexts

OndewoIntentRankingMatch 11

Algorithm to improve the interplay of the other algorithms

OndewoWeightedEnsemble 13

Ensemble calculation of used algorithms

OndewoIntentExitDetector 14

Maximum number of repeated fallbacks before this algorithm exists the conversation and resets contexts

OndewoIntentParameterMatch 15

Matches the intent based on the parameter constellation and the current user context

Mode

Type of mode

NameNumberDescription
UNSPECIFIED 0

default mode, described in agent config

EXCLUSIVE 1

skip algorithms listed in algorithms field,

INCLUSIVE 2

run ONLY algorithms listed in algorithms field

ondewo/nlu/ccai_project.proto

Top

Services

CcaiProjects

Service to manage Call Center AI (CCAI service) Projects.

Service Methods

GetCcaiProject

rpc GetCcaiProject (GetCcaiProjectRequest) returns (CcaiProject)
Retrieves information about a specific CCAI service project.

CreateCcaiProject

rpc CreateCcaiProject (CreateCcaiProjectRequest) returns (CreateCcaiProjectResponse)
Creates a new CCAI service project based on the provided request.

DeleteCcaiProject

rpc DeleteCcaiProject (DeleteCcaiProjectRequest) returns (DeleteCcaiProjectResponse)
Deletes a CCAI service project identified by the provided request.

ListCcaiProjects

rpc ListCcaiProjects (ListCcaiProjectsRequest) returns (ListCcaiProjectsResponse)
Lists all CCAI service projects based on the provided request.

UpdateCcaiProject

rpc UpdateCcaiProject (UpdateCcaiProjectRequest) returns (UpdateCcaiProjectResponse)
Updates the information of an existing CCAI service project.

GetCcaiService

rpc GetCcaiService (GetCcaiServiceRequest) returns (CcaiService)
Retrieves information about a specific CCAI service.
Messages

CcaiProject

Message representing a CCAI service project

FieldTypeLabelDescription
name string

Resource name of the CCAI service project

display_name string

Required. The display name of this ccai project.

owner_name string

Optional. Resource name of the user who is the owner of the project.

ccai_services_map CcaiProject.CcaiServicesMapEntry repeated

Map of two letter language codes to lists of CcaiServiceList Two-letter language codes following ISO 639-1 (see https://en.wikipedia.org/wiki/ISO_639-1)

ccai_project_status CcaiProjectStatus

The status of the ccai project.

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in the form of a valid UUID.

modified_by string

User id in the form of a valid UUID.

nlu_project_name string

Required. Associated NLU agent Format:

projects/<project_uuid>/agent

CcaiProject.CcaiServicesMapEntry

FieldTypeLabelDescription
key string

value CcaiServiceList

CcaiProjectSorting

This protobuf message defines the sorting order for CCAI service (Virtual Test System Infrastructure) projects.

FieldTypeLabelDescription
sorting_field CcaiProjectSorting.CcaiProjectSortingField optional

sorting field for ccai projects sorting

sorting_mode SortingMode optional

Sorting mode

CcaiService

Definition of a Call Center AI (CCAI service) Service.

FieldTypeLabelDescription
name string

Resource name of the service. Must be unique.

display_name string

Display name for better identification.

language_code string

Language code representing the service language Format (e.g., "en" for English, "de" for German).

grpc_host string

gRPC host for communication with the specified port.

grpc_port int32

Port for gRPC communication.

webgrpc_host string

Web gRPC host for web-based communication with the specified port.

webgrpc_port int32

Port for web gRPC communication.

grpc_cert string

Path to the gRPC certificate for secure communication.

host string

Additional host for communication, if needed.

port int32

Port for additional communication.

port2 int32

Another additional port for communication if required.

http_basic_auth_token string

Http basic auth token

account_name string

Account name for authentication.

account_password string

Password for the specified account for authentication.

api_key string

API key for accessing the service, if applicable.

ccai_service_type CcaiServiceType

Type of CCAI service service (e.g., TEXT_TO_SPEECH, SPEECH_TO_TEXT).

ccai_project_name string

Resource name of the ccai_project the ccai_service belongs to

ccai_service_config google.protobuf.Struct

Detailed configuration of the CcaiService

created_at google.protobuf.Timestamp

Creation date and time of the service. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time of the service. Read-only field.

created_by string

User ID of the creator in the form of a valid UUID. Read-only field.

modified_by string

User ID of the last modifier in the form of a valid UUID. Read-only field.

headers google.protobuf.Struct optional

Optional. The headers of the request message

ccai_service_provider CcaiServiceProvider optional

Provider of the ccai service

service_hierarchy string optional

Index indicating the hierarchical position of a service within the service hierarchy. The index follows a tree-like structure, where each level of depth is separated by a "_". For example:

  • "1" represents a top-level service
  • "1_1" represents a sub-service under "1"
  • "1_1_1" represents a sub-service under "1.1"
This structure allows for easy representation and organization of services in nested workflows. If CcaiService have the same service_hierarchy they are executed in parallel. For example:
  • "1" Service A
  • "1_1" Service B
  • "1_1" Service C
Service B and C will be executed in parallel and the Service A receives both results of service B and C. The variable for the return value of a service is {{OUTPUT_SERVICE_service_hierarchy}}. So in the example above the outputs of the services are {{OUTPUT_SERVICE_1}}, {{OUTPUT_SERVICE_1_1}}, and {{OUTPUT_SERVICE_1_2}}.

CcaiServiceFilter

Filter which services should be included in the returned CcaiProject

FieldTypeLabelDescription
language_codes string repeated

Language codes of the projects for which services are filtered.

ccai_service_types CcaiServiceType repeated

Type of CCAI service service

ccai_service_providers CcaiServiceProvider repeated

Type of CCAI service providers

CcaiServiceList

Message representing a list of CCAI service services

FieldTypeLabelDescription
ccai_services CcaiService repeated

CCAI service services

CreateCcaiProjectRequest

Request to create a Call Center AI (CCAI service) project.

FieldTypeLabelDescription
ccai_project CcaiProject

The CCAI service project to be created.

nlu_project_name string

Required. The nlu agent project of this CcaiProject. Format:

projects/<project_uuid>/agent

CreateCcaiProjectResponse

Response after attempting to create a Call Center AI (CCAI service) project.

FieldTypeLabelDescription
ccai_project CcaiProject

The created CCAI service project.

error_message string

Error message if the creation is unsuccessful.

DeleteCcaiProjectRequest

Request to delete a CCAI service project

If a deployed CCAI service project was deleted then it was undeployed beforehand automatically

FieldTypeLabelDescription
name string

CCAI service project name with which to perform the call of the form

projects/<project_uuid>/project

nlu_project_name string

Required. The nlu agent project of this CcaiProject. Format:

projects/<project_uuid>/agent

DeleteCcaiProjectResponse

Response to delete a CCAI service project

If a deployed CCAI service project was deleted then it was undeployed beforehand automatically

FieldTypeLabelDescription
name string

CCAI service project name with which to perform the call of the form

projects/<project_uuid>/project

error_message string

error message if there are any.

nlu_project_name string

Required. The nlu agent project of this CcaiProject. Format:

projects/<project_uuid>/agent

GetCcaiProjectRequest

Request to retrieve a CCAI service project

FieldTypeLabelDescription
name string

CCAI service project name with which to perform the call of the form

projects/<project_uuid>/project

ccai_project_view CcaiProjectView optional

Optional. Specify the view of the returned CcaiProject (full view by default)

ccai_service_filter CcaiServiceFilter optional

Filter which services should be included in the returned CcaiProject

nlu_project_name string

Required. The nlu agent project of this CcaiProject. Format:

projects/<project_uuid>/agent

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

GetCcaiServiceRequest

Request to retrieve a CCAI service project

FieldTypeLabelDescription
name string

CCAI service project name with which to perform the call of the form

projects/<project_uuid>/ccai/services/<service_uuid>

nlu_project_name string

Required. The nlu agent project of this CcaiProject. Format:

projects/<project_uuid>/agent

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListCcaiProjectsRequest

Request to get the list of agents

FieldTypeLabelDescription
ccai_project_view CcaiProjectView

Optional. Specify the view of the returned CcaiProject (full view by default)

ccai_service_filter CcaiServiceFilter optional

Filter which services should be included in the CcaiProject

ccai_project_sorting CcaiProjectSorting optional

Optional. Field to define the sorting of the list of CCAI service projects in the response. If not specified, the default behavior is to have no sorting.

page_token string optional

Optional. The next_page_token value returned from a previous list request. Example: "current_index-1--page_size-20" The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

nlu_project_name string

Required. The nlu agent project of this CcaiProject. Format:

projects/<project_uuid>/agent

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListCcaiProjectsResponse

This is a protobuf message definition for the response of getting a list of CCAI service projects.

FieldTypeLabelDescription
ccai_projects CcaiProject repeated

The list of CCAI service projects returned in the response. Use the 'repeated' keyword to indicate that this field can contain multiple instances of CcaiProject.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

UpdateCcaiProjectRequest

Request to updated CCAI service project

FieldTypeLabelDescription
ccai_project CcaiProject

The CcaiProject that should be updated

ccai_service_filter CcaiServiceFilter optional

Filter which services should be updated in the CcaiProject

update_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields get updated.

nlu_project_name string

Required. The nlu agent project of this CcaiProject. Format:

projects/<project_uuid>/agent

UpdateCcaiProjectResponse

Request to updated CCAI service project

FieldTypeLabelDescription
name string

CCAI service project name with which to perform the call of the form

projects/<project_uuid>/project

error_message string

error message if there are any.

Enums

CcaiProjectSorting.CcaiProjectSortingField

Enum to specify the sorting field for CCAI service projects.

NameNumberDescription
NO_CCAI_PROJECT_SORTING 0

No sorting

SORT_CCAI_PROJECT_BY_NAME 1

Sort by project name such as

projects/<project_uuid>/project

SORT_CCAI_PROJECT_BY_DISPLAY_NAME 2

Sort by display name

SORT_CCAI_PROJECT_BY_CREATION_DATE 3

Sort by creation date

SORT_CCAI_PROJECT_BY_LAST_MODIFIED 4

Sort by last modified date

CcaiProjectStatus

Status of a Call Center AI (CCAI service) Project.

NameNumberDescription
CCAI_PROJECT_STATUS_UNSPECIFIED 0

No status specified

CCAI_PROJECT_STATUS_UNDEPLOYED 1

Project successfully created and undeployed

CCAI_PROJECT_STATUS_UPDATING 2

Project configuration is updating

CCAI_PROJECT_STATUS_DEPLOYING 3

Project is deploying

CCAI_PROJECT_STATUS_DEPLOYED 4

Project is deployed

CCAI_PROJECT_STATUS_UNDEPLOYING 5

Project is un-deploying

CCAI_PROJECT_STATUS_DELETING 6

Project is currently deleting

CCAI_PROJECT_STATUS_DELETED 7

Project is deleted

CcaiProjectView

CcaiProjectView defines what the CcaiProject message contains

NameNumberDescription
CCAI_PROJECT_VIEW_UNSPECIFIED 0

Unspecified CCAI_PROJECT view: the view is defined by the call:

CCAI_PROJECT_VIEW_FULL 1

Full CCAI_PROJECT view: populate all the fields of the CCAI_PROJECT message including configs.

CCAI_PROJECT_VIEW_SHALLOW 2

Shallow CCAI_PROJECT view: populates all the fields except configs.

CCAI_PROJECT_VIEW_MINIMUM 3

Minimum view including only CCAI_PROJECT UUID and CCAI_PROJECT display name

CcaiServiceProvider

NameNumberDescription
NO_CCAI_SERVICE_PROVIDER 0

No specified provider or placeholder

CCAI_SERVICE_PROVIDER_ONDEWO 1

ONDEWO provider for CCAI service services ONDEWO

CCAI_SERVICE_PROVIDER_GOOGLE_GEMINI 2

Google as the CCAI service provider, utilizing Google's conversational AI capabilities Google Gemini

CCAI_SERVICE_PROVIDER_MICROSOFT_AZURE_OPENAI 3

Microsoft Azure as the CCAI service provider, using Microsoft's Azure cognitive services Azure OpenAI

CCAI_SERVICE_PROVIDER_MICROSOFT_AUTOGEN 4

Microsoft AutoGen as the CCAI service provider AutoGen

CCAI_SERVICE_PROVIDER_OLLAMA 5

Ollama as the CCAI service provider, typically associated with specific OLLAMA AI tools Ollama

CCAI_SERVICE_PROVIDER_OPENAI 6

OpenAI as the CCAI service provider, commonly used for models such as GPT OpenAI

CCAI_SERVICE_PROVIDER_ANTHROPIC 7

Anthropic as the CCAI service provider, used with AI models from Anthropic Anthropic

CCAI_SERVICE_PROVIDER_HUGGINGFACE 8

Hugging Face as the CCAI service provider, often used for open-source NLP models Hugging Face

CCAI_SERVICE_PROVIDER_IBM 9

IBM as the CCAI service provider, such as IBM Watson for conversational AI IBM Watson

CCAI_SERVICE_PROVIDER_HAYSTACK 10

Haystack as the CCAI service provider, e.g., for question answering and conversations Haystack

CCAI_SERVICE_PROVIDER_LANGCHAIN 11

LangChain as the CCAI service provider LangChain

CCAI_SERVICE_PROVIDER_AMAZON 12

Amazon AWS as the CCAI service provider, using Amazon's AI/ML services AWS AI Services

CCAI_SERVICE_PROVIDER_MISTRAL 13

Mistral as the CCAI service provider, using Mistral's services Mistral

CCAI_SERVICE_PROVIDER_DUCKDUCKGO 14

DuckDuckGo Websearch API DuckDuckGo API

CCAI_SERVICE_PROVIDER_GOOGLE_PSE 15

Google PSE Websearch API Google Programmable Search Engine

CCAI_SERVICE_PROVIDER_JINA 16

Jina Websearch API Jina AI

CCAI_SERVICE_PROVIDER_TAVILY 17

Tavily Websearch API Tavily API

CCAI_SERVICE_PROVIDER_ELASTICSEARCH 18

ElasticSearch vector database service ElasticSearch

CCAI_SERVICE_PROVIDER_MILVUS 19

Milvus vector database service Milvus

CCAI_SERVICE_PROVIDER_QDRANT 20

Qdrant vector database service Qdrant

CCAI_SERVICE_PROVIDER_CHROMA 21

Chroma vector database service ChromaDB

CCAI_SERVICE_PROVIDER_GOOGLE 22

Google CCAI service provider Google Cloud AI

CCAI_SERVICE_PROVIDER_MICROSOFT 23

Microsoft CCAI service provider Microsoft AI

CCAI_SERVICE_PROVIDER_DEEPGRAM 24

Deepgram as the CCAI service provider for speech processing Deepgram

CCAI_SERVICE_PROVIDER_ELEVENLABS 25

ElevenLabs as the CCAI service provider for voice synthesis ElevenLabs

CCAI_SERVICE_PROVIDER_HUGGINGFACE_TGI 26

Hugging Face Text Generation Inference (TGI) as the CCAI service provider Text Generation Inference

CCAI_SERVICE_PROVIDER_HUGGINGFACE_TGE 27

Hugging Face Text Embedding Inference (TGE) as the CCAI service provider Text Embeddings Inference

CCAI_SERVICE_PROVIDER_HUGGINGFACE_SMOLAGENTS 28

Hugging Face SmolAgents as the CCAI service provider SmolAgents

CCAI_SERVICE_PROVIDER_GOOGLE_AGENT_DEVELOPMENT_KIT 29

Google Agent Development Kit (ADK) as the CCAI service provider Google Agent Development Kit (ADK)

CCAI_SERVICE_PROVIDER_MODEL_CONTEXT_PROTOCOL 30

Model Context Protocol as the CCAI service provider, enabling integration with services following the Model Context Protocol standard. MCP

CCAI_SERVICE_PROVIDER_OPENSEARCH 31

Opensearch as the CCAI service provider, enabling integration with Opensearch vector database and search services Opensearch

CCAI_SERVICE_PROVIDER_GROK 32

Grok as the CCAI service provider, commonly used for models such as Grok-1 Grok

CCAI_SERVICE_PROVIDER_POSTGRES 33

PostgreSQL as the CCAI service provider, enabling integration with PostgreSQL databases PostgreSQL

CcaiServiceType

NameNumberDescription
CCAI_SERVICE_TYPE_UNSPECIFIED 0

unspecified

CCAI_SERVICE_TYPE_ONDEWO_AIM 1

ondewo-aim service

CCAI_SERVICE_TYPE_ONDEWO_BPI 2

ondewo-bpi service

CCAI_SERVICE_TYPE_ONDEWO_CSI 3

ondewo-csi service

CCAI_SERVICE_TYPE_ONDEWO_NLU 4

ondewo-nlu service

CCAI_SERVICE_TYPE_ONDEWO_S2T 5

ondewo-s2t service

CCAI_SERVICE_TYPE_ONDEWO_SIP 6

ondewo-sip service

CCAI_SERVICE_TYPE_ONDEWO_T2S 7

ondewo-t2s service

CCAI_SERVICE_TYPE_ONDEWO_VTSI 8

ondewo-vtsi service

CCAI_SERVICE_TYPE_ONDEWO_VTSI_RABBITMQ 9

ondewo-vtsi service

CCAI_SERVICE_TYPE_ONDEWO_NLU_QA 10

ondewo-nlu-qa service

CCAI_SERVICE_TYPE_ONDEWO_NLU_WEBHOOK 11

ondewo-nlu-webhook service

CCAI_SERVICE_TYPE_ONDEWO_SURVEY 12

ondewo-survey service

CCAI_SERVICE_TYPE_ONDEWO_NLU_LLM 13

ondewo-nlu-llm service

CCAI_SERVICE_TYPE_ONDEWO_NLU_WEBSEARCH 14

ondewo-nlu-websearch service

CCAI_SERVICE_TYPE_ONDEWO_AIM_WEBCHAT 15

ondewo-aim-webchat service

CCAI_SERVICE_TYPE_ONDEWO_AIM_WEBPHONE 16

ondewo-aim-webphone service

CCAI_SERVICE_TYPE_ONDEWO_NLU_VECTORSTORE 17

ondewo-nlu-vectorstore service

CCAI_SERVICE_TYPE_ONDEWO_NLU_LLM_AGENT 18

ondewo-nlu-llm-agent service

CCAI_SERVICE_TYPE_ONDEWO_NLU_LLM_MCP 19

ondewo-nlu-llm-mcp service

CCAI_SERVICE_TYPE_ONDEWO_NLU_LLM_RAG 20

ondewo-nlu-llm-rag service

CCAI_SERVICE_TYPE_ONDEWO_ANALYTICS 21

ondewo-analytics service

CCAI_SERVICE_TYPE_ONDEWO_ANALYTICS_DASHBOARD 22

ondewo-analytics-dashboard service

ondewo/nlu/common.proto

Top

Messages

AddNotificationsRequest

Message for adding notifications in a batch.

FieldTypeLabelDescription
notifications Notification repeated

List of notifications to be added.

AddNotificationsResponse

Message containing the response to adding notifications.

FieldTypeLabelDescription
notifications Notification repeated

List of notifications that have been added.

Comment

Comment message

FieldTypeLabelDescription
name string

resource name of the comment

text string

text of the comment

user_id string

User id as resource name. Format:

projects/<project_uuid>/agent/users/<user_uuid>

comment_about_name string

name of the resource for which the comment is about. Format:

projects/<project_uuid>/agent/<resource_type>/<resource_uuid>/.../

parent_comment_name string

The resource name of the parent comment. A parent comment is a reply to a certain comment. Format:

projects/<project_uuid>/agent/<resource_type>/<resource_uuid>/.../

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

KeyValuePair

Key-Value pair message, where the value can be one of various types (int, float, double, string, etc.).

FieldTypeLabelDescription
key string

The key of the key-value pair.

int_value int32

The integer value (if applicable).

float_value float

The float value (if applicable).

double_value double

The double value (if applicable).

string_value string

The string value (if applicable).

created_at google.protobuf.Timestamp

The timestamp value (if applicable).

ListNotificationsRequest

Message for listing notifications based on certain criteria.

FieldTypeLabelDescription
notification_filter NotificationFilter

Optional filter to narrow the response down to specific notifications.

page_token string

Optional. Token for pagination, obtained from a previous list request. The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

field_mask google.protobuf.FieldMask

Optional. Mask to control which fields will be filled with data.
Example: path=["notification.user_names"]

ListNotificationsResponse

Message containing the response to a list request for notifications.

FieldTypeLabelDescription
notifications Notification repeated

List of notifications that meet the specified criteria.

Notification

Notification message

FieldTypeLabelDescription
name string

resource name of the notification

user_name string

User id as resource name. Format:

projects/<project_uuid>/agent/users/<user_uuid>

title string

User id as resource name. Format:

projects/<project_uuid>/agent/users/<user_uuid>

description_short string

A short notification text is displayed directly with max. 50 chars which is a truncated version of the long message

description_long string

A long notification text

notification_flagged_status NotificationFlaggedStatus

Has a notification been flagged by a specific user

notification_flagged_timestamp google.protobuf.Timestamp

When the user marked the notification as read

notification_read_status NotificationReadStatus

Has a notification been read by a specific user

notification_read_timestamp google.protobuf.Timestamp

When the user marked the notification as read, i.e. read the notification

notification_origin NotificationOrigin

The origin of a notification. A Notification origin can be from a product (service), e.g. ondewo-nlu, ondewo-s2t, ondewo-t2s, etc.

origin_name string

The name of resource of where the notification originated

origin_language string

language of the origin resource e.g. language of the nlu agent or language of the speech-to-text service

notification_type NotificationType

The type of notification

notification_visibility NotificationVisibility

The visibility level of the notification

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

NotificationFilter

Message for filtering notifications based on various criteria.

FieldTypeLabelDescription
language_codes string repeated

Language codes of the projects for which notifications are filtered.

notification_origins NotificationOrigin repeated

Origins of the notifications to filter.

notification_visibilities NotificationVisibility repeated

Visibilities of the notifications to filter.

notification_flagged_status NotificationFlaggedStatus repeated

Flagged status of the notifications to filter.

notification_read_status NotificationReadStatus repeated

Read status of the notifications to filter.

earliest google.protobuf.Timestamp

Filter notifications with a time range starting from the specified earliest time.

latest google.protobuf.Timestamp

Filter notifications with a time range ending at the specified latest time.

user_names string repeated

Resource names of users to filter notifications for.

origin_names string repeated

Resource names of the origin of the notification to filter notifications.

SetNotificationsFlaggedStatusRequest

Message for setting the flagged status of notifications.

FieldTypeLabelDescription
notification_names string repeated

Names of notifications to set the flagged status for.

flagged bool repeated

Flagged status to set for the specified notifications.

SetNotificationsReadStatusRequest

Message for setting the read status of notifications.

FieldTypeLabelDescription
notification_names string repeated

Names of notifications to set the read status for.

flagged bool repeated

Read status to set for the specified notifications.

StatResponse

statistic response

FieldTypeLabelDescription
value uint32

Response wrapper for the "Get<Stat>" endpoints

Enums

NotificationFlaggedStatus

Enumerates the possible flagged statuses for a notification.

NameNumberDescription
NOTIFICATION_FLAGGED_STATUS_UNSPECIFIED 0

Unspecified flagged status

NOTIFICATION_FLAGGED_STATUS_FLAGGED 1

Notification is flagged

NOTIFICATION_FLAGGED_STATUS_UNFLAGGED 2

Notification is unflagged

NotificationOrigin

Enumerates the possible origins for a notification.

NameNumberDescription
NOTIFICATION_ORIGIN_UNSPECIFIED 0

unspecified

NOTIFICATION_ORIGIN_ONDEWO_AIM 1

ondewo-aim service

NOTIFICATION_ORIGIN_ONDEWO_BPI 2

ondewo-bpi service

NOTIFICATION_ORIGIN_ONDEWO_CSI 3

ondewo-csi service

NOTIFICATION_ORIGIN_ONDEWO_NLU 4

ondewo-nlu service

NOTIFICATION_ORIGIN_ONDEWO_S2T 5

ondewo-s2t service

NOTIFICATION_ORIGIN_ONDEWO_SIP 6

ondewo-sip service

NOTIFICATION_ORIGIN_ONDEWO_T2S 7

ondewo-t2s service

NOTIFICATION_ORIGIN_ONDEWO_VTSI 8

ondewo-vtsi service

NOTIFICATION_ORIGIN_ONDEWO_VTSI_RABBITMQ 9

ondewo-vtsi-rabbitmq service

NotificationReadStatus

Enumerates the possible read statuses for a notification.

NameNumberDescription
NOTIFICATION_READ_STATUS_UNSPECIFIED 0

Unspecified read status

NOTIFICATION_READ_STATUS_READ 1

Notification is marked as read

NOTIFICATION_READ_STATUS_UNREAD 2

Notification is marked as unread

NotificationType

Enumerates the possible types for a notification.

NameNumberDescription
NOTIFICATION_TYPE_UNSPECIFIED 0

Unspecified notification type

NOTIFICATION_TYPE_DEBUG 1

Debug notification type

NOTIFICATION_TYPE_WARNING 2

Warning notification type

NOTIFICATION_TYPE_INFO 3

Informational notification type

NOTIFICATION_TYPE_ERROR 4

Error notification type

NOTIFICATION_TYPE_NEWS 5

News notification type

NotificationVisibility

Enum for notification type

NameNumberDescription
NOTIFICATION_VISIBILITY_UNSPECIFIED 0

unspecified

NOTIFICATION_VISIBILITY_USER 1

only user sees the notification - usually a notification of the user interface

NOTIFICATION_VISIBILITY_PROJECT 2

all members of a project see this notification

NOTIFICATION_VISIBILITY_PROJECT_OWNER 3

all admins of a project see this notification

NOTIFICATION_VISIBILITY_PROJECT_ADMIN 4

all admins of a project see this notification

NOTIFICATION_VISIBILITY_PROJECT_DEVELOPER 5

all admins of a project see this notification

NOTIFICATION_VISIBILITY_PROJECT_USER 6

all users of a project see this notification

NOTIFICATION_VISIBILITY_PROJECT_EXECUTOR 7

all users of a project see this notification

NOTIFICATION_VISIBILITY_PROJECT_INACTIVE 8

all users of a project see this notification

NOTIFICATION_VISIBILITY_SERVER_ADMIN 9

all admins of the server

NOTIFICATION_VISIBILITY_SERVER_MANAGER 10

all admins of the server

NOTIFICATION_VISIBILITY_SERVER_USER 11

all admins of the server

NOTIFICATION_VISIBILITY_SERVER_INACTIVE 12

all admins of the server

SortingMode

Sorting mode

NameNumberDescription
ASCENDING 0

ascending sorting

DESCENDING 1

descending sorting

ondewo/nlu/context.proto

Top

Services

Contexts

A context represents additional information included with user input or with an intent returned by the Dialogflow API. Contexts are helpful for differentiating user input which may be vague or have a different meaning depending on additional details from your application such as user setting and preferences, previous user input, where the user is in your application, geographic location, and so on.

You can include contexts as input parameters of a DetectIntent (or StreamingDetectIntent) request, or as output contexts included in the returned intent.

Contexts expire when an intent is matched, after the number of DetectIntent requests specified by the lifespan_count parameter, or after 10 minutes if no intents are matched for a DetectIntent request.

For more information about contexts, see the Dialogflow documentation.

Service Methods

ListContexts

rpc ListContexts (ListContextsRequest) returns (ListContextsResponse)
Returns the list of all contexts in the specified session.

GetContext

rpc GetContext (GetContextRequest) returns (Context)
Retrieves the specified context.

CreateContext

rpc CreateContext (CreateContextRequest) returns (Context)
Creates a context.

UpdateContext

rpc UpdateContext (UpdateContextRequest) returns (Context)
Updates the specified context.

DeleteContext

rpc DeleteContext (DeleteContextRequest) returns (.google.protobuf.Empty)
Deletes the specified context.

DeleteAllContexts

rpc DeleteAllContexts (DeleteAllContextsRequest) returns (.google.protobuf.Empty)
Deletes all active contexts in the specified session.

Methods with HTTP bindings

Method Name Method Pattern Body
ListContexts GET /v2/{parent=projects/*/agent/sessions/*}/contexts
GetContext GET /v2/{name=projects/*/agent/sessions/*/contexts/*}
CreateContext POST /v2/{parent=projects/*/agent/sessions/*}/contexts context
UpdateContext PATCH /v2/{context.name=projects/*/agent/sessions/*/contexts/*} context
DeleteContext DELETE /v2/{name=projects/*/agent/sessions/*/contexts/*}
DeleteAllContexts DELETE /v2/{parent=projects/*/agent/sessions/*}/contexts
Messages

Context

Represents a context.

FieldTypeLabelDescription
name string

Required. The display name of the context (must be unique per session). Note: we are deviating from the dialogflow format projects/<project_uuid>/agent/sessions/<session_uuid>/contexts/<context_uuid>.

  • DetectIntent only returns
    • the short display name in the "name" field in query_result.output_contexts
    • only expects the short display name in the "name" field in query_parameters.contexts
  • Also inside the persisted session object only the short display name is used.
    • SessionStep.contexts only contains the short display name
    • SessionReviewStep.contexts only contains the short display name

lifespan_count int32

Optional. The number of conversational query requests after which the context expires. If set to 0 (the default) the context expires immediately. Contexts expire automatically after 10 minutes even if there are no matching queries.

parameters Context.ParametersEntry repeated

Optional. The collection of parameters associated with this context. Refer to this doc for syntax. Keys are the display names of context parameters.

lifespan_time float

Optional. The time span in seconds after which the context expires. By default it does not expire.

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

Context.Parameter

Represents a parameter associated with a context

FieldTypeLabelDescription
name string

The name of the context parameter.

display_name string

The display name of the context parameter.

value string

The value(s) of the context parameter.

value_original string

The original value(s) of the context parameter.

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

Context.ParametersEntry

FieldTypeLabelDescription
key string

value Context.Parameter

CreateContextRequest

The request message for Contexts.CreateContext.

FieldTypeLabelDescription
session_id string

Required. The session to create a context for. Format:

projects/<project_uuid>/agent/sessions/<session_uuid>

context Context

Required. The context to create.

DeleteAllContextsRequest

The request message for Contexts.DeleteAllContexts.

FieldTypeLabelDescription
session_id string

Required. The name of the session to delete all contexts from. Format:

projects/<project_uuid>/agent/sessions/<session_uuid>

DeleteContextRequest

The request message for Contexts.DeleteContext.

FieldTypeLabelDescription
name string

Required. The name of the context to delete. Format: projects/<project_uuid>/agent/sessions/<session_uuid>/contexts/<context_uuid>.

GetContextRequest

The request message for Contexts.GetContext.

FieldTypeLabelDescription
name string

Required. The name of the context. Format: projects/<project_uuid>/agent/sessions/<session_uuid>/contexts/<context_uuid>.

ListContextsRequest

The request message for Contexts.ListContexts.

FieldTypeLabelDescription
session_id string

Required. The session to list all contexts from. Format:

projects/<project_uuid>/agent/sessions/<session_uuid>

page_token string

Optional. The next_page_token value returned from a previous list request. The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

ListContextsResponse

The response message for Contexts.ListContexts.

FieldTypeLabelDescription
contexts Context repeated

The list of contexts. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

UpdateContextRequest

The request message for Contexts.UpdateContext.

FieldTypeLabelDescription
context Context

Required. The context to update.

update_mask google.protobuf.FieldMask

Optional. The mask to control which fields get updated.

ondewo/nlu/entity_type.proto

Top

Services

EntityTypes

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:

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

Service Methods

ListEntityTypes

rpc ListEntityTypes (ListEntityTypesRequest) returns (ListEntityTypesResponse)
Returns the list of all entity types in the specified agent.

GetEntityType

rpc GetEntityType (GetEntityTypeRequest) returns (EntityType)
Retrieves the specified entity type.

CreateEntityType

rpc CreateEntityType (CreateEntityTypeRequest) returns (EntityType)
Creates an entity type in the specified agent.

UpdateEntityType

rpc UpdateEntityType (UpdateEntityTypeRequest) returns (EntityType)
Updates the specified entity type.

DeleteEntityType

rpc DeleteEntityType (DeleteEntityTypeRequest) returns (.google.protobuf.Empty)
Deletes the specified entity type.

BatchUpdateEntityTypes

rpc BatchUpdateEntityTypes (BatchUpdateEntityTypesRequest) returns (Operation)
Updates/Creates multiple entity types in the specified agent. Operation <response: BatchUpdateEntityTypesResponse, metadata: google.protobuf.Struct>

BatchDeleteEntityTypes

rpc BatchDeleteEntityTypes (BatchDeleteEntityTypesRequest) returns (Operation)
Deletes entity types in the specified agent. Operation <response: google.protobuf.Empty, metadata: google.protobuf.Struct>

GetEntity

rpc GetEntity (GetEntityRequest) returns (EntityType.Entity)
Retrieves the specified entity .

CreateEntity

rpc CreateEntity (CreateEntityRequest) returns (EntityType.Entity)
Creates an entity in the specified agent.

UpdateEntity

rpc UpdateEntity (UpdateEntityRequest) returns (EntityType.Entity)
Updates the specified entity .

DeleteEntity

rpc DeleteEntity (DeleteEntityRequest) returns (DeleteEntityStatus)
Deletes the specified entity .

BatchCreateEntities

rpc BatchCreateEntities (BatchCreateEntitiesRequest) returns (BatchEntitiesResponse)
Creates an entity value in an entity type.

BatchUpdateEntities

rpc BatchUpdateEntities (BatchUpdateEntitiesRequest) returns (BatchEntitiesResponse)
Updates a specific entity value.

BatchGetEntities

rpc BatchGetEntities (BatchGetEntitiesRequest) returns (BatchEntitiesResponse)
Gets a specific entity value.

BatchDeleteEntities

rpc BatchDeleteEntities (BatchDeleteEntitiesRequest) returns (BatchDeleteEntitiesResponse)
Deletes the specified entity value.

ListEntities

rpc ListEntities (ListEntitiesRequest) returns (ListEntitiesResponse)
List entities of an entity type

Methods with HTTP bindings

Method Name Method Pattern Body
ListEntityTypes GET /v2/{parent=projects/*/agent}/entityTypes
GetEntityType GET /v2/{name=projects/*/agent/entityTypes/*}
CreateEntityType POST /v2/{parent=projects/*/agent}/entityTypes *
UpdateEntityType PATCH /v2/{entity_type.name=projects/*/agent/entityTypes/*} *
DeleteEntityType DELETE /v2/{name=projects/*/agent/entityTypes/*}
BatchUpdateEntityTypes POST /v2/{parent=projects/*/agent}/entityTypes:batchUpdate *
BatchDeleteEntityTypes POST /v2/{parent=projects/*/agent}/entityTypes:batchDelete *
GetEntity GET /v2/{name=projects/*/agent/entityTypes/*/entities/*}
CreateEntity POST /v2/{parent=projects/*/agent}/entityTypes/*/entities/ *
UpdateEntity PATCH /v2/{entity_.name=projects/*/agent/entityTypes/*/entities/*} *
DeleteEntity DELETE /v2/{name=projects/*/agent/entityTypes/*/entities/*}
Messages

BatchCreateEntitiesRequest

This message is a request to create a batch entities

FieldTypeLabelDescription
create_entity_requests CreateEntityRequest repeated

The create entity requests in a batch

BatchDeleteEntitiesRequest

This message is a request to delete a batch of entities

FieldTypeLabelDescription
names string repeated

The unique identifiers of the entities. Format: projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>/entities/<entity_uuid>.

BatchDeleteEntitiesResponse

This message is a response of deletion of a batch of entities

FieldTypeLabelDescription
delete_statuses DeleteEntityStatus repeated

status of an entity deletion

has_errors bool

error messages

BatchDeleteEntityTypesRequest

The request message for EntityTypes.BatchDeleteEntityTypes.

FieldTypeLabelDescription
parent string

Required. The name of the agent to delete all entities types for. Format: projects/<project_uuid>/agent.

entity_type_names string repeated

Required. The names entity types to delete. All names must point to the same agent as `parent`.

BatchEntitiesResponse

This message is a response of batch entities

FieldTypeLabelDescription
entity_statuses EntityStatus repeated

A list of entity statuses

has_errors bool

indicates if statuses of some of the training phrases have errors

BatchGetEntitiesRequest

This message is a request to get a batch of entities

FieldTypeLabelDescription
names string repeated

The unique identifiers of the entities. Format: projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>/entities/<entity_uuid>.

BatchUpdateEntitiesRequest

This message is a request to update a batch of entities

FieldTypeLabelDescription
entities EntityType.Entity repeated

The entities to update

BatchUpdateEntityTypesRequest

The request message for EntityTypes.BatchUpdateEntityTypes.

FieldTypeLabelDescription
parent string

Required. The name of the agent to update or create entity types in. Format:

projects/<project_uuid>/agent

entity_type_batch_uri string

The URI to a Google Cloud Storage file containing entity types to update or create. The file format can either be a serialized proto (of EntityBatch type) or a JSON object. Note: The URI must start with "gs://".

entity_type_batch_inline EntityTypeBatch

The collection of entity type to update or create.

language_code string

Optional. The language of entity synonyms defined in entity_types. If not specified, the agent's default language is used. More than a dozen languages are supported. Note: languages must be enabled in the agent, before they can be used.

update_mask google.protobuf.FieldMask

Optional. The mask to control which fields get updated.

BatchUpdateEntityTypesResponse

The response message for EntityTypes.BatchUpdateEntityTypes.

FieldTypeLabelDescription
entity_types EntityType repeated

The collection of updated or created entity types.

CreateEntityRequest

FieldTypeLabelDescription
entity_type_name string

Required. Name of the entity type in which to create the entity value. Format: projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>/entities/<entity_uuid>.

entity EntityType.Entity

The entity value to create

CreateEntityTypeRequest

The request message for EntityTypes.CreateEntityType.

FieldTypeLabelDescription
parent string

Required. The agent to create a entity type for. Format:

projects/<project_uuid>/agent

entity_type EntityType

Required. The entity type to create.

language_code string

Optional. The language of entity synonyms defined in entity_type. If not specified, the agent's default language is used. More than a dozen languages are supported. Note: languages must be enabled in the agent, before they can be used.

entity_type_view EntityTypeView

Optional. The resource view to apply to the returned Entity Type

DeleteEntityRequest

This message is a request to delete a batch of entities

FieldTypeLabelDescription
name string

The unique identifiers of the entities. Format: projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>/entities/<entity_uuid>.

DeleteEntityStatus

This message contains the status of an entity deletion

FieldTypeLabelDescription
successfully_deleted google.protobuf.Empty

error_message string

DeleteEntityTypeRequest

The request message for EntityTypes.DeleteEntityType.

FieldTypeLabelDescription
name string

Required. The name of the entity type to delete. Format:

projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>

EntityStatus

This message is for the entity status

FieldTypeLabelDescription
entity EntityType.Entity

The entity

error_message string

Error message

EntityType

Represents an entity type.

Entity types serve as a tool for extracting parameter values from natural

language queries.

FieldTypeLabelDescription
name string

Required for all methods except create (create populates the name automatically. The unique identifier of the entity type. Format: projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>.

display_name string

Required. The name of the entity type.

kind EntityType.Kind

Required. Indicates the kind of entity type.

auto_expansion_mode EntityType.AutoExpansionMode

Optional. Indicates whether the entity type can be automatically expanded.

entities EntityType.Entity repeated

Optional. The collection of entities associated with the entity type.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

entity_count int32

Read-Only field. Total count of entity values of the entity type

status EntityType.EntityTypeStatus

Indicates whether the entity type is active or not

synonym_count int32

Read-Only field. Total count of entity synonyms of the entity type

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

EntityType.Entity

Represents an entity value within an entity type

FieldTypeLabelDescription
value string

Required. For KIND_MAP entity types: A canonical name to be used in place of synonyms. For KIND_LIST entity types: A string that can contain references to other entity types (with or without aliases). Values can also be described as regexes with postprocessing options such as:


 * regex('//1') => references the first group match of the regex defined as a synonym
 * regex('//2') => references the second group match of the regex defined as a synonym
 * regex('//1') => references the first group match of the regex defined as a synonym
Values can also be described as regexes with one or more postprocessing options such as one postprocessing option to remove all whitespaces regex('<#RW#>\\1') or by a combination of several postprocessing options such as remove all whitespaces and lower casing regex('<#RW#><#LC#>\\1'). All processing options are:

 * regex('<#TW>//1') => matches 1st group and trims duplicated whitespaces to one single space
 * regex('<#RW>//1') => matches 1st group and removes all whitespaces
 * regex('<#UC>//1') => matches 1st group and converts to upper case
 * regex('<#LC>//1') => matches 1st group and converts to lower case
 * regex('<#CC>//1') => matches 1st group and converts to camelCase
 * regex('<#SC>//1') => matches 1st group and converts to snake_case

synonyms string repeated

Required. A collection of synonyms. For KIND_LIST entity types this must contain exactly one synonym equal to value. Synonyms can be regex expressions, i.e. regular expressions, that are python compatible. See here for supported regex: https://docs.python.org/3/library/re.html Examples are:


 * regex('[a-zA-Z]+') => just letters
 * regex('\d{1,5}') => just numbers
 * regex('^[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$') => mix of numbers, letters and dot
 * regex('(?i)(^|\s)(0\s{0,3}') => with matching groups and case insensitivity

name string

The unique identifier of the entity. Format: projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>/entities/<entity_uuid>.

display_name string

The name of the entity.

synonym_count int32

Optional. Total count of entity synonyms

language_code string

Required. The language to list entity synonyms for.

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

EntityTypeBatch

This message is a wrapper around a collection of entity types.

FieldTypeLabelDescription
entity_types EntityType repeated

A collection of entity types.

EntityTypeSorting

This message contains Entity type sorting

FieldTypeLabelDescription
sorting_field EntityTypeSorting.EntityTypeSortingField

sorting_mode SortingMode

EntityValueSorting

This message contains entity value sorting

FieldTypeLabelDescription
sorting_field EntityValueSorting.EntityValueSortingField

sorting_mode SortingMode

GetEntityRequest

This message is a request to get a an entity

FieldTypeLabelDescription
name string

The unique identifiers of the entities. Format: projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>/entities/<entity_uuid>.

GetEntityTypeRequest

The request message for EntityTypes.GetEntityType.

FieldTypeLabelDescription
name string

Required. The name of the entity type. Format:

projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>

language_code string

Optional. The language to retrieve entity synonyms for. If not specified, the agent's default language is used. More than a dozen languages are supported. Note: languages must be enabled in the agent, before they can be used.

page_token string

The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

entity_type_view EntityTypeView

Optional. The resource view to apply to the returned Entity Type

ListEntitiesRequest

This message is a request to get a list of entities

FieldTypeLabelDescription
entity_type_name string

The unique identifier of the entity type. Format: projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>

language_code string

Optional. The language to list training phrases, parameters and rich messages for. If not specified, the agent's default language is used.

page_token string

Optional. The next_page_token value returned from a previous list request. The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

sort_by_field EntityValueSorting

Optional. Defines the sorting of the list. Default, no sorting.

search_by_pattern string

Optional. Defines a pattern to search for in the entity type "values" and "synonyms" Example:


     Pattern: "dark"
     Results:
             [Entity Value]          [Entity Synonyms]
             Red                     red, scarlett, dark red, ...
             Blue                    blue, indico, dark blue, sky blue, ...
             Dark                    obscure, black, opaque, ...

ListEntitiesResponse

This message is a response of listing entities

FieldTypeLabelDescription
entities EntityType.Entity repeated

The list of entities

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

ListEntityTypesRequest

The request message for EntityTypes.ListEntityTypes.

FieldTypeLabelDescription
parent string

Required. The agent to list all entity types from. Format:

projects/<project_uuid>/agent

language_code string

Optional. The language to list entity synonyms for. If not specified, the agent's default language is used. More than a dozen languages are supported. Note: languages must be enabled in the agent, before they can be used.

page_token string

Optional. The next_page_token value returned from a previous list request. The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

entity_type_view EntityTypeView

Optional. The resource view to apply to the returned entity type.

filter_by_category EntityTypeCategory

Optional. Applies a filter to the list. Default, no filter.

sort_by_field EntityTypeSorting

Optional. Defines the sorting of the list. Default, no sorting.

ListEntityTypesResponse

The response message for EntityTypes.ListEntityTypes.

FieldTypeLabelDescription
entity_types EntityType repeated

The list of agent entity types. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

UpdateEntityRequest

This message is a request to update an entity

FieldTypeLabelDescription
entity EntityType.Entity

The entity to update

UpdateEntityTypeRequest

The request message for EntityTypes.UpdateEntityType.

FieldTypeLabelDescription
entity_type EntityType

Required. The entity type to update. Format:

projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>

language_code string

Optional. The language of entity synonyms defined in entity_type. If not specified, the agent's default language is used. More than a dozen languages are supported. Note: languages must be enabled in the agent, before they can be used.

update_mask google.protobuf.FieldMask

Optional. The mask to control which fields get updated.

entity_type_view EntityTypeView

Optional. The resource view to apply to the returned Entity Type

Enums

EntityType.AutoExpansionMode

Represents different entity type expansion modes. Automated expansion

allows an agent to recognize values that have not been explicitly listed in

the entity (for example, new kinds of shopping list items).

NameNumberDescription
AUTO_EXPANSION_MODE_UNSPECIFIED 0

Auto expansion disabled for the entity.

AUTO_EXPANSION_MODE_DEFAULT 1

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

EntityType.EntityTypeStatus

NameNumberDescription
ACTIVE 0

Entity type is active

INACTIVE 1

Entity type is inactive

EntityType.Kind

Represents kinds of entities.

NameNumberDescription
KIND_UNSPECIFIED 0

Not specified. This value should be never used.

KIND_MAP 1

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

KIND_LIST 2

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

EntityTypeCategory

Represents the category of entity types to filter by in the "List Entity Types" request

NameNumberDescription
ALL_ENTITY_TYPES 0

represent all entity types

DEFAULT_ENTITY_TYPES 1

represent the default entity types

USER_DEFINED_ENTITY_TYPES 2

represent the user defined (custom) entity types

EntityTypeSorting.EntityTypeSortingField

Structure of Entity type sorting field

NameNumberDescription
NO_ENTITY_TYPE_SORTING 0

No sorting applied

SORT_ENTITY_TYPE_BY_NAME 1

Sort by entity type name

SORT_ENTITY_TYPE_BY_CREATION_DATE 2

Sort by creation date

SORT_ENTITY_TYPE_BY_LAST_UPDATED 3

Sort by last updated date

SORT_ENTITY_TYPE_BY_ENTITY_VALUE_COUNT 4

Sort by entity value count

SORT_ENTITY_TYPE_BY_SYNONYM_COUNT 5

Sort by synonym count

EntityTypeView

Represents the options for views of an entity type.

An entity type can be a sizable object. Therefore, we provide a resource view that

does not return all values and synonyms besides the full view that is set by default.

NameNumberDescription
ENTITY_TYPE_VIEW_UNSPECIFIED 0

Same as ENTITY_TYPE_VIEW_FULL

ENTITY_TYPE_VIEW_FULL 1

All fields are populated.

ENTITY_TYPE_VIEW_PARTIAL 2

The amount of entity values and synonyms is limited

ENTITY_TYPE_VIEW_SHALLOW 3

No entity synonyms are returned, only entity values

ENTITY_TYPE_VIEW_MINIMUM 4

Minimum view including only entity type UUID and entity type display name

EntityValueSorting.EntityValueSortingField

Structure of Entity value sorting field

NameNumberDescription
NO_ENTITY_VALUE_SORTING 0

Default behaviour: Sorts by value

SORT_ENTITY_VALUE_BY_DISPLAY_NAME 1

Sort by display name

SORT_ENTITY_VALUE_BY_VALUE 2

Sort by value

SORT_ENTITY_VALUE_BY_SYNONYM_COUNT 3

Sort by synonym count

ondewo/nlu/intent.proto

Top

Services

Intents

An intent represents a mapping between input from a user and an action to be taken by your application. When you pass user input to the DetectIntent (or StreamingDetectIntent) method, the Dialogflow API analyzes the input and searches for a matching intent. If no match is found, the Dialogflow API returns a fallback intent (is_fallback = true).

You can provide additional information for the Dialogflow API to use to match user input to an intent by adding the following to your intent.

For more information about intents, see the Dialogflow documentation.

Service Methods

ListIntents

rpc ListIntents (ListIntentsRequest) returns (ListIntentsResponse)
Returns the list of all intents in the specified agent.

GetIntent

rpc GetIntent (GetIntentRequest) returns (Intent)
Retrieves the specified intent.

CreateIntent

rpc CreateIntent (CreateIntentRequest) returns (Intent)
Creates an intent in the specified agent.

UpdateIntent

rpc UpdateIntent (UpdateIntentRequest) returns (Intent)
Updates the specified intent.

DeleteIntent

rpc DeleteIntent (DeleteIntentRequest) returns (.google.protobuf.Empty)
Deletes the specified intent.

BatchUpdateIntents

rpc BatchUpdateIntents (BatchUpdateIntentsRequest) returns (BatchUpdateIntentsResponse)
Updates/Creates multiple intents in the specified agent. Operation <response: BatchUpdateIntentsResponse>

BatchDeleteIntents

rpc BatchDeleteIntents (BatchDeleteIntentsRequest) returns (Operation)
Deletes intents in the specified agent.
Operation <response: google.protobuf.Empty>

TagIntent

rpc TagIntent (IntentTagRequest) returns (.google.protobuf.Empty)
Tags a specific intent with tag(s)

DeleteIntentTag

rpc DeleteIntentTag (IntentTagRequest) returns (.google.protobuf.Empty)
Deletes tag(s) for a specific intent

GetIntentTags

rpc GetIntentTags (GetIntentTagsRequest) returns (GetIntentTagsResponse)
Gets all the tags for a specific intent

GetAllIntentTags

rpc GetAllIntentTags (GetAllIntentTagsRequest) returns (GetIntentTagsResponse)
Gets all the tags for all the intents

BatchCreateTrainingPhrases

rpc BatchCreateTrainingPhrases (BatchCreateTrainingPhrasesRequest) returns (BatchTrainingPhrasesStatusResponse)
Creates batch of training phrases

BatchGetTrainingPhrases

rpc BatchGetTrainingPhrases (BatchGetTrainingPhrasesRequest) returns (BatchTrainingPhrasesStatusResponse)
Retrieve a training phrases batch of the specified names.

BatchUpdateTrainingPhrases

rpc BatchUpdateTrainingPhrases (BatchUpdateTrainingPhrasesRequest) returns (BatchTrainingPhrasesStatusResponse)
Updates batch of training phrases

BatchDeleteTrainingPhrases

rpc BatchDeleteTrainingPhrases (BatchDeleteTrainingPhrasesRequest) returns (BatchDeleteTrainingPhrasesResponse)
Delete a training phrases batch of the specified names.

ListTrainingPhrases

rpc ListTrainingPhrases (ListTrainingPhrasesRequest) returns (ListTrainingPhrasesResponse)
List training phrases (of a specific intent).

BatchCreateResponseMessages

rpc BatchCreateResponseMessages (BatchCreateResponseMessagesRequest) returns (BatchResponseMessagesStatusResponse)
Creates batch of intent messages

BatchGetResponseMessages

rpc BatchGetResponseMessages (BatchGetResponseMessagesRequest) returns (BatchResponseMessagesStatusResponse)
Retrieve a intent messages batch of the specified names.

BatchUpdateResponseMessages

rpc BatchUpdateResponseMessages (BatchUpdateResponseMessagesRequest) returns (BatchResponseMessagesStatusResponse)
Updates batch of intent messages

BatchDeleteResponseMessages

rpc BatchDeleteResponseMessages (BatchDeleteResponseMessagesRequest) returns (BatchDeleteResponseMessagesResponse)
Delete a intent messages batch of the specified names.

ListResponseMessages

rpc ListResponseMessages (ListResponseMessagesRequest) returns (ListResponseMessagesResponse)
List messages (of a specific intent).

BatchCreateParameters

rpc BatchCreateParameters (BatchCreateParametersRequest) returns (BatchParametersStatusResponse)
Creates batch of intent messages

BatchGetParameters

rpc BatchGetParameters (BatchGetParametersRequest) returns (BatchParametersStatusResponse)
Retrieve a intent messages batch of the specified names.

BatchUpdateParameters

rpc BatchUpdateParameters (BatchUpdateParametersRequest) returns (BatchParametersStatusResponse)
Updates batch of intent messages

BatchDeleteParameters

rpc BatchDeleteParameters (BatchDeleteParametersRequest) returns (BatchDeleteParametersResponse)
Delete a intent messages batch of the specified names.

ListParameters

rpc ListParameters (ListParametersRequest) returns (ListParametersResponse)
List messages (of a specific intent).

ListTrainingPhrasesofIntentsWithEnrichment

rpc ListTrainingPhrasesofIntentsWithEnrichment (ListTrainingPhrasesofIntentsWithEnrichmentRequest) returns (ListTrainingPhrasesofIntentsWithEnrichmentResponse)
List Training phrases (of a specific intent).

Methods with HTTP bindings

Method Name Method Pattern Body
ListIntents GET /v2/{parent=projects/*/agent}/intents
GetIntent GET /v2/{name=projects/*/agent/intents/*}
CreateIntent POST /v2/{parent=projects/*/agent}/intents *
UpdateIntent PATCH /v2/{intent.name=projects/*/agent/intents/*} *
DeleteIntent DELETE /v2/{name=projects/*/agent/intents/*}
BatchUpdateIntents POST /v2/{parent=projects/*/agent}/intents:batchUpdate *
BatchDeleteIntents POST /v2/{parent=projects/*/agent}/intents:batchDelete *
TagIntent POST /v2/{parent=projects/*/agent}/intents:tagIntent *
DeleteIntentTag POST /v2/{parent=projects/*/agent}/intents:deleteIntentTag *
Messages

BatchCreateParametersRequest

Request to create a batch of parameters in the specified intent

FieldTypeLabelDescription
parameter_requests BatchCreateParametersRequest.CreateParameterRequest repeated

List of parameters to create

BatchCreateParametersRequest.CreateParameterRequest

Request to create a single parameter

FieldTypeLabelDescription
intent_name string

Required. The name of the intent for which to create a training phrase for.

parameter Intent.Parameter

Required. The response message.

BatchCreateResponseMessagesRequest

Request to create a list of new response messages and adds it to an intent

FieldTypeLabelDescription
response_message_requests BatchCreateResponseMessagesRequest.CreateResponseMessageRequest repeated

BatchCreateResponseMessagesRequest.CreateResponseMessageRequest

Request to create a single response message

FieldTypeLabelDescription
intent_name string

Required. The name of the intent for which to create a response message for.

response_message Intent.Message

Required. The response message.

BatchCreateTrainingPhrasesRequest

This message is a request of a creation of a batch of training phrases

FieldTypeLabelDescription
training_phrase_requests BatchCreateTrainingPhrasesRequest.CreateTrainingPhraseRequest repeated

BatchCreateTrainingPhrasesRequest.CreateTrainingPhraseRequest

Request to create a single training phrase

FieldTypeLabelDescription
intent_name string

Required. The name of the intent for which to create a training phrase for.

training_phrase Intent.TrainingPhrase

Required. The training phrase to create.

BatchDeleteIntentsRequest

The request message for Intents.BatchDeleteIntents.

FieldTypeLabelDescription
parent string

Required. The name of the agent to delete all entities types for. Format: projects/<project_uuid>/agent.

intents Intent repeated

Required. The collection of intents to delete. Only intent name must be filled in.

BatchDeleteParametersRequest

Request to delete parameters specified by their names.

FieldTypeLabelDescription
names string repeated

Required. The names of the response messages. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>/parameters/<parameter_uuid

BatchDeleteParametersResponse

This message contains response of deleted parameters

FieldTypeLabelDescription
delete_statuses BatchDeleteParametersResponse.DeleteParameterStatus repeated

has_errors bool

BatchDeleteParametersResponse.DeleteParameterStatus

Status of a parameter deletion operation

FieldTypeLabelDescription
successfully_deleted google.protobuf.Empty

error_message string

BatchDeleteResponseMessagesRequest

Request to delete response messages specified by their names

FieldTypeLabelDescription
names string repeated

Required. The names of the response messages. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>/responseMessages/<message_uuid>

BatchDeleteResponseMessagesResponse

Response containing list with deleted response messages

FieldTypeLabelDescription
delete_statuses BatchDeleteResponseMessagesResponse.DeleteResponseMessageStatus repeated

has_errors bool

BatchDeleteResponseMessagesResponse.DeleteResponseMessageStatus

Status of a response message deletion operation

FieldTypeLabelDescription
successfully_deleted google.protobuf.Empty

error_message string

BatchDeleteTrainingPhrasesRequest

This message is a request to delete a batch of training phrases

FieldTypeLabelDescription
names string repeated

Required. The names of the training phrases. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>/trainingPhrases/<training_phrase_uuid>

BatchDeleteTrainingPhrasesResponse

This message is a response of deleting a batch of training phrases

FieldTypeLabelDescription
delete_statuses BatchDeleteTrainingPhrasesResponse.DeleteTrainingPhraseStatus repeated

has_errors bool

BatchDeleteTrainingPhrasesResponse.DeleteTrainingPhraseStatus

Status of a training phrase deletion operation

FieldTypeLabelDescription
successfully_deleted google.protobuf.Empty

error_message string

BatchGetParametersRequest

Request to get batch of parameters in a specified intent

FieldTypeLabelDescription
names string repeated

Required. The names of the response messages. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>/parameters/<parameter_uuid>

BatchGetResponseMessagesRequest

Request to retrieve a response messages

FieldTypeLabelDescription
names string repeated

Required. The names of the response messages. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>/responseMessages/<message_uuid>

BatchGetTrainingPhrasesRequest

This message is a request to get a batch training phrases

FieldTypeLabelDescription
names string repeated

Required. The names of the training phrases. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>/trainingPhrases/<training_phrase_uuid>

BatchParametersStatusResponse

Response containing a batch of parameters in the specified intent

FieldTypeLabelDescription
parameter_statuses BatchParametersStatusResponse.ParameterStatus repeated

has_errors bool

indicates if statuses of some of the parameters have errors

BatchParametersStatusResponse.ParameterStatus

Status of a parameter operation

FieldTypeLabelDescription
parameter Intent.Parameter

error_message string

BatchResponseMessagesStatusResponse

This message is a response of a batch responses of message status

FieldTypeLabelDescription
response_message_statuses BatchResponseMessagesStatusResponse.ResponseMessageStatus repeated

has_errors bool

indicates if statuses of some of the response messages have errors

BatchResponseMessagesStatusResponse.ResponseMessageStatus

Status of a response message operation

FieldTypeLabelDescription
response_message Intent.Message

error_message string

BatchTrainingPhrasesStatusResponse

This message is a response of the status of a batch of training phrases

FieldTypeLabelDescription
training_phrase_statuses TrainingPhraseStatus repeated

A list of training phrase statuses

has_errors bool

indicates if statuses of some of the training phrases have errors

BatchUpdateIntentsRequest

The request message for Intents.BatchUpdateIntents.

FieldTypeLabelDescription
parent string

Required. The name of the agent to update or create intents in. Format:

projects/<project_uuid>/agent

intent_batch_uri string

The URI to a Google Cloud Storage file containing intents to update or create. The file format can either be a serialized proto (of IntentBatch type) or JSON object. Note: The URI must start with "gs://".

intent_batch_inline IntentBatch

The collection of intents to update or create.

language_code string

Optional. The language of training phrases, parameters and rich messages defined in intents. If not specified, the agent's default language is used. More than a dozen languages are supported. Note: languages must be enabled in the agent, before they can be used.

update_mask google.protobuf.FieldMask

Optional. The mask to control which fields get updated.

intent_view IntentView

Optional. The resource view to apply to the returned intent.

BatchUpdateIntentsResponse

The response message for Intents.BatchUpdateIntents.

FieldTypeLabelDescription
intents Intent repeated

The collection of updated or created intents.

BatchUpdateParametersRequest

Request to update parameters and adds them to an intent

FieldTypeLabelDescription
parameters Intent.Parameter repeated

The response messages to update

BatchUpdateResponseMessagesRequest

Request to update a response message in the specified intent

FieldTypeLabelDescription
response_messages Intent.Message repeated

The response messages to update

BatchUpdateTrainingPhrasesRequest

This message is a request to update a batch of training phrases

FieldTypeLabelDescription
training_phrases Intent.TrainingPhrase repeated

A list of training phrases

CreateIntentRequest

The request message for Intents.CreateIntent.

FieldTypeLabelDescription
parent string

Required. The agent to create a intent for. Format:

projects/<project_uuid>/agent

intent Intent

Required. The intent to create.

language_code string

Optional. The language of training phrases, parameters and rich messages defined in intent. If not specified, the agent's default language is used. More than a dozen languages are supported. Note: languages must be enabled in the agent, before they can be used.

intent_view IntentView

Optional. The resource view to apply to the returned intent.

DeleteIntentRequest

The request message for Intents.DeleteIntent.

FieldTypeLabelDescription
name string

Required. The name of the intent to delete. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

GetAllIntentTagsRequest

This message is a request to get all intent tags

FieldTypeLabelDescription
parent string

Required. The name of the agent to delete all entities types for. Format: projects/<project_uuid>/agent.

GetIntentRequest

The request message for Intents.GetIntent.

FieldTypeLabelDescription
name string

Required. The name of the intent. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

language_code string

Optional. The language to retrieve training phrases, parameters and rich messages for. If not specified, the agent's default language is used. More than a dozen languages are supported. Note: languages must be enabled in the agent, before they can be used.

intent_view IntentView

Optional. The resource view to apply to the returned intent.

page_token string

The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

GetIntentTagsRequest

This message is a request to get intent tags

FieldTypeLabelDescription
intent_name string

The path of the intent. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

GetIntentTagsResponse

This message is a response of getting intent tags

FieldTypeLabelDescription
intent_tags string repeated

All the distinct intent tags sorted

Intent

Represents an intent.

Intents convert a number of user expressions or patterns into an action. An action is an extraction of a user command or sentence semantics.

FieldTypeLabelDescription
name string

Required for all methods except create (create populates the name automatically. The unique identifier of this intent. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

display_name string

Required. The name of this intent.

webhook_state Intent.WebhookState

Required. Indicates whether webhooks are enabled for the intent.

priority int32

Optional. The priority of this intent. Higher numbers represent higher priorities. Zero or negative numbers mean that the intent is disabled.

is_fallback bool

Optional. Indicates whether this is a fallback intent.

ml_disabled bool

Optional. Indicates whether Machine Learning is disabled for the intent. Note: If ml_disabled setting is set to true, then this intent is not taken into account during inference in ML ONLY match mode. Also, auto-markup in the UI is turned off.

input_context_names string repeated

Optional. The list of context names required for this intent to be triggered. Format:

projects/<project_uuid>/agent/sessions/-/contexts/<context_uuid>

events string repeated

Optional. The collection of event names that trigger the intent. If the collection of input contexts is not empty, all of the contexts must be present in the active user session for an event to trigger this intent.

training_phrases Intent.TrainingPhrase repeated

Optional. The collection of examples/templates that the agent is trained on.

action string

Optional. The name of the action associated with the intent.

output_contexts Context repeated

Optional. The collection of contexts that are activated when the intent is matched. Context messages in this collection should not set the parameters field. Setting the lifespan_count to 0 will reset the context when the intent is matched. Format:

projects/<project_uuid>/agent/sessions/-/contexts/<context_uuid>

reset_contexts bool

Optional. Indicates whether to delete all contexts in the current session when this intent is matched.

parameters Intent.Parameter repeated

Optional. The collection of parameters associated with the intent.

messages Intent.Message repeated

Optional. The collection of rich messages corresponding to the Response field in the Dialogflow console.

default_response_platforms Intent.Message.Platform repeated

Optional. The list of platforms for which the first response will be taken from among the messages assigned to the DEFAULT_PLATFORM.

root_followup_intent_name string

The unique identifier of the root intent in the chain of followup intents. It identifies the correct followup intents chain for this intent. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

parent_followup_intent_name string

The unique identifier of the parent intent in the chain of followup intents. It identifies the parent followup intent. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

followup_intent_info Intent.FollowupIntentInfo repeated

Optional. Collection of information about all followup intents that have name of this intent as a root_name.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

domain_name string

Optional. Domain to which the intent belongs

is_start_of_deviation bool

Optional. Indicates whether the intent starts a deviation in conversation flow

is_end_of_deviation bool

Optional. Indicates whether the intent ends a deviation in conversation flow

training_phrase_count int32

Optional. Total count of training phrases associated to the intent.

status Intent.IntentStatus

Indicates whether the intent is active or not

start_date google.protobuf.Timestamp

Optional. Provides information that can be used in custom scripts

end_date google.protobuf.Timestamp

Optional. Provides information that can be used in custom scripts

tags string repeated

Optional. Adds arbitrary "categories" for which one could filter the intents

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

Intent.FollowupIntentInfo

Represents a single followup intent in the chain.

FieldTypeLabelDescription
followup_intent_name string

The unique identifier of the followup intent. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

parent_followup_intent_name string

The unique identifier of the followup intent parent. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

Intent.Message

Corresponds to the Response field in the Dialogflow console.

FieldTypeLabelDescription
name string

Required. The name of the return message. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>/responseMessages/<message_uuid>

language_code string

Required. The language of the return message.

text Intent.Message.Text

The text response.

image Intent.Message.Image

The image response.

quick_replies Intent.Message.QuickReplies

The quick replies response.

card Intent.Message.Card

The card response.

payload google.protobuf.Struct

Returns a response containing a custom, platform-specific payload. See the Intent.Message.Platform type for a description of the structure that may be required for your platform.

simple_responses Intent.Message.SimpleResponses

The voice and text-only responses for Actions on Google.

basic_card Intent.Message.BasicCard

The basic card response for Actions on Google.

suggestions Intent.Message.Suggestions

The suggestion chips for Actions on Google.

link_out_suggestion Intent.Message.LinkOutSuggestion

The link out suggestion chip for Actions on Google.

list_select Intent.Message.ListSelect

The list card response for Actions on Google.

carousel_select Intent.Message.CarouselSelect

The carousel card response for Actions on Google.

html_text Intent.Message.HTMLText

The HTML text response

video Intent.Message.Video

The Video response

audio Intent.Message.Audio

The Audio response

platform Intent.Message.Platform

Optional. The platform that this message is intended for.

is_prompt bool

Read-only. States if a returned message is a prompt or not.

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

Intent.Message.Audio

The Audio response message.

FieldTypeLabelDescription
uri string

Optional. The public URI to an audio file.

accessibility_text string

Optional. A text description of the audio to be used for accessibility, e.g., screen readers.

Intent.Message.BasicCard

The basic card message. Useful for displaying information.

FieldTypeLabelDescription
title string

Optional. The title of the card.

subtitle string

Optional. The subtitle of the card.

formatted_text string

Required, unless image is present. The body text of the card.

image Intent.Message.Image

Optional. The image for the card.

buttons Intent.Message.BasicCard.Button repeated

Optional. The collection of card buttons.

Intent.Message.BasicCard.Button

The button object that appears at the bottom of a card.

FieldTypeLabelDescription
title string

Required. The title of the button.

open_uri_action Intent.Message.BasicCard.Button.OpenUriAction

Required. Action to take when a user taps on the button.

Intent.Message.BasicCard.Button.OpenUriAction

Opens the given URI.

FieldTypeLabelDescription
uri string

Required. The HTTP or HTTPS scheme URI.

Intent.Message.Card

The card response message.

FieldTypeLabelDescription
title string

Optional. The title of the card.

subtitle string

Optional. The subtitle of the card.

image_uri string

Optional. The public URI to an image file for the card.

buttons Intent.Message.Card.Button repeated

Optional. The collection of card buttons.

Intent.Message.Card.Button

Optional. Contains information about a button.

FieldTypeLabelDescription
text string

Note: One of the following is required: Optional. The text to show on the button.

postback string

Optional. The text to send back to the Dialogflow API or a URI to open.

Intent.Message.CarouselSelect

The card for presenting a carousel of options to select from.

FieldTypeLabelDescription
items Intent.Message.CarouselSelect.Item repeated

Required. Carousel items.

Intent.Message.CarouselSelect.Item

An item in the carousel.

FieldTypeLabelDescription
info Intent.Message.SelectItemInfo

Required. Additional info about the option item.

title string

Required. Title of the carousel item.

description string

Optional. The body text of the card.

image Intent.Message.Image

Optional. The image to display.

Intent.Message.HTMLText

This message contains HTML text

FieldTypeLabelDescription
text string repeated

Collection of the agent's responses in HTML format

Intent.Message.Image

The image response message.

FieldTypeLabelDescription
image_uri string

Optional. The public URI to an image file.

accessibility_text string

Optional. A text description of the image to be used for accessibility, e.g., screen readers.

Intent.Message.LinkOutSuggestion

The suggestion chip message that allows the user to jump out to the app or website associated with this agent.

FieldTypeLabelDescription
destination_name string

Required. The name of the app or site this chip is linking to.

uri string

Required. The URI of the app or site to open when the user taps the suggestion chip.

Intent.Message.ListSelect

The card for presenting a list of options to select from.

FieldTypeLabelDescription
title string

Optional. The overall title of the list.

items Intent.Message.ListSelect.Item repeated

Required. List items.

Intent.Message.ListSelect.Item

An item in the list.

FieldTypeLabelDescription
info Intent.Message.SelectItemInfo

Required. Additional information about this option.

title string

Required. The title of the list item.

description string

Optional. The main text describing the item.

image Intent.Message.Image

Optional. The image to display.

Intent.Message.QuickReplies

The quick replies response message.

FieldTypeLabelDescription
title string

Optional. The title of the collection of quick replies.

quick_replies string repeated

Optional. The collection of quick replies.

Intent.Message.SelectItemInfo

Additional info about the select item for when it is triggered in a dialog.

FieldTypeLabelDescription
key string

Required. A unique key that will be sent back to the agent if this response is given.

synonyms string repeated

Optional. A list of synonyms that can also be used to trigger this item in dialog.

Intent.Message.SimpleResponse

The simple response message containing speech or text.

FieldTypeLabelDescription
text_to_speech string

One of text_to_speech or ssml must be provided. The plain text of the speech output. Mutually exclusive with ssml.

ssml string

One of text_to_speech or ssml must be provided. Structured spoken response to the user in the SSML format. Mutually exclusive with text_to_speech.

display_text string

Optional. The text to display.

Intent.Message.SimpleResponses

The collection of simple response candidates. This message in QueryResult.fulfillment_messages and WebhookResponse.fulfillment_messages should contain only one SimpleResponse.

FieldTypeLabelDescription
simple_responses Intent.Message.SimpleResponse repeated

Required. The list of simple responses.

Intent.Message.Suggestion

The suggestion chip message that the user can tap to quickly post a reply to the conversation.

FieldTypeLabelDescription
title string

Required. The text shown the in the suggestion chip.

Intent.Message.Suggestions

The collection of suggestions.

FieldTypeLabelDescription
suggestions Intent.Message.Suggestion repeated

Required. The list of suggested replies.

Intent.Message.Text

The text response message.

FieldTypeLabelDescription
text string repeated

Optional. The collection of the agent's responses.

Intent.Message.Video

The Video response message.

FieldTypeLabelDescription
uri string

Optional. The public URI to a video file.

accessibility_text string

Optional. A text description of the video to be used for accessibility, e.g., screen readers.

Intent.Parameter

Represents intent parameters.

FieldTypeLabelDescription
name string

The unique identifier of this parameter. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>/parameters/<parameter_uuid>

display_name string

Required. The name of the parameter.

value string

Optional. The definition of the parameter value. It can be:

  • a constant string,
  • a parameter value defined as $parameter_name,
  • an original parameter value defined as $parameter_name.original,
  • a parameter value from some context defined as #context_name.parameter_name.

default_value string

Optional. The default value to use when the value yields an empty result. Default values can be extracted from contexts by using the following syntax: #context_name.parameter_name.

entity_type_name string

Optional. The unique identifier of the entity type in format projects/<project_uuid>/agent/entityTypes/<entity_type_uuid> that describes values of the parameter. If the parameter is required, this must be provided.

entity_type_display_name string

Optional. The name of the entity type that describes values of the parameter. If the parameter is required, this must be provided.

mandatory bool

Optional. Indicates whether the parameter is required. That is, whether the intent cannot be completed without collecting the parameter value.

prompts Intent.Parameter.Prompt repeated

Optional. The collection of prompts that the agent can present to the user in order to collect value for the parameter.

is_list bool

Optional. Indicates whether the parameter represents a list of values.

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

Intent.Parameter.Prompt

Represents the prompts in the parameters.

FieldTypeLabelDescription
name string

The unique identifier of this prompt. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>/parameters/<parameter_uuid>/prompts/<prompt_uuid>

text string

Required. Text of the prompt

language_code string

The language of the prompts. If not specified, the default language code will be used.

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

Intent.TrainingPhrase

Represents an example or template that the agent is trained on.

FieldTypeLabelDescription
name string

Required. The unique identifier of this training phrase. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>/trainingPhrases/<training_phrase_uuid>

type Intent.TrainingPhrase.Type

Required. The type of the training phrase.

text string

Required. The text of the training phrase.

entities Intent.TrainingPhrase.Entity repeated

Optional. The collection of annotated entities in the training phrase.

times_added_count int32

Optional. Indicates how many times this example or template was added to the intent. Each time a developer adds an existing sample by editing an intent or training, this counter is increased.

language_code string

Optional. The language of the training phrase.

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

Intent.TrainingPhrase.Entity

Represents an entity annotation in a training phrase. The entity can be annotated on the level of

entity type only or both entity type and entity value.

FieldTypeLabelDescription
entity_type_name string

Required. The unique entity type identifier in format projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>.

entity_type_display_name string

Optional. The entity type name.

entity_value_name string

Optional. The unique entity value identifier in format projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>/entities/<entity_uuid>. The entity value must belong to the entity type defined in entity_type_name.

entity_value_display_name string

Optional. The entity value name.

start int32

Required. Defines a character position, where the entity starts in the training phrase text (0-indexed).

end int32

Required. Defines a character position + 1, where the entity ends in the training phrase. Example: "Meet you tomorrow" -> Entity(entity_type_display_name="sys.date", start=9, end=17)

parameter_name string

Optional. The unique parameter identifier in format projects/<project_uuid>/agent/intents/<intent_uuid>/parameters/<parameter_uuid> for the value extracted from the annotated part of the example. The parameter must be one of the parameters defined in the top-level intent message. Can be unset if the parameter is created in the same create/update intent request as the annotation.

parameter_display_name string

Optional. The parameter name.

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

IntentBatch

This message is a wrapper around a collection of intents.

FieldTypeLabelDescription
intents Intent repeated

A collection of intents.

IntentSorting

This message contains sorting of an intent

FieldTypeLabelDescription
sorting_field IntentSorting.IntentSortingField

sorting_mode SortingMode

IntentTagRequest

This message is a request to get an intent tag

FieldTypeLabelDescription
intent_name string

The path of the intent. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

tags string repeated

Intent tags for this intent to operate on

ListIntentsRequest

The request message for Intents.ListIntents.

FieldTypeLabelDescription
parent string

Required. The agent to list all intents from. Format:

projects/<project_uuid>/agent

language_code string

Optional. The language to list training phrases, parameters and rich messages for. If not specified, the agent's default language is used. More than a dozen languages are supported. Note: languages must be enabled in the agent before they can be used.

intent_view IntentView

Optional. The resource view to apply to the returned intent.

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

filter_by_category IntentCategory

Optional. Applies a filter to the list. Default, no filter.

sort_by_field IntentSorting

Optional. Defines the sorting of the list. Default, no sorting.

filter_by_tags string repeated

Optional. Applies a filter to the list by tags. Default, no filter.

ListIntentsResponse

The response message for Intents.ListIntents.

FieldTypeLabelDescription
intents Intent repeated

The list of agent intents. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

ListParametersRequest

The request message for TrainingPhraseRequest

FieldTypeLabelDescription
intent_name string

Required. The agent to list all intents from. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

language_code string

Optional. The language code used to filter out prompts.

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

ListParametersResponse

The response message for ListTrainingPhrase

FieldTypeLabelDescription
parameters Intent.Parameter repeated

The list of parameters. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

Token to retrieve the next page of results, or empty if there are no more results in the list. Format: current_index-<CURRENT_INDEX>--page_size-<PAGE_SIZE>--sub_field-<SUB_FIELD> where <CURRENT_INDEX> and <PAGE_SIZE> are of type int, <SUB_FIELD> is of type str (example: parameters)

ListResponseMessagesRequest

The request message for ResponseMessageRequest

FieldTypeLabelDescription
intent_name string

Required. The agent to list all intents from. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

language_code string

Optional. The language to list response messages, parameters and rich messages for. If not specified, the agent's default language is used.

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

ListResponseMessagesResponse

The response message for ListResponseMessage

FieldTypeLabelDescription
response_messages Intent.Message repeated

The list of response messages. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

Token to retrieve the next page of results, or empty if there are no more results in the list. Format: current_index-<CURRENT_INDEX>--page_size-<PAGE_SIZE>--sub_field-<SUB_FIELD> where <CURRENT_INDEX> and <PAGE_SIZE> are of type int, <SUB_FIELD> is of type str (example: messages)

ListTrainingPhrasesRequest

The request message for TrainingPhraseRequest

FieldTypeLabelDescription
intent_name string

Required. The agent to list all intents from. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

language_code string

Optional. The language to list training phrases, parameters and rich messages for. If not specified, the agent's default language is used.

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

ListTrainingPhrasesResponse

The response message for ListTrainingPhrase

FieldTypeLabelDescription
training_phrases Intent.TrainingPhrase repeated

The list of training phrases. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

Token to retrieve the next page of results, or empty if there are no more results in the list. Format: current_index-<CURRENT_INDEX>--page_size-<PAGE_SIZE>--sub_field-<SUB_FIELD> where <CURRENT_INDEX> and <PAGE_SIZE> are of type int, <SUB_FIELD> is of type str (example: training_phrases)

ListTrainingPhrasesofIntentsWithEnrichmentRequest

The request message for TrainingPhraseRequest

FieldTypeLabelDescription
parent string

Required. The name of the agent to delete all entities types for. Format: projects/<project_uuid>/agent.

language_code string

Optional. The language code used to filter out prompts.

intent_ids string repeated

Optional. List of intent uuids to filter by. Only training phrases that have this intent uuid will be returned If not passed, returns all

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

ListTrainingPhrasesofIntentsWithEnrichmentResponse

This message contains a list of training phrases filtered by intent ids, language code and parent passed through the request

FieldTypeLabelDescription
training_phrases string repeated

List of user_says values. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

Optional. The next_page_token value returned from a previous list request. Format: current_index-<CURRENT_INDEX>--page_size-<PAGE_SIZE>--sub_field-<SUB_FIELD> where <CURRENT_INDEX> and <PAGE_SIZE> are of type int, <SUB_FIELD> is of type str (example: parameters)

TrainingPhraseStatus

This message containing the training phrases status

FieldTypeLabelDescription
training_phrase Intent.TrainingPhrase

error_message string

UpdateIntentRequest

The request message for Intents.UpdateIntent.

FieldTypeLabelDescription
intent Intent

Required. The intent to update. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

language_code string

Optional. The language of training phrases, parameters and rich messages defined in intent. If not specified, the agent's default language is used. More than a dozen languages are supported. Note: languages must be enabled in the agent, before they can be used.

update_mask google.protobuf.FieldMask

Optional. The mask to control which fields get updated.

intent_view IntentView

Optional. The resource view to apply to the returned intent.

Enums

Intent.IntentStatus

Structure of status of an Intent

NameNumberDescription
ACTIVE 0

Intent is active

INACTIVE 1

Intent is inactive

Intent.Message.Platform

Represents different platforms that a rich message can be intended for.

NameNumberDescription
PLATFORM_UNSPECIFIED 0

Not specified.

FACEBOOK 1

Facebook.

SLACK 2

Slack.

TELEGRAM 3

Telegram.

KIK 4

Kik.

SKYPE 5

Skype.

LINE 6

Line.

VIBER 7

Viber.

ACTIONS_ON_GOOGLE 8

Actions on Google. When using Actions on Google, you can choose one of the specific Intent.Message types that mention support for Actions on Google, or you can use the advanced Intent.Message.payload field. The payload field provides access to AoG features not available in the specific message types. If using the Intent.Message.payload field, it should have a structure similar to the JSON message shown here. For more information, see Actions on Google Webhook Format

{
  "expectUserResponse": true,
  "isSsml": false,
  "noInputPrompts": [],
  "richResponse": {
    "items": [
      {
        "simpleResponse": {
          "displayText": "hi",
          "textToSpeech": "hello"
        }
      }
    ],
    "suggestions": [
      {
        "title": "Say this"
      },
      {
        "title": "or this"
      }
    ]
  },
  "systemIntent": {
    "data": {
      "@type": "type.googleapis.com/google.actions.v2.OptionValueSpec",
      "listSelect": {
        "items": [
          {
            "optionInfo": {
              "key": "key1",
              "synonyms": [
                "key one"
              ]
            },
            "title": "must not be empty, but unique"
          },
          {
            "optionInfo": {
              "key": "key2",
              "synonyms": [
                "key two"
              ]
            },
            "title": "must not be empty, but unique"
          }
        ]
      }
    },
    "intent": "actions.intent.OPTION"
  }
}

PLACEHOLDER_1 9

Placeholder platform 1

PLACEHOLDER_2 10

Placeholder platform 2

PLACEHOLDER_3 11

Placeholder platform 3

PLACEHOLDER_4 12

Placeholder platform 4

PLACEHOLDER_5 13

Placeholder platform 5

PLACEHOLDER_6 14

Placeholder platform 6

PLACEHOLDER_7 15

Placeholder platform 7

PLACEHOLDER_8 16

Placeholder platform 8

PLACEHOLDER_9 17

Placeholder platform 9

PLACEHOLDER_10 18

Placeholder platform 10

PLACEHOLDER_11 19

Placeholder platform 11

PLACEHOLDER_12 20

Placeholder platform 12

PLACEHOLDER_13 21

Placeholder platform 13

PLACEHOLDER_14 22

Placeholder platform 14

PLACEHOLDER_15 23

Placeholder platform 15

PLACEHOLDER_16 24

Placeholder platform 16

PLACEHOLDER_17 25

Placeholder platform 17

PLACEHOLDER_18 26

Placeholder platform 18

PLACEHOLDER_19 27

Placeholder platform 19

PLACEHOLDER_20 28

Placeholder platform 20

Intent.TrainingPhrase.Type

Represents different types of training phrases.

NameNumberDescription
TYPE_UNSPECIFIED 0

Not specified. This value should never be used.

EXAMPLE 1

Examples do not contain @-prefixed entity type names, but example parts can be annotated with entity types.

TEMPLATE 2

Templates are not annotated with entity types, but they can contain @-prefixed entity type names as substrings.

Intent.WebhookState

Represents the different states that webhooks can be in.

NameNumberDescription
WEBHOOK_STATE_UNSPECIFIED 0

Webhook is disabled in the agent and in the intent.

WEBHOOK_STATE_ENABLED 1

Webhook is enabled in the agent and in the intent.

WEBHOOK_STATE_ENABLED_FOR_SLOT_FILLING 2

Webhook is enabled in the agent and in the intent. Also, each slot filling prompt is forwarded to the webhook.

IntentCategory

Represents the type of intents to filter by in the "List Intents" request

NameNumberDescription
ALL_INTENTS 0

represent all intents

DEFAULT_INTENTS 1

represent the default intents

USER_DEFINED_INTENTS 2

represent the user defined (custom) intents

DATE_EXPIRED_INTENTS 3

represents the intents that had its end_date elapsed

DATE_ACTIVE_INTENTS 4

represents the intents that its start_date began but had not yet expired

DATE_UPCOMING_INTENTS 5

represent the intents that are still expecting its start_date to begin

IntentSorting.IntentSortingField

Structure of intent sorting field

NameNumberDescription
NO_INTENT_SORTING 0

No sorting applied

SORT_INTENT_BY_NAME 1

Sort by intent name

SORT_INTENT_BY_CREATION_DATE 2

Sort by creation date

SORT_INTENT_BY_LAST_UPDATED 3

Sort by last updated date

SORT_INTENT_BY_USERSAYS_COUNT 4

Sort by training phrase (user says) count

SORT_INTENT_BY_START_DATE 5

Sort by start date

SORT_INTENT_BY_END_DATE 6

Sort by end date

IntentView

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 by default.

NameNumberDescription
INTENT_VIEW_UNSPECIFIED 0

Same as INTENT_VIEW_FULL

INTENT_VIEW_FULL 1

All fields are populated.

INTENT_VIEW_PARTIAL 2

The only nested structures populated are Contexts and Training phrases. The Training phrases field is populated with only a few entries and no annotations.

INTENT_VIEW_SHALLOW 3

All nested structures are not populated (no training phrases, nor contexts, nor parameters, ...)

INTENT_VIEW_MINIMUM 4

Minimum view including only intent UUID and intent display name

ondewo/nlu/operation_metadata.proto

Top

Messages

OperationMetadata

Represents the metadata of the long-running operation that can be a parent operation for sub-operations or

can be a sub-operation itself

FieldTypeLabelDescription
status OperationMetadata.Status

long-running operation status code

parent_operation_name string

optional parent operation name

sub_operation_names string repeated

list of the sub-operations' names of the operation

create_time google.protobuf.Timestamp

the time the operation was submitted.

start_time google.protobuf.Timestamp

the time operation processing started.

end_time google.protobuf.Timestamp

the time operation processing completed.

is_cancellation_requested bool

indicates whether a request to cancel this operation has been made.

cancel_command string

command executed at cancel operation

user_id_created string

id of the user who created the operation

user_id_cancelled string

id of the user who cancelled the operation

project_parent string

project parent name, e.g. "projects/pepper/agent"

operation_type OperationMetadata.OperationType

operation type

host_name string

name of the host where the operation was executed

num_reruns int32

number of times the operation was re-run

max_num_reruns int32

maximum number of re-runs in case the operation fails

description string

description, normally needed for sub operations when type is OPERATION_TYPE_UNSPECIFIED

log string repeated

The log output of an operation

log_limit int32

The log output of an operation limited to the last x log entries

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

Enums

OperationMetadata.OperationType

Type of operation.

It can be creating, importing, exporting, deleting, restoring, building cache, training or exporting benchmark an agent

NameNumberDescription
OPERATION_TYPE_UNSPECIFIED 0

unspecified operation type

CREATE_AGENT 1

create a new agent with specified configuration

IMPORT_AGENT 2

import agent from a zip file

EXPORT_AGENT 3

export agent to a zip file

DELETE_AGENT 4

delete agent

RESTORE_AGENT 5

restore agent

BUILD_AGENT_CACHE 6

build agent cache

TRAIN_AGENT 7

train agent

EXPORT_BENCHMARK_AGENT 8

export benchmark agent to a zip file

INDEX_AGENT 9

force loading agent data for full text search

OperationMetadata.Status

Structure to set status of operation.

An operation may not be started if NOT_STARTED is set, in progress if IN_PROGRESS, finished if DONE, interrupted if CANCELED or failed if FAILED.

NameNumberDescription
STATUS_UNSPECIFIED 0

unspecified status code

NOT_STARTED 1

operation haven't started yet

IN_PROGRESS 2

operation currently in progress

DONE 3

operation has completed without any error

CANCELLED 4

operation has completed with cancellation by user

FAILED 5

operation has completed with errors

ondewo/nlu/operations.proto

Top

Services

Operations

Manages long-running operations with an API service.

When an API method normally takes long time to complete, it can be designed to return Operation to the client, and the client can use this interface to receive the real response asynchronously by polling the operation resource, or pass the operation resource to another API (such as Google Cloud Pub/Sub API) to receive the response. Any API service that returns long-running operations should implement the Operations interface so developers can have a consistent client experience.

Service Methods

ListOperations

rpc ListOperations (ListOperationsRequest) returns (ListOperationsResponse)
Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.
NOTE: the name binding below allows API services to override the binding to use different resource name schemes, such as users/*/operations.

GetOperation

rpc GetOperation (GetOperationRequest) returns (Operation)
Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.

DeleteOperation

rpc DeleteOperation (DeleteOperationRequest) returns (.google.protobuf.Empty)
Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED

CancelOperation

rpc CancelOperation (CancelOperationRequest) returns (.google.protobuf.Empty)
Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED. Clients can use Operations.GetOperation or other methods to verify whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to Code.CANCELLED.

Methods with HTTP bindings

Method Name Method Pattern Body
ListOperations GET /v1/{name=operations}
GetOperation GET /v1/{name=operations/**}
DeleteOperation DELETE /v1/{name=operations/**}
CancelOperation POST /v1/{name=operations/**}:cancel *
Messages

CancelOperationRequest

The request message for Operations.CancelOperation.

FieldTypeLabelDescription
name string

The name of the operation resource to be cancelled.

DeleteOperationRequest

The request message for Operations.DeleteOperation.

FieldTypeLabelDescription
name string

The name of the operation resource to be deleted.

GetOperationRequest

The request message for Operations.GetOperation.

FieldTypeLabelDescription
name string

The name of the operation resource.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListOperationsRequest

The request message for Operations.ListOperations.

FieldTypeLabelDescription
name string

The name of the operation collection.

filter string

The standard list filter.

page_size int32

The standard list page size.

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

operation_filter OperationFilter

Optional. A filter to narrow the response down to operations of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListOperationsResponse

The response message for Operations.ListOperations.

FieldTypeLabelDescription
operations Operation repeated

A list of operations that matches the specified filter in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

Operation

This resource represents a long-running operation that is the result of a network API call.

FieldTypeLabelDescription
name string

The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.

metadata OperationMetadata

Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.

done bool

If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.

error google.rpc.Status

The error result of the operation in case of failure or cancellation.

response google.protobuf.Any

The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.

OperationFilter

This message contains an operation filter

FieldTypeLabelDescription
project_parents string repeated

An operationFilter can be used in some requests to return only operations matching certain filter conditions. All fields below are optional. Multiple fields specified at the same time are chained via OR. Match operations with any of the following project parents.

statuses OperationMetadata.Status repeated

Match operation which had any of the following operation statuses.

types OperationMetadata.OperationType repeated

Match operation which had any of the following operation types.

start_time google.protobuf.Timestamp

The time operation processing started.

end_time google.protobuf.Timestamp

The time operation processing completed.

user_ids string repeated

Match operation which had any of the following user_ids.

ondewo/nlu/project_role.proto

Top

Services

ProjectRoles

Project roles

Service Methods

CreateProjectRole

rpc CreateProjectRole (CreateProjectRoleRequest) returns (ProjectRole)
Creates a project role by creating the knowledge base master

GetProjectRole

rpc GetProjectRole (GetProjectRoleRequest) returns (ProjectRole)
Creates a project role by getting the knowledge base master

DeleteProjectRole

rpc DeleteProjectRole (DeleteProjectRoleRequest) returns (.google.protobuf.Empty)
Deletes project role

UpdateProjectRole

rpc UpdateProjectRole (UpdateProjectRoleRequest) returns (ProjectRole)
Updates project role

ListProjectRoles

rpc ListProjectRoles (ListProjectRolesRequest) returns (ListProjectRolesResponse)
List project roles

Methods with HTTP bindings

Method Name Method Pattern Body
CreateProjectRole POST /v2/{parent=projects/*/agent}/project_roles *
GetProjectRole GET /v2/{parent=projects/*/agent}/project_roles/{role_id=*}
DeleteProjectRole DELETE /v2/{parent=projects/*/agent}/project_roles/{role_id=*}
UpdateProjectRole PATCH /v2/{parent=projects/*/agent}/project_roles *
ListProjectRoles GET /v2/{parent=projects/*/agent}/project_roles
Messages

CreateProjectRoleRequest

This message is a request to create project role

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

role ProjectRole

If the role_id is not provided, an incremental value will be assigned The "name" and "role_type" are mandatory values The permissions all default to False if not provided specifically

project_role_view ProjectRoleView

Optional. specify the view of the created project role, PROJECT_ROLE_VIEW_FULL by default

DeleteProjectRoleRequest

This message is a request to delete project role

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

role_id uint32

role is identified by role id, if empty will throw an error in the backend

GetProjectRoleRequest

This message is a request to get project role

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

role_id uint32

role is identified by role id

role_name string

role can also be uniquely identified by its name

project_role_view ProjectRoleView

Optional. specify the view of the project role, PROJECT_ROLE_VIEW_FULL by default

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListProjectRolesRequest

This message is a request to list project role

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

project_role_view ProjectRoleView

Optional. specify the view of the project roles, PROJECT_ROLE_VIEW_FULL by default

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListProjectRolesResponse

This message is a response of listing project role

FieldTypeLabelDescription
project_roles ProjectRole repeated

The list of project roles. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

ProjectRole

Project Role messages

FieldTypeLabelDescription
role_id uint32

unique identifier of the role

name string

unique name of the role

permissions string repeated

defines the permissions for the given role (the strings can be gotten from the ListProjectPermissions)

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

UpdateProjectRoleRequest

This message is a request to update project role

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

role ProjectRole

role_id in the Role message should be given, if empty will throw an error in the backend other fields in the Role are optional. Only the fields to be updated should be provided

update_mask google.protobuf.FieldMask

Optional. The mask to control which fields get updated.

project_role_view ProjectRoleView

Optional. specify the view of the updated project role, PROJECT_ROLE_VIEW_FULL by default

Enums

DefaultProjectRole

Structure of project role

NameNumberDescription
PROJECT_UNSPECIFIED 0

These roles have permissions valid only on a specific project unspecified, default value depends on endpoint

PROJECT_USER 1

read-only access

PROJECT_EXECUTOR 2

permissions of PROJECT_USER + execution rights (detect intent, extract entities, train, etc)

PROJECT_DEVELOPER 3

permissions of PROJECT_EXECUTOR + CRUD rights

PROJECT_ADMIN 4

this role can do everything. The creator of a project is set automatically as PROJECT_ADMIN of it.

PROJECT_INACTIVE 5

This role can do nothing. Used to set a user as inactive inside a project

ProjectRoleView

Structure of project role view

NameNumberDescription
PROJECT_ROLE_VIEW_UNSPECIFIED 0

The view depends on the endpoint:

  • CreateProjectRole: FULL
  • GetProjectRole: FULL
  • UpdateProjectRole: FULL
  • ListProjectRoles: FULL

PROJECT_ROLE_VIEW_SHALLOW 1

only role ID and name fields are populated

PROJECT_ROLE_VIEW_FULL 2

all fields including permissions are populated

ondewo/nlu/project_statistics.proto

Top

Services

ProjectStatistics

Project Root Statistics

Service Methods

GetIntentCount

rpc GetIntentCount (GetIntentCountRequest) returns (StatResponse)
Returns the intent count within a project

GetEntityTypeCount

rpc GetEntityTypeCount (GetEntityTypeCountRequest) returns (StatResponse)
Returns the entity types count within a project

GetUserCount

rpc GetUserCount (GetProjectStatRequest) returns (StatResponse)
Returns the users count within a project

GetSessionCount

rpc GetSessionCount (GetProjectStatRequest) returns (StatResponse)
Returns the sessions count within a project

GetTrainingPhraseCount

rpc GetTrainingPhraseCount (GetProjectElementStatRequest) returns (StatResponse)
Returns the training phrases count within a project

GetResponseCount

rpc GetResponseCount (GetProjectElementStatRequest) returns (StatResponse)
Returns the responses count within a project

GetEntityValueCount

rpc GetEntityValueCount (GetProjectElementStatRequest) returns (StatResponse)
Returns the entity value count within a project

GetEntitySynonymCount

rpc GetEntitySynonymCount (GetProjectElementStatRequest) returns (StatResponse)
Returns the entity synonyms count within a project

Methods with HTTP bindings

Method Name Method Pattern Body
GetIntentCount GET /{parent=projects/*/agent}/intents:count
GetEntityTypeCount GET /{parent=projects/*/agent}/entityTypes:count
GetUserCount GET /{parent=projects/*/agent}/users:count
GetSessionCount GET /{parent=projects/*/agent}/sessions:count
GetTrainingPhraseCount GET /{name=projects/*/agent/intents/*}/trainingPhrases:count
GetResponseCount GET /{name=projects/*/agent/intents/*}/responses:count
GetEntityValueCount GET /{name=projects/*/agent/entityTypes/*}/entities:count
GetEntitySynonymCount GET /{name=projects/*/agent/entityTypes/*/entityValues/*}/entitySynonyms:count
Messages

GetEntityTypeCountRequest

Request to get entity type count

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

filter_by_category EntityTypeCategory

Optional. Applies a filter to the list to be counted. Default, no filter.

GetIntentCountRequest

Request to get the intent count

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

filter_by_category IntentCategory

Optional. Applies a filter to the list to be counted. Default, no filter.

GetProjectElementStatRequest

Request to get project element statistics

FieldTypeLabelDescription
name string

Required. The name/path of the concept to get the statistic from. Example:

  • projects/<project_uuid>/agent/intents/<intent_uuid>
  • projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>
  • projects/<project_uuid>/agent/entityTypes/<entity_type_uuid>/entityValues/<entity_value_uuid>

language_code string

Language code

GetProjectStatRequest

Request to get project statistics

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

ondewo/nlu/rag.proto

Top

File-level comment for ondewo/nlu/rag.proto.

This file contains a single service Rags. The Rags service provides integration with RAGFlow for Retrieval-Augmented Generation (RAG), including dataset management, document processing, chunk retrieval, conversational AI with chat and agent assistants, and file management. Key message types include RagDataset, RagChat, and RagAgent.

All message fields that are marked as optional are not actually optional but marked as such to enable presence tracking so that it is possible to distinguish between null and default value fields. Without the optional keyword it would for instance not be possible to distinguish between an integer 0 and null.

Services

Rags

Provides an interface for interacting with the RAGFlow RAG engine.

Covers all endpoints of the RAGFlow HTTP API. For more information on RAGFlow refer to the official documentation

Service Methods

RagCreateDataset

rpc RagCreateDataset (RagCreateDatasetRequest) returns (RagDataset)
Create a new dataset (knowledge base).
Uses tenant's default embedding model if not specified.

RagUpdateDataset

rpc RagUpdateDataset (RagUpdateDatasetRequest) returns (RagDataset)
Update an existing dataset's configuration.
Cannot change embedding_model if dataset has chunks.

RagDeleteDatasets

rpc RagDeleteDatasets (RagDeleteRequest) returns (RagPartialSuccess)
Delete one or more datasets (batch operation).
If ids is null or empty, deletes all user's datasets.
Deletes all associated documents, files, and chunks.

RagListDatasets

rpc RagListDatasets (RagListDatasetsRequest) returns (RagDatasetList)
List datasets with pagination and filtering.
Returns datasets from all tenants the user has access to.

RagGetKnowledgeGraph

rpc RagGetKnowledgeGraph (RagDatasetIdRequest) returns (RagGetKnowledgeGraphResponse)
Get the knowledge graph for a dataset.
Returns graph structure with nodes (max 256) and edges (max 128).

RagDeleteKnowledgeGraph

rpc RagDeleteKnowledgeGraph (RagDatasetIdRequest) returns (.google.protobuf.Empty)
Delete the knowledge graph for a dataset.
Deletes graph-related chunks but not the dataset itself.

RagConstructKnowledgeGraph

rpc RagConstructKnowledgeGraph (RagDatasetIdRequest) returns (RagConstructKnowledgeGraphResponse)
Construct a knowledge graph for a dataset.
Uses the dataset's GraphRAG settings.

RagKnowledgeGraphStatus

rpc RagKnowledgeGraphStatus (RagDatasetIdRequest) returns (RagTaskStatus)
Get the knowledge graph construction status of a dataset.

RagConstructRaptor

rpc RagConstructRaptor (RagDatasetIdRequest) returns (RagConstructRaptorResponse)
Construct a RAPTOR for a dataset.
Uses the dataset's RAPTOR settings.

RagRaptorStatus

rpc RagRaptorStatus (RagDatasetIdRequest) returns (RagTaskStatus)
Get the RAPTOR construction status of a dataset.

RagUploadDocuments

rpc RagUploadDocuments (stream RagUploadDocumentsRequest) returns (RagDocumentList)
Upload one or more documents to a dataset.
Documents start in UNSTART state and must be parsed.

RagUpdateDocument

rpc RagUpdateDocument (RagUpdateDocumentRequest) returns (RagDocument)
Update document metadata and configuration.
Changing chunk_method resets document to UNSTART and deletes chunks.

RagDownloadDocument

rpc RagDownloadDocument (RagDownloadDocumentRequest) returns (stream RagFileChunk)
Download the original document file.
Returns binary file stream from storage.
First chunk contains metadata, subsequent chunks only contain data.

RagListDocuments

rpc RagListDocuments (RagListDocumentsRequest) returns (RagListDocumentsResponse)
List documents in a dataset with pagination and filtering.
Supports time range filtering and keyword search.

RagDeleteDocuments

rpc RagDeleteDocuments (RagDeleteDocumentsRequest) returns (RagPartialSuccess)
Delete one or more documents from a dataset (batch operation).
If ids empty, deletes all documents. Removes chunks and storage files.

RagParseDocuments

rpc RagParseDocuments (RagParseDocumentsRequest) returns (RagPartialSuccess)
Start parsing documents into chunks.
Cannot parse documents currently being processed (0 < progress < 1).
Queues documents for background processing.

RagStopParsing

rpc RagStopParsing (RagStopParsingRequest) returns (RagPartialSuccess)
Stop parsing documents.
Can only stop documents with progress between 0 and 1.

RagListChunks

rpc RagListChunks (RagListChunksRequest) returns (RagListChunksResponse)
List chunks of a document with pagination.
Supports keyword search with content highlighting.

RagAddChunk

rpc RagAddChunk (RagAddChunkRequest) returns (RagAddChunkResponse)
Manually add a chunk to a document.
Automatically tokenizes content and generates embeddings.

RagRemoveChunks

rpc RagRemoveChunks (RagRemoveChunksRequest) returns (RagPartialSuccess)
Remove one or more chunks from a document.
If chunk_ids empty, removes all chunks from document.

RagUpdateChunk

rpc RagUpdateChunk (RagUpdateChunkRequest) returns (.google.protobuf.Empty)
Update an existing chunk's content and metadata.
Re-tokenizes content and re-generates embeddings if content changed.

RagRetrieval

rpc RagRetrieval (RagRetrievalRequest) returns (RagRetrievalResponse)
Retrieve chunks using vector similarity search.
All datasets must use the same embedding model.
Supports reranking, metadata filtering, and knowledge graph retrieval.

RagUploadFiles

rpc RagUploadFiles (stream RagUploadFilesRequest) returns (RagFileList)
Upload one or more files via multipart form data.
Supports nested folder paths in filename.
Auto-creates intermediate folders.

RagCreateFile

rpc RagCreateFile (RagCreateFileRequest) returns (RagFile)
Create a new file or folder.
Duplicate names in same folder not allowed.

RagListFiles

rpc RagListFiles (RagListFilesRequest) returns (RagListFilesResponse)
List files in a folder with pagination.
Supports keyword search. Auto-initializes knowledgebase docs folder.

RagGetRootFolder

rpc RagGetRootFolder (RagGetRootFolderRequest) returns (RagGetRootFolderResponse)
Get user's root folder information.
Each tenant has a unique root folder.

RagGetParentFolder

rpc RagGetParentFolder (RagFileIdRequest) returns (RagGetParentFolderResponse)
Get the parent folder of a file.
Returns 404 if file or parent not found.

RagGetAllParentFolders

rpc RagGetAllParentFolders (RagFileIdRequest) returns (RagParentFoldersList)
Get all parent folders (breadcrumb path) of a file.
Returns array from file itself to root (includes the file, ordered deepest to root).

RagDeleteFiles

rpc RagDeleteFiles (RagDeleteFilesRequest) returns (.google.protobuf.Empty)
Delete one or more files/folders.
Recursively deletes folder contents. Removes from storage.

RagRenameFile

rpc RagRenameFile (RagRenameFileRequest) returns (.google.protobuf.Empty)
Rename a file or folder.
Cannot change file extension. Duplicate names not allowed.

RagDownloadFile

rpc RagDownloadFile (RagFileIdRequest) returns (stream RagFileChunk)
Download a file.
Retrieves from MinIO/S3 storage.
First chunk contains metadata, subsequent chunks only contain data.

RagMoveFile

rpc RagMoveFile (RagMoveFileRequest) returns (.google.protobuf.Empty)
Move one or more files to another folder.
Validates all files and destination exist.

RagFileToDocument

rpc RagFileToDocument (RagFileToDocumentRequest) returns (RagFileToDocumentList)
Convert files to documents and add to datasets.
Handles folders recursively (converts all inner files).
Links files to multiple datasets if multiple dataset_ids provided.

RagCreateChatAssistant

rpc RagCreateChatAssistant (RagCreateChatAssistantRequest) returns (RagChatAssistant)
Create a new chat assistant.
All datasets must have parsed files (chunk_num > 0).
All datasets must use the same embedding model.

RagUpdateChatAssistant

rpc RagUpdateChatAssistant (RagUpdateChatAssistantRequest) returns (.google.protobuf.Empty)
Update an existing chat assistant's configuration.
LLM and prompt configs are merged with existing values.

RagDeleteChatAssistants

rpc RagDeleteChatAssistants (RagDeleteRequest) returns (RagPartialSuccess)
Delete one or more chat assistants (batch operation).
If ids empty, deletes all user's chats.

RagListChatAssistants

rpc RagListChatAssistants (RagListChatAssistantsRequest) returns (RagChatAssistantList)
List chat assistants with pagination.
Returns full dataset objects (not just IDs).

RagCreateAgent

rpc RagCreateAgent (RagCreateAgentRequest) returns (.google.protobuf.Empty)
Create a new agent with DSL configuration.
Title must be unique for the user.

RagUpdateAgent

rpc RagUpdateAgent (RagUpdateAgentRequest) returns (.google.protobuf.Empty)
Update an existing agent.
DSL updates create new version snapshot. Only owner can update.

RagDeleteAgent

rpc RagDeleteAgent (RagDeleteAgentRequest) returns (.google.protobuf.Empty)
Delete an agent.
Only owner can delete.

RagListAgents

rpc RagListAgents (RagListAgentsRequest) returns (RagAgentList)
List agents with pagination.
Only returns user's own agents.

RagCreateChatSession

rpc RagCreateChatSession (RagCreateChatSessionRequest) returns (RagChatSession)
Create a new chat session (conversation).
Session initialized with assistant's prologue message.

RagUpdateChatSession

rpc RagUpdateChatSession (RagUpdateChatSessionRequest) returns (.google.protobuf.Empty)
Update a chat session's metadata (name only).
Cannot update message or reference fields.

RagListChatSessions

rpc RagListChatSessions (RagListChatSessionsRequest) returns (RagChatSessionList)
List sessions for a chat assistant.
Returns message history with embedded chunk references.

RagDeleteChatSessions

rpc RagDeleteChatSessions (RagDeleteChatSessionsRequest) returns (RagPartialSuccess)
Delete one or more chat sessions (batch operation).
If ids empty, deletes all sessions for the chat.

RagListAgentSessions

rpc RagListAgentSessions (RagListAgentSessionsRequest) returns (RagAgentSessionList)
List sessions for an agent.
Can optionally exclude DSL from response for performance.

RagDeleteAgentSessions

rpc RagDeleteAgentSessions (RagDeleteAgentSessionsRequest) returns (RagPartialSuccess)
Delete one or more agent sessions (batch operation).
If ids empty, deletes all sessions for the agent.

RagChatCompletion

rpc RagChatCompletion (RagChatCompletionRequest) returns (stream RagChatCompletionResponse)
Generate chat completion with RAG (server streaming).
Creates new session if session_id not provided.

RagAgentCompletion

rpc RagAgentCompletion (RagAgentCompletionRequest) returns (stream RagAgentCompletionResponse)
Generate agent completion (server streaming).
Filters events to only return message-related events.

RagAsk

rpc RagAsk (RagAskRequest) returns (stream RagAskResponse)
Ask a question across datasets without a chat assistant.
Streaming only. All datasets must have parsed files.

RagRelatedQuestions

rpc RagRelatedQuestions (RagRelatedQuestionsRequest) returns (RagRelatedQuestionsResponse)
Generate related search terms for a question.
Returns 5-10 suggestions considering industry context.
Messages

RagAddChunkRequest

Request message for manually adding a chunk to a document.

The chunk content is automatically tokenized and embeddings are generated.

FieldTypeLabelDescription
parent string

Required. The agent to add the chunk for. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Dataset ID containing the document.

document_id string

Required. Document ID to add the chunk to.

content string

Required. Chunk text content.

important_keywords string repeated

Optional. Important keywords to associate with this chunk.

questions string repeated

Optional. Associated questions for this chunk (useful for Q&A-style retrieval).

RagAddChunkResponse

Response message for adding a chunk.

FieldTypeLabelDescription
chunk RagChunk

The newly created chunk.

RagAgent

RAGFlow agent (workflow-based AI assistant).

Agents are workflow-based AI assistants configured using Canvas DSL.

FieldTypeLabelDescription
id string

Agent UUID uniquely identifying this agent.

avatar string

Optional. Base64-encoded icon in the format "data:image/[png|jpeg];base64,<base64_string>".

user_id string

User ID of the agent owner.

title string

Unique agent title.

permission RagPermission optional

Agent access permissions

description string

Agent description providing details about the agent's purpose and functionality.

canvas_type string optional

Canvas type.

canvas_category RagCanvasCategory optional

Canvas category.

dsl google.protobuf.Struct

Canvas DSL configuration defining the agent's workflow.

create_time int64

Creation timestamp (Unix timestamp in milliseconds).

create_date string

Creation date in ISO 8601 datetime format.

update_time int64

Last update timestamp (Unix timestamp in milliseconds).

update_date string

Last update date in ISO 8601 datetime format.

RagAgentCompletionData

Data payload in agent completion response.

FieldTypeLabelDescription
content string

Response text content. Incremental for streaming mode, complete for non-streaming mode.

inputs google.protobuf.Struct

Input data that was passed to the agent workflow.

outputs google.protobuf.Struct

Output data produced by the agent workflow. Structure depends on the agent's DSL configuration.

reference google.protobuf.Struct

Source references including document chunks used to generate the response.

additional_fields google.protobuf.Struct

Additional fields returned by RAGFlow API.

RagAgentCompletionRequest

Request message for generating an agent completion.

Agents are workflow-based AI assistants with Domain Specific Language (DSL) configuration.

FieldTypeLabelDescription
parent string

Required. The agent to generate the completion for. Format:

projects/<project_uuid>/agent

agent_id string

Required. RAGFlow agent ID to use for generating the completion.

session_id string

Optional. Session ID to continue an existing conversation. If not provided, a new session will be created.

question string

Required. User question or message to send to the agent.

stream bool optional

Optional. Enable streaming mode. If true, the response will be streamed as Server-Sent Events (SSE). Default: true.

files RagFile repeated

Optional. Files to include in the agent's context for processing.

inputs google.protobuf.Struct

Optional. Input form data to pass to the agent workflow. The structure depends on the agent's DSL configuration.

user_id string

Optional. User identifier for tracking and personalization. Ignored if session_id is given.

additional_fields google.protobuf.Struct

Optional. Additional fields to pass through to RAGFlow API.

RagAgentCompletionResponse

Response message for agent completion.

FieldTypeLabelDescription
event RagAgentEventType optional

Event type indicating the kind of event in the stream.

message_id string

Message ID uniquely identifying this response.

created_at int64

Creation timestamp (Unix timestamp in milliseconds).

task_id string

Task ID associated with this agent workflow execution.

data RagAgentCompletionData

Event data payload containing the actual response content.

session_id string

Session ID for the conversation.

additional_fields google.protobuf.Struct

Additional fields returned by RAGFlow API.

RagAgentList

Response message containing a list of RAGFlow agents.

FieldTypeLabelDescription
agents RagAgent repeated

List of RAGFlow agents.

RagAgentSession

Agent session containing conversation history for an agent workflow.

FieldTypeLabelDescription
id string

Session UUID.

agent_id string

RAGFlow agent UUID.

user_id string

User identifier.

messages RagMessage repeated

Message history in chronological order.

tokens int32 optional

Number of tokens used.

source RagSessionSource optional

Session source.

dsl google.protobuf.Struct

Agent DSL (Domain Specific Language) workflow configuration.

duration float

Session duration in seconds.

round int32 optional

Conversation round.

thumb_up int32 optional

Number of likes.

errors string

Optional. Error messages.

create_time int64

Creation timestamp (Unix timestamp in milliseconds).

create_date string

Creation date (ISO 8601 datetime).

update_time int64

Last update timestamp (Unix timestamp in milliseconds).

update_date string

Last update date (ISO 8601 datetime).

RagAgentSessionList

Response message for listing agent sessions.

FieldTypeLabelDescription
agent_sessions RagAgentSession repeated

List of agent sessions.

RagAskRequest

Request message for asking a question using RAGFlow's basic QA endpoint.

FieldTypeLabelDescription
parent string

Required. The agent to ask the question for. Format:

projects/<project_uuid>/agent

question string

Required. User question to be answered.

dataset_ids string repeated

Required. List of dataset IDs to search for relevant information. The system will search across all specified datasets.

RagAskResponse

Response message containing the answer to a user's question.

FieldTypeLabelDescription
answer string

Generated answer text based on the retrieved information. When streaming is enabled, this field contains incremental text chunks.

reference google.protobuf.Struct

Source references and citations for the generated answer. Typically includes chunk information, document titles, and similarity scores.

RagChatAssistant

Chat assistant configuration.

FieldTypeLabelDescription
id string

Chat UUID.

tenant_id string

Tenant ID.

name string

Chat name (required, unique).

description string

Optional description.

avatar string

Base64-encoded avatar image.

language string

Language of the chat.

dataset_ids string repeated

Dataset IDs.

datasets RagDataset repeated

Full dataset objects.

llm RagLlmSetting

LLM configuration.

prompt_type RagPromptType optional

Prompt type.

prompt RagPromptConfig

Prompt and retrieval configuration.

meta_data_filter google.protobuf.Struct

Metadata filter.

do_refer string

Whether to insert reference index into answer. "1" yes, "0" no.

status string

Validation status indicating if chat is enabled ("1"=valid/enabled, "0"=invalid/disabled).

create_time int64

Creation timestamp (Unix timestamp in milliseconds).

create_date string

Creation date (ISO 8601 datetime).

update_time int64

Last update timestamp (Unix timestamp in milliseconds).

update_date string

Last update date (ISO 8601 datetime).

RagChatAssistantList

Response message for listing chat assistants.

FieldTypeLabelDescription
chats RagChatAssistant repeated

List of chat assistants (with full dataset objects embedded).

RagChatCompletionRequest

Request message for generating a chat completion.

FieldTypeLabelDescription
parent string

Required. The agent to generate the chat completion for. Format:

projects/<project_uuid>/agent

chat_id string

Required. Chat assistant ID to use for generating the completion.

session_id string

Optional. Session ID to continue an existing conversation. If not provided, a new session will be created.

name string

Optional. Maximum length 255. Name for new session. Ignored if session_id is provided.

user_id string

Optional. Maximum length 255. User defined ID for new session. Ignored if session_id is provided.

question string

Optional. User question or message to send to the chat assistant.

stream bool optional

Optional. Enable streaming mode. If true, the response will be streamed as Server-Sent Events (SSE). Default: true.

additional_fields google.protobuf.Struct

Optional. Additional fields to pass through to RAGFlow API.

RagChatCompletionResponse

Response message for chat completion.

FieldTypeLabelDescription
answer string

Response text. Incremental for streaming mode, complete for non-streaming mode.

reference google.protobuf.Struct

Source references including document chunks used to generate the response. Contains a chunks array with metadata about retrieved documents.

audio_binary string

Optional. Base64-encoded audio response when text-to-speech is enabled.

id string

Message ID uniquely identifying this response.

session_id string

Session ID for the conversation.

prompt string

Prompt used for generation. Usually empty string.

created_at double

Creation timestamp (Unix timestamp in seconds).

additional_fields google.protobuf.Struct

Additional fields returned by RAGFlow API.

RagChatSession

Chat session containing conversation history for a chat assistant.

FieldTypeLabelDescription
id string

Session UUID.

chat_id string

Parent chat assistant UUID.

name string

Session name (default: "New session").

messages RagMessage repeated

Message history in chronological order.

create_time int64

Creation timestamp (Unix timestamp in milliseconds).

create_date string

Creation date (ISO 8601 datetime).

update_time int64

Last update timestamp (Unix timestamp in milliseconds).

update_date string

Last update date (ISO 8601 datetime).

RagChatSessionList

Response message for listing chat sessions.

FieldTypeLabelDescription
chat_sessions RagChatSession repeated

List of chat sessions.

RagChunk

Chunk of text extracted from a document.

Chunks are the basic retrieval units used for vector similarity search in RAG.

FieldTypeLabelDescription
id string

Chunk ID (computed as xxhash of content combined with document_id).

dataset_id string

Parent dataset ID.

document_id string

Parent document ID.

content string

Chunk text content (the actual text segment extracted from the document).

docnm_kwd string

Document name keyword used for filtering and identification.

important_keywords string repeated

Important keywords extracted from or manually assigned to this chunk.

questions string repeated

Associated questions for Q&A chunks (used when chunk_method=qa).

image_id string

Associated image ID if this chunk references an image.

available bool optional

Availability status indicating if the chunk is active and can be retrieved (can be disabled without deletion).

positions google.protobuf.ListValue repeated

Position information in the original document.
Each position is an array of 5 integers representing location data (format varies by document type).

create_time string

Creation timestamp (ISO 8601 datetime string).

create_timestamp float

Creation timestamp as a floating-point Unix timestamp.

document_keyword string

Document name used as a keyword for retrieval.

similarity float optional

Similarity score between 0.0 and 1.0 (only populated in retrieval responses).

vector google.protobuf.Struct

Embedding vector for this chunk (optional, rarely included in responses for performance reasons).

additional_fields google.protobuf.Struct

Additional fields returned by RAGFlow not explicitly defined above.

RagConstructKnowledgeGraphResponse

Response message for starting construction of a knowledge graph.

FieldTypeLabelDescription
graphrag_task_id string

ID of the GraphRAG task.

RagConstructRaptorResponse

Response message for starting RAPTOR construction.

FieldTypeLabelDescription
raptor_task_id string

ID of the GraphRAG task.

RagCreateAgentRequest

Request message for creating a new RAGFlow agent.

FieldTypeLabelDescription
parent string

Required. The agent to create the RAGFlow agent for. Format:

projects/<project_uuid>/agent

avatar string

Optional. Base64-encoded icon in the format "data:image/[png|jpeg];base64,<base64_string>".

title string

Required. Maximum length 255. Unique agent title. Must be unique within the project.

permission RagPermission optional

Optional. Default me

description string

Optional. Agent description providing details about the agent's purpose and functionality.

canvas_type string optional

Optional. Max length 32. Canvas type.

canvas_category RagCanvasCategory optional

Optional. Canvas category.

dsl google.protobuf.Struct

Required. Canvas DSL configuration defining the agent's workflow.

RagCreateChatAssistantRequest

Request message for creating a new chat assistant.

FieldTypeLabelDescription
parent string

Required. The agent to create a chat assistant for. Format:

projects/<project_uuid>/agent

name string

Required. Maximum length 255. Unique name for the chat assistant.

description string

Optional. Description of the chat assistant's purpose.

avatar string

Optional. Base64-encoded icon in the format "data:image/[png|jpeg];base64,<base64_string>".

dataset_ids string repeated

Optional. Dataset IDs to use as knowledge base (all datasets must have parsed files and use the same embedding model).

llm RagLlmSetting

Optional. LLM configuration settings.

prompt RagPromptConfig

Optional. Prompt and retrieval configuration settings.

additional_fields google.protobuf.Struct

Optional. Additional fields to pass through to RAGFlow.

RagCreateChatSessionRequest

Request message for creating a new chat session.

FieldTypeLabelDescription
parent string

Required. The agent to create a chat session for. Format:

projects/<project_uuid>/agent

chat_id string

Required. Parent chat assistant UUID.

name string

Optional. Maximum length 255. Session name (default: "New session").

user_id string

Optional. Maximum length 255. User identifier for tracking conversation ownership.

RagCreateDatasetRequest

Request message for creating a new dataset.

FieldTypeLabelDescription
parent string

Required. The agent to create the dataset for. Format:

projects/<project_uuid>/agent

name string

Required. Unique name of the dataset to create. Must follow these requirements:

  • contain only characters from the basic multilingual Unicode plane
  • maximum 128 characters
  • case-insensitive

description string

Optional. Dataset description. Maximum 65,535 characters.

avatar string

Optional. Base64-encoded avatar image in the format "data:image/[png|jpeg];base64,<base64_string>". Maximum 65,535 characters.

permission RagPermission optional

Optional. Access permission for new dataset.

chunk_method RagChunkMethod optional

Optional. Default chunking method for documents in this dataset.

parser_config RagParserConfig

Optional. Configuration settings for the dataset parser. The used fields vary depending on the selected chunk_method.

embedding_model string

Optional. Embedding model name in the format "<model_name>@<factory_name>" (uses user's default if not specified). Maximum length 255.

RagCreateFileRequest

Request message for creating a file or folder in RAGFlow.

FieldTypeLabelDescription
parent string

Required. The agent to create the file for. Format:

projects/<project_uuid>/agent

name string

Required. Maximum length 255. Name of the file or folder to create.

parent_id string

Optional. Parent folder ID. If not provided, creates in root directory.

type RagCreateFileFileType optional

Required. Type of item to create: "folder" for directories or "virtual" for virtual files.

RagDataset

Dataset containing documents for RAG.

FieldTypeLabelDescription
id string

Dataset UUID.

avatar string

Base64-encoded avatar image.

tenant_id string

RAGFlow Tenant ID.

name string

Dataset name.

language string

Dataset language (e.g. "English").

description string

Dataset description.

embedding_model string

Embedding model name.

permission RagPermission optional

Access permission.

created_by string

ID of RAGFlow user who created the dataset.

document_count int32 optional

Number of documents in the dataset.

token_num int32 optional

Number of tokens in the dataset.

chunk_count int32 optional

Number of chunks of all documents in the dataset.

similarity_threshold float optional

Default similarity threshold (0.0-1.0).

vector_similarity_weight float optional

Default vector similarity weight (0.0-1.0).

chunk_method RagChunkMethod optional

Default chunking method for documents in this dataset.

pipeline_id string

Optional. Pipeline ID.

parser_config RagParserConfig

Document parser configuration (auto-generated based on chunk_method).

pagerank int32 optional

Pagerank.

graphrag_task_id string

Optional. GraphRAG task ID.

graphrag_task_finish_at string

Optional. Finish time of GraphRAG task (ISO 8601 datetime).

raptor_task_id string

Optional. RAPTOR task ID.

raptor_task_finish_at string

Optional. Finish time of RAPTOR task (ISO 8601 datetime).

mindmap_task_id string

Optional. Mindmap task ID.

mindmap_task_finish_at string

Optional. Finish time of Mindmap task (ISO 8601 datetime).

status string optional

Optional. Status of dataset ("0": inactive, "1": active).

create_time int64

Creation timestamp (Unix timestamp in milliseconds).

create_date string

Creation date (ISO 8601 datetime).

update_time int64

Last update timestamp (Unix timestamp in milliseconds).

update_date string

Last update date (ISO 8601 datetime).

RagDatasetIdRequest

Request message with a single dataset ID.

FieldTypeLabelDescription
parent string

Required. The agent to list all datasets from. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Dataset ID.

RagDatasetList

Response message for listing datasets.

FieldTypeLabelDescription
datasets RagDataset repeated

List of datasets.

RagDeleteAgentRequest

Request message for deleting a RAGFlow agent.

FieldTypeLabelDescription
parent string

Required. The agent to delete the RAGFlow agent from. Format:

projects/<project_uuid>/agent

agent_id string

Required. ID of the RAGFlow agent to delete.

RagDeleteAgentSessionsRequest

Request message for deleting agent sessions.

FieldTypeLabelDescription
parent string

Required. The agent to delete agent sessions from. Format:

projects/<project_uuid>/agent

agent_id string

Required. RAGFlow agent UUID.

ids string repeated

Optional. Session UUIDs to delete. Specify either this field or delete_all.

delete_all bool optional

Optional. Delete all sessions for this agent (needed because protobuf cannot represent ids=null).

RagDeleteChatSessionsRequest

Request message for deleting chat sessions.

FieldTypeLabelDescription
parent string

Required. The agent to delete chat sessions from. Format:

projects/<project_uuid>/agent

chat_id string

Required. Chat assistant UUID.

ids string repeated

Optional. Session UUIDs to delete. Specify either this field or delete_all.

delete_all bool optional

Optional. Delete all sessions for this chat (needed because protobuf cannot represent ids=null).

RagDeleteDocumentsRequest

Request message for deleting one or more documents from a dataset.

FieldTypeLabelDescription
parent string

Required. The agent to delete documents from. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Dataset ID containing the documents to delete.

ids string repeated

Optional. Document IDs to delete. If empty and delete_all is true, deletes all documents in the dataset.

delete_all bool optional

Optional. Delete all documents in the dataset (needed because protobuf cannot represent ids=null).

RagDeleteFilesRequest

Request message for deleting files or folders.

FieldTypeLabelDescription
parent string

Required. The agent to delete files from. Format:

projects/<project_uuid>/agent

file_ids string repeated

Required. UUIDs of files or folders to delete. Supports batch deletion.

RagDeleteRequest

Request message for deleting one or more of a RAGFlow resource.

FieldTypeLabelDescription
parent string

Required. The agent to delete datasets from. Format:

projects/<project_uuid>/agent

ids string repeated

Optional. IDs of resources to delete. If empty and delete_all is true, deletes all. Duplicate IDs are not allowed.

delete_all bool optional

Optional. Delete all (needed because protobuf cannot represent ids=null).

RagDocument

Document uploaded to a dataset.

FieldTypeLabelDescription
id string

Document UUID.

thumbnail string

Base64-encoded thumbnail image in the format "data:image/[png|jpeg];base64,<base64_string>". Maximum 65,535 characters.

dataset_id string

Parent dataset ID.

chunk_method RagChunkMethod optional

Chunking method used for this document.

pipeline_id string

Pipeline ID.

parser_config RagParserConfig

Parser configuration used for chunking this document.

source_type string

Source type indicating how the document was added (e.g., "local" for direct uploads, "knowledgebase" for file system imports).

type string

File type or extension (e.g., "pdf", "docx", "txt").

created_by string

ID of the user who created the document.

name string

Document filename.

location string

Storage location path in the backend file system or object storage.

size int64 optional

File size in bytes.

chunk_count int32 optional

Number of chunks extracted from this document (initially 0 until parsed).

token_count int32 optional

Number of tokens across all chunks in this document.

progress float optional

Processing progress as a decimal value between 0.0 (not started) and 1.0 (complete).

progress_msg string

Human-readable progress message describing current processing state.

process_begin_at string

Processing start timestamp (ISO 8601 datetime string).

process_duration float optional

Total processing duration in seconds.

meta_fields google.protobuf.Struct

Custom metadata fields specific to this document (arbitrary key-value pairs).

suffix string

Actual file extension extracted from the file (may differ from filename extension).

run RagDocumentStatus optional

Document processing status.

status string

Validation status indicating if document is enabled ("1"=valid/enabled, "0"=invalid/disabled).

create_time int64

Creation timestamp (Unix timestamp in milliseconds).

create_date string

Creation date (ISO 8601 datetime string).

update_time int64

Last update timestamp (Unix timestamp in milliseconds).

update_date string

Last update date (ISO 8601 datetime string).

RagDocumentList

Response message containing a list of documents.

FieldTypeLabelDescription
documents RagDocument repeated

List of documents.

RagDownloadDocumentRequest

Request message for downloading the original document file.

FieldTypeLabelDescription
parent string

Required. The agent to download the document from. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Dataset ID containing the document.

document_id string

Required. Document ID to download.

RagFile

File or folder in RAGFlow file system.

FieldTypeLabelDescription
id string

File or folder UUID.

parent_id string

Parent folder ID. Empty string for root-level items.

tenant_id string

Tenant ID.

created_by string

ID of the user who created the file.

name string

File or folder name.

location string

Storage location path within the RAGFlow file system.

size int64 optional

File size in bytes (0 for folders).

type string

File type/extension or "folder" for directories. Check type == "folder" to distinguish folders from files.

source_type string

Source type indicating file origin (e.g., "local" for uploaded files).

create_time int64

Creation timestamp (Unix timestamp in milliseconds).

create_date string

Creation date (ISO 8601 datetime format).

update_time int64

Last update timestamp (Unix timestamp in milliseconds).

update_date string

Last update date (ISO 8601 datetime format).

RagFileChunk

File chunk for streaming downloads.

First chunk contains metadata, subsequent chunks only contain data.

FieldTypeLabelDescription
data bytes

Optional. Chunk of file content.

metadata RagFileMetadata

Optional. File metadata (only in first chunk).

RagFileIdRequest

Request message for requests that only need a file ID.

FieldTypeLabelDescription
parent string

Required. The agent to rename the file for. Format:

projects/<project_uuid>/agent

file_id string

Required. File ID.

RagFileList

Response message containing a list of files.

FieldTypeLabelDescription
files RagFile repeated

Uploaded files. RAGFlow automatically creates intermediate folders as needed during upload.

RagFileMetadata

File metadata for streaming uploads/downloads.

FieldTypeLabelDescription
file_name string

Required. Filename. Maximum length 255.

content_type string

Optional. MIME type (e.g., "application/pdf", "image/png").

size int64

Optional. Minimum 0. File size in bytes (if known, 0 if unknown).

RagFileToDocument

Association between a file and a document in a dataset.

Tracks the relationship when files are converted to documents for use in RAG operations.

FieldTypeLabelDescription
id string

UUID of the file-to-document association.

file_id string

UUID of the source file.

document_id string

UUID of the generated document in the dataset.

create_time int64

Creation timestamp (Unix timestamp in milliseconds).

create_date string

Creation date (ISO 8601 datetime format).

update_time int64

Last update timestamp (Unix timestamp in milliseconds).

update_date string

Last update date (ISO 8601 datetime format).

RagFileToDocumentList

Response message containing a list of file-to-document associations.

FieldTypeLabelDescription
files_to_documents RagFileToDocument repeated

List of file-to-document associations created during the conversion operation.

RagFileToDocumentRequest

Request message for converting files to documents and linking them to datasets.

RAGFlow allows linking uploaded files to multiple target datasets for RAG operations.

FieldTypeLabelDescription
parent string

Required. The agent to convert files to documents for. Format:

projects/<project_uuid>/agent

file_ids string repeated

Required. UUIDs of files to convert. If folders are provided, processes contents recursively.

kb_ids string repeated

Required. Target dataset IDs (knowledge base IDs). A single file can be linked to multiple datasets.

RagGetKnowledgeGraphResponse

Response message for getting a dataset's knowledge graph.

FieldTypeLabelDescription
graph google.protobuf.Struct

Graph structure with nodes (max 256) and edges (max 128).
Format: {nodes: [{id, pagerank}], edges: [{source, target, weight}]}

mind_map google.protobuf.Struct

Mind map structure (optional).

additional_fields google.protobuf.Struct

Additional fields to pass through to RAGFlow.

RagGetParentFolderResponse

Response message for getting the parent folder of a file.

FieldTypeLabelDescription
parent_folder RagFile

The immediate parent folder of the requested file.

RagGetRootFolderRequest

Empty request message with only the parent field.

FieldTypeLabelDescription
parent string

Required. The agent to get the parent folder for. Format:

projects/<project_uuid>/agent

RagGetRootFolderResponse

Response message for getting the root folder.

FieldTypeLabelDescription
root_folder RagFile

The root folder of the file system.

RagGraphRagConfig

GraphRAG configuration.

FieldTypeLabelDescription
use_graphrag bool

Optional. Default false.

entity_types string repeated

Optional. Default ["organization", "person", "geo", "event", "category"].

method RagGraphRagMethod optional

Optional. Default light.

community bool

Optional. Default false.

resolution bool

Optional. Default false.

RagListAgentSessionsRequest

Request message for listing agent sessions.

FieldTypeLabelDescription
parent string

Required. The agent to list agent sessions from. Format:

projects/<project_uuid>/agent

agent_id string

Required. RAGFlow agent UUID.

pagination RagPagination

Optional. Pagination parameters for paging through results.

orderby string

Sort field (default: "update_time").

desc bool optional

Optional. Sort in descending order (default: true).

id string

Optional. Filter by session UUID.

user_id string

Optional. Filter by user identifier.

dsl bool optional

Optional. Include DSL workflow configuration in response.

RagListAgentsRequest

Request message for listing RAGFlow agents.

FieldTypeLabelDescription
parent string

Required. The agent to list RAGFlow agents from. Format:

projects/<project_uuid>/agent

pagination RagPagination

Optional. Pagination parameters to control the number and offset of results.

title string

Optional. Filter results by agent title. Only agents with matching titles will be returned.

orderby string

Optional. Sort field for ordering results. Default: "update_time".

desc bool optional

Optional. Sort in descending order. If true, results are sorted from highest to lowest. Default: true.

id string

Optional. Filter results by specific agent ID.

RagListChatAssistantsRequest

Request message for listing chat assistants.

FieldTypeLabelDescription
parent string

Required. The agent to list chat assistants from. Format:

projects/<project_uuid>/agent

pagination RagPagination

Optional. Pagination parameters for paging through results.

id string

Optional. Filter by chat assistant UUID.

name string

Optional. Filter by chat assistant name.

orderby string

Sort field (default: "create_time").

desc bool optional

Optional. Sort in descending order (default: true).

additional_fields google.protobuf.Struct

Optional. Additional fields to pass through to RAGFlow.

RagListChatSessionsRequest

Request message for listing chat sessions.

FieldTypeLabelDescription
parent string

Required. The agent to list chat sessions from. Format:

projects/<project_uuid>/agent

chat_id string

Required. Chat assistant UUID.

pagination RagPagination

Optional. Pagination parameters for paging through results.

orderby string

Sort field (default: "create_time").

desc bool optional

Optional. Sort in descending order (default: true).

name string

Optional. Filter by session name.

id string

Optional. Filter by session UUID.

user_id string

Optional. Filter by user identifier.

RagListChunksRequest

Request message for listing chunks of a document with pagination.

FieldTypeLabelDescription
parent string

Required. The agent to list chunks from. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Dataset ID containing the document.

document_id string

Required. Document ID to list chunks from.

pagination RagPagination

Optional. Pagination parameters.

keywords string

Optional. Search keywords to filter chunks (supports content highlighting in results).

id string

Optional. Filter by specific chunk ID.

RagListChunksResponse

Response message for listing chunks.

FieldTypeLabelDescription
total int32 optional

Total number of chunks matching the filter criteria (before pagination).

chunks RagChunk repeated

List of chunks for the current page.

doc RagDocument

Document details for the parent document.

RagListDatasetsRequest

Request message for listing datasets with pagination and filtering.

FieldTypeLabelDescription
parent string

Required. The agent to list all datasets from. Format:

projects/<project_uuid>/agent

pagination RagPagination

Optional. Pagination parameters.

id string

Optional. Filter by dataset ID.

name string

Optional. Filter by dataset name.

orderby string

Optional. Sort field (default: create_time).

desc bool optional

Optional. Sort descending (default: true).

RagListDocumentsRequest

Request message for listing documents in a dataset with pagination and filtering.

FieldTypeLabelDescription
parent string

Required. The agent to list documents from. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Dataset ID to list documents from.

id string

Optional. Filter by specific document ID.

name string

Optional. Filter by document name (exact match).

pagination RagPagination

Optional. Pagination parameters.

orderby string

Optional. Sort field (default: "create_time"). Accept any field of RagDocument.

desc bool optional

Optional. Sort in descending order (default: true).

keywords string

Optional. Search keywords to filter documents (searches in document name and metadata).

suffix string repeated

Optional. Suffixes to filter by (e.g. ["pdf", "png", "docx"]).

run_status RagDocumentStatus repeated

Optional. Document status to filter by.

create_time_from int64

Optional. Filter by creation time start (Unix timestamp in milliseconds, 0 = no filter).

create_time_to int64

Optional. Filter by creation time end (Unix timestamp in milliseconds, 0 = no filter).

RagListDocumentsResponse

Response message for listing documents.

FieldTypeLabelDescription
total int32 optional

Total number of documents matching the filter criteria (not limited by pagination).

docs RagDocument repeated

List of documents for the current page.

RagListFilesRequest

Request message for listing files and folders.

FieldTypeLabelDescription
parent string

Required. The agent to list files from. Format:

projects/<project_uuid>/agent

parent_id string

Optional. Folder ID to list contents from. If not provided, lists root directory contents.

pagination RagPagination

Optional. Pagination parameters. Default page size is 15 items per page.

keywords string

Optional. Search keywords to filter files by name or other searchable attributes.

orderby string

Optional. Field to sort results by. All fields of RagFile are possible.

desc bool optional

Optional. Sort in descending order. Default is true (newest first).

RagListFilesResponse

Response message for listing files and folders.

FieldTypeLabelDescription
total int32 optional

Total number of files and folders matching the query (before pagination).

files RagFile repeated

List of files and folders in the current page.

parent_folder RagFile

Information about the parent folder being listed.

RagLlmSetting

LLM configuration for chat assistant.

FieldTypeLabelDescription
model_name string

Optional. LLM model name. If not set, the user's default model will be used.

temperature float optional

Optional. Minimum 0.0. Maximum 2.0. Default 0.1. Sampling temperature. Controls randomness in responses.

top_p float optional

Optional. Minimum 0.0. Maximum 1.0. Default 0.3. Nucleus sampling parameter. Filters token choices by cumulative probability.

frequency_penalty float optional

Optional. Minimum -2.0. Maximum 2.0. Default 0.4. Frequency penalty. Reduces repetition of frequent tokens.

presence_penalty float optional

Optional. Minimum -2.0. Maximum 2.0. Default 0.7. Presence penalty. Reduces repetition of any tokens already used.

max_tokens int32

Optional. Minimum 1. Maximum number of tokens to generate.

additional_fields google.protobuf.Struct

Optional. Additional fields to pass through to RAGFlow.

RagMessage

Message in a conversation session.

FieldTypeLabelDescription
role RagMessageRole optional

Role of the message sender.

content string

Message content text.

additional_fields google.protobuf.Struct

Additional fields returned by RAGFlow.

RagMetadataCondition

Condition to filter document metadata on.

FieldTypeLabelDescription
name string

Required. Metadata field name.

comparison_operator string

Required. Comparison operator. Can be one of: "contains", "not contains", "start with", "empty", "not empty", "=", "≠", "<", ">, "≥", "≤"

value string

Required. Value to compare to.

RagMetadataConditions

List of document metadata conditions.

FieldTypeLabelDescription
conditions RagMetadataCondition repeated

Optional. List of conditions.

RagMoveFileRequest

Request message for moving files or folders.

FieldTypeLabelDescription
parent string

Required. The agent to move files for. Format:

projects/<project_uuid>/agent

src_file_ids string repeated

Required. UUIDs of source files or folders to move. Supports batch move operations.

dest_file_id string

Required. UUID of the destination folder.

RagPagination

Pagination parameters for list requests.

FieldTypeLabelDescription
page int32

Optional. Minimum 1. Page number (1-indexed, default: 1).

page_size int32

Optional. Minimum 1. Number of items per page (default varies by endpoint).

RagParentFoldersList

Response message for getting all parent folders in the hierarchy.

FieldTypeLabelDescription
parent_folders RagFile repeated

All parent folders in the hierarchy, from immediate parent to root folder.

RagParseDocumentsRequest

Request message for starting document parsing.

Parsing extracts chunks from documents using the configured chunk method.

FieldTypeLabelDescription
parent string

Required. The agent to parse documents for. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Dataset ID containing the documents to parse.

document_ids string repeated

Required. Document IDs to parse into chunks (queues documents for background processing).

RagParserConfig

Document parser configuration.

Used fields depend on the chunking method of the document.

FieldTypeLabelDescription
auto_keywords int32 optional

Optional. Minimum 0, maximum 32, default 0. See https://ragflow.io/docs/dev/autokeyword_autoquestion for details.

auto_questions int32 optional

Optional. Minimum 0, maximum 10, default 0. See https://ragflow.io/docs/dev/autokeyword_autoquestion for details.

chunk_token_num int32

Optional. Minimum 1, maximum 2048, default 512.

delimiter string

Optional. Default "\n".

html4excel bool

Optional. Convert Excel documents to HTML. Default false.

layout_recognize string

Optional. Default "DeepDOC".

tag_kb_ids string repeated

Optional. List of dataset IDs. See https://ragflow.io/docs/dev/use_tag_sets for details.

topn_tags int32

Optional. Minimum 1. Maximum 10. Default 1.

filename_embd_weight float optional

Optional. Minimum 0.0. Maximum 1.0. Default 0.1.

task_page_size int32

Optional. Minimum 1, default 12. Only applies to PDFs.

raptor RagRaptorConfig

Optional. RAPTOR-specific settings. Default { "use_raptor": false }.

graphrag RagGraphRagConfig

Optional. GRAPHRAG-specific settings. Default { "use_graphrag": false }.

RagPartialSuccess

On complete success: no fields set (empty message).

On partial success/failure: both fields set.

FieldTypeLabelDescription
success_count int32

Number of successful operations.

errors string repeated

Error messages for failed operations.

RagPromptConfig

Prompt and retrieval configuration for chat assistant.

FieldTypeLabelDescription
prompt string

Optional. System prompt (RAGFlow provides default if not specified).

variables RagPromptVariable repeated

Optional. Prompt template variables for dynamic content insertion.

opener string

Optional. Opening message displayed at conversation start.

show_quote bool optional

Optional. Default true. Show quotations from retrieved source chunks in responses.

empty_response string

Optional. Response to return when no relevant chunks are found in the knowledge base.

tts bool optional

Optional. Default false. Enable text-to-speech for responses.

refine_multiturn bool optional

Optional. Default true. Refine and optimize multi-turn conversation context.

similarity_threshold float optional

Optional. Minimum 0.0. Maximum 1.0. Default 0.2. Minimum similarity score for chunk retrieval.

keywords_similarity_weight float optional

Optional. Minimum 0.0. Maximum 1.0. Default 0.7. Weight for keywords versus vector similarity in hybrid search.

top_n int32

Optional. Minimum 1. Default 6. Number of chunks to retrieve after reranking.

top_k int32

Optional. Minimum 1. Default 1024. Maximum chunks to retrieve before reranking.

rerank_model string

Optional. Rerank model ID for reordering retrieved chunks. If not specified, cosine similarity is used.

additional_fields google.protobuf.Struct

Optional. Additional fields to pass through to RAGFlow.

RagPromptVariable

Prompt template variable for dynamic content insertion.

FieldTypeLabelDescription
key string

Required. Variable name used in prompt template.

optional bool optional

Required. Whether this variable is optional in the template.

RagRaptorConfig

RAPTOR configuration. Refer to RAPTOR paper for more information about RAPTOR.

FieldTypeLabelDescription
use_raptor bool

Optional. Default false. Whether to use RAPTOR for this dataset.

prompt string

Optional. Prompt to use for RAPTOR. Default:
"Please summarize the following paragraphs. Be careful with the numbers, do not make things up. Paragraphs as following:\n {cluster_content}\nThe above is the content you need to summarize."

max_token int32

Optional. Minimum 1. Maximum 2048. Default 256.

threshold float optional

Optional. Minimum 0.0. Maximum 1.0. Default 0.1.

max_cluster int32

Optional. Minimum 1. Maximum 1024. Default 64.

random_seed int64 optional

Optional. Minimum 0. Default 0.

RagRelatedQuestionsRequest

Request message for generating related questions based on a user's query.

FieldTypeLabelDescription
parent string

Required. The agent to generate related questions for. Format:

projects/<project_uuid>/agent

question string

Required. Original user question to generate related questions from.

industry string

Optional. Industry context to focus the related questions. Helps tailor suggestions to specific domains (e.g., "healthcare", "finance").

RagRelatedQuestionsResponse

Response message containing a list of suggested related questions.

FieldTypeLabelDescription
questions string repeated

List of 5-10 related question suggestions based on the original query.

RagRemoveChunksRequest

Request message for removing one or more chunks from a document.

FieldTypeLabelDescription
parent string

Required. The agent to remove chunks from. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Dataset ID containing the document.

document_id string

Required. Document ID to remove chunks from.

chunk_ids string repeated

Optional. Chunk IDs to remove. If empty, removes all chunks from the document.

RagRenameFileRequest

Request message for renaming a file or folder.

FieldTypeLabelDescription
parent string

Required. The agent to rename the file for. Format:

projects/<project_uuid>/agent

file_id string

Required. UUID of the file or folder to rename.

name string

Required. New name for the file or folder. For files, the extension must remain the same.

RagRetrievalRequest

Request message for retrieving chunks using vector similarity search.

Supports hybrid search combining vector similarity with keyword matching.

FieldTypeLabelDescription
parent string

Required. The agent to retrieve chunks for. Format:

projects/<project_uuid>/agent

dataset_ids string repeated

Required. Dataset IDs to search (all datasets must use the same embedding model).

pagination RagPagination

Optional. Pagination parameters.

question string

Required. Query string to search for.

document_ids string repeated

Optional. Filter by specific document IDs within the datasets.

use_kg bool optional

Optional. Include knowledge graph retrieval to enhance results with graph relationships.

cross_languages string repeated

Optional. Cross-language translation codes to enable multilingual retrieval.

metadata_condition RagMetadataConditions

Optional. Metadata filter condition to restrict results based on document metadata.

similarity_threshold float

Optional. Minimum similarity score threshold between 0.0 and 1.0 (default: 0.2).

vector_similarity_weight float optional

Optional. Weight for vector similarity versus keyword matching between 0.0 and 1.0 (default: 0.3).
Higher values favor vector similarity, lower values favor keyword matching.

top_k int32

Optional. Minimum 1. Maximum number of chunks to retrieve before reranking (default: 1024).

rerank_id string

Optional. Rerank model ID to reorder results after initial retrieval.

highlight bool optional

Optional. Whether to highlight matched content in the returned chunks.

keyword bool optional

Optional. Extract additional keywords from the query to improve retrieval.

RagRetrievalResponse

Response message for chunk retrieval.

FieldTypeLabelDescription
chunks RagChunk repeated

Retrieved chunks with similarity scores populated (ordered by relevance).

doc_aggs google.protobuf.Struct repeated

Document aggregations providing statistics about which documents matched.

total int32 optional

Total number of chunks matching the query (before pagination).

additional_fields google.protobuf.Struct

Additional fields returned by RAGFlow not explicitly defined above.

RagStopParsingRequest

Request message for stopping document parsing.

Only documents currently being processed can be stopped.

FieldTypeLabelDescription
parent string

Required. The agent to stop parsing for. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Dataset ID containing the documents to stop parsing.

document_ids string repeated

Required. Document IDs to stop parsing (only stops documents with progress between 0 and 1).

RagTaskStatus

Status of a task.

FieldTypeLabelDescription
id string

Task ID.

doc_id string

Document ID.

from_page int32 optional

Start page.

to_page int32 optional

End page.

task_type string

Task type.

priority int32 optional

Priority.

begin_at string

Optional. Start time of the task (ISO 8601 datetime).

process_duration float optional

Current duration of the task (in seconds).

progress float optional

Task progress (0.0 - 1.0).

progress_msg string

Task progress message.

retry_count int32 optional

Retry count.

digest string

Digest.

chunk_ids string

List of document chunk IDs as a string.

RagUpdateAgentRequest

Request message for updating an existing RAGFlow agent.

FieldTypeLabelDescription
parent string

Required. The agent to update the RAGFlow agent for. Format:

projects/<project_uuid>/agent

agent_id string

Required. ID of the RAGFlow agent to update.

avatar string

Optional. Base64-encoded icon in the format "data:image/[png|jpeg];base64,<base64_string>".

title string

Optional. Maximum length 255. Unique agent title. Must be unique within the project.

permission RagPermission optional

Optional. Default me

description string

Optional. Agent description providing details about the agent's purpose and functionality.

canvas_type string optional

Optional. Max length 32. Canvas type.

canvas_category RagCanvasCategory optional

Optional. Canvas category.

dsl google.protobuf.Struct

Optional. Canvas DSL configuration defining the agent's workflow.

RagUpdateChatAssistantRequest

Request message for updating an existing chat assistant.

FieldTypeLabelDescription
parent string

Required. The agent containing the chat assistant to update. Format:

projects/<project_uuid>/agent

chat_id string

Required. UUID of the chat assistant to update.

name string

Required. Maximum length 255. Unique name for the chat assistant.

description string

Optional. Description of the chat assistant's purpose.

avatar string

Optional. Base64-encoded icon in the format "data:image/[png|jpeg];base64,<base64_string>".

dataset_ids string repeated

Optional. Dataset IDs to use as knowledge base (all datasets must have parsed files and use the same embedding model).

llm RagLlmSetting

Optional. LLM configuration settings.

prompt RagPromptConfig

Optional. Prompt and retrieval configuration settings.

additional_fields google.protobuf.Struct

Optional. Additional fields to pass through to RAGFlow.

RagUpdateChatSessionRequest

Request message for updating an existing chat session.

FieldTypeLabelDescription
parent string

Required. The agent containing the chat session to update. Format:

projects/<project_uuid>/agent

chat_id string

Required. Chat assistant UUID.

session_id string

Required. Session UUID to update.

name string

Optional. Maximum length 255. New session name.

user_id string

Optional. Maximum length 255. User identifier.

RagUpdateChunkRequest

Request message for updating an existing chunk's content and metadata.

Content changes trigger re-tokenization and re-generation of embeddings.

FieldTypeLabelDescription
parent string

Required. The agent to update the chunk for. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Dataset ID containing the document.

document_id string

Required. Document ID containing the chunk.

chunk_id string

Required. Chunk ID to update.

content string

Optional. New chunk content (re-tokenizes and re-generates embeddings if changed).

important_keywords string repeated

Optional. Updated important keywords for this chunk.

questions string repeated

Optional. Updated questions associated with this chunk.

available bool optional

Optional. Availability status (disable chunk without deleting it).

positions google.protobuf.ListValue repeated

Position information in the original document.
Each position is an array of 5 integers representing location data (format varies by document type).

RagUpdateDatasetRequest

Request message for updating an existing dataset.

The same field constraints as for RagCreateDatasetRequest apply here.

FieldTypeLabelDescription
parent string

Required. The agent to update the dataset for. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Dataset ID.

name string

Optional. New dataset name.

description string

Optional. New dataset description.

avatar string

Optional. New avatar image.

permission RagPermission optional

Optional. New access permission.

chunk_method RagChunkMethod optional

Optional. New chunk method.

parser_config RagParserConfig

Optional. New parser config (deep merged with existing).

embedding_model string

Optional. New embedding model (cannot change if chunk_count > 0).

pagerank int32 optional

Optional. PageRank value.

RagUpdateDocumentRequest

Request message for updating an existing document's metadata and configuration.

FieldTypeLabelDescription
parent string

Required. The agent to update the document for. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Dataset ID containing the document.

document_id string

Required. Document ID to update.

name string

Optional. Maximum length 255. New document name (file extension must remain the same).

chunk_method RagChunkMethod optional

Optional. New chunking method (resets document to UNSTART status and deletes all existing chunks).

parser_config RagParserConfig

Optional. New parser configuration (deep merged with existing configuration).

enabled bool optional

Optional. Document enabled/disabled status.

meta_fields google.protobuf.Struct

Optional. Custom metadata fields for document-specific metadata (replaces existing metadata).

RagUploadChunk

Upload chunk for streaming uploads.

Used to stream file data after metadata is sent in first message.

FieldTypeLabelDescription
file_index int32 optional

Required. Not actually optional but `optional` keyword is needed to enable presence tracking. Without it, it is impossible to distinguish between `0` and not present. Index into metadata.files array (0-based).

data bytes

Optional. Chunk of file content, null indicates EOF.

RagUploadDocumentsRequest

Request message for uploading documents to a dataset.

Documents are uploaded via streaming multipart form data.

FieldTypeLabelDescription
metadata RagUploadDocumentsRequest.RagMetadata

First message: declares all files to be uploaded.

chunk RagUploadChunk

Subsequent messages: stream file data chunks.

RagUploadDocumentsRequest.RagMetadata

Metadata for the upload (first message only).

FieldTypeLabelDescription
parent string

Required. The agent to upload documents for. Format:

projects/<project_uuid>/agent

dataset_id string

Required. Target dataset ID to upload documents to.

files RagFileMetadata repeated

Required. Metadata for all files being uploaded in this stream.

RagUploadFilesRequest

Request message for uploading files via streaming multipart form data.

RAGFlow supports individual and bulk file uploads. Files can be uploaded to a specific folder or to the root directory if no parent folder is specified.

FieldTypeLabelDescription
metadata RagUploadFilesRequest.RagMetadata

First message: declares all files to be uploaded.

chunk RagUploadChunk

Subsequent messages: stream file data in chunks.

RagUploadFilesRequest.RagMetadata

Metadata for the upload operation (must be sent in first message only).

FieldTypeLabelDescription
parent string

Required. The agent to upload files for. Format:

projects/<project_uuid>/agent

parent_id string

Optional. Parent folder ID. If not provided, files will be uploaded to root directory.

files RagFileMetadata repeated

Required. Metadata for all files being uploaded in this request.

Enums

RagAgentEventType

Agent completion event type.

NameNumberDescription
message 0

Regular message event.

message_end 1

Message completion event.

RagCanvasCategory

Agent canvas category.

NameNumberDescription
agent_canvas 0

agent canvas

dataflow_canvas 1

dataflow canvas

RagChunkMethod

Chunking method for documents. See https://ragflow.io/docs/dev/configure_knowledge_base#select-chunking-method for details.

NameNumberDescription
naive 0

General (default).

book 1

Book.

email 2

Email.

laws 3

Laws.

manual 4

Manual.

one 5

One.

paper 6

Paper.

picture 7

Picture.

presentation 8

Presentation.

qa 9

Q&A.

table 10

Table.

tag 11

Tag.

RagCreateFileFileType

Available file types for file creation.

NameNumberDescription
virtual 0

virtual file

folder 1

folder

RagDocumentStatus

Document processing status.

NameNumberDescription
UNSTART 0

Document has not started processing.

RUNNING 1

Document is currently being processed.

CANCEL 2

Document processing was cancelled.

DONE 3

Document processing completed successfully.

FAIL 4

Document processing failed.

RagGraphRagMethod

Knowledge graph construction methods.

NameNumberDescription
light 0

Use prompts provided by LightRAG.

general 1

Use prompts provided by GraphRAG.

RagMessageRole

Role of message sender in conversation.

NameNumberDescription
user 0

Message from user.

assistant 1

Message from AI assistant.

system 2

System message.

RagPermission

Access permissions for a dataset.

NameNumberDescription
me 0

Only the current user can manage the dataset (default).

team 1

All team members of the current user can manage the dataset.

RagPromptType

Chat assistant prompt type.

NameNumberDescription
simple 0

simple

advanced 1

advanced

RagSessionSource

Session source

NameNumberDescription
none 0

none

agent 1

agent

dialog 2

dialog

ondewo/nlu/server_statistics.proto

Top

Services

ServerStatistics

Server project statistics

Service Methods

GetProjectCount

rpc GetProjectCount (.google.protobuf.Empty) returns (StatResponse)
Returns the count of projects in the CAI server

GetUserProjectCount

rpc GetUserProjectCount (GetUserProjectCountRequest) returns (StatResponse)
Returns the count of projects of a user

GetUserCount

rpc GetUserCount (.google.protobuf.Empty) returns (StatResponse)
Returns the users count within a project

Methods with HTTP bindings

Method Name Method Pattern Body
GetProjectCount GET /projects:count
GetUserProjectCount GET /users/{user_identifier=*}/projects:count
GetUserCount GET /users:count
Messages

GetUserProjectCountRequest

Request to get user project count

FieldTypeLabelDescription
user_id string

Required. The ID of the User to count the projects from

ondewo/nlu/session.proto

Top

Services

Sessions

A session represents an interaction with a user. You retrieve user input and pass it to the DetectIntent (or StreamingDetectIntent) method to determine user intent and respond.

Service Methods

DetectIntent

rpc DetectIntent (DetectIntentRequest) returns (DetectIntentResponse)
Processes a natural language query and returns structured, actionable data as a result. This method is not idempotent, because it may cause contexts and session entity types to be updated, which in turn might affect results of future queries.

StreamingDetectIntent

rpc StreamingDetectIntent (stream StreamingDetectIntentRequest) returns (stream StreamingDetectIntentResponse)
Processes a natural language query in audio format in a streaming fashion and returns structured, actionable data as a result. This method is only available via the gRPC API (not REST).

ListSessions

rpc ListSessions (ListSessionsRequest) returns (ListSessionsResponse)
ListSessions: returns list of sessions from ondewo-kb; by default returns only session IDs

GetSession

rpc GetSession (GetSessionRequest) returns (Session)
GetSession: returns a session(=conversation) from ondewo-kb

CreateSession

rpc CreateSession (CreateSessionRequest) returns (Session)
CreateSession: creates and returns a session(=conversation) from ondewo-kb

CreateSessionStep

rpc CreateSessionStep (CreateSessionStepRequest) returns (SessionStep)
CreateSessionStep: creates a new session step for a session

GetSessionStep

rpc GetSessionStep (GetSessionStepRequest) returns (SessionStep)
GetSessionStep: gets an existing session step of a session

UpdateSessionStep

rpc UpdateSessionStep (UpdateSessionStepRequest) returns (SessionStep)
UpdateSessionStep: updates an existing session step in a session

DeleteSessionStep

rpc DeleteSessionStep (DeleteSessionStepRequest) returns (.google.protobuf.Empty)
DeleteSessionStep: deletes an existing session step from the session

DeleteSession

rpc DeleteSession (DeleteSessionRequest) returns (.google.protobuf.Empty)
DeleteSession: delete a session(=conversation) from ondewo-kb (for testing only)

ListSessionLabels

rpc ListSessionLabels (ListSessionLabelsRequest) returns (ListSessionLabelsResponse)

ListSessionLabelsOfAllSessions

rpc ListSessionLabelsOfAllSessions (ListSessionLabelsOfAllSessionsRequest) returns (ListSessionLabelsResponse)

ListLanguageCodesOfAllSessions

rpc ListLanguageCodesOfAllSessions (ListLanguageCodesOfAllSessionsRequest) returns (ListLanguageCodesResponse)

ListMatchedIntentsOfAllSessions

rpc ListMatchedIntentsOfAllSessions (ListMatchedIntentsOfAllSessionsRequest) returns (ListMatchedIntentsResponse)

ListMatchedEntityTypesOfAllSessions

rpc ListMatchedEntityTypesOfAllSessions (ListMatchedEntityTypesOfAllSessionsRequest) returns (ListMatchedEntityTypesResponse)

ListUserIdsOfAllSessions

rpc ListUserIdsOfAllSessions (ListUserIdsOfAllSessionsRequest) returns (ListUserIdsResponse)

ListIdentifiedUserIdsOfAllSessions

rpc ListIdentifiedUserIdsOfAllSessions (ListIdentifiedUserIdsOfAllSessionsRequest) returns (ListIdentifiedUserIdsResponse)

ListTagsOfAllSessions

rpc ListTagsOfAllSessions (ListTagsOfAllSessionsRequest) returns (ListTagsResponse)

ListInputContextsOfAllSessions

rpc ListInputContextsOfAllSessions (ListInputContextsOfAllSessionsRequest) returns (ListInputContextsResponse)

ListOutputContextsOfAllSessions

rpc ListOutputContextsOfAllSessions (ListOutputContextsOfAllSessionsRequest) returns (ListOutputContextsResponse)

ListPlatformsOfAllSessions

rpc ListPlatformsOfAllSessions (ListPlatformsOfAllSessionsRequest) returns (ListPlatformsResponse)

ListAccountIdsOfAllSessions

rpc ListAccountIdsOfAllSessions (ListAccountIdsOfAllSessionsRequest) returns (ListAccountIdsResponse)

ListPropertyIdsOfAllSessions

rpc ListPropertyIdsOfAllSessions (ListPropertyIdsOfAllSessionsRequest) returns (ListPropertyIdsResponse)

ListDatastreamIdsOfAllSessions

rpc ListDatastreamIdsOfAllSessions (ListDatastreamIdsOfAllSessionsRequest) returns (ListDatastreamIdsResponse)

ListOriginIdsOfAllSessions

rpc ListOriginIdsOfAllSessions (ListOriginIdsOfAllSessionsRequest) returns (ListOriginIdsResponse)

AddSessionLabels

rpc AddSessionLabels (AddSessionLabelsRequest) returns (Session)

DeleteSessionLabels

rpc DeleteSessionLabels (DeleteSessionLabelsRequest) returns (Session)

AddSessionComment

rpc AddSessionComment (AddSessionCommentRequest) returns (Comment)

DeleteSessionComments

rpc DeleteSessionComments (DeleteSessionCommentsRequest) returns (Session)

UpdateSessionComments

rpc UpdateSessionComments (UpdateSessionCommentsRequest) returns (Session)

ListSessionComments

rpc ListSessionComments (ListSessionCommentsRequest) returns (ListSessionCommentsResponse)

ListSessionReviews

rpc ListSessionReviews (ListSessionReviewsRequest) returns (ListSessionReviewsResponse)
ListSessionReviews: returns list of session reviews from ondewo-kb; by default only returns session review IDs

GetSessionReview

rpc GetSessionReview (GetSessionReviewRequest) returns (SessionReview)
GetSessionReview: returns a session-review from ondewo-kb or computes the first review if none exists

GetLatestSessionReview

rpc GetLatestSessionReview (GetLatestSessionReviewRequest) returns (SessionReview)
GetLatestSessionReview: returns a session-review from ondewo-kb or computes the first review if none exists

CreateSessionReview

rpc CreateSessionReview (CreateSessionReviewRequest) returns (SessionReview)
CreateSessionReview: persist a session review in ondewo-kb as a side effect: also update training data in ondewo-cai

GetAudioFiles

rpc GetAudioFiles (GetAudioFilesRequest) returns (GetAudioFilesResponse)
RPC to get audio files based on specified criteria. Retrieves information about audio files associated with specific sessions. Returns a response containing details of the requested audio files.

AddAudioFiles

rpc AddAudioFiles (AddAudioFilesRequest) returns (AddAudioFilesResponse)
RPC to add audio files to a session. Adds new audio files to the specified session, providing details about each file. Returns a response containing information about the added audio files.

DeleteAudioFiles

rpc DeleteAudioFiles (DeleteAudioFilesRequest) returns (DeleteAudioFilesResponse)
RPC to delete specified audio files. Deletes audio files associated with specific sessions based on unique identifiers. Returns an empty response indicating the successful deletion of the specified audio files.

GetAudioFileOfSession

rpc GetAudioFileOfSession (GetAudioFileOfSessionRequest) returns (AudioFileResource)
RPC to get a consolidated audio file for a specific session. Retrieves a single audio file that combines all audio files associated with the specified session. Returns details of the consolidated audio file.

ListAudioFiles

rpc ListAudioFiles (ListAudioFilesRequest) returns (ListAudioFilesResponse)
RPC to get a list audio files for a specific session. Retrieves a single audio file that combines all audio files associated with the specified session.

Methods with HTTP bindings

Method Name Method Pattern Body
DetectIntent POST /v2/{session=projects/*/agent/sessions/*}:detectIntent *
ListSessions GET /v2/{parent=projects/*/agent}/sessions
GetSession GET /v2/{session_id=projects/*/agent/sessions/*}
CreateSession POST /v2/{parent=projects/*/agent}/sessions *
GetSessionStep POST /v2/{session_id=projects/*/agent/sessions/*}:getSessionStep *
UpdateSessionStep POST /v2/{session_id=projects/*/agent/sessions/*}:updateSessionStep *
DeleteSessionStep POST /v2/{session_id=projects/*/agent/sessions/*}:deleteSessionStep *
DeleteSession DELETE /v2/{session_id=projects/*/agent/sessions/*}
ListSessionLabels GET /v2/{session_id=projects/*/agent/sessions/*}/labels
ListSessionLabelsOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/labels
ListLanguageCodesOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/language_codes
ListMatchedIntentsOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/matched_intents
ListMatchedEntityTypesOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/matched_entity_types
ListUserIdsOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/user_ids
ListIdentifiedUserIdsOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/identified_user_ids
ListTagsOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/tags
ListInputContextsOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/input_contexts
ListOutputContextsOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/output_contexts
ListPlatformsOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/platforms
ListAccountIdsOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/account_ids
ListPropertyIdsOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/property_ids
ListDatastreamIdsOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/datastream_ids
ListOriginIdsOfAllSessions GET /v2/{parent=projects/*/agent}/sessions/origin_ids
AddSessionLabels POST /v2/{session_id=projects/*/agent/sessions/*}/labels:add *
DeleteSessionLabels POST /v2/{session_id=projects/*/agent/sessions/*}/labels:delete *
AddSessionComment POST /v2/{session_id=projects/*/agent/sessions/*}/comments:add *
DeleteSessionComments POST /v2/{session_id=projects/*/agent/sessions/*}/comments:delete *
UpdateSessionComments POST /v2/{session_id=projects/*/agent/sessions/*}/comments:update *
ListSessionComments GET /v2/{session_id=projects/*/agent/sessions/*}/reviews
ListSessionReviews GET /v2/{session_id=projects/*/agent/sessions/*}/reviews
GetSessionReview GET /v2/{session_review_id=projects/*/agent/sessions/*/reviews/*}
GetLatestSessionReview GET /v2/{session_id=projects/*/agent/sessions/*}/reviews:getLatestSessionReview
CreateSessionReview POST /v2/{session_id=projects/*/agent/sessions/*}:createSessionReview *
Messages

AddAudioFilesRequest

This message is a request to add the audio files specified

FieldTypeLabelDescription
parent string

Required. The project of this agent. Format:

projects/<project_uuid>/agent

session_id string

The unique identifier of the session for which the audio files should be listed Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/<

audio_file_resources AudioFileResource repeated

AudioFileResources to be added

session_step_id string

The unique identifier of the session step for which the audio files should be listed Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/sessionsteps/<session_step_uuid>/<

AddAudioFilesResponse

This message is a request to add the audio files specified

FieldTypeLabelDescription
audio_file_resources AudioFileResource repeated

The unique identifier of the audio files for a specific session. Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/audios/<audio_uuid>

error_message string

error message if there are any.

AddSessionCommentRequest

This message is a request to add a comment to a session

FieldTypeLabelDescription
session_id string

The id of the session

comment Comment

The comment to add to the session

AddSessionLabelsRequest

This message is a request to add session labels

FieldTypeLabelDescription
session_id string

The id of the session

labels string repeated

The labels to add to the session

AudioFileResource

FieldTypeLabelDescription
name string

The unique identifier of the session for which the latest review should be returned Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/audios/<audio_uuid>

bytes bytes

Bytes of the audio file

language string

Language of the audio file

duration_in_s float

Duration in seconds and milliseconds of the audio file

sample_rate int32

sample rate of the audio

audio_file_resource_type AudioFileResourceType

File type of an audio resource

transcriptions S2tTranscription repeated

transcriptions of the user input sorted by score. A transcription can be from a speech-to-text system or a human

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

display_name string

Bytes of the audio file

ContextFilter

Message used to filter sessions based on contextual information

FieldTypeLabelDescription
context_name string

name of the context

key string

name of the key of the context parameter

value string

value of the parameter

operator ComparisonOperator

comparison operator to use for filtering

CreateSessionRequest

This message is a request to create a session

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

session_uuid string

The unique UUID of a Session Format: UUID Version 4, e.g. 2f59fad2-06bc-4730-9920-d3148f28f357 Optional. If not provided, it will be auto-generated

labels string repeated

Optional. labels for the session.

contexts Context repeated

Optional. The collection of contexts to be activated before this query is executed.

CreateSessionReviewRequest

FieldTypeLabelDescription
session_id string

The unique identifier for the session under review Format:

projects/<project_uuid>/agent/sessions/<session_uuid>

parent_review_id string

Optional: The unique identifier of the parent review Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/reviews/<session_review_uuid>

session_review SessionReview

The reviews for all steps in the session

session_review_view SessionReview.View

Represents the options for views of a session_review. A session_review can be a sizable object. Therefore, we provide a resource view that does not return all data

CreateSessionStepRequest

CreateSessionStepRequest stores a session step into the session

FieldTypeLabelDescription
session_id string

The unique identifier for the given review Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/sessionsteps/<session_step_uuid>
.

session_step SessionStep

The session step to be added

field_mask google.protobuf.FieldMask

field mask specifying what the request should return, e.g. only name, created_at etc.

DeleteAudioFilesRequest

This message is a request to the delete audio files specified

FieldTypeLabelDescription
parent string

Required. The project of this agent. Format:

projects/<project_uuid>/agent

names string repeated

The unique identifier of the audio file of the specific session Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/audios/<audio_uuid>

DeleteAudioFilesResponse

This message is a request to the delete audio files specified

FieldTypeLabelDescription
names string repeated

The unique identifier of the audio file of the specific session Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/audios/<audio_uuid>

error_message string

error message if there are any.

DeleteSessionCommentsRequest

This message is a request to delete a session comment

FieldTypeLabelDescription
session_id string

The id of the session

comment_names string repeated

The comment names to delete from the session

DeleteSessionLabelsRequest

This message is a request to delete session labels

FieldTypeLabelDescription
session_id string

The id of the session

labels string repeated

The labels to delete from the session

DeleteSessionRequest

This message is a request to delete a session

FieldTypeLabelDescription
session_id string

Required. The session to be deleted Format:

projects/<project_uuid>/agent/sessions/<session_uuid>

DeleteSessionStepRequest

This message is a request to delete a session step of a session

FieldTypeLabelDescription
name string

The unique identifier for the given session step Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/sessionsteps/<session_step_uuid>
.

DetectIntentRequest

The request to detect user's intent.

FieldTypeLabelDescription
session string

Required. The name of the session this query is sent to. Format: projects/<project_uuid>/agent/sessions/<session_uuid>. It's up to the API caller to choose an appropriate session ID. It can be a random number or some type of user identifier (preferably hashed). The length of the session ID must not exceed 36 bytes.

query_params QueryParameters

Optional. The parameters of this query.

query_input QueryInput

Required. The input specification. It can be set to:

  1. an audio config which instructs the speech recognizer how to process the speech audio,
  2. a conversational query in the form of text, or
  3. an event that specifies which intent to trigger.

input_audio bytes

Optional. The natural language speech audio to be processed. This field should be populated iff query_input is set to an input audio config. A single request can contain up to 1 minute of speech audio data.

DetectIntentResponse

The message returned from the DetectIntent method.

FieldTypeLabelDescription
response_id string

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

query_result QueryResult

The results of the conversational query or event processing.

webhook_status google.rpc.Status

Specifies the status of the webhook request. webhook_status is never populated in webhook requests.

DetectedIntent

This message contains a detected intent

FieldTypeLabelDescription
intent Intent

intent

score float

score of intent detection

algorithm string

intent detection algorithm

fulfillment_messages Intent.Message repeated

collection of rich messages to present to the user This field is set only for the first detected intent. For the rest of the intents the messages are not resolved and the raw messages for the current language code are available in self.intent.messages

required_param_missing bool

This field is set to:

  • true if the matched intent has required parameters and not all of the required parameter values have been collected.
  • false if all required parameter values have been collected, or if the matched intent doesn't contain any required parameters.

DocumentFileResource

Represents a document file resource (e.g., text, markdown, PDF, DOCX).

FieldTypeLabelDescription
name string

The unique identifier for the document file resource. Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/documents/<document_uuid>

display_name string

The display name of the document file, which can be the file name (e.g., "report.pdf") or a user-assigned name.

bytes bytes

The raw bytes of the document file (e.g., PDF, DOCX, TXT).

created_at google.protobuf.Timestamp

Creation date and time of the document file. This is a read-only field.

modified_at google.protobuf.Timestamp

The last modification date and time of the document file. This is a read-only field.

created_by string

The UUID of the user who created the document file.

modified_by string

The UUID of the user who last modified the document file.

EventInput

Events allow for matching intents by event name instead of the natural language input.

For instance, input <event: { name: "welcome_event", parameters: { name: "Sam" } }> can trigger a personalized welcome response.

The parameter name may be used by the agent in the response: "Hello #welcome_event.name! What can I do for you today?".

FieldTypeLabelDescription
name string

Required. The unique identifier of the event.

parameters google.protobuf.Struct

Optional. The collection of parameters associated with the event.

language_code string

Required. The language of this query. See Language Support for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language.

FileResource

Represents a file resource that can either be an image, audio, document, or video file.

FieldTypeLabelDescription
document_file_resource DocumentFileResource

Document file resource (e.g., markdown, text, word, powerpoint, pdf, excel etc.).

audio_file_resource AudioFileResource

An audio file resource, such as a recording or sound file.

image_file_resource ImageFileResource

An image file resource, such as a JPEG, PNG, etc.

video_file_resource VideoFileResource

A video file resource, such as an MP4 or AVI file.

GetAudioFileOfSessionRequest

This message is a request to get one one file combining all audios of a specific session

FieldTypeLabelDescription
parent string

Required. The project of this agent. Format:

projects/<project_uuid>/agent

session_id string

The unique identifier of the session for which the audio files should be combined Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/<

resource_view ResourceView

Represents the options for views of resources

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

GetAudioFilesRequest

This message is a request to get audio files specified

FieldTypeLabelDescription
parent string

Required. The project of this agent. Format:

projects/<project_uuid>/agent

names string repeated

The unique identifier of the audio file of the specific session Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/audios/<audio_uuid>

resource_view ResourceView

Represents the options for views of resources

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

sorting_mode SortingMode

sorting mode

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

GetAudioFilesResponse

This message is a request to retrieve the audio files specified

FieldTypeLabelDescription
audio_files AudioFileResource repeated

The unique identifier of the audio file for a specific session. Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/audios/<audio_uuid>

error_message string

error message if there are any.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

GetLatestSessionReviewRequest

This message is a request to get latest session review

FieldTypeLabelDescription
session_id string

The unique identifier of the session for which the latest review should be returned Format:

projects/<project_uuid>/agent/sessions/<session_uuid>

session_review_view SessionReview.View

An enum specifying the amount of information to be returned for the desired session review

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

GetSessionRequest

This message is a request to get a session

FieldTypeLabelDescription
session_id string

The session to be returned Format:

projects/<project_uuid>/agent/sessions/<session_uuid>

session_view Session.View

whether to return a full or sparse view; if unspecified full view is returned

field_mask google.protobuf.FieldMask

Optional. The mask to control which fields will be filled with data. Example: path=["session_info.duration_in_s_min"]

GetSessionReviewRequest

This message is a request to get session review

FieldTypeLabelDescription
session_review_id string

The unique identifier of the session review to be returned

session_review_view SessionReview.View

The view of the session review to be returned

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

GetSessionStepRequest

This message is a request to get a session step

FieldTypeLabelDescription
name string

The unique identifier for the given session step Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/sessionsteps/<session_step_uuid> 

field_mask google.protobuf.FieldMask

Optional. The mask to control which fields will be filled with data. Example: path=["session_step.detect_intent_response.query_result.fulfillment_messages"]

ImageFileResource

FieldTypeLabelDescription
name string

The unique identifier of the session for which the latest review should be returned Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/images/<image_uuid>

display_name string

File name of the image, e.g., MyPicture.jpg, or a user assigned display name

bytes bytes

Bytes of the audio file

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

InputAudioConfig

Instructs the speech recognizer how to process the audio content.

FieldTypeLabelDescription
audio_encoding AudioEncoding

Required. Audio encoding of the audio content to process.

sample_rate_hertz int32

Required. Sample rate (in Hertz) of the audio content sent in the query. Refer to Cloud Speech API documentation for more details.

language_code string

Required. The language of the supplied audio. Dialogflow does not do translations. See Language Support for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language.

phrase_hints string repeated

Optional. The collection of phrase hints which are used to boost accuracy of speech recognition. Refer to Cloud Speech API documentation for more details.

ListAccountIdsOfAllSessionsRequest

request to list all account_ids of all sessions

FieldTypeLabelDescription
parent string

The parent for which the account_ids for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListAccountIdsResponse

This message is a response of listing session account_ids

FieldTypeLabelDescription
account_ids string repeated

The account_ids of the session

ListAudioFilesRequest

This message is a request to list all available audio files of a session

FieldTypeLabelDescription
parent string

Required. The project of this agent. Format:

projects/<project_uuid>/agent

session_id string

Optional: The unique identifier of the session for which the audio files should be listed Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/<

resource_view ResourceView

Represents the options for views of resources

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

sorting_mode SortingMode

sorting mode

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListAudioFilesResponse

This message is a request to retrieve the audio files specified

FieldTypeLabelDescription
audio_files AudioFileResource repeated

The requested audio files . Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/audios/<audio_uuid>

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

error_message string

error message if there are any.

ListDatastreamIdsOfAllSessionsRequest

request to list all datastream_ids of all sessions

FieldTypeLabelDescription
parent string

The parent for which the datastream_ids for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

ListDatastreamIdsResponse

This message is a response of listing session datastream_ids

FieldTypeLabelDescription
datastream_ids string repeated

The datastream_ids of the session

ListIdentifiedUserIdsOfAllSessionsRequest

request to list all identified_user_ids of all sessions

FieldTypeLabelDescription
parent string

The parent for which the identified_user_ids for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListIdentifiedUserIdsResponse

This message is a response of listing session identified_user_ids

FieldTypeLabelDescription
identified_user_ids string repeated

The identified_user_ids of the session

ListInputContextsOfAllSessionsRequest

request to list all input_contexts of all sessions

FieldTypeLabelDescription
parent string

The parent for which the input_contexts for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListInputContextsResponse

This message is a response of listing session input_contexts

FieldTypeLabelDescription
input_contexts string repeated

The input_contexts ids of the session

ListLanguageCodesOfAllSessionsRequest

request to list all language codes of all sessions

FieldTypeLabelDescription
parent string

The parent for which the language_codes for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListLanguageCodesResponse

This message is a response of listing session language_codes

FieldTypeLabelDescription
language_codes string repeated

The language_codes of the session

ListMatchedEntityTypesOfAllSessionsRequest

request to list all matched_entity_types of all sessions

FieldTypeLabelDescription
parent string

The parent for which the matched_entity_types for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListMatchedEntityTypesResponse

This message is a response of listing session matched_entity_types

FieldTypeLabelDescription
matched_entity_types string repeated

The matched_entity_types of the session

ListMatchedIntentsOfAllSessionsRequest

request to list all matched_intents of all sessions

FieldTypeLabelDescription
parent string

The parent for which the matched_intents for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListMatchedIntentsResponse

This message is a response of listing session matched_intents

FieldTypeLabelDescription
matched_intents string repeated

The matched_intents of the session

ListOriginIdsOfAllSessionsRequest

request to list all origin_ids of all sessions

FieldTypeLabelDescription
parent string

The parent for which the origin_ids for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListOriginIdsResponse

This message is a response of listing session origin_ids

FieldTypeLabelDescription
origin_ids string repeated

The origin_ids of the session

ListOutputContextsOfAllSessionsRequest

request to list all output_contexts of all sessions

FieldTypeLabelDescription
parent string

The parent for which the output_contexts for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListOutputContextsResponse

This message is a response of listing session output_contexts

FieldTypeLabelDescription
output_contexts string repeated

The output_contexts ids of the session

ListPlatformsOfAllSessionsRequest

request to list all labels of all sessions

FieldTypeLabelDescription
parent string

The parent for which the platforms for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListPlatformsResponse

This message is a response of listing session platforms

FieldTypeLabelDescription
platforms string repeated

The platforms of the session

ListPropertyIdsOfAllSessionsRequest

request to list all property_ids of all sessions

FieldTypeLabelDescription
parent string

The parent for which the property_ids for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

ListPropertyIdsResponse

This message is a response of listing session property_ids

FieldTypeLabelDescription
property_ids string repeated

The property_ids of the session

ListSessionCommentsRequest

This message is a request to list comments of a session

FieldTypeLabelDescription
session_id string

The unique identifier for the session for which reviews should be listed Format:

projects/<project_uuid>/agent/sessions/<session_uuid>

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListSessionCommentsResponse

This message is a request to list comments of a session

FieldTypeLabelDescription
comment Comment repeated

The comments of a specific session Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/comments/<comment_uuid>

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

ListSessionLabelsOfAllSessionsRequest

request to list all labels of all sessions

FieldTypeLabelDescription
parent string

The parent for which the labels for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListSessionLabelsRequest

This message is a request to list session labels

FieldTypeLabelDescription
session_id string

The id of the session

ListSessionLabelsResponse

This message is a response of listing session labels

FieldTypeLabelDescription
labels string repeated

The labels of the session

ListSessionReviewsRequest

This message is a request to list session reviews

FieldTypeLabelDescription
session_id string

The unique identifier for the session for which reviews should be listed Format:

projects/<project_uuid>/agent/sessions/<session_uuid>

session_review_view SessionReview.View

An enum specifying the amount of information to be returned per session review

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

ListSessionReviewsResponse

This message is a response of listing session reviews

FieldTypeLabelDescription
session_reviews SessionReview repeated

The requested session reviews

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

ListSessionsRequest

This message is a request to list sessions

FieldTypeLabelDescription
parent string

Required. The project that the agent to fetch is associated with. Format:

projects/<project_uuid>/agents

session_view Session.View

An enum specifying the amount of information to be returned per session

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask

Optional. The mask to control which fields will be filled with data. Example: path=["session_info.duration_in_s_min"]

ListSessionsResponse

This message is a response including the listing of sessions

FieldTypeLabelDescription
sessions Session repeated

The requested sessions

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

ListTagsOfAllSessionsRequest

request to list all tags of all sessions

FieldTypeLabelDescription
parent string

The parent for which the tags for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListTagsResponse

This message is a response of listing session tags

FieldTypeLabelDescription
tags string repeated

The tags of the session

ListUserIdsOfAllSessionsRequest

request to list all user_ids of all sessions

FieldTypeLabelDescription
parent string

The parent for which the user_ids for all sessions should be listed Format:

projects/<project_uuid>/agent

session_filter SessionFilter

Optional. A filter to narrow the response down to sessions of interest.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListUserIdsResponse

This message is a response of listing session user_ids

FieldTypeLabelDescription
user_ids string repeated

The user_ids of the session

QueryInput

Represents the query input. It can contain either:

1. An audio config which instructs the speech recognizer how to process the speech audio.

2. A conversational query in the form of text,.

3. An event that specifies which intent to trigger.

FieldTypeLabelDescription
audio_config InputAudioConfig

Instructs the speech recognizer how to process the speech audio.

text TextInput

The natural language text to be processed.

event EventInput

The event to be processed.

file_resources FileResource repeated

Files as input for the detect intent request, e.g., image, document, audio, video etc.

QueryParameters

Represents the parameters of the conversational query.

FieldTypeLabelDescription
time_zone string

Optional. The time zone of this conversational query from the time zone database, e.g., America/New_York, Europe/Paris. If not provided, the time zone specified in agent settings is used.

geo_location google.type.LatLng

Optional. The geo location of this conversational query.

contexts Context repeated

Optional. The collection of contexts to be activated before this query is executed.

reset_contexts bool

Optional. Specifies whether to delete all contexts in the current session before the new ones are activated.

payload google.protobuf.Struct

Optional. This field can be used to pass custom data into the webhook associated with the agent. Following key:value pairs are supported in the JSON objects: key: language

language=LanguageCode.de.value
key: timestamp
timestamp=time.time() # float python timestamp in seconds since epoch 
key: source
source='https://ondewo.com'
key: configuration
configuration='config_example_123'
key: single_intent_algorithm
single_intent_algorithm='IntentClassifierType.OndewoIntentAgent'
=> allowed other values for single_intent_algorithm:
 IntentClassifierType.DefaultFallBackAlgorithm
 IntentClassifierType.DeviationEndingDetection
 IntentClassifierType.IntentExitDetector
 IntentClassifierType.OndewoIntentAgent
 IntentClassifierType.OndewoIntentBertClassifier
 IntentClassifierType.OndewoIntentExactContextDetector
 IntentClassifierType.OndewoIntentExactMatch
 IntentClassifierType.OndewoIntentExitDetector
 IntentClassifierType.OndewoIntentLogisticRegression
 IntentClassifierType.OndewoIntentMetaClassifier
 IntentClassifierType.OndewoIntentNamedExactMatch
 IntentClassifierType.OndewoIntentNamedSimilarityMatch
 IntentClassifierType.OndewoIntentParameterMatch
 IntentClassifierType.OndewoIntentRandomForestClassifier
 IntentClassifierType.OndewoIntentRankingMatch
 IntentClassifierType.OndewoIntentSimilarityMatch
 IntentClassifierType.OndewoIntentSupportVectorClassifier
 IntentClassifierType.OndewoWeightedEnsemble
key: single_ner_algorithm
single_ner_algorithm='NerMethodType.OndewoNerRegex'
=> allowed other values for single_ner_algorithm:
 NerMethodType.OndewoNerBert
 NerMethodType.OndewoNerDateNer
 NerMethodType.OndewoNerDictionary
 NerMethodType.OndewoNerDuckling
 NerMethodType.OndewoNerFuzzy
 NerMethodType.OndewoNerHybrid
 NerMethodType.OndewoNerRegex
 NerMethodType.OndewoNerSpacy
 NerMethodType.OndewoNerTfNer

labels string repeated

labels associated to this request

platforms Intent.Message.Platform repeated

Only messages for the specified Intent.Message.Platform platforms are sent to the user in the DetectIntentResponse

account_id string

Id of the account, e.g. Company Ondewo

property_id string

Id of the property of the account, e.g. Domain ondewo.com This field can also be used for a customized tracking id or tag id

datastream_id string

Id of the datastream of the property of the account, e.g. Subdomain sub1.ondewo.com or sub2.ondewo.com This field can also be used for a customized tracking id or tag id

origin_id string

Id of the the origin of the user request For a phone bot, this is the phone number +123456789 the user called (Note: This is not the user's phone number) For a chatbot or voicebot on the web, this is the URL on which the bo, e.g. https://ondewo.com/webchat For a voice assistant device, this is the device-id or the app id This field can also be used for a customized tracking id or tag id https://aim-develop.ondewo.com/

identified_user_id string

Id of the "identified user" e.g. for a chatbot the email address or for a phone bot the phone number of the user This field can also be used for a customized tracking id or tag id

transcriptions S2tTranscription repeated

transcriptions of the user input sorted by score

QueryResult

Represents the result of conversational query or event processing.

FieldTypeLabelDescription
query_text string

The original conversational query text:

  • If natural language text was provided as input, query_text contains a copy of the input.
  • If natural language speech audio was provided as input, query_text contains the speech recognition result. If speech recognizer produced multiple alternatives, a particular one is picked.
  • If an event was provided as input, query_text is not set.

speech_recognition_confidence float

The Speech recognition confidence between 0.0 and 1.0. A higher number indicates an estimated greater likelihood that the recognized words are correct. The default of 0.0 is a sentinel value indicating that confidence was not set. You should not rely on this field as it isn't guaranteed to be accurate, or even set. In particular this field isn't set in Webhook calls and for StreamingDetectIntent since the streaming endpoint has separate confidence estimates per portion of the audio in StreamingRecognitionResult.

action string

The action name from the matched intent.

parameters google.protobuf.Struct

The collection of extracted parameters.

all_required_params_present bool

This field is set to:

  • false if the matched intent has required parameters and not all of the required parameter values have been collected.
  • true if all required parameter values have been collected, or if the matched intent doesn't contain any required parameters.

fulfillment_text string

The text to be pronounced to the user or shown on the screen.

fulfillment_messages Intent.Message repeated

The collection of rich messages to present to the user.

webhook_source string

If the query was fulfilled by a webhook call, this field is set to the value of the source field returned in the webhook response.

webhook_payload google.protobuf.Struct

If the query was fulfilled by a webhook call, this field is set to the value of the payload field returned in the webhook response.

output_contexts Context repeated

The collection of output contexts. If applicable, output_contexts.parameters contains entries with name <parameter name>.original containing the original parameter values before the query.

intent Intent

The intent that matched the conversational query. Some, not all fields are filled in this message, including but not limited to: name, display_name and webhook_state.

intent_detection_confidence float

The intent detection confidence. Values range from 0.0 (completely uncertain) to 1.0 (completely certain).

query_text_original string

The user input gets pre-processed by spelling correction, stop word removal etc. This property holds the string that is passed to the entity recognition and intent detection

diagnostic_info google.protobuf.Struct

The free-form diagnostic info. For example, this field could contain webhook call latency.

language_code string

The language that was triggered during intent detection. See Language Support for a list of the currently supported language codes.

file_resources FileResource repeated

Generated or attached files, e.g., llm generates a picture or file attachment

S2tTranscription

Represents a speech-to-text transcription.

FieldTypeLabelDescription
name string

resource name of the transcription

text string

The transcribed text content.

score float

Optional. A confidence score associated with the transcription. The score indicates the level of confidence in the accuracy of the transcription. It is a floating-point number, typically ranging from 0.0 (low confidence) to 1.0 (high confidence).

language_code string

Optional. The detected language of the transcription. The language is represented by a string following language codes (e.g., "en" for English, "es" for Spanish).

audio_resource_name string

the resource name of the audio file of the transcription

pipeline_id string

Optional. pipeline used for transcription. A pipeline ID. Example: "pipeline_1"

duration_in_s float

Optional. Duration in seconds for transcription

transcription_type TranscriptionType

Whether a speech-to-text engine or a human has transcribed the audio

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

Session

Session of a user interaction

FieldTypeLabelDescription
name string

The unique identifier of the session Format:

projects/<project_uuid>/agent/sessions/<session_uuid>

session_steps SessionStep repeated

The list of all the steps of the session

session_info SessionInfo

session information

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

SessionFilter

This message contains a session filter

FieldTypeLabelDescription
language_codes string repeated

A SessionFilter can be used in some requests to return only sessions matching certain filter conditions. All fields below are optional. Multiple fields specified at the same time are chained via AND. Match only sessions with all of the following language_codes

matched_intents Intent repeated

Match only sessions during which all of the following intents were detected NOTE: only name and display name fields are used for comparison

matched_entity_types EntityType repeated

Match only sessions during which all of the following entity types were recognized NOTE: only name and display name fields are used for comparison

min_intents_confidence_min float

Match only sessions where the minimum confidence for intent detection along the session falls in the following range. Defaults to -1 if not set.

min_intents_confidence_max float

Match only sessions where the minimum confidence for intent detection along the session falls in the following range. Defaults to +1 if not set.

min_entity_types_confidence_min float

Match only sessions where the minimum confidence for entity recognition along the session falls in the following range. Defaults to -1 if not set.

min_entity_types_confidence_max float

Match only sessions where the minimum confidence for entity recognition along the session falls in the following range. Defaults to +1 if not set.

earliest double

Match only sessions whose time range falls within the following range (in UNIX epochs). Defaults to 0 if not set.

latest double

Match only sessions whose time range falls within the following range (in UNIX epochs). Defaults to current epoch if not set

min_number_turns int32

Match only sessions for which the number of turns (interaction steps) falls in the following range Defaults to 0 if not set.

max_number_turns int32

Match only sessions for which the number of turns (interaction steps) falls in the following range Defaults to MAXINT if not set.

labels string repeated

Match only session which have all of the following labels assigned

user_ids string repeated

Match only session which had all of the following user_ids interacting with them.

intent_tags string repeated

Match only session which have all of the following intent tags assigned

session_ids string repeated

Match only sessions whose IDs are specified here

input_contexts Context repeated

Match only sessions whose session info contains at least one step having all the contexts specified here The input contexts are pre-conditions for detecting intents

output_contexts Context repeated

The output contexts are the result of the intent matching and track the contextual state of a conversation

duration_in_s_min float

Match only sessions for which the duration in seconds are larger or equal

duration_in_s_max float

Match only sessions for which the duration in seconds are smaller or equal

duration_in_m_min float

Match only sessions for which the duration in minutes are larger or equal

duration_in_m_max float

Match only sessions for which the duration in minutes are smaller or equal

duration_in_m_rounded_min float

Match only sessions for which the duration in minutes rounded are larger or equal

duration_in_m_rounded_max float

Match only sessions for which the duration in minutes rounded are smaller or equal

duration_interval_15s_rounded_min float

Match only sessions for which the duration in 15 seconds rounded are larger or equal

duration_interval_15s_rounded_max float

Match only sessions for which the duration in 15 seconds rounded are smaller or equal

duration_interval_30s_rounded_min float

Match only sessions for which the duration in 30 seconds rounded are larger or equal

duration_interval_30s_rounded_max float

Match only sessions for which the duration in 30 seconds rounded are smaller or equal

duration_interval_45s_rounded_min float

Match only sessions for which the duration in 45 seconds rounded are larger or equal

duration_interval_45s_rounded_max float

Match only sessions for which the duration in 45 seconds rounded are smaller or equal

started_time_slot_per_hour_min string

Match only sessions for which the started_time_slot_per_hour (e.g. 08:00) are larger or equal

started_time_slot_per_hour_max string

Match only sessions for which the started_time_slot_per_hour (e.g. 14:00) are smaller or equal

started_time_slot_per_quarter_hour_min string

Match only sessions for which the started_time_slot_per_quarter_hour (e.g. 08:00) are larger or equal

started_time_slot_per_quarter_hour_max string

Match only sessions for which the started_time_slot_per_quarter_hour (e.g. 14:00) are smaller or equal

started_time_slot_per_half_hour_min string

Match only sessions for which the started_time_slot_per_half_hour (e.g. 08:00) are larger or equal

started_time_slot_per_half_hour_max string

Match only sessions for which the started_time_slot_per_half_hour (e.g. 14:00) are smaller or equal

started_time_slot_per_day_phase_min string

Match only sessions for which the started_time_slot_per_day_phase (e.g. 08:00) are larger or equal

started_time_slot_per_day_phase_max string

Match only sessions for which the started_time_slot_per_day_phase (e.g. 14:00) are smaller or equal

started_time_slot_per_minute_min string

Match only sessions for which the started_time_slot_per_minute (e.g. 08:00) are larger or equal

started_time_slot_per_minute_max string

Match only sessions for which the started_time_slot_per_minute (e.g. 14:00) are smaller or equal

duration_in_s_rounded_min float

Match only sessions for which the duration in seconds rounded are larger or equal

duration_in_s_rounded_max float

Match only sessions for which the duration in seconds rounded are smaller or equal

platforms Intent.Message.Platform repeated

Messages for each of the Intent.Message.Platform were sent to the user

account_ids string repeated

Ids of the account, e.g. Company Ondewo, This field can also be used for customized tracking ids or tag ids

property_ids string repeated

Ids of the property of the account, e.g. Domain ondewo.com This field can also be used for customized tracking ids or tag ids

datastream_ids string repeated

Ids of the datastream of the property of the account, e.g. Subdomain sub1.ondewo.com or sub2.ondewo.com This field can also be used for customized tracking ids or tag ids

origin_ids string repeated

Ids of the the origin of the user request For a phone bot, this is the phone number +123456789 the user called (Note: This is not the user's phone number) For a chatbot or voicebot on the web, this is the URL on which the bo, e.g. https://ondewo.com/webchat For a voice assistant device, this is the device-id or the app id

identified_user_ids string repeated

Ids of the "identified user" e.g. for a chatbot the email address or for a phone bot the phone number of the user

duration_interval_60s_rounded_min float

Match only sessions for which the duration in 60 seconds rounded are larger or equal

duration_interval_60s_rounded_max float

Match only sessions for which the duration in 60 seconds rounded are smaller or equal

SessionInfo

This message contains information about session

FieldTypeLabelDescription
language_codes string repeated

A SessionInfo contains some general information about a session. This information can be returned inside a Session object for consumption by a client. Or it can be used by the backend to check whether the Session matches a given SessionFilter. All fields below are optional. Multiple fields specified at the same time are chained The language codes used in the given session.

matched_intents Intent repeated

A list of intents which have been matched

matched_entity_types EntityType repeated

A list of entity types which have been matched

min_intents_confidence float

The minimum confidence for intent recognition along the session

min_entity_types_confidence float

The minimum confidence for entity recognition along the session

earliest double

The earliest date of the given session (in UNIX epochs), i.e. the time of the first interaction of a user in the given session

latest double

The latest date of the given session (in UNIX epochs), i.e. the time of the last interaction of a user in the given session

number_turns int32

The number of turns (interaction steps) in the given session

labels string repeated

The list of labels of the given session

user_ids string repeated

The user_ids of the users which were interacting within the given session

intent_tags string repeated

The list of intent tags in the given session

input_context_steps SessionInfo.ContextSteps repeated

The input contexts that are matched in the given session. The name of the context here is the short name and not the full URL name including the project parent

output_context_steps SessionInfo.ContextSteps repeated

The output contexts that are matched in the given session. The name of the context here is the short name and not the full URL name including the project parent

duration_in_s float

duration in seconds

duration_in_m float

duration in minutes

duration_in_m_rounded float

duration in minutes rounded

duration_interval_15s_rounded float

duration in 15 seconds intervals rounded

duration_interval_30s_rounded float

duration in 30 seconds intervals rounded

duration_interval_45s_rounded float

duration in 45 seconds intervals rounded

started_time_slot_per_hour string

started_time_slot_per_hour (e.g. 08:00)

started_time_slot_per_quarter_hour string

started_time_slot_per_quarter_hour (e.g. 08:00)

started_time_slot_per_half_hour string

started_time_slot_per_half_hour (e.g. 08:00)

started_time_slot_per_day_phase string

started_time_slot_per_day_phase (e.g. 14:00)

started_time_slot_per_minute string

started_time_slot_per_minute (e.g. 14:00)

duration_in_s_rounded float

duration in seconds rounded

platforms Intent.Message.Platform repeated

Messages for each of the Intent.Message.Platform were sent to the user

account_ids string repeated

Ids of the account, e.g. Company Ondewo, This field can also be used for customized tracking ids or tag ids

property_ids string repeated

Ids of the property of the account, e.g. Domain ondewo.com This field can also be used for customized tracking ids or tag ids

datastream_ids string repeated

Ids of the datastream of the property of the account, e.g. Subdomain sub1.ondewo.com or sub2.ondewo.com This field can also be used for customized tracking ids or tag ids

origin_ids string repeated

Ids of the the origin of the user request For a phone bot, this is the phone number +123456789 the user called (Note: This is not the user's phone number) For a chatbot or voicebot on the web, this is the URL on which the bo, e.g. https://ondewo.com/webchat For a voice assistant device, this is the device-id or the app id

identified_user_ids string repeated

Ids of the "identified user" e.g. for a chatbot the email address or for a phone bot the phone number of the user

duration_interval_60s_rounded float

duration in 60 seconds intervals rounded

parent_comment Comment repeated

comments about a session

SessionInfo.ContextSteps

The list of contexts of each step collected in an outer list

FieldTypeLabelDescription
contexts Context repeated

List of contexts for a session step

SessionReview

This message contains a session review

FieldTypeLabelDescription
name string

The unique identifier for the given review Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/reviews/<session_review_uuid>

session_review_steps SessionReviewStep repeated

The reviews for all steps in the session

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

SessionReviewStep

This message contains a session review step

FieldTypeLabelDescription
name string

The unique identifier for the given review step Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/reviews/<review_uuid>/sessionreviewsteps/<session_review_step_uuid>

annotated_usersays Intent.TrainingPhrase

The user says with markup of the detected entity types after the preprocessing such as spelling correction, stopword removal etc. has been applied. This string represents what has been passed to the entity recognition and intent detection algorithms.

language_code string

The language code

detected_intents DetectedIntent repeated

Unique detected intents ordered by descending confidence

contexts Context repeated

The contexts which were active at the beginning of this step

contexts_out Context repeated

The output contexts of this step

query_text_original string

User input without any pre-processing applied

platforms Intent.Message.Platform repeated

Messages for each of the Intent.Message.Platform were sent to the user

timestamp google.protobuf.Timestamp

Timestamp of session review step

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

audio_file_resources AudioFileResource repeated

audio file resources associated with the session review step

SessionStep

SessionStep is a single user interaction as part of a session

FieldTypeLabelDescription
name string

The unique identifier for the given review Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/sessionsteps/<session_step_uuid>

detect_intent_request DetectIntentRequest

The detect intent request of the session step

detect_intent_response DetectIntentResponse

The detect intent response of the session step

contexts Context repeated

The contexts which were active at the beginning of this step

timestamp google.protobuf.Timestamp

Timestamp of session step

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

audio_file_resources AudioFileResource repeated

audio file resources associated with the session step

StreamingDetectIntentRequest

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

Multiple request messages should be sent in order:

1. The first message must contain session, query_input plus optionally query_params and/or single_utterance. The message must not contain input_audio.

2. If query_input was set to a streaming input audio config, all subsequent messages must contain only input_audio. Otherwise, finish the request stream.

FieldTypeLabelDescription
session string

Required. The name of the session the query is sent to. Format of the session name: projects/<project_uuid>/agent/sessions/<session_uuid>. It's up to the API caller to choose an appropriate <session_uuid>. It can be a random number or some type of user identifier (preferably hashed). The length of the session ID must not exceed 36 characters.

query_params QueryParameters

Optional. The parameters of this query.

query_input QueryInput

Required. The input specification. It can be set to:

  1. an audio config which instructs the speech recognizer how to process the speech audio,
  2. a conversational query in the form of text, or
  3. an event that specifies which intent to trigger.

single_utterance bool

Optional. If false (default), recognition does not cease until the client closes the stream. If true, the recognizer will detect a single spoken utterance in input audio. Recognition ceases when it detects the audio's voice has stopped or paused. In this case, once a detected intent is received, the client should close the stream and start a new request with a new stream as needed. This setting is ignored when query_input is a piece of text or an event.

input_audio bytes

Optional. The input audio content to be recognized. Must be sent if query_input was set to a streaming input audio config. The complete audio over all streaming messages must not exceed 1 minute.

StreamingDetectIntentResponse

The top-level message returned from the StreamingDetectIntent method.

Multiple response messages can be returned in order:

1. If the input was set to streaming audio, the first one or more messages contain recognition_result. Each recognition_result represents a more complete transcript of what the user said. The last recognition_result has is_final set to true.

2. The next message contains response_id, query_result and optionally webhook_status if a WebHook was called.

FieldTypeLabelDescription
response_id string

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

recognition_result StreamingRecognitionResult

The result of speech recognition.

query_result QueryResult

The result of the conversational query or event processing.

webhook_status google.rpc.Status

Specifies the status of the webhook request.

StreamingRecognitionResult

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.

Example:

1. transcript: "tube"

2. transcript: "to be a"

3. transcript: "to be"

4. transcript: "to be or not to be"

is_final: true

5. transcript: " that's"

6. transcript: " that is"

7. recognition_event_type: RECOGNITION_EVENT_END_OF_SINGLE_UTTERANCE

8. transcript: " that is the question"

is_final: true

Only two of the responses contain final results (#4 and #8 indicated by is_final: true). Concatenating these generates the full transcript: "to be or not to be that is the question".

In each response we populate:

FieldTypeLabelDescription
message_type StreamingRecognitionResult.MessageType

Type of the result message.

transcript string

Transcript text representing the words that the user spoke. Populated if and only if event_type = RECOGNITION_EVENT_TRANSCRIPT.

is_final bool

The default of 0.0 is a sentinel value indicating confidence was not set. If false, the StreamingRecognitionResult represents an interim result that may change. If true, the recognizer will not return any further hypotheses about this piece of the audio. May only be populated for event_type = RECOGNITION_EVENT_TRANSCRIPT.

confidence float

The Speech confidence between 0.0 and 1.0 for the current portion of audio. A higher number indicates an estimated greater likelihood that the recognized words are correct. The default of 0.0 is a sentinel value indicating that confidence was not set. This field is typically only provided if is_final is true and you should not rely on it being accurate or even set.

TextInput

Represents the natural language text to be processed.

FieldTypeLabelDescription
text string

Required. The UTF-8 encoded natural language text to be processed. Text length must not exceed 256 bytes.

language_code string

Required. The language of this conversational query. See Language Support for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language.

UpdateSessionCommentsRequest

This message is a request to update a session comment

FieldTypeLabelDescription
session_id string

The id of the session

comment Comment

The comment of a session to be updated

UpdateSessionStepRequest

UpdateSessionStepRequest stores a session step into the session

FieldTypeLabelDescription
session_step SessionStep

The session step to be updated

update_mask google.protobuf.FieldMask

Optional. The mask to control which fields will be updated. Example: path=["session_step.detect_intent_response.query_result.fulfillment_messages"]

field_mask google.protobuf.FieldMask

Optional. The mask to control which fields will be filled with data. Example: path=["session_step.detect_intent_response.query_result.fulfillment_messages"]

VideoFileResource

Represents a video file resource (e.g., MP4, AVI).

FieldTypeLabelDescription
name string

The unique identifier for the video file resource. Format:

projects/<project_uuid>/agent/sessions/<session_uuid>/videos/<video_uuid>

display_name string

The display name of the video file, which can be a user-assigned label.

bytes bytes

The raw bytes representing the video file (e.g., MP4, AVI).

duration_in_s float

The duration of the video file in seconds.

resolution string

The resolution of the video (e.g., "1920x1080" for Full HD).

frame_rate float

The frame rate of the video (e.g., 30 fps).

created_at google.protobuf.Timestamp

Creation date and time of the video file. This is a read-only field.

modified_at google.protobuf.Timestamp

The last modification date and time of the video file. This is a read-only field.

created_by string

The UUID of the user who created the video file.

modified_by string

The UUID of the user who last modified the video file.

Enums

AudioEncoding

Audio encoding of the audio content sent in the conversational query request.

Refer to the Cloud Speech API documentation for more details.

NameNumberDescription
AUDIO_ENCODING_UNSPECIFIED 0

Not specified.

AUDIO_ENCODING_LINEAR_16 1

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

AUDIO_ENCODING_FLAC 2

FLAC (Free Lossless Audio Codec) is the recommended encoding because it is lossless (therefore recognition is not compromised) and requires only about half the bandwidth of LINEAR16. FLAC stream encoding supports 16-bit and 24-bit samples, however, not all fields in STREAMINFO are supported.

AUDIO_ENCODING_MULAW 3

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

AUDIO_ENCODING_AMR 4

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

AUDIO_ENCODING_AMR_WB 5

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

AUDIO_ENCODING_OGG_OPUS 6

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

AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE 7

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

AudioFileResourceType

File type of an audio resource

NameNumberDescription
AUDIO_FILE_RESOURCE_TYPE_UNSPECIFIED 0

Unspecified audio file type

AUDIO_FILE_RESOURCE_TYPE_T2S 1

Audio file from text to speech

AUDIO_FILE_RESOURCE_TYPE_S2T 2

Audio file from speech to text

AUDIO_FILE_RESOURCE_TYPE_S2T_AND_T2S 3

Audio file from speech to text and text to speech

ComparisonOperator

Type of operator to compare

NameNumberDescription
EQUAL 0

equal operator

GREATER 1

greater operator, e.g. for numbers, dates, and strings

GREATER_OR_EQUAL 2

greater or equal operator, e.g. for numbers, dates, and strings

LESS_OR_EQUAL 3

less or equal operator, e.g. for numbers, dates, and strings

CONTAINS 4

contains operator, e.g. part of string, or one of the elements in an iterable such as set or list

STARTS_WITH 5

starts with operator for string comparison only

ENDS_WITH 6

ends with operator for string comparison only

ResourceView

Represents the options for views of resources.

NameNumberDescription
RESOURCE_VIEW_UNSPECIFIED 0

Resource view not specified

RESOURCE_VIEW_FULL 1

All fields are populated including bytes e.g., for audio files

RESOURCE_VIEW_PARTIAL 2

Fields include metadata but no bytes

RESOURCE_VIEW_MINIMUM 3

Minimum view only without bytes and metadata

Session.View

Represents the options for views of a session.

A session can be a sizable object. Therefore, we provide a resource view that does not return all data

NameNumberDescription
VIEW_UNSPECIFIED 0

Endpoints decide whether to return the full or the sparse view

VIEW_FULL 1

All fields are populated.

VIEW_SPARSE 2

Only some fields are populated in the response.

SessionReview.View

Represents the options for views of a session_review.

A session_review can be a sizable object. Therefore, we provide a resource view that does not return all data

NameNumberDescription
VIEW_UNSPECIFIED 0

Endpoints decide whether to return the full or the sparse view

VIEW_FULL 1

All fields are populated.

VIEW_SPARSE 2

Only some fields are populated in the response.

StreamingRecognitionResult.MessageType

Type of the response message.

NameNumberDescription
MESSAGE_TYPE_UNSPECIFIED 0

Not specified. Should never be used.

TRANSCRIPT 1

Message contains a (possibly partial) transcript.

END_OF_SINGLE_UTTERANCE 2

Event indicates that the server has detected the end of the user's speech utterance and expects no additional speech. Therefore, the server will not process additional audio (although it may subsequently return additional results). The client should stop sending additional audio data, half-close the gRPC connection, and wait for any additional results until the server closes the gRPC connection. This message is only sent if single_utterance was set to true, and is not used otherwise.

TranscriptionType

NameNumberDescription
TRANSCRIPTION_TYPE_UNSPECIFIED 0

unspecified

TRANSCRIPTION_TYPE_S2T 1

Automatic transcription by a speech to text system

TRANSCRIPTION_TYPE_HUMAN 2

Manual human transcription

ondewo/nlu/user.proto

Top

Services

Users

gRPC service for managing users and server roles.

Service Methods

CreateUser

rpc CreateUser (CreateUserRequest) returns (User)
Creates a user.

GetUser

rpc GetUser (GetUserRequest) returns (User)
Retrieves a user by identifier.

GetUserInfo

rpc GetUserInfo (GetUserRequest) returns (UserInfo)
Retrieves user information by identifier.

DeleteUser

rpc DeleteUser (GetUserRequest) returns (.google.protobuf.Empty)
Deletes a user by identifier.

UpdateUser

rpc UpdateUser (UpdateUserRequest) returns (User)
Updates a user.

ListUsers

rpc ListUsers (ListUsersRequest) returns (ListUsersResponse)
Lists users.

ListUserInfos

rpc ListUserInfos (ListUsersRequest) returns (ListUserInfosResponse)
Lists user information.

CreateServerRole

rpc CreateServerRole (CreateServerRoleRequest) returns (ServerRole)
Creates a server role.

GetServerRole

rpc GetServerRole (GetServerRoleRequest) returns (ServerRole)
Retrieves a server role by ID.

DeleteServerRole

rpc DeleteServerRole (DeleteServerRoleRequest) returns (.google.protobuf.Empty)
Deletes a server role by ID.

UpdateServerRole

rpc UpdateServerRole (UpdateServerRoleRequest) returns (ServerRole)
Updates a server role.

ListServerRoles

rpc ListServerRoles (ListServerRolesRequest) returns (ListServerRolesResponse)
Lists server roles.

ListServerPermissions

rpc ListServerPermissions (ListServerPermissionsRequest) returns (ListServerPermissionsResponse)
Lists server permissions.

Login

rpc Login (LoginRequest) returns (LoginResponse)
Requests login.

CheckLogin

rpc CheckLogin (.google.protobuf.Empty) returns (.google.protobuf.Empty)
Checks login.

ListNotifications

rpc ListNotifications (ListNotificationsRequest) returns (ListNotificationsResponse)
Lists notifications based on specified filters.

SetNotificationsFlaggedStatus

rpc SetNotificationsFlaggedStatus (SetNotificationsFlaggedStatusRequest) returns (ListNotificationsResponse)
Sets the flagged status for multiple notifications.

SetNotificationsReadStatus

rpc SetNotificationsReadStatus (SetNotificationsReadStatusRequest) returns (ListNotificationsResponse)
Sets the read status for multiple notifications.

GetUserPreferences

rpc GetUserPreferences (GetUserPreferencesRequest) returns (GetUserPreferencesResponse)
Retrieves user preferences based on the provided request.

SetUserPreferences

rpc SetUserPreferences (SetUserPreferencesRequest) returns (SetUserPreferencesResponse)
Sets or updates user preferences based on the provided request.

DeleteUserPreferences

rpc DeleteUserPreferences (DeleteUserPreferencesRequest) returns (DeleteUserPreferencesResponse)
Deletes specific user preferences based on the provided request.

DeleteAllUserPreferences

rpc DeleteAllUserPreferences (DeleteAllUserPreferencesRequest) returns (DeleteUserPreferencesResponse)
Deletes all user preferences for a specific user, optionally filtered by a substring.

Methods with HTTP bindings

Method Name Method Pattern Body
CreateUser POST /v2/users *
GetUser GET /v2/users/{user_identifier=*}
GetUserInfo GET /v2/user_infos/{user_identifier=*}
DeleteUser DELETE /v2/users/{user_identifier=*}
UpdateUser PATCH /v2/users *
ListUsers GET /v2/users
ListUserInfos GET /v2/users_infos
CreateServerRole POST /v2/server_roles *
GetServerRole GET /v2/server_roles/{role_id=*}
DeleteServerRole DELETE /v2/server_roles/{role_id=*}
UpdateServerRole PATCH /v2/server_roles *
ListServerRoles GET /v2/server_roles
ListServerPermissions GET /v2/server_permissions
Login POST /v2/login *
CheckLogin DELETE /v2/check_login
Messages

CreateServerRoleRequest

Request to create server role

FieldTypeLabelDescription
role ServerRole

If the role_id is not provided, an incremental value will be assigned The "name" and "role_type" are mandatory values The permissions all default to False if not provided specifically

CreateUserRequest

Request to create user

FieldTypeLabelDescription
user User

user_id in the User message should be given, if empty will throw an error in the backend

password string

password

DeleteAllUserPreferencesRequest

Request to delete all user preferences with an optional filter substring.

FieldTypeLabelDescription
user_name string

The name of the user. Format:

projects/<project_uuid>/agent/users/<user_uuid>

regex_filter string

Optional: Only delete keys that match the provided regular expression. If user does not add regex_filter, then all user preferences will be deleted Example: Only delete keys starting with DE: ^DE_ Only delete keys matching: .*user.*

DeleteServerRoleRequest

Request to delete server role

FieldTypeLabelDescription
role_id uint32

role is identified by role id, if empty will throw an error in the backend

DeleteUserPreferencesRequest

Request to delete specific user preferences.

FieldTypeLabelDescription
user_name string

The name of the user. Format:

projects/<project_uuid>/agent/users/<user_uuid>

keys string repeated

List of keys to delete from user preferences.

regex_include string

Optional: In addition to the keys specified also include all keys that match the provided regex_include regular expression. If user does not add regex_filter, then only the keys specified in the keys field are deleted. If both, a key in the keys field and in the regex_include is matched then the key is deleted without raising an error.

DeleteUserPreferencesResponse

Response to delete specific user preferences.

FieldTypeLabelDescription
user_name string

The name of the user. Format:

projects/<project_uuid>/agent/users/<user_uuid>

keys string repeated

List of keys to delete from user preferences.

error_message string

error message if there are any.

DeleteUserRequest

Request to delete user

FieldTypeLabelDescription
user_id string

user is identified by user id, if empty will throw an error in the backend

GetServerRoleRequest

Request to get server role

FieldTypeLabelDescription
role_id uint32

role is identified by role id

role_name string

role can also be uniquely identified by its name

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

GetUserPreferencesRequest

Request to get user preferences.

FieldTypeLabelDescription
user_name string

The name of the user. Format:

projects/<project_uuid>/agent/users/<user_uuid>

keys string repeated

Specific keys to retrieve from user preferences. If keys are specified multiple times then only one KeyValue pair is returned

regex_include string

Optional: In addition to the keys specified also include all keys that match the provided regex_include regular expression. If user does not add regex_filter, then only the keys specified in the keys field are returned. If both, a key in the keys field and in the regex_include will be matched than only a single KeyValuePair is returned.

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

GetUserPreferencesResponse

Response containing user preferences.

FieldTypeLabelDescription
user_name string

The name of the user. Format:

projects/<project_uuid>/agent/users/<user_uuid>

key_value_pairs KeyValuePair repeated

List of key-value pairs representing user preferences.

error_message string

error message if there are any.

GetUserRequest

Request to get user

FieldTypeLabelDescription
user_id string

the user is identified by user id

user_email string

the user can identified by their email

field_mask google.protobuf.FieldMask

Optional field mask to specify which fields to return in the response

ListServerPermissionsRequest

Server permissions

FieldTypeLabelDescription
page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListServerPermissionsResponse

Response containing list of server permissions

FieldTypeLabelDescription
permissions string repeated

The list of server permissions. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

ListServerRolesRequest

Request to list server roles

FieldTypeLabelDescription
page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListServerRolesResponse

Response containing list of server roles

FieldTypeLabelDescription
server_roles ServerRole repeated

The list of server roles. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

ListUserInfosResponse

Response containing list of users

FieldTypeLabelDescription
users UserInfo repeated

The list of server roles. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

ListUserPreferencesRequest

Request to list all user preferences for a specific user.

FieldTypeLabelDescription
user_name string

The name of the user. Format:

projects/<project_uuid>/agent/users/<user_uuid>

regex_filter string

Optional: Only list keys that match the provided regular expression

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListUserPreferencesResponse

Response containing a list of user preferences for a specific user with an optional filter substring.

FieldTypeLabelDescription
user_name string

The name of the user.

key_value_pairs KeyValuePair repeated

List of key-value pairs representing user preferences.

error_message string

error message if there are any.

ListUsersRequest

Request to list user

FieldTypeLabelDescription
page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

ListUsersResponse

Response containing list of users

FieldTypeLabelDescription
users User repeated

The list of users. There will be a maximum number of items returned based on the page_token field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

LoginRequest

Authentication messages

FieldTypeLabelDescription
user_email string

user email

password string

user password

field_mask google.protobuf.FieldMask optional

Optional. The mask to control which fields gets returned.

LoginResponse

This message is a response of logging

FieldTypeLabelDescription
user User

user object - user_id must be there

auth_token string

authentication token after successful login of the user to access NLU services

ServerRole

Server Role messages

FieldTypeLabelDescription
role_id uint32

unique identifier of the role

name string

unique name of the role

permissions string repeated

defines the permissions for the given role (the strings can be gotten from the ListServerPermissions)

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

SetUserPreferencesRequest

Request to set or update user preferences.

FieldTypeLabelDescription
user_name string

The name of the user. Format:

projects/<project_uuid>/agent/users/<user_uuid>

key_value_pairs KeyValuePair repeated

List of key-value pairs to set or update.

SetUserPreferencesResponse

Response to set or update user preferences.

FieldTypeLabelDescription
user_name string

The name of the user. Format:

projects/<project_uuid>/agent/users/<user_uuid>

keys string repeated

List of keys to delete from user preferences.

error_message string

error message if there are any.

UpdateServerRoleRequest

Request to update server role

FieldTypeLabelDescription
role ServerRole

role_id in the Role message should be given, if empty will throw an error in the backend other fields in the Role are optional. Only the fields to be updated should be provided

update_mask google.protobuf.FieldMask

Optional. The mask to control which fields get updated.

UpdateUserRequest

Request to update user

FieldTypeLabelDescription
user User

user_id in the User message should be given, if empty will throw an error in the backend password and other fields in the User are optional. Only the fields to be updated should be provided

password string

Password of the user

update_mask google.protobuf.FieldMask

Optional. The mask to control which fields get updated.

User

this message contains all the fields that required for user db

FieldTypeLabelDescription
user_id string

when creating user user_id is empty, then it will be generated on creation time on backend

display_name string

Optional field display_name is the name that will be used on the frontend to interact with the user it shouldn't be unique. If not provided user_name will also be used as display name

server_role_id uint32

server role type of the given user. If nothing is provided, the user is set to USER (minimum access)

user_email string

user e-mail should be a valid e-mail and unique

user_profile_picture bytes

user profile picture

created_at google.protobuf.Timestamp

Creation date and time. Read-only field.

modified_at google.protobuf.Timestamp

Modification date and time. Read-only field.

created_by string

User id in form of a valid UUID.

modified_by string

User id in form of a valid UUID.

UserInfo

This message contains information about user

FieldTypeLabelDescription
user User

user object

project_roles UserInfo.ProjectRolesEntry repeated

If in GetUser, ListUser requests UserView is FULL, then the mapping is additionally provided of parent of the project and corresponding ProjectRole of the user

UserInfo.ProjectRolesEntry

FieldTypeLabelDescription
key string

value ProjectRole

Enums

DefaultServerRole

Structure of server role

NameNumberDescription
SERVER_UNSPECIFIED 0

unspecified server role

SERVER_USER 1

read-only access

SERVER_MANAGER 2

SERVER_USER's permissions + CRUD of projects and Users

SERVER_ADMIN 3

this role can do everything

SERVER_INACTIVE 4

this role can do nothing. Used to set a user as inactive in the server.

ondewo/nlu/utility.proto

Top

Services

Utilities

This is collection of utility endpoints, intended to language-independent operations, such as code checks, regex checks, etc. Holds a collection of utility functions

Service Methods

ValidateRegex

rpc ValidateRegex (ValidateRegexRequest) returns (ValidateRegexResponse)
Validates the validity of python regexes

ValidateEmbeddedRegex

rpc ValidateEmbeddedRegex (ValidateEmbeddedRegexRequest) returns (ValidateEmbeddedRegexResponse)
Validate that entity types with group references have synonyms with capturing groups.

CleanAllIntents

rpc CleanAllIntents (CleanAllIntentsRequest) returns (CleanAllIntentsResponse)
Cleans all intent training phrases and entity annotations of parent

CleanIntent

rpc CleanIntent (CleanIntentRequest) returns (CleanIntentResponse)
Cleans single intent training phrases and entity annotations

CleanAllEntityTypes

rpc CleanAllEntityTypes (CleanAllEntityTypesRequest) returns (CleanAllEntityTypesResponse)
Cleans all entity types of parent

CleanEntityType

rpc CleanEntityType (CleanEntityTypeRequest) returns (CleanEntityTypeResponse)
Cleans entity type

AddTrainingPhrases

rpc AddTrainingPhrases (AddTrainingPhrasesRequest) returns (AddTrainingPhrasesResponse)
Creates new training phrases corresponding to intent specified by its intent display name

AddTrainingPhrasesFromCSV

rpc AddTrainingPhrasesFromCSV (AddTrainingPhrasesFromCSVRequest) returns (AddTrainingPhrasesResponse)
Creates new training phrases corresponding to intent specified by its intent display name from csv file
Messages

AddTrainingPhrasesFromCSVRequest

Request message to AddTrainingPhraseFromCSV rpc

FieldTypeLabelDescription
parent string

Required. The agent to list all intents from. Format:

projects/<project_uuid>/agent

language_code string

Required. The language to list training phrases, parameters and rich messages for. If not specified, the agent's default language is used. Note: languages must be enabled in the agent before they can be used.

csv_contents bytes

Required. Contents of the .csv file containing training phrases to be added to the intents

extract_entities bool

Optional. Whether or not to extract entities for the new training phrases

special_characters string

Optional. Before new training phrases are added to their corresponding intent, they are cleaned with cleaning scripts. These cleaning scripts remove certain special characters, if they are found at the beginning of the text or if they appear in annotations. Overrides the default: '.,;!?:'

training_phrase_cleaner_options TrainingPhraseCleanerOptions

Optional. Options for the training phrase cleaner to override the default settings

number_of_workers int32

Optional. Number of threads used to accomplish the task

AddTrainingPhrasesRequest

Request message to AddTrainingPhrase rpc

FieldTypeLabelDescription
parent string

Required. The agent to list all intents from. Format:

projects/<project_uuid>/agent

language_code string

Required. The language to list training phrases, parameters and rich messages for. If not specified, the agent's default language is used. Note: languages must be enabled in the agent before they can be used.

training_phrase_list AddTrainingPhrasesRequest.TrainingPhraseForIntent repeated

Required. List of training phrases to be added to the intent

extract_entities bool

Optional. Whether or not to extract entities for the new training phrases

special_characters string

Optional. Characters to be recognized as special characters for cleaning the training phrases. Overrides the default: '.,;!?:'

training_phrase_cleaner_options TrainingPhraseCleanerOptions

Optional. Options for the training phrase cleaner to override the default settings

number_of_workers int32

Optional. Number of threads used to accomplish the task

AddTrainingPhrasesRequest.TrainingPhraseForIntent

Message that contains the new training phrase, together with the intent display name and, optionally the entity annotations

FieldTypeLabelDescription
training_phrase string

Required. New training phrase to be added

intent_display_name string

Required. Corresponding display name of the intent

entities Intent.TrainingPhrase.Entity repeated

Optional. Entity annotations

AddTrainingPhrasesResponse

Response message to AddTrainingPhrase rpc

FieldTypeLabelDescription
error_messages string repeated

Required. If something goes wrong, error messages will be conveyed via a repeated string

CleanAllEntityTypesRequest

Request to clean the entity types

FieldTypeLabelDescription
parent string

Required. The agent to list all intents from. Format:

projects/<project_uuid>/agent

language_code string

Optional. The language to list training phrases, parameters and rich messages for. If not specified, the agent's default language is used. Note: languages must be enabled in the agent before they can be used.

special_characters string

Optional. Characters to be recognized as special characters for cleaning. Overrides the default: '.,;!?:'

substring_white_list string repeated

Optional. List of substring that shall not be cleaned/deleted. Example: ['St.', 'U.S.', 'sys.', '24.12.', 'Nr.', 'TelNr.']

max_entity_count_update int32

Optional. Entity type that contain more than max_entity_count_update entities will not be cleaned. Relevant for auto-generated entity values (e.g. City Names) Default = 10000

forbidden_entity_type_patterns string repeated

Optional. List of strings or regexes. Entity types will be deleted if their display name matches an element of this list Example: ['sys.ignore.'] -> would delete entity types with display names sys.ignore.*

dry_run bool

Required. Do not apply changes to the database if set to True

number_of_workers int32

Optional. Number of threads used to accomplish the task

CleanAllEntityTypesResponse

Response from entity type cleaner

FieldTypeLabelDescription
cleaned_entity_types EntityType repeated

Required. List of updated entity types

deleted_entity_types EntityType repeated

Optional. List of updated entity types

entity_type_updates EntityTypeUpdate repeated

Optional. List of updates performed on entity types

entity_type_deletions EntityTypeUpdate repeated

Optional. List of the deleted entity types

CleanAllIntentsRequest

The request to clean the all intents.

FieldTypeLabelDescription
parent string

Required. The agent to list all intents from. Format:

projects/<project_uuid>/agent

language_code string

Optional. The language to list training phrases, parameters and rich messages for. If not specified, the agent's default language is used. Note: languages must be enabled in the agent before they can be used.

special_characters string

Optional. Characters to be recognized as special characters for cleaning. Overrides the default: '.,;!?:'

substring_white_list string repeated

Optional. List of substring that shall not be cleaned/deleted. Example: ['St.', 'U.S.', 'sys.', '24.12.', 'Nr.', 'TelNr.'] Default = None

dry_run bool

Required. Do not apply changes to the database if set to True

training_phrase_cleaner_options TrainingPhraseCleanerOptions

Optional. Options for the cleaning of the training phrases.

reannotate_entities_options ReannotateEntitiesOptions

Optional. Options for re-annotation of entities (default = REANNOTATE_NEVER)

number_of_workers int32

Optional. Number of threads used to accomplish the task

CleanAllIntentsResponse

Response corresponding to the CleanAllIntents Request

FieldTypeLabelDescription
cleaned_intents Intent repeated

Required. List of updates performed on intents

intent_update_list IntentUpdate repeated

Optional. List of updates applied to intents

CleanEntityTypeRequest

Request to clean a single entity type

FieldTypeLabelDescription
parent string

Required. The agent to list all intents from. Format:

projects/<project_uuid>/agent

entity_type_name string

Required. The name of the entity_type

language_code string

Optional. The language to list training phrases, parameters and rich messages for. If not specified, the agent's default language is used. Note: languages must be enabled in the agent before they can be used.

special_characters string

Optional. Characters to be recognized as special characters for cleaning. Overrides the default: '.,;!?:'

substring_white_list string repeated

Optional. List of substring that shall not be cleaned/deleted. Example: ['St.', 'U.S.', 'sys.', '24.12.', 'Nr.', 'TelNr.']

max_entity_count_update int32

Optional. Entity type that contain more than max_entity_count_update entities will not be cleaned. Relevant for auto-generated entity values (e.g. City Names) Default = 10000

dry_run bool

Required. Do not apply changes to the database if set to True

CleanEntityTypeResponse

Response from entity type cleaner

FieldTypeLabelDescription
cleaned_entity_type EntityType

Required. The cleaned entity type

entity_type_update EntityTypeUpdate

Optional. The updated entity type

CleanIntentRequest

The request message to clean a single intents.

FieldTypeLabelDescription
parent string

Required. The agent to list all intents from. Format:

projects/<project_uuid>/agent

intent_name string

Required. The name of the intent. Format:

projects/<project_uuid>/agent/intents/<intent_uuid>

language_code string

Optional. The language to list training phrases, parameters and rich messages for. If not specified, the agent's default language is used. Note: languages must be enabled in the agent before they can be used.

special_characters string

Optional. Characters to be recognized as special characters for cleaning. Overrides the default: '.,;!?:'

substring_white_list string repeated

Optional. List of substring that shall not be cleaned/deleted. Example: ['St.', 'U.S.', 'sys.', '24.12.', 'Nr.', 'TelNr.'] Default = None

dry_run bool

Required. Do not apply changes to the database if set to True

training_phrase_cleaner_options TrainingPhraseCleanerOptions

Optional. Options for the cleaning of the training phrases.

reannotate_entities_options ReannotateEntitiesOptions

Optional. Options for re-annotation of entities (default = REANNOTATE_NEVER)

CleanIntentResponse

The response message to clean a single intents.

FieldTypeLabelDescription
cleaned_intent Intent

Required. Cleaned Intent

intent_update IntentUpdate

Optional. Updates applied to intent

EntityTypeUpdate

Stores updates applied to an entity type

FieldTypeLabelDescription
entity_type_name string

The entity type name

values_update_list EntityTypeUpdate.EntityUpdate repeated

List of the updated entities

EntityTypeUpdate.EntityUpdate

Stores updates applied to an entity

FieldTypeLabelDescription
entity_value_update StringUpdate

Updates made to the entity value

entity_synonym_updates StringUpdate repeated

Updates made to the entity synonyms

IntentUpdate

Stores updates applied to an intent

FieldTypeLabelDescription
intent_display_name string

The display name of the intent

training_phrase_update_list IntentUpdate.TrainingPhraseUpdate repeated

List of the updated training phrases

deleted_parameters string repeated

List of the deleted parameters

IntentUpdate.TrainingPhraseUpdate

Message to track the updates made to a training phrase

FieldTypeLabelDescription
training_phrase_update StringUpdate

Stores updates of training phrases

entity_updates StringUpdate repeated

Stores updates of entity strings

entities_reannotated string repeated

Stores re-annotated entity strings

contains_update_variable bool

Will be switched to True if at least one update has been performed

StringUpdate

Message to keep track of updated strings

FieldTypeLabelDescription
new string

New version of the string

old string

Old version of the string

TrainingPhraseCleanerOptions

Options for cleaning the training phrases

FieldTypeLabelDescription
delete_repeated_whitespaces bool

Whether or not to delete repeated whitespaces

delete_leading_special_characters bool

Whether of not to delete leading special characters

delete_trailing_special_characters bool

Whether of not to delete trailing special characters

ValidateEmbeddedRegexRequest

Validation request for entity type values

FieldTypeLabelDescription
entity_type EntityType.Entity

ValidateEmbeddedRegexResponse

Response of the entity type validation

FieldTypeLabelDescription
error_messages string repeated

List of error message from the validation

ValidateRegexRequest

The request to validate regexes.

FieldTypeLabelDescription
regex string

String containing the regex.

ValidateRegexResponse

The response of the regex validation

FieldTypeLabelDescription
error_messages string repeated

Error messages

Enums

ReannotateEntitiesOptions

Encapsulates entity re-annotation options

NameNumberDescription
REANNOTATE_NEVER 0

Never re-annotate training phrases

REANNOTATE_ALWAYS 1

Always re-annotate training phrases

REANNOTATE_IF_EMPTY 2

Re-annotate training phrases if there are no annotations

REANNOTATE_AFTER_DELETION 3

Re-annotate if training phrases have been deleted

REANNOTATE_IF_EMPTY_OR_AFTER_DELETION 4

Re-annotate if there are no annotations or if training phrases have been deleted

ondewo/nlu/webhook.proto

Top

Services

Webhook

service to send requests to a webhook server

Service Methods

ResponseRefinement

rpc ResponseRefinement (WebhookRequest) returns (WebhookResponse)
send a request for /response_refinement/ to the webhook server fulfillment messages can be overwritten by the webhook server

SlotFilling

rpc SlotFilling (WebhookRequest) returns (WebhookResponse)
send a request for /slot_filling/ to the webhook server parameter values can be provided & context information can be changed by the webhook server

Ping

rpc Ping (PingRequest) returns (PingResponse)
send a Ping to the webhook server to verify server health will return True if http status_code==200 is detected in the response

CreateSessionEntityType

rpc CreateSessionEntityType (CreateSessionEntityTypeRequest) returns (SessionEntityType)
Creates a session entity type. If the specified session entity type already exists, overrides the session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.

UpdateSessionEntityType

rpc UpdateSessionEntityType (UpdateSessionEntityTypeRequest) returns (SessionEntityType)
Updates the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.

DeleteSessionEntityType

rpc DeleteSessionEntityType (DeleteSessionEntityTypeRequest) returns (.google.protobuf.Empty)
Deletes the specified session entity type. This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.

Methods with HTTP bindings

Method Name Method Pattern Body
ResponseRefinement POST /{session=projects/*/agent/sessions/*}:responseRefinement *
SlotFilling POST /{session=projects/*/agent/sessions/*}:slotFilling *
Ping GET /projects/*/agent/webhook:ping
Messages

CreateSessionEntityTypeRequest

The request message for Webhook.CreateSessionEntityType

FieldTypeLabelDescription
parent string

Required. The agent to list all intents from. Format:

projects/<project_uuid>/agent

session_entity_type SessionEntityType

Required. The session entity type to create.

session_id string

Required. The session to create a session entity type for. Format:

projects/<project_uuid>/agents/sessions/<session_uuid>
or
projects/<project_uuid>/agents/sessions/<session_uuid>
projects/<project_uuid>/agent/environments/<environment_uuid>/users/<user_uuid>/ sessions/<session_uuid>. If Environment ID is not specified, we assume default 'draft' environment. If User ID is not specified, we assume default '-' user. Required. The project that the agent to fetch is associated with. The session to create a session entity type for. Format:
projects/<project_uuid>/agents/sessions/<session_uuid>

DeleteSessionEntityTypeRequest

The request message for Webhook.DeleteSessionEntityType.

FieldTypeLabelDescription
name string

Required. The name of the entity type to delete. Format: projects/<project_uuid>/agent/sessions/<session_uuid>/entityTypes/<Entity Type Display Name> or projects/<project_uuid>/agent/environments/ <<environment_uuid>/users/<user_uuid>/sessions/<session_uuid>/entityTypes/<Entity Type Display Name>. If Environment ID is not specified, we assume default 'draft' environment. If User ID is not specified, we assume default '-' user.

GetSessionEntityTypeRequest

The request message for Webhook.GetSessionEntityType.

FieldTypeLabelDescription
name string

Required. The name of the session entity type. Format: projects/<project_uuid>/agent/sessions/<session_uuid>/entityTypes/<Entity Type Display Name> or projects/<project_uuid>/agent/environments/ <<environment_uuid>/users/<user_uuid>/sessions/<session_uuid>/entityTypes/<Entity Type Display Name>. If Environment ID is not specified, we assume default 'draft' environment. If User ID is not specified, we assume default '-' user.

ListSessionEntityTypesRequest

The request message for Webhook.ListSessionEntityTypes.

FieldTypeLabelDescription
parent string

Required. The session to list all session entity types from. Format: projects/<project_uuid>/agent/sessions/<session_uuid> or projects/<project_uuid>/agent/environments/<environment_uuid>/users/<user_uuid>/ sessions/<session_uuid>. If Environment ID is not specified, we assume default 'draft' environment. If User ID is not specified, we assume default '-' user.

page_size int32

Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.

page_token string

Optional: The page token to support pagination. Pagination allows you to retrieve a large result set in smaller, more manageable portions. The page token is a string representing the current index and page size. Valid page token strings:

  • "" (empty string) - Retrieves the first page.
  • "current_index-0--page_size-20" - Retrieves the first page with a page size of 20.
  • "current_index-1--page_size-20" - Retrieves the second page with a page size of 20.
Index starts at 0. Examples of valid page token strings:
  • ""
  • "current_index-0--page_size-20"
  • "current_index-1--page_size-20"
  • "current_index-10--page_size-20"
Examples of invalid page token strings:
  • "1"
  • "current_index-0--page_size-20"
  • "current_index--1--page_size-20"
  • "current_index1--page_size-20"
  • "current_index-1--page_size--20"

ListSessionEntityTypesResponse

The response message for Webhook.ListSessionEntityTypes.

FieldTypeLabelDescription
session_entity_types SessionEntityType repeated

The list of session entity types. There will be a maximum number of items returned based on the page_size field in the request.

next_page_token string

The next_page_token is used to retrieve the next page of a returned result, e.g. next_page_token is current_index-2

OriginalDetectIntentRequest

Represents the contents of the original request that was passed to the [Streaming]DetectIntent call.

FieldTypeLabelDescription
source string

The source of this request, e.g., google, facebook, slack or other "platforms". . Used to identify the "platform"

payload google.protobuf.Struct

Optional. This field is set to the value of the QueryParameters.payload field passed in the request. Some integrations that query an agent may provide additional data in the payload. In particular this can be of the form:

{
 "a": {
   "b": "c"
 }
}

PingRequest

request sent for webhook ping

FieldTypeLabelDescription
session string

session ID for webhook ping

PingResponse

This message is a response of pinging

FieldTypeLabelDescription
is_reachable bool

This is the response message of a Ping request. It's purpose is to report the reachability of a Webhook server.

SessionEntityType

A session represents a conversation between a Dialogflow agent and an end-user. You can create special entities, called session entities, during a session. Session entities can extend or replace custom entity types and only exist during the session that they were created for. All session data, including session entities, is stored by Dialogflow for 20 minutes.

For more information, see the session entity guide.

FieldTypeLabelDescription
name string

Required. The unique identifier of this session entity type. Format: projects/<project_uuid>/agent/sessions/<session_uuid>/entityTypes/<Entity Type Display Name>, or projects/<project_uuid>/agent/environments/ <<environment_uuid>/users/<user_uuid>/sessions/<session_uuid>/entityTypes/<Entity Type Display Name>. If Environment ID is not specified, we assume default 'draft' environment. If User ID is not specified, we assume default '-' user. <Entity Type Display Name> must be the display name of an existing entity type in the same agent that will be overridden or supplemented.

entity_override_mode SessionEntityType.EntityOverrideMode

Required. Indicates whether the additional data should override or supplement the custom entity type definition.

entities EntityType.Entity repeated

Required. The collection of entities associated with this session entity type.

UpdateSessionEntityTypeRequest

The request message for Webhook.UpdateSessionEntityType.

FieldTypeLabelDescription
session_entity_type SessionEntityType

Required. The session entity type to update.

update_mask google.protobuf.FieldMask

Optional. The mask to control which fields get updated.

WebhookRequest

The request message for a webhook call.

FieldTypeLabelDescription
response_id string

The unique identifier of the response. Contains the same value as [Streaming]DetectIntentResponse.response_id.

query_result QueryResult

The result of the conversational query or event processing. Contains the same value as [Streaming]DetectIntentResponse.query_result.

original_detect_intent_request OriginalDetectIntentRequest

Optional. The contents of the original request that was passed to [Streaming]DetectIntent call.

session string

The unique identifier of detectIntent request session. Can be used to identify end-user inside webhook implementation. Format:

projects/<project_uuid>/agent/sessions/<session_uuid>

headers google.protobuf.Struct

Optional. The headers of the request message

WebhookResponse

The response message for a webhook call.

FieldTypeLabelDescription
fulfillment_text string

Optional. The text to be shown on the screen. This value is passed directly to QueryResult.fulfillment_text.

fulfillment_messages Intent.Message repeated

Optional. The collection of rich messages to present to the user. This value is passed directly to QueryResult.fulfillment_messages.

source string

Optional. This value is passed directly to QueryResult.webhook_source.

payload google.protobuf.Struct

Optional. This value is passed directly to QueryResult.webhook_payload. See the related fulfillment_messages[i].payload field, which may be used as an alternative to this field. This field can be used for Actions on Google responses. It should have a structure similar to the JSON message shown here. For more information, see Actions on Google Webhook Format

{
  "google": {
    "expectUserResponse": true,
    "richResponse": {
      "items": [
        {
          "simpleResponse": {
            "textToSpeech": "this is a simple response"
          }
        }
      ]
    }
  }
}

output_contexts Context repeated

Optional. The collection of output contexts. This value is passed directly to QueryResult.output_contexts.

followup_event_input EventInput

Optional. Makes the platform immediately invoke another DetectIntent call internally with the specified event as input.

session_entity_types SessionEntityType repeated

Optional. Additional session entity types to replace or extend developer entity types with. The entity synonyms apply to all languages and persist for the session. Setting this data from a webhook overwrites the session entity types that have been set using detectIntent method.

Enums

SessionEntityType.EntityOverrideMode

The types of modifications for a session entity type.

NameNumberDescription
ENTITY_OVERRIDE_MODE_UNSPECIFIED 0

Not specified. This value should be never used.

ENTITY_OVERRIDE_MODE_OVERRIDE 1

The collection of session entities overrides the collection of entities in the corresponding custom entity type.

ENTITY_OVERRIDE_MODE_SUPPLEMENT 2

The collection of session entities extends the collection of entities in the corresponding custom entity type. Note: Even in this override mode calls to ListSessionEntityTypes, GetSessionEntityType, CreateSessionEntityType and UpdateSessionEntityType only return the additional entities added in this session entity type. If you want to get the supplemented list, please call EntityTypes.GetEntityType on the custom entity type and merge.

ondewo/qa/qa.proto

Top

Services

QA

gRPC service for QA functionalities.

Service Methods

GetAnswer

rpc GetAnswer (GetAnswerRequest) returns (GetAnswerResponse)
Retrieves an answer based on the provided request.

RunScraper

rpc RunScraper (RunScraperRequest) returns (RunScraperResponse)
Runs a web scraper job for specified project IDs.

UpdateDatabase

rpc UpdateDatabase (UpdateDatabaseRequest) returns (UpdateDatabaseResponse)
Updates the database for specified project IDs.

RunTraining

rpc RunTraining (.google.protobuf.Empty) returns (RunTrainingResponse)
Runs a training job for the QA system.

GetServerState

rpc GetServerState (.google.protobuf.Empty) returns (GetServerStateResponse)
Retrieves the server state for QA.

ListProjectIds

rpc ListProjectIds (.google.protobuf.Empty) returns (ListProjectIdsResponse)
Lists project IDs associated with QA.

GetProjectConfig

rpc GetProjectConfig (GetProjectConfigRequest) returns (GetProjectConfigResponse)
Retrieves the configuration of a specific project.

Methods with HTTP bindings

Method Name Method Pattern Body
GetAnswer POST /qa *
RunScraper GET /qa:RunScraper
UpdateDatabase GET /qa:UpdateDatabase
RunTraining GET /qa:RunTraining
GetServerState GET /qa:GetServerState
ListProjectIds GET /qa:ListProjectIds
GetProjectConfig GET /qa:ListProjectConfig
Messages

GetAnswerRequest

The request message

FieldTypeLabelDescription
session_id string

Required. The name of the session this query is sent to. Format: projects/<Project ID>/agent/sessions/<Session ID>. It's up to the API caller to choose an appropriate session ID. It can be a random number or some type of user identifier (preferably hashed). The length of the session ID must not exceed 36 bytes.

text ondewo.nlu.TextInput

Required. The context of the request. A message containing a string (in the form of a sentence) and a language code.

max_num_answers int32

Maximal number of answers returned

threshold_reader float

Threshold (minimal score) to give back reader result

threshold_retriever float

Threshold (minimal score) to give back retriever result

threshold_overall float

Threshold (minimal score) overall probability

reader_model_name string

Reader model name

url_filter UrlFilter

Optional. Filters applied to the urls, to restrict the retrieved documents.

GetAnswerResponse

Message containing the response for retrieving answers.

FieldTypeLabelDescription
query_result ondewo.nlu.DetectIntentResponse

The results of the conversational query or event processing.

GetProjectConfigRequest

Message for requesting the configuration of a specific project.

FieldTypeLabelDescription
project_id string

The ID of the project for which to retrieve the configuration.

GetProjectConfigResponse

Message containing the response for getting the configuration of a project.

FieldTypeLabelDescription
config_serialized string

Serialized configuration of the project.

GetServerStateResponse

Message containing the response for checking the server state.

FieldTypeLabelDescription
server_is_ready bool

Indicates whether the server is ready to accept requests.

ListProjectIdsResponse

Message for listing project IDs in the response.

FieldTypeLabelDescription
project_ids string repeated

List of project IDs.

RunScraperRequest

Message for running a web scraper job.

FieldTypeLabelDescription
project_ids string repeated

List of project IDs to run the scraper on.

RunScraperResponse

Message containing the response for running a web scraper job.

FieldTypeLabelDescription
scraper_containers RunScraperResponse.ScraperContainer repeated

List of scraper containers running the jobs.

RunScraperResponse.ScraperContainer

Message representing a scraper container.

FieldTypeLabelDescription
container_name string

Name of the Docker container running the job.

container_id string

ID of the Docker container running the scraping job.

RunTrainingResponse

Message containing the response for running a training job.

FieldTypeLabelDescription
f1 float

F1 score as a response of the training.

accuracy float

Accuracy as a response of the training.

UpdateDatabaseRequest

Message for requesting a database update for specific projects.

FieldTypeLabelDescription
project_ids string repeated

List of project IDs for which to update the database.

UpdateDatabaseResponse

Message containing the response for updating the database of specific projects.

FieldTypeLabelDescription
error_messages string repeated

List of error messages encountered during the database update.

UrlFilter

Message for defining URL filters to include and exclude from the scraping process.

FieldTypeLabelDescription
allowed_values string repeated

Optional. List of allowed values for the metadata field 'url'.

regex_filter_include string

Optional. Regular expression that must be matched by the metadata.

regex_filter_exclude string

Optional. Regular expression that must not be matched by the metadata.

Scalar Value Types

.proto TypeNotesC++JavaPythonGoC#PHPRuby
double double double float float64 double float Float
float float float float float32 float float Float
int32 Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. int32 int int int32 int integer Bignum or Fixnum (as required)
int64 Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. int64 long int/long int64 long integer/string Bignum
uint32 Uses variable-length encoding. uint32 int int/long uint32 uint integer Bignum or Fixnum (as required)
uint64 Uses variable-length encoding. uint64 long int/long uint64 ulong integer/string Bignum or Fixnum (as required)
sint32 Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. int32 int int int32 int integer Bignum or Fixnum (as required)
sint64 Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. int64 long int/long int64 long integer/string Bignum
fixed32 Always four bytes. More efficient than uint32 if values are often greater than 2^28. uint32 int int uint32 uint integer Bignum or Fixnum (as required)
fixed64 Always eight bytes. More efficient than uint64 if values are often greater than 2^56. uint64 long int/long uint64 ulong integer/string Bignum
sfixed32 Always four bytes. int32 int int int32 int integer Bignum or Fixnum (as required)
sfixed64 Always eight bytes. int64 long int/long int64 long integer/string Bignum
bool bool boolean boolean bool bool boolean TrueClass/FalseClass
string A string must always contain UTF-8 encoded or 7-bit ASCII text. string String str/unicode string string string String (UTF-8)
bytes May contain any arbitrary sequence of bytes. string ByteString str []byte ByteString string String (ASCII-8BIT)