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.
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.
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"
}
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"
}
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"
}
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
{}
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{}
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" }
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" }
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" }
rpc AddUserToProject (AddUserToProjectRequest) returns (.google.protobuf.Empty)Adds a user with specified id to the project (agent)
rpc RemoveUserFromProject (RemoveUserFromProjectRequest) returns (.google.protobuf.Empty)Removes a user with specified id from the project (agent)
rpc ListUsersInProject (ListUsersInProjectRequest) returns (ListUsersInProjectResponse)Lists users in the project (agent)
rpc GetPlatformInfo (.google.protobuf.Empty) returns (GetPlatformInfoResponse)Gets information from the platform
rpc ListProjectPermissions (ListProjectPermissionsRequest) returns (ListProjectPermissionsResponse)List permissions from the project (agent)
rpc TrainAgent (TrainAgentRequest) returns (Operation)Trains the specified agent. Operation <response: google.protobuf.Empty, metadata: google.protobuf.Struct>
rpc BuildCache (BuildCacheRequest) returns (Operation)Builds cache for the specified agent. Operation <response: google.protobuf.Empty, metadata: google.protobuf.Struct>
rpc ExportAgent (ExportAgentRequest) returns (Operation)Exports the specified agent to a ZIP file.
rpc ExportBenchmarkAgent (ExportBenchmarkAgentRequest) returns (Operation)Exports the specified train agent to a ZIP file after train-test split, returns the test TrainingPhrase list.
rpc ImportAgent (ImportAgentRequest) returns (Operation)Imports the specified agent from a ZIP file.
rpc MigrateAgent (MigrateAgentRequest) returns (Operation)
rpc OptimizeRankingMatch (OptimizeRankingMatchRequest) returns (Operation)
rpc RestoreAgent (RestoreAgentRequest) returns (Operation)Restores the specified agent from a ZIP file.
rpc GetAgentStatistics (GetAgentStatisticsRequest) returns (GetAgentStatisticsResponse)Gets statistics for the agent
rpc GetSessionsStatistics (GetSessionsStatisticsRequest) returns (GetSessionsStatisticsResponse)
rpc SetAgentStatus (SetAgentStatusRequest) returns (Agent)Sets status for the agent
rpc SetResources (SetResourcesRequest) returns (.google.protobuf.Empty)Sets resources
rpc DeleteResources (DeleteResourcesRequest) returns (.google.protobuf.Empty)Deletes resources
rpc ExportResources (ExportResourcesRequest) returns (ExportResourcesResponse)Exports resources
rpc GetModelStatuses (GetModelStatusesRequest) returns (GetModelStatusesResponse)Get statuses of models related to project
rpc GetPlatformMapping (GetPlatformMappingRequest) returns (PlatformMapping)Get all set platform name mappings for an Agent
rpc SetPlatformMapping (PlatformMapping) returns (PlatformMapping)Set platform name mappings for an Agent
rpc GetFullTextSearchEntityType (FullTextSearchRequest) returns (FullTextSearchResponseEntityType)Full text search endpoint in entity types
rpc GetFullTextSearchEntity (FullTextSearchRequest) returns (FullTextSearchResponseEntity)Full text search endpoint in entities
rpc GetFullTextSearchEntitySynonym (FullTextSearchRequest) returns (FullTextSearchResponseEntitySynonym)Full text search endpoint in entity synonyms
rpc GetFullTextSearchIntent (FullTextSearchRequest) returns (FullTextSearchResponseIntent)Full text search endpoint in intents
rpc GetFullTextSearchIntentContextIn (FullTextSearchRequest) returns (FullTextSearchResponseIntentContextIn)Full text search endpoint in context ins of intents
rpc GetFullTextSearchIntentContextOut (FullTextSearchRequest) returns (FullTextSearchResponseIntentContextOut)Full text search endpoint in context outs of intents
rpc GetFullTextSearchIntentUsersays (FullTextSearchRequest) returns (FullTextSearchResponseIntentUsersays)Full text search endpoint in user says of intents
rpc GetFullTextSearchIntentTags (FullTextSearchRequest) returns (FullTextSearchResponseIntentTags)Full text search endpoint in tags of intents
rpc GetFullTextSearchIntentResponse (FullTextSearchRequest) returns (FullTextSearchResponseIntentResponse)Full text search endpoint in responses of intents
rpc GetFullTextSearchIntentParameters (FullTextSearchRequest) returns (FullTextSearchResponseIntentParameters)Full text search endpoint in parameters of intents
rpc ReindexAgent (ReindexAgentRequest) returns (Operation)Force reindexing Intent and Entity data of Agent
| 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 | * |
Request to add user to project.
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to train is associated with. Format: |
|
| user_id | string | id of the user |
|
| project_role_id | uint32 | ID of the project role of the user |
Project/Agent messages
| Field | Type | Label | Description |
| parent | string | Required. The project of this agent. Format:
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 |
|
| supported_language_codes | string | repeated | Optional. The list of all languages supported by this agent (except for the
|
| 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. |
This message contains the agent of user with owner
| Field | Type | Label | Description |
| 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) |
Sorting order of agent
| Field | Type | Label | Description |
| sorting_field | AgentSorting.AgentSortingField | sorting field for agent sorting |
|
| sorting_mode | SortingMode | Sorting mode |
This message contains the agent with owner
| Field | Type | Label | Description |
| agent | Agent | The agent |
|
| owner | User | User who created the agent |
The request message for Agents.TrainAgentBuildCache.
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to build cache is associated with. Format: |
|
| branch | string | Name of the branch of the agent for versioning. The default branch name is |
Request to create an agent
| Field | Type | Label | Description |
| agent | Agent | The agent |
|
| agent_view | AgentView | Optional. Specify the view of the returned agent (sparse view by default) |
This message contains the information of custom platform
| Field | Type | Label | Description |
| 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. |
Request to delete the agent
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
Request to delete resources
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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. |
The request message for Agents.ExportAgent.
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to export is associated with. Format: |
|
| 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. |
The response message for Agents.ExportAgent.
| Field | Type | Label | Description |
| agent_uri | string | The URI to a file containing the exported agent. This field is populated
only if |
|
| agent_content | bytes | The exported agent.
Example for how to export an agent to a zip file via a command line:
|
Request to export benchmark agent
| Field | Type | Label | Description |
| parent | string | Agent related info Required. The project that the agent to export is associated with. Format: |
|
| 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 |
Response to export benchmark agent
| Field | Type | Label | Description |
| agent_content | bytes | Agent responses as zip file |
|
| training_phrases | ExportBenchmarkAgentResponse.TrainingPhrasesEntry | repeated | Key is the language code, value is the corresponding ListTrainingPhrasesResponse |
| Field | Type | Label | Description |
| key | string |
|
|
| value | ListTrainingPhrasesResponse |
|
Request to export resources
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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. |
Response to export resources
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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. |
This message is a request to run full text search
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent is associated with. Format: |
|
| 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:
|
This message is a response of full text search of entity
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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 |
Search result for an entity
| Field | Type | Label | Description |
| 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. |
This message is a response of full text search of synonym entity
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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 |
Search result for an entity synonym
| Field | Type | Label | Description |
| 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. |
This message is a response of full text search of entity type
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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 |
Search result for an entity type
| Field | Type | Label | Description |
| 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. |
This message is a response of full text search of intent
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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 |
Search result for an intent
| Field | Type | Label | Description |
| 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. |
This message is a response of full text search of intent with context in
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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 |
Search result for an intent input context
| Field | Type | Label | Description |
| 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. |
This message is a response of full text search of intent with context out
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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 |
Search result for an intent output context
| Field | Type | Label | Description |
| 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. |
This message is a response of full text search of intent with parameters
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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 |
Search result for an intent parameter
| Field | Type | Label | Description |
| 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. |
This message is a response of full text search of intent response
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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:
|
Search result for an intent response
| Field | Type | Label | Description |
| 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. |
This message is a response of full text search of intent with tags
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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 |
Search result for an intent tag
| Field | Type | Label | Description |
| 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. |
This message is a response of full text search of intent with sentence
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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 |
Search result for an intent training phrase (user says)
| Field | Type | Label | Description |
| 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. |
The request message for Agents.GetAgent.
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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. |
Request statistics of the agent
| Field | Type | Label | Description |
| parent | string | Required. The project to get statistics from. Format: |
|
| 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 |
Response to get statistics of the agent
| Field | Type | Label | Description |
| reports | bytes | Statistic info. |
|
| format | ReportFormat | File formats for reports |
|
| type | ReportType | Type of reports about the domain of the agent |
Request to get model statuses
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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. |
Response to get model statuses
| Field | Type | Label | Description |
| model_statuses | ModelStatus | repeated | List of model statuses matching the request filters. |
GIT information about the version of the server
| Field | Type | Label | Description |
| version | string | version of the server build |
|
| commit_hash | string | git commit hash of the server build |
Request to get platform mapping
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent is associated with. Format: |
Request of the report of the statistics about sessions
| Field | Type | Label | Description |
| parent | string | Required. The project to get statistics from. Format: |
|
| 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.
|
|
| sql_query | string | SQL Query - only usable with specific SessionsReportType such as SessionsReportType.SESSION_SQL_QUERY |
Report of the statistics about sessions
| Field | Type | Label | Description |
| reports | bytes | Statistic info. |
|
| format | ReportFormat | File formats for reports |
|
| type | SessionsReportType | Type of reports about the domain of the agent |
The request message for Agents.ImportAgent.
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to import is associated with. Format: |
|
| 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.
|
Get list of agents of user
| Field | Type | Label | Description |
| 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 |
Request to get the list of agents
| Field | Type | Label | Description |
| 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. |
Get list of agents
| Field | Type | Label | Description |
| 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 |
Project permissions
| Field | Type | Label | Description |
| 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:
|
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
List project permissions
| Field | Type | Label | Description |
| 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 |
Request to list users in the project
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to train is associated with. Format: |
|
| 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:
|
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned.
|
List the users in a project
| Field | Type | Label | Description |
| 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 |
Request to migrate an agent
| Field | Type | Label | Description |
| agent_content | bytes | The agent to migrate as zip file |
Status of model
| Field | Type | Label | Description |
| 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. |
This message is a request to run Optimize Ranking Match
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to train is associated with. Format: |
|
| 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 |
This message is a response of Optimize Ranking Match
| Field | Type | Label | Description |
| 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
|
This message contains the mapping of platform
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent is associated with. Format: |
|
| platform_info | CustomPlatformInfo | repeated | Required. If not set, it will set it empty. |
This message contains the configuration to run Optimize Ranking Match
| Field | Type | Label | Description |
| 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
|
This message is a request to reindex agent
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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 |
Request to remove user from the project.
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to train is associated with. Format: |
|
| user_id | string | id of the user |
The request message for Agents.RestoreAgent.
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to restore is associated with. Format: |
|
| 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.
|
Request to set status of the agent
| Field | Type | Label | Description |
| parent | string | Required. The project of which to set the status. Format: |
|
| status | AgentStatus | Required. Status of the agent |
|
| agent_view | AgentView | Optional. View of the returned agent |
Request to set resources
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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. |
The request message for Agents.TrainAgent.
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to train is associated with. Format: |
|
| branch | string | Name of the branch of the agent for versioning. The default branch name is |
|
| initiation_protocol | InitiationProtocol | Defines when to initiate newly created agent when training started |
Request to update the agent
| Field | Type | Label | Description |
| 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. |
Request to get user in project
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to train is associated with. Format: |
|
| user | User | User object |
|
| role_id | uint32 | ID of the project role of the user |
Sorting field
| Name | Number | Description |
| 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 |
Type of Agent / Project status
| Name | Number | Description |
| ACTIVE | 0 | If project is active, all its endpoints are active |
| INACTIVE | 1 | If project is inactive:
|
Structure of agent view
| Name | Number | Description |
| AGENT_VIEW_UNSPECIFIED | 0 | Unspecified agent view: the view is defined by the call:
|
| 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 |
Type of query
| Name | Number | Description |
| 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 |
Defines when to initiate newly created agent when training started
| Name | Number | Description |
| 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 |
Status name of the model.
| Name | Number | Description |
| 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 |
File formats for reports
| Name | Number | Description |
| CSV | 0 | CSV (comma separated values) file format |
| HTML | 1 | HTML file format |
| JSON | 2 | JSON file format |
Type of reports about the domain of the agent
| Name | Number | Description |
| 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 |
Type of reports about the domain of the agent
| Name | Number | Description |
| 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
|
| 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. |
The Central class defining the ondewo ai services
rpc ExtractEntities (ExtractEntitiesRequest) returns (ExtractEntitiesResponse)Processes a natural language query and returns detected entities
rpc GenerateUserSays (GenerateUserSaysRequest) returns (GenerateUserSaysResponse)Generates a list of training phrases
rpc GenerateResponses (GenerateResponsesRequest) returns (GenerateResponsesResponse)Generate responses from all intents using synonyms
rpc GetAlternativeSentences (GetAlternativeSentencesRequest) returns (GetAlternativeSentencesResponse)Generates alternative phrase based on original phrase
rpc GetAlternativeTrainingPhrases (GetAlternativeTrainingPhrasesRequest) returns (GetAlternativeTrainingPhrasesResponse)Generates alternative training phrase based on original training phrase
rpc GetSynonyms (GetSynonymsRequest) returns (GetSynonymsResponse)Generates synonyms for a certain word
rpc ClassifyIntents (ClassifyIntentsRequest) returns (ClassifyIntentsResponse)Preprocess text and detects intents in a sentence
rpc ExtractEntitiesFuzzy (ExtractEntitiesFuzzyRequest) returns (ExtractEntitiesResponse)Processes a natural language query and returns detected entities
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.
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.
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.
| 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 | * |
This message contains an alternative sentence
| Field | Type | Label | Description |
| sentence | string | Alternative sentence |
|
| score | float | Score associated to the alternative sentence resulted |
This message contains an alternative training phrase
| Field | Type | Label | Description |
| training_phrase | Intent.TrainingPhrase | Alternative training phrase |
|
| score | float | Score associated to training_phrase |
Configuration for BERT augmenter enrichment
| Field | Type | Label | Description |
| is_active | bool | Activation flag |
|
| enrichment_factor | int32 | Factor of enrichment |
|
| execution_order | int32 | Order of augmenter execution |
The request for intent classification.
| Field | Type | Label | Description |
| parent | string | Required. The project of this agent. Format: |
|
| 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 | 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:
|
|
| algorithms | IntentAlgorithms | repeated | Optional: Algorithm list |
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
Response containing the intents classified in a sentence
| Field | Type | Label | Description |
| 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 |
This message contains the configuration of data enrichment
| Field | Type | Label | Description |
| 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 |
This message contains the entity detected
| Field | Type | Label | Description |
| 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 |
Configuration for Entity enrichment
| Field | Type | Label | Description |
| is_active | bool | Activation flag |
|
| enrichment_factor | int32 | Factor of enrichment |
|
| execution_order | int32 | Order of augmenter execution |
Configuration for Fuzzy Entity Recognizer
| Field | Type | Label | Description |
| 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 |
This message is a request to extract entities with Fuzzy Entity Recognizer
| Field | Type | Label | Description |
| parent | string | the parent of the request Format: |
|
| 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. |
The request to detect parameters.
| Field | Type | Label | Description |
| parent | string | the parent of the request Format: |
|
| 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: |
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
This message is a response of extracting entities
| Field | Type | Label | Description |
| entities_detected | EntityDetected | repeated | A list of entities detected |
| text | string | The text containing the entities detected |
Configuration for GPT2 enrichment
| Field | Type | Label | Description |
| is_active | bool | Activation flag |
|
| enrichment_factor | int32 | Factor of enrichment |
|
| execution_order | int32 | Order of augmenter execution |
Request to generate responses
| Field | Type | Label | Description |
| 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: |
|
| 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. |
Response containing responses
| Field | Type | Label | Description |
| responses | string | repeated | A list of responses |
Request to generate user sentences
| Field | Type | Label | Description |
| 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: |
|
| 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. |
Response containing user sentences
| Field | Type | Label | Description |
| user_says | string | repeated | A list of sampled sentences |
Request to get alternative sentences
| Field | Type | Label | Description |
| 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: |
|
| 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. |
Response containing alternative sentences
| Field | Type | Label | Description |
| alternative_sentences | AltSentence | repeated | A list of alternative sentences |
Request to get alternative training phrases
| Field | Type | Label | Description |
| 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: |
|
| 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. |
Response containing alternative training phrases
| Field | Type | Label | Description |
| alternative_training_phrases | AltTrainingPhrase | repeated | A list of alternative training phrases |
Request to get synonyms
| Field | Type | Label | Description |
| 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: |
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
Response containing synonyms
| Field | Type | Label | Description |
| synonyms | Synonym | repeated | A list of synonyms |
Configuration for GloVe enrichment
| Field | Type | Label | Description |
| is_active | bool | Activation flag |
|
| enrichment_factor | int32 | Factor of enrichment |
|
| execution_order | int32 | Order of augmenter execution |
Intent classified by a certain intent classifier
| Field | Type | Label | Description |
| intent_name | string | The unique identifier of this intent. Format: |
|
| 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 |
The request message to list available LLM models for a specified CCAI service.
| Field | Type | Label | Description |
| ccai_service_name | string | The CCAI service for which to list models. Format: |
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
The response message containing a list of available LLM models.
| Field | Type | Label | Description |
| llm_models | LlmModel | repeated | A list of LLM models associated with the specified CCAI service.
|
Configuration for large language model (LLM) enrichment
| Field | Type | Label | Description |
| 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: |
The request message to generate a response from a Large Language Model (LLM).
| Field | Type | Label | Description |
| llm_generation_request | google.protobuf.Struct | The request payload for the LLM, structured according to the specific
requirements of the large language model provider.
|
|
| 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: |
|
| 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. |
The response message containing the generated output from a Large Language Model (LLM).
| Field | Type | Label | Description |
| llm_generation_response | google.protobuf.Struct | The response data from the LLM, returned as a structured payload.
|
|
| file_resources | FileResource | repeated | Files as input for the generation request, e.g., generated pictures, audio or video |
Represents an individual LLM model available within a CCAI service.
| Field | Type | Label | Description |
| name | string | The resource name of the model. Format:
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 and |
|
| 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. |
The response message for streaming generation from a Large Language Model (LLM).
| Field | Type | Label | Description |
| llm_generation_stream_response | google.protobuf.Struct | The response data from the LLM in a streaming format, returned as a structured payload.
|
This message contains a Synonym
| Field | Type | Label | Description |
| synonym | string | Synonym word |
|
| score | int32 | Score associated to the synonym resulted |
Configuration for Thesaurus enrichment
| Field | Type | Label | Description |
| is_active | bool | Activation flag |
|
| enrichment_factor | int32 | Factor of enrichment |
|
| execution_order | int32 | Order of augmenter execution |
Configuration for Word2Vec enrichment
| Field | Type | Label | Description |
| is_active | bool | Activation flag |
|
| enrichment_factor | int32 | Factor of enrichment |
|
| execution_order | int32 | Order of augmenter execution |
Configuration for WordNet augmenter enrichment
| Field | Type | Label | Description |
| is_active | bool | Activation flag |
|
| enrichment_factor | int32 | Factor of enrichment |
|
| execution_order | int32 | Order of augmenter execution |
Configuration for XLNet enrichment
| Field | Type | Label | Description |
| is_active | bool | Activation flag |
|
| enrichment_factor | int32 | Factor of enrichment |
|
| execution_order | int32 | Order of augmenter execution |
Enum of fuzzy ner algorithms
| Name | Number | Description |
| PREFILTER_LEVENSHTEIN | 0 | Levenshtein algorithm for fuzzy ner matching |
| LOCAL_MAXIMUM | 1 | local maximum |
Type of Intent algorithm.
| Name | Number | Description |
| 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 |
Type of mode
| Name | Number | Description |
| UNSPECIFIED | 0 | default mode, described in agent config |
| EXCLUSIVE | 1 | skip algorithms listed in |
| INCLUSIVE | 2 | run ONLY algorithms listed in |
Service to manage Call Center AI (CCAI service) Projects.
rpc GetCcaiProject (GetCcaiProjectRequest) returns (CcaiProject)Retrieves information about a specific CCAI service project.
rpc CreateCcaiProject (CreateCcaiProjectRequest) returns (CreateCcaiProjectResponse)Creates a new CCAI service project based on the provided request.
rpc DeleteCcaiProject (DeleteCcaiProjectRequest) returns (DeleteCcaiProjectResponse)Deletes a CCAI service project identified by the provided request.
rpc ListCcaiProjects (ListCcaiProjectsRequest) returns (ListCcaiProjectsResponse)Lists all CCAI service projects based on the provided request.
rpc UpdateCcaiProject (UpdateCcaiProjectRequest) returns (UpdateCcaiProjectResponse)Updates the information of an existing CCAI service project.
rpc GetCcaiService (GetCcaiServiceRequest) returns (CcaiService)Retrieves information about a specific CCAI service.
Message representing a CCAI service project
| Field | Type | Label | Description |
| 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: |
| Field | Type | Label | Description |
| key | string |
|
|
| value | CcaiServiceList |
|
This protobuf message defines the sorting order for CCAI service (Virtual Test System Infrastructure) projects.
| Field | Type | Label | Description |
| sorting_field | CcaiProjectSorting.CcaiProjectSortingField | optional | sorting field for ccai projects sorting |
| sorting_mode | SortingMode | optional | Sorting mode |
Definition of a Call Center AI (CCAI service) Service.
| Field | Type | Label | Description |
| 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:
|
Filter which services should be included in the returned CcaiProject
| Field | Type | Label | Description |
| 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 |
Message representing a list of CCAI service services
| Field | Type | Label | Description |
| ccai_services | CcaiService | repeated | CCAI service services |
Request to create a Call Center AI (CCAI service) project.
| Field | Type | Label | Description |
| ccai_project | CcaiProject | The CCAI service project to be created. |
|
| nlu_project_name | string | Required. The nlu agent project of this CcaiProject. Format: |
Response after attempting to create a Call Center AI (CCAI service) project.
| Field | Type | Label | Description |
| ccai_project | CcaiProject | The created CCAI service project. |
|
| error_message | string | Error message if the creation is unsuccessful. |
Request to delete a CCAI service project
If a deployed CCAI service project was deleted then it was undeployed beforehand automatically
| Field | Type | Label | Description |
| name | string | CCAI service project name with which to perform the call of the form |
|
| nlu_project_name | string | Required. The nlu agent project of this CcaiProject. Format: |
Response to delete a CCAI service project
If a deployed CCAI service project was deleted then it was undeployed beforehand automatically
| Field | Type | Label | Description |
| name | string | CCAI service project name with which to perform the call of the form |
|
| error_message | string | error message if there are any. |
|
| nlu_project_name | string | Required. The nlu agent project of this CcaiProject. Format: |
Request to retrieve a CCAI service project
| Field | Type | Label | Description |
| name | string | CCAI service project name with which to perform the call of the form |
|
| 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: |
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
Request to retrieve a CCAI service project
| Field | Type | Label | Description |
| name | string | CCAI service project name with which to perform the call of the form |
|
| nlu_project_name | string | Required. The nlu agent project of this CcaiProject. Format: |
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
Request to get the list of agents
| Field | Type | Label | Description |
| 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:
|
| nlu_project_name | string | Required. The nlu agent project of this CcaiProject. Format: |
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
This is a protobuf message definition for the response of getting a list of CCAI service projects.
| Field | Type | Label | Description |
| 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 |
Request to updated CCAI service project
| Field | Type | Label | Description |
| 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: |
Request to updated CCAI service project
| Field | Type | Label | Description |
| name | string | CCAI service project name with which to perform the call of the form |
|
| error_message | string | error message if there are any. |
Enum to specify the sorting field for CCAI service projects.
| Name | Number | Description |
| NO_CCAI_PROJECT_SORTING | 0 | No sorting |
| SORT_CCAI_PROJECT_BY_NAME | 1 | Sort by project name such as |
| 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 |
Status of a Call Center AI (CCAI service) Project.
| Name | Number | Description |
| 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 defines what the CcaiProject message contains
| Name | Number | Description |
| 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 |
| Name | Number | Description |
| 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 |
| Name | Number | Description |
| 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 |
Message for adding notifications in a batch.
| Field | Type | Label | Description |
| notifications | Notification | repeated | List of notifications to be added. |
Message containing the response to adding notifications.
| Field | Type | Label | Description |
| notifications | Notification | repeated | List of notifications that have been added. |
Comment message
| Field | Type | Label | Description |
| name | string | resource name of the comment |
|
| text | string | text of the comment |
|
| user_id | string | User id as resource name. Format: |
|
| comment_about_name | string | name of the resource for which the comment is about. Format: |
|
| parent_comment_name | string | The resource name of the parent comment. A parent comment is a reply to a certain comment. Format: |
|
| 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. |
Key-Value pair message, where the value can be one of various types (int, float, double, string, etc.).
| Field | Type | Label | Description |
| 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). |
Message for listing notifications based on certain criteria.
| Field | Type | Label | Description |
| 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:
|
|
| field_mask | google.protobuf.FieldMask | Optional. Mask to control which fields will be filled with data.
|
Message containing the response to a list request for notifications.
| Field | Type | Label | Description |
| notifications | Notification | repeated | List of notifications that meet the specified criteria. |
Notification message
| Field | Type | Label | Description |
| name | string | resource name of the notification |
|
| user_name | string | User id as resource name. Format: |
|
| title | string | User id as resource name. Format: |
|
| 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. |
Message for filtering notifications based on various criteria.
| Field | Type | Label | Description |
| 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. |
Message for setting the flagged status of notifications.
| Field | Type | Label | Description |
| notification_names | string | repeated | Names of notifications to set the flagged status for. |
| flagged | bool | repeated | Flagged status to set for the specified notifications. |
Message for setting the read status of notifications.
| Field | Type | Label | Description |
| notification_names | string | repeated | Names of notifications to set the read status for. |
| flagged | bool | repeated | Read status to set for the specified notifications. |
statistic response
| Field | Type | Label | Description |
| value | uint32 | Response wrapper for the "Get<Stat>" endpoints |
Enumerates the possible flagged statuses for a notification.
| Name | Number | Description |
| NOTIFICATION_FLAGGED_STATUS_UNSPECIFIED | 0 | Unspecified flagged status |
| NOTIFICATION_FLAGGED_STATUS_FLAGGED | 1 | Notification is flagged |
| NOTIFICATION_FLAGGED_STATUS_UNFLAGGED | 2 | Notification is unflagged |
Enumerates the possible origins for a notification.
| Name | Number | Description |
| 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 |
Enumerates the possible read statuses for a notification.
| Name | Number | Description |
| 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 |
Enumerates the possible types for a notification.
| Name | Number | Description |
| 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 |
Enum for notification type
| Name | Number | Description |
| 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 |
Sorting mode
| Name | Number | Description |
| ASCENDING | 0 | ascending sorting |
| DESCENDING | 1 | descending sorting |
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.
rpc ListContexts (ListContextsRequest) returns (ListContextsResponse)Returns the list of all contexts in the specified session.
rpc GetContext (GetContextRequest) returns (Context)Retrieves the specified context.
rpc CreateContext (CreateContextRequest) returns (Context)Creates a context.
rpc UpdateContext (UpdateContextRequest) returns (Context)Updates the specified context.
rpc DeleteContext (DeleteContextRequest) returns (.google.protobuf.Empty)Deletes the specified context.
rpc DeleteAllContexts (DeleteAllContextsRequest) returns (.google.protobuf.Empty)Deletes all active contexts in the specified session.
| 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 |
Represents a context.
| Field | Type | Label | Description |
| name | string | Required. The display name of the context (must be unique per session).
Note: we are deviating from the dialogflow format
|
|
| lifespan_count | int32 | Optional. The number of conversational query requests after which the
context expires. If set to |
|
| 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. |
Represents a parameter associated with a context
| Field | Type | Label | Description |
| 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. |
| Field | Type | Label | Description |
| key | string |
|
|
| value | Context.Parameter |
|
The request message for Contexts.CreateContext.
| Field | Type | Label | Description |
| session_id | string | Required. The session to create a context for. Format: |
|
| context | Context | Required. The context to create. |
The request message for Contexts.DeleteAllContexts.
| Field | Type | Label | Description |
| session_id | string | Required. The name of the session to delete all contexts from. Format: |
The request message for Contexts.DeleteContext.
| Field | Type | Label | Description |
| name | string | Required. The name of the context to delete. Format:
|
The request message for Contexts.GetContext.
| Field | Type | Label | Description |
| name | string | Required. The name of the context. Format:
|
The request message for Contexts.ListContexts.
| Field | Type | Label | Description |
| session_id | string | Required. The session to list all contexts from. Format: |
|
| 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:
|
The response message for Contexts.ListContexts.
| Field | Type | Label | Description |
| 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 |
The request message for Contexts.UpdateContext.
| Field | Type | Label | Description |
| context | Context | Required. The context to update. |
|
| update_mask | google.protobuf.FieldMask | Optional. The mask to control which fields get updated. |
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:
EntityType type.pizza.sauce entity for red or white pizza sauce, a pizza.cheese entity for the different types of cheese on a pizza, a pizza.topping entity for different toppings, and so on. A developer entity is represented by the EntityType type.For more information about entity types, see the Dialogflow documentation.
rpc ListEntityTypes (ListEntityTypesRequest) returns (ListEntityTypesResponse)Returns the list of all entity types in the specified agent.
rpc GetEntityType (GetEntityTypeRequest) returns (EntityType)Retrieves the specified entity type.
rpc CreateEntityType (CreateEntityTypeRequest) returns (EntityType)Creates an entity type in the specified agent.
rpc UpdateEntityType (UpdateEntityTypeRequest) returns (EntityType)Updates the specified entity type.
rpc DeleteEntityType (DeleteEntityTypeRequest) returns (.google.protobuf.Empty)Deletes the specified entity type.
rpc BatchUpdateEntityTypes (BatchUpdateEntityTypesRequest) returns (Operation)Updates/Creates multiple entity types in the specified agent. Operation <response: BatchUpdateEntityTypesResponse, metadata: google.protobuf.Struct>
rpc BatchDeleteEntityTypes (BatchDeleteEntityTypesRequest) returns (Operation)Deletes entity types in the specified agent. Operation <response: google.protobuf.Empty, metadata: google.protobuf.Struct>
rpc GetEntity (GetEntityRequest) returns (EntityType.Entity)Retrieves the specified entity .
rpc CreateEntity (CreateEntityRequest) returns (EntityType.Entity)Creates an entity in the specified agent.
rpc UpdateEntity (UpdateEntityRequest) returns (EntityType.Entity)Updates the specified entity .
rpc DeleteEntity (DeleteEntityRequest) returns (DeleteEntityStatus)Deletes the specified entity .
rpc BatchCreateEntities (BatchCreateEntitiesRequest) returns (BatchEntitiesResponse)Creates an entity value in an entity type.
rpc BatchUpdateEntities (BatchUpdateEntitiesRequest) returns (BatchEntitiesResponse)Updates a specific entity value.
rpc BatchGetEntities (BatchGetEntitiesRequest) returns (BatchEntitiesResponse)Gets a specific entity value.
rpc BatchDeleteEntities (BatchDeleteEntitiesRequest) returns (BatchDeleteEntitiesResponse)Deletes the specified entity value.
rpc ListEntities (ListEntitiesRequest) returns (ListEntitiesResponse)List entities of an entity type
| 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/*} |
This message is a request to create a batch entities
| Field | Type | Label | Description |
| create_entity_requests | CreateEntityRequest | repeated | The create entity requests in a batch |
This message is a request to delete a batch of entities
| Field | Type | Label | Description |
| names | string | repeated | The unique identifiers of the entities. Format:
|
This message is a response of deletion of a batch of entities
| Field | Type | Label | Description |
| delete_statuses | DeleteEntityStatus | repeated | status of an entity deletion |
| has_errors | bool | error messages |
The request message for EntityTypes.BatchDeleteEntityTypes.
| Field | Type | Label | Description |
| parent | string | Required. The name of the agent to delete all entities types for. Format:
|
|
| entity_type_names | string | repeated | Required. The names entity types to delete. All names must point to the same agent as `parent`. |
This message is a response of batch entities
| Field | Type | Label | Description |
| entity_statuses | EntityStatus | repeated | A list of entity statuses |
| has_errors | bool | indicates if statuses of some of the training phrases have errors |
This message is a request to get a batch of entities
| Field | Type | Label | Description |
| names | string | repeated | The unique identifiers of the entities. Format:
|
This message is a request to update a batch of entities
| Field | Type | Label | Description |
| entities | EntityType.Entity | repeated | The entities to update |
The request message for EntityTypes.BatchUpdateEntityTypes.
| Field | Type | Label | Description |
| parent | string | Required. The name of the agent to update or create entity types in. Format: |
|
| 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 |
|
| update_mask | google.protobuf.FieldMask | Optional. The mask to control which fields get updated. |
The response message for EntityTypes.BatchUpdateEntityTypes.
| Field | Type | Label | Description |
| entity_types | EntityType | repeated | The collection of updated or created entity types. |
| Field | Type | Label | Description |
| entity_type_name | string | Required. Name of the entity type in which to create the entity value. Format:
|
|
| entity | EntityType.Entity | The entity value to create |
The request message for EntityTypes.CreateEntityType.
| Field | Type | Label | Description |
| parent | string | Required. The agent to create a entity type for. Format: |
|
| entity_type | EntityType | Required. The entity type to create. |
|
| language_code | string | Optional. The language of entity synonyms defined in |
|
| entity_type_view | EntityTypeView | Optional. The resource view to apply to the returned Entity Type |
This message is a request to delete a batch of entities
| Field | Type | Label | Description |
| name | string | The unique identifiers of the entities. Format:
|
This message contains the status of an entity deletion
| Field | Type | Label | Description |
| successfully_deleted | google.protobuf.Empty |
|
|
| error_message | string |
|
The request message for EntityTypes.DeleteEntityType.
| Field | Type | Label | Description |
| name | string | Required. The name of the entity type to delete. Format: |
This message is for the entity status
| Field | Type | Label | Description |
| entity | EntityType.Entity | The entity |
|
| error_message | string | Error message |
Represents an entity type.
Entity types serve as a tool for extracting parameter values from natural
language queries.
| Field | Type | Label | Description |
| name | string | Required for all methods except |
|
| 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. |
Represents an entity value within an entity type
| Field | Type | Label | Description |
| value | string | Required.
For
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:
|
|
| synonyms | string | repeated | Required. A collection of synonyms. For |
| name | string | The unique identifier of the entity. Format:
|
|
| 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. |
This message is a wrapper around a collection of entity types.
| Field | Type | Label | Description |
| entity_types | EntityType | repeated | A collection of entity types. |
This message contains Entity type sorting
| Field | Type | Label | Description |
| sorting_field | EntityTypeSorting.EntityTypeSortingField |
|
|
| sorting_mode | SortingMode |
|
This message contains entity value sorting
| Field | Type | Label | Description |
| sorting_field | EntityValueSorting.EntityValueSortingField |
|
|
| sorting_mode | SortingMode |
|
This message is a request to get a an entity
| Field | Type | Label | Description |
| name | string | The unique identifiers of the entities. Format:
|
The request message for EntityTypes.GetEntityType.
| Field | Type | Label | Description |
| name | string | Required. The name of the entity type. Format: |
|
| 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:
|
|
| entity_type_view | EntityTypeView | Optional. The resource view to apply to the returned Entity Type |
This message is a request to get a list of entities
| Field | Type | Label | Description |
| entity_type_name | string | The unique identifier of the entity type. Format:
|
|
| 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:
|
|
| 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: |
This message is a response of listing entities
| Field | Type | Label | Description |
| 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 |
The request message for EntityTypes.ListEntityTypes.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list all entity types from. Format: |
|
| 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:
|
|
| 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. |
The response message for EntityTypes.ListEntityTypes.
| Field | Type | Label | Description |
| 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 |
This message is a request to update an entity
| Field | Type | Label | Description |
| entity | EntityType.Entity | The entity to update |
The request message for EntityTypes.UpdateEntityType.
| Field | Type | Label | Description |
| entity_type | EntityType | Required. The entity type to update. Format: |
|
| language_code | string | Optional. The language of entity synonyms defined in |
|
| 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 |
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).
| Name | Number | Description |
| 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. |
| Name | Number | Description |
| ACTIVE | 0 | Entity type is active |
| INACTIVE | 1 | Entity type is inactive |
Represents kinds of entities.
| Name | Number | Description |
| 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). |
Represents the category of entity types to filter by in the "List Entity Types" request
| Name | Number | Description |
| 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 |
Structure of Entity type sorting field
| Name | Number | Description |
| 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 |
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.
| Name | Number | Description |
| 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 |
Structure of Entity value sorting field
| Name | Number | Description |
| 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 |
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.
rpc ListIntents (ListIntentsRequest) returns (ListIntentsResponse)Returns the list of all intents in the specified agent.
rpc GetIntent (GetIntentRequest) returns (Intent)Retrieves the specified intent.
rpc CreateIntent (CreateIntentRequest) returns (Intent)Creates an intent in the specified agent.
rpc UpdateIntent (UpdateIntentRequest) returns (Intent)Updates the specified intent.
rpc DeleteIntent (DeleteIntentRequest) returns (.google.protobuf.Empty)Deletes the specified intent.
rpc BatchUpdateIntents (BatchUpdateIntentsRequest) returns (BatchUpdateIntentsResponse)Updates/Creates multiple intents in the specified agent. Operation <response: BatchUpdateIntentsResponse>
rpc BatchDeleteIntents (BatchDeleteIntentsRequest) returns (Operation)Deletes intents in the specified agent.
rpc TagIntent (IntentTagRequest) returns (.google.protobuf.Empty)Tags a specific intent with tag(s)
rpc DeleteIntentTag (IntentTagRequest) returns (.google.protobuf.Empty)Deletes tag(s) for a specific intent
rpc GetIntentTags (GetIntentTagsRequest) returns (GetIntentTagsResponse)Gets all the tags for a specific intent
rpc GetAllIntentTags (GetAllIntentTagsRequest) returns (GetIntentTagsResponse)Gets all the tags for all the intents
rpc BatchCreateTrainingPhrases (BatchCreateTrainingPhrasesRequest) returns (BatchTrainingPhrasesStatusResponse)Creates batch of training phrases
rpc BatchGetTrainingPhrases (BatchGetTrainingPhrasesRequest) returns (BatchTrainingPhrasesStatusResponse)Retrieve a training phrases batch of the specified names.
rpc BatchUpdateTrainingPhrases (BatchUpdateTrainingPhrasesRequest) returns (BatchTrainingPhrasesStatusResponse)Updates batch of training phrases
rpc BatchDeleteTrainingPhrases (BatchDeleteTrainingPhrasesRequest) returns (BatchDeleteTrainingPhrasesResponse)Delete a training phrases batch of the specified names.
rpc ListTrainingPhrases (ListTrainingPhrasesRequest) returns (ListTrainingPhrasesResponse)List training phrases (of a specific intent).
rpc BatchCreateResponseMessages (BatchCreateResponseMessagesRequest) returns (BatchResponseMessagesStatusResponse)Creates batch of intent messages
rpc BatchGetResponseMessages (BatchGetResponseMessagesRequest) returns (BatchResponseMessagesStatusResponse)Retrieve a intent messages batch of the specified names.
rpc BatchUpdateResponseMessages (BatchUpdateResponseMessagesRequest) returns (BatchResponseMessagesStatusResponse)Updates batch of intent messages
rpc BatchDeleteResponseMessages (BatchDeleteResponseMessagesRequest) returns (BatchDeleteResponseMessagesResponse)Delete a intent messages batch of the specified names.
rpc ListResponseMessages (ListResponseMessagesRequest) returns (ListResponseMessagesResponse)List messages (of a specific intent).
rpc BatchCreateParameters (BatchCreateParametersRequest) returns (BatchParametersStatusResponse)Creates batch of intent messages
rpc BatchGetParameters (BatchGetParametersRequest) returns (BatchParametersStatusResponse)Retrieve a intent messages batch of the specified names.
rpc BatchUpdateParameters (BatchUpdateParametersRequest) returns (BatchParametersStatusResponse)Updates batch of intent messages
rpc BatchDeleteParameters (BatchDeleteParametersRequest) returns (BatchDeleteParametersResponse)Delete a intent messages batch of the specified names.
rpc ListParameters (ListParametersRequest) returns (ListParametersResponse)List messages (of a specific intent).
rpc ListTrainingPhrasesofIntentsWithEnrichment (ListTrainingPhrasesofIntentsWithEnrichmentRequest) returns (ListTrainingPhrasesofIntentsWithEnrichmentResponse)List Training phrases (of a specific intent).
| 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 | * |
Request to create a batch of parameters in the specified intent
| Field | Type | Label | Description |
| parameter_requests | BatchCreateParametersRequest.CreateParameterRequest | repeated | List of parameters to create |
Request to create a single parameter
| Field | Type | Label | Description |
| intent_name | string | Required. The name of the intent for which to create a training phrase for. |
|
| parameter | Intent.Parameter | Required. The response message. |
Request to create a list of new response messages and adds it to an intent
| Field | Type | Label | Description |
| response_message_requests | BatchCreateResponseMessagesRequest.CreateResponseMessageRequest | repeated |
|
Request to create a single response message
| Field | Type | Label | Description |
| 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. |
This message is a request of a creation of a batch of training phrases
| Field | Type | Label | Description |
| training_phrase_requests | BatchCreateTrainingPhrasesRequest.CreateTrainingPhraseRequest | repeated |
|
Request to create a single training phrase
| Field | Type | Label | Description |
| 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. |
The request message for Intents.BatchDeleteIntents.
| Field | Type | Label | Description |
| parent | string | Required. The name of the agent to delete all entities types for. Format:
|
|
| intents | Intent | repeated | Required. The collection of intents to delete. Only intent |
Request to delete parameters specified by their names.
| Field | Type | Label | Description |
| names | string | repeated | Required. The names of the response messages. Format: |
This message contains response of deleted parameters
| Field | Type | Label | Description |
| delete_statuses | BatchDeleteParametersResponse.DeleteParameterStatus | repeated |
|
| has_errors | bool |
|
Status of a parameter deletion operation
| Field | Type | Label | Description |
| successfully_deleted | google.protobuf.Empty |
|
|
| error_message | string |
|
Request to delete response messages specified by their names
| Field | Type | Label | Description |
| names | string | repeated | Required. The names of the response messages. Format: |
Response containing list with deleted response messages
| Field | Type | Label | Description |
| delete_statuses | BatchDeleteResponseMessagesResponse.DeleteResponseMessageStatus | repeated |
|
| has_errors | bool |
|
Status of a response message deletion operation
| Field | Type | Label | Description |
| successfully_deleted | google.protobuf.Empty |
|
|
| error_message | string |
|
This message is a request to delete a batch of training phrases
| Field | Type | Label | Description |
| names | string | repeated | Required. The names of the training phrases. Format: |
This message is a response of deleting a batch of training phrases
| Field | Type | Label | Description |
| delete_statuses | BatchDeleteTrainingPhrasesResponse.DeleteTrainingPhraseStatus | repeated |
|
| has_errors | bool |
|
Status of a training phrase deletion operation
| Field | Type | Label | Description |
| successfully_deleted | google.protobuf.Empty |
|
|
| error_message | string |
|
Request to get batch of parameters in a specified intent
| Field | Type | Label | Description |
| names | string | repeated | Required. The names of the response messages. Format: |
Request to retrieve a response messages
| Field | Type | Label | Description |
| names | string | repeated | Required. The names of the response messages. Format: |
This message is a request to get a batch training phrases
| Field | Type | Label | Description |
| names | string | repeated | Required. The names of the training phrases. Format: |
Response containing a batch of parameters in the specified intent
| Field | Type | Label | Description |
| parameter_statuses | BatchParametersStatusResponse.ParameterStatus | repeated |
|
| has_errors | bool | indicates if statuses of some of the parameters have errors |
Status of a parameter operation
| Field | Type | Label | Description |
| parameter | Intent.Parameter |
|
|
| error_message | string |
|
This message is a response of a batch responses of message status
| Field | Type | Label | Description |
| response_message_statuses | BatchResponseMessagesStatusResponse.ResponseMessageStatus | repeated |
|
| has_errors | bool | indicates if statuses of some of the response messages have errors |
Status of a response message operation
| Field | Type | Label | Description |
| response_message | Intent.Message |
|
|
| error_message | string |
|
This message is a response of the status of a batch of training phrases
| Field | Type | Label | Description |
| 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 |
The request message for Intents.BatchUpdateIntents.
| Field | Type | Label | Description |
| parent | string | Required. The name of the agent to update or create intents in. Format: |
|
| 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 |
|
| 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. |
The response message for Intents.BatchUpdateIntents.
| Field | Type | Label | Description |
| intents | Intent | repeated | The collection of updated or created intents. |
Request to update parameters and adds them to an intent
| Field | Type | Label | Description |
| parameters | Intent.Parameter | repeated | The response messages to update |
Request to update a response message in the specified intent
| Field | Type | Label | Description |
| response_messages | Intent.Message | repeated | The response messages to update |
This message is a request to update a batch of training phrases
| Field | Type | Label | Description |
| training_phrases | Intent.TrainingPhrase | repeated | A list of training phrases |
The request message for Intents.CreateIntent.
| Field | Type | Label | Description |
| parent | string | Required. The agent to create a intent for. Format: |
|
| intent | Intent | Required. The intent to create. |
|
| language_code | string | Optional. The language of training phrases, parameters and rich messages
defined in |
|
| intent_view | IntentView | Optional. The resource view to apply to the returned intent. |
The request message for Intents.DeleteIntent.
| Field | Type | Label | Description |
| name | string | Required. The name of the intent to delete. Format: |
This message is a request to get all intent tags
| Field | Type | Label | Description |
| parent | string | Required. The name of the agent to delete all entities types for. Format:
|
The request message for Intents.GetIntent.
| Field | Type | Label | Description |
| name | string | Required. The name of the intent. Format: |
|
| 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:
|
This message is a request to get intent tags
| Field | Type | Label | Description |
| intent_name | string | The path of the intent. Format: |
This message is a response of getting intent tags
| Field | Type | Label | Description |
| intent_tags | string | repeated | All the distinct intent tags sorted |
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.
| Field | Type | Label | Description |
| name | string | Required for all methods except |
|
| 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 |
|
| input_context_names | string | repeated | Optional. The list of context names required for this intent to be triggered. Format: |
| 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 |
| 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
|
| 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: |
|
| 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: |
|
| 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. |
Represents a single followup intent in the chain.
| Field | Type | Label | Description |
| followup_intent_name | string | The unique identifier of the followup intent. Format: |
|
| parent_followup_intent_name | string | The unique identifier of the followup intent parent. Format: |
Corresponds to the Response field in the Dialogflow console.
| Field | Type | Label | Description |
| name | string | Required. The name of the return message. Format: |
|
| 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. |
The Audio response message.
| Field | Type | Label | Description |
| 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. |
The basic card message. Useful for displaying information.
| Field | Type | Label | Description |
| 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. |
The button object that appears at the bottom of a card.
| Field | Type | Label | Description |
| 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. |
Opens the given URI.
| Field | Type | Label | Description |
| uri | string | Required. The HTTP or HTTPS scheme URI. |
The card response message.
| Field | Type | Label | Description |
| 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. |
Optional. Contains information about a button.
| Field | Type | Label | Description |
| 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. |
The card for presenting a carousel of options to select from.
| Field | Type | Label | Description |
| items | Intent.Message.CarouselSelect.Item | repeated | Required. Carousel items. |
An item in the carousel.
| Field | Type | Label | Description |
| 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. |
This message contains HTML text
| Field | Type | Label | Description |
| text | string | repeated | Collection of the agent's responses in HTML format |
The image response message.
| Field | Type | Label | Description |
| 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. |
The suggestion chip message that allows the user to jump out to the app or website associated with this agent.
| Field | Type | Label | Description |
| 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. |
The card for presenting a list of options to select from.
| Field | Type | Label | Description |
| title | string | Optional. The overall title of the list. |
|
| items | Intent.Message.ListSelect.Item | repeated | Required. List items. |
An item in the list.
| Field | Type | Label | Description |
| 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. |
The quick replies response message.
| Field | Type | Label | Description |
| title | string | Optional. The title of the collection of quick replies. |
|
| quick_replies | string | repeated | Optional. The collection of quick replies. |
Additional info about the select item for when it is triggered in a dialog.
| Field | Type | Label | Description |
| 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. |
The simple response message containing speech or text.
| Field | Type | Label | Description |
| 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. |
The collection of simple response candidates. This message in QueryResult.fulfillment_messages and WebhookResponse.fulfillment_messages should contain only one SimpleResponse.
| Field | Type | Label | Description |
| simple_responses | Intent.Message.SimpleResponse | repeated | Required. The list of simple responses. |
The suggestion chip message that the user can tap to quickly post a reply to the conversation.
| Field | Type | Label | Description |
| title | string | Required. The text shown the in the suggestion chip. |
The collection of suggestions.
| Field | Type | Label | Description |
| suggestions | Intent.Message.Suggestion | repeated | Required. The list of suggested replies. |
The text response message.
| Field | Type | Label | Description |
| text | string | repeated | Optional. The collection of the agent's responses. |
The Video response message.
| Field | Type | Label | Description |
| 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. |
Represents intent parameters.
| Field | Type | Label | Description |
| name | string | The unique identifier of this parameter. Format: |
|
| display_name | string | Required. The name of the parameter. |
|
| value | string | Optional. The definition of the parameter value. It can be:
|
|
| default_value | string | Optional. The default value to use when the |
|
| entity_type_name | string | Optional. The unique identifier of the entity type in format
|
|
| 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. |
Represents the prompts in the parameters.
| Field | Type | Label | Description |
| name | string | The unique identifier of this prompt. Format: |
|
| 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. |
Represents an example or template that the agent is trained on.
| Field | Type | Label | Description |
| name | string | Required. The unique identifier of this training phrase. Format: |
|
| 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. |
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.
| Field | Type | Label | Description |
| entity_type_name | string | Required. The unique entity type identifier in format
|
|
| entity_type_display_name | string | Optional. The entity type name. |
|
| entity_value_name | string | Optional. The unique entity value identifier in format
|
|
| 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
|
|
| 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. |
This message is a wrapper around a collection of intents.
| Field | Type | Label | Description |
| intents | Intent | repeated | A collection of intents. |
This message contains sorting of an intent
| Field | Type | Label | Description |
| sorting_field | IntentSorting.IntentSortingField |
|
|
| sorting_mode | SortingMode |
|
This message is a request to get an intent tag
| Field | Type | Label | Description |
| intent_name | string | The path of the intent. Format: |
|
| tags | string | repeated | Intent tags for this intent to operate on |
The request message for Intents.ListIntents.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list all intents from. Format: |
|
| 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:
|
|
| 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. |
The response message for Intents.ListIntents.
| Field | Type | Label | Description |
| 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 |
The request message for TrainingPhraseRequest
| Field | Type | Label | Description |
| intent_name | string | Required. The agent to list all intents from. Format: |
|
| 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:
|
The response message for ListTrainingPhrase
| Field | Type | Label | Description |
| 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: |
The request message for ResponseMessageRequest
| Field | Type | Label | Description |
| intent_name | string | Required. The agent to list all intents from. Format: |
|
| 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:
|
The response message for ListResponseMessage
| Field | Type | Label | Description |
| 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: |
The request message for TrainingPhraseRequest
| Field | Type | Label | Description |
| intent_name | string | Required. The agent to list all intents from. Format: |
|
| 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:
|
The response message for ListTrainingPhrase
| Field | Type | Label | Description |
| 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: |
The request message for TrainingPhraseRequest
| Field | Type | Label | Description |
| parent | string | Required. The name of the agent to delete all entities types for. Format:
|
|
| 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:
|
This message contains a list of training phrases filtered by intent ids, language code and parent passed through the request
| Field | Type | Label | Description |
| 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: |
This message containing the training phrases status
| Field | Type | Label | Description |
| training_phrase | Intent.TrainingPhrase |
|
|
| error_message | string |
|
The request message for Intents.UpdateIntent.
| Field | Type | Label | Description |
| intent | Intent | Required. The intent to update. Format: |
|
| language_code | string | Optional. The language of training phrases, parameters and rich messages
defined in |
|
| 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. |
Structure of status of an Intent
| Name | Number | Description |
| ACTIVE | 0 | Intent is active |
| INACTIVE | 1 | Intent is inactive |
Represents different platforms that a rich message can be intended for.
| Name | Number | Description |
| PLATFORM_UNSPECIFIED | 0 | Not specified. |
| 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 |
| 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 |
Represents different types of training phrases.
| Name | Number | Description |
| 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. |
Represents the different states that webhooks can be in.
| Name | Number | Description |
| 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. |
Represents the type of intents to filter by in the "List Intents" request
| Name | Number | Description |
| 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 |
Structure of intent sorting field
| Name | Number | Description |
| 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 |
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.
| Name | Number | Description |
| 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 |
Represents the metadata of the long-running operation that can be a parent operation for sub-operations or
can be a sub-operation itself
| Field | Type | Label | Description |
| 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. |
Type of operation.
It can be creating, importing, exporting, deleting, restoring, building cache, training or exporting benchmark an agent
| Name | Number | Description |
| 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 |
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.
| Name | Number | Description |
| 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 |
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.
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.
name binding below allows API services to override the binding
to use different resource name schemes, such as users/*/operations.
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.
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
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.
| 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 | * |
The request message for Operations.CancelOperation.
| Field | Type | Label | Description |
| name | string | The name of the operation resource to be cancelled. |
The request message for Operations.DeleteOperation.
| Field | Type | Label | Description |
| name | string | The name of the operation resource to be deleted. |
The request message for Operations.GetOperation.
| Field | Type | Label | Description |
| name | string | The name of the operation resource. |
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
The request message for Operations.ListOperations.
| Field | Type | Label | Description |
| 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:
|
|
| 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. |
The response message for Operations.ListOperations.
| Field | Type | Label | Description |
| 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 |
This resource represents a long-running operation that is the result of a network API call.
| Field | Type | Label | Description |
| 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
|
|
| 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 |
|
| 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 |
This message contains an operation filter
| Field | Type | Label | Description |
| 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. |
Project roles
rpc CreateProjectRole (CreateProjectRoleRequest) returns (ProjectRole)Creates a project role by creating the knowledge base master
rpc GetProjectRole (GetProjectRoleRequest) returns (ProjectRole)Creates a project role by getting the knowledge base master
rpc DeleteProjectRole (DeleteProjectRoleRequest) returns (.google.protobuf.Empty)Deletes project role
rpc UpdateProjectRole (UpdateProjectRoleRequest) returns (ProjectRole)Updates project role
rpc ListProjectRoles (ListProjectRolesRequest) returns (ListProjectRolesResponse)List project roles
| 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 |
This message is a request to create project role
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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 |
This message is a request to delete project role
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| role_id | uint32 | role is identified by role id, if empty will throw an error in the backend |
This message is a request to get project role
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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. |
This message is a request to list project role
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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:
|
|
| 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. |
This message is a response of listing project role
| Field | Type | Label | Description |
| 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 |
Project Role messages
| Field | Type | Label | Description |
| 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. |
This message is a request to update project role
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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 |
Structure of project role
| Name | Number | Description |
| 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 |
Structure of project role view
| Name | Number | Description |
| PROJECT_ROLE_VIEW_UNSPECIFIED | 0 | The view depends on the endpoint:
|
| PROJECT_ROLE_VIEW_SHALLOW | 1 | only role ID and name fields are populated |
| PROJECT_ROLE_VIEW_FULL | 2 | all fields including permissions are populated |
Project Root Statistics
rpc GetIntentCount (GetIntentCountRequest) returns (StatResponse)Returns the intent count within a project
rpc GetEntityTypeCount (GetEntityTypeCountRequest) returns (StatResponse)Returns the entity types count within a project
rpc GetUserCount (GetProjectStatRequest) returns (StatResponse)Returns the users count within a project
rpc GetSessionCount (GetProjectStatRequest) returns (StatResponse)Returns the sessions count within a project
rpc GetTrainingPhraseCount (GetProjectElementStatRequest) returns (StatResponse)Returns the training phrases count within a project
rpc GetResponseCount (GetProjectElementStatRequest) returns (StatResponse)Returns the responses count within a project
rpc GetEntityValueCount (GetProjectElementStatRequest) returns (StatResponse)Returns the entity value count within a project
rpc GetEntitySynonymCount (GetProjectElementStatRequest) returns (StatResponse)Returns the entity synonyms count within a project
| 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 |
Request to get entity type count
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| filter_by_category | EntityTypeCategory | Optional. Applies a filter to the list to be counted. Default, no filter. |
Request to get the intent count
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| filter_by_category | IntentCategory | Optional. Applies a filter to the list to be counted. Default, no filter. |
Request to get project element statistics
| Field | Type | Label | Description |
| name | string | Required. The name/path of the concept to get the statistic from. Example:
|
|
| language_code | string | Language code |
Request to get project statistics
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
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.
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
rpc RagCreateDataset (RagCreateDatasetRequest) returns (RagDataset)Create a new dataset (knowledge base).
rpc RagUpdateDataset (RagUpdateDatasetRequest) returns (RagDataset)Update an existing dataset's configuration.
rpc RagDeleteDatasets (RagDeleteRequest) returns (RagPartialSuccess)Delete one or more datasets (batch operation).
rpc RagListDatasets (RagListDatasetsRequest) returns (RagDatasetList)List datasets with pagination and filtering.
rpc RagGetKnowledgeGraph (RagDatasetIdRequest) returns (RagGetKnowledgeGraphResponse)Get the knowledge graph for a dataset.
rpc RagDeleteKnowledgeGraph (RagDatasetIdRequest) returns (.google.protobuf.Empty)Delete the knowledge graph for a dataset.
rpc RagConstructKnowledgeGraph (RagDatasetIdRequest) returns (RagConstructKnowledgeGraphResponse)Construct a knowledge graph for a dataset.
rpc RagKnowledgeGraphStatus (RagDatasetIdRequest) returns (RagTaskStatus)Get the knowledge graph construction status of a dataset.
rpc RagConstructRaptor (RagDatasetIdRequest) returns (RagConstructRaptorResponse)Construct a RAPTOR for a dataset.
rpc RagRaptorStatus (RagDatasetIdRequest) returns (RagTaskStatus)Get the RAPTOR construction status of a dataset.
rpc RagUploadDocuments (stream RagUploadDocumentsRequest) returns (RagDocumentList)Upload one or more documents to a dataset.
rpc RagUpdateDocument (RagUpdateDocumentRequest) returns (RagDocument)Update document metadata and configuration.
rpc RagDownloadDocument (RagDownloadDocumentRequest) returns (stream RagFileChunk)Download the original document file.
rpc RagListDocuments (RagListDocumentsRequest) returns (RagListDocumentsResponse)List documents in a dataset with pagination and filtering.
rpc RagDeleteDocuments (RagDeleteDocumentsRequest) returns (RagPartialSuccess)Delete one or more documents from a dataset (batch operation).
rpc RagParseDocuments (RagParseDocumentsRequest) returns (RagPartialSuccess)Start parsing documents into chunks.
rpc RagStopParsing (RagStopParsingRequest) returns (RagPartialSuccess)Stop parsing documents.
rpc RagListChunks (RagListChunksRequest) returns (RagListChunksResponse)List chunks of a document with pagination.
rpc RagAddChunk (RagAddChunkRequest) returns (RagAddChunkResponse)Manually add a chunk to a document.
rpc RagRemoveChunks (RagRemoveChunksRequest) returns (RagPartialSuccess)Remove one or more chunks from a document.
rpc RagUpdateChunk (RagUpdateChunkRequest) returns (.google.protobuf.Empty)Update an existing chunk's content and metadata.
rpc RagRetrieval (RagRetrievalRequest) returns (RagRetrievalResponse)Retrieve chunks using vector similarity search.
rpc RagUploadFiles (stream RagUploadFilesRequest) returns (RagFileList)Upload one or more files via multipart form data.
rpc RagCreateFile (RagCreateFileRequest) returns (RagFile)Create a new file or folder.
rpc RagListFiles (RagListFilesRequest) returns (RagListFilesResponse)List files in a folder with pagination.
rpc RagGetRootFolder (RagGetRootFolderRequest) returns (RagGetRootFolderResponse)Get user's root folder information.
rpc RagGetParentFolder (RagFileIdRequest) returns (RagGetParentFolderResponse)Get the parent folder of a file.
rpc RagGetAllParentFolders (RagFileIdRequest) returns (RagParentFoldersList)Get all parent folders (breadcrumb path) of a file.
rpc RagDeleteFiles (RagDeleteFilesRequest) returns (.google.protobuf.Empty)Delete one or more files/folders.
rpc RagRenameFile (RagRenameFileRequest) returns (.google.protobuf.Empty)Rename a file or folder.
rpc RagDownloadFile (RagFileIdRequest) returns (stream RagFileChunk)Download a file.
rpc RagMoveFile (RagMoveFileRequest) returns (.google.protobuf.Empty)Move one or more files to another folder.
rpc RagFileToDocument (RagFileToDocumentRequest) returns (RagFileToDocumentList)Convert files to documents and add to datasets.
rpc RagCreateChatAssistant (RagCreateChatAssistantRequest) returns (RagChatAssistant)Create a new chat assistant.
rpc RagUpdateChatAssistant (RagUpdateChatAssistantRequest) returns (.google.protobuf.Empty)Update an existing chat assistant's configuration.
rpc RagDeleteChatAssistants (RagDeleteRequest) returns (RagPartialSuccess)Delete one or more chat assistants (batch operation).
rpc RagListChatAssistants (RagListChatAssistantsRequest) returns (RagChatAssistantList)List chat assistants with pagination.
rpc RagCreateAgent (RagCreateAgentRequest) returns (.google.protobuf.Empty)Create a new agent with DSL configuration.
rpc RagUpdateAgent (RagUpdateAgentRequest) returns (.google.protobuf.Empty)Update an existing agent.
rpc RagDeleteAgent (RagDeleteAgentRequest) returns (.google.protobuf.Empty)Delete an agent.
rpc RagListAgents (RagListAgentsRequest) returns (RagAgentList)List agents with pagination.
rpc RagCreateChatSession (RagCreateChatSessionRequest) returns (RagChatSession)Create a new chat session (conversation).
rpc RagUpdateChatSession (RagUpdateChatSessionRequest) returns (.google.protobuf.Empty)Update a chat session's metadata (name only).
rpc RagListChatSessions (RagListChatSessionsRequest) returns (RagChatSessionList)List sessions for a chat assistant.
rpc RagDeleteChatSessions (RagDeleteChatSessionsRequest) returns (RagPartialSuccess)Delete one or more chat sessions (batch operation).
rpc RagListAgentSessions (RagListAgentSessionsRequest) returns (RagAgentSessionList)List sessions for an agent.
rpc RagDeleteAgentSessions (RagDeleteAgentSessionsRequest) returns (RagPartialSuccess)Delete one or more agent sessions (batch operation).
rpc RagChatCompletion (RagChatCompletionRequest) returns (stream RagChatCompletionResponse)Generate chat completion with RAG (server streaming).
rpc RagAgentCompletion (RagAgentCompletionRequest) returns (stream RagAgentCompletionResponse)Generate agent completion (server streaming).
rpc RagAsk (RagAskRequest) returns (stream RagAskResponse)Ask a question across datasets without a chat assistant.
rpc RagRelatedQuestions (RagRelatedQuestionsRequest) returns (RagRelatedQuestionsResponse)Generate related search terms for a question.
Request message for manually adding a chunk to a document.
The chunk content is automatically tokenized and embeddings are generated.
| Field | Type | Label | Description |
| parent | string | Required. The agent to add the chunk for. Format: |
|
| 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). |
Response message for adding a chunk.
| Field | Type | Label | Description |
| chunk | RagChunk | The newly created chunk. |
RAGFlow agent (workflow-based AI assistant).
Agents are workflow-based AI assistants configured using Canvas DSL.
| Field | Type | Label | Description |
| id | string | Agent UUID uniquely identifying this agent. |
|
| avatar | string | Optional. Base64-encoded icon in the format |
|
| 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. |
Data payload in agent completion response.
| Field | Type | Label | Description |
| 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. |
Request message for generating an agent completion.
Agents are workflow-based AI assistants with Domain Specific Language (DSL) configuration.
| Field | Type | Label | Description |
| parent | string | Required. The agent to generate the completion for. Format: |
|
| 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 |
| 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 |
|
| additional_fields | google.protobuf.Struct | Optional. Additional fields to pass through to RAGFlow API. |
Response message for agent completion.
event indicating the event type (e.g., "message", "message_end").| Field | Type | Label | Description |
| 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. |
Response message containing a list of RAGFlow agents.
| Field | Type | Label | Description |
| agents | RagAgent | repeated | List of RAGFlow agents. |
Agent session containing conversation history for an agent workflow.
| Field | Type | Label | Description |
| 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). |
Response message for listing agent sessions.
| Field | Type | Label | Description |
| agent_sessions | RagAgentSession | repeated | List of agent sessions. |
Request message for asking a question using RAGFlow's basic QA endpoint.
| Field | Type | Label | Description |
| parent | string | Required. The agent to ask the question for. Format: |
|
| 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. |
Response message containing the answer to a user's question.
| Field | Type | Label | Description |
| 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. |
Chat assistant configuration.
| Field | Type | Label | Description |
| 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. |
|
| status | string | Validation status indicating if chat is enabled ( |
|
| 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). |
Response message for listing chat assistants.
| Field | Type | Label | Description |
| chats | RagChatAssistant | repeated | List of chat assistants (with full dataset objects embedded). |
Request message for generating a chat completion.
| Field | Type | Label | Description |
| parent | string | Required. The agent to generate the chat completion for. Format: |
|
| 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 |
|
| user_id | string | Optional. Maximum length 255. User defined ID for new session. Ignored if |
|
| question | string | Optional. User question or message to send to the chat assistant. |
|
| stream | bool | optional | Optional. Enable streaming mode. If |
| additional_fields | google.protobuf.Struct | Optional. Additional fields to pass through to RAGFlow API. |
Response message for chat completion.
| Field | Type | Label | Description |
| 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 |
|
| 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. |
Chat session containing conversation history for a chat assistant.
| Field | Type | Label | Description |
| id | string | Session UUID. |
|
| chat_id | string | Parent chat assistant UUID. |
|
| name | string | Session name (default: |
|
| 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). |
Response message for listing chat sessions.
| Field | Type | Label | Description |
| chat_sessions | RagChatSession | repeated | List of chat sessions. |
Chunk of text extracted from a document.
Chunks are the basic retrieval units used for vector similarity search in RAG.
| Field | Type | Label | Description |
| 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 |
| 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. |
| 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 |
| 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. |
Response message for starting construction of a knowledge graph.
| Field | Type | Label | Description |
| graphrag_task_id | string | ID of the GraphRAG task. |
Response message for starting RAPTOR construction.
| Field | Type | Label | Description |
| raptor_task_id | string | ID of the GraphRAG task. |
Request message for creating a new RAGFlow agent.
| Field | Type | Label | Description |
| parent | string | Required. The agent to create the RAGFlow agent for. Format: |
|
| avatar | string | Optional. Base64-encoded icon in the format |
|
| title | string | Required. Maximum length 255. Unique agent title. Must be unique within the project. |
|
| permission | RagPermission | optional | Optional. Default |
| 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. |
Request message for creating a new chat assistant.
| Field | Type | Label | Description |
| parent | string | Required. The agent to create a chat assistant for. Format: |
|
| 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 |
|
| 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. |
Request message for creating a new chat session.
| Field | Type | Label | Description |
| parent | string | Required. The agent to create a chat session for. Format: |
|
| chat_id | string | Required. Parent chat assistant UUID. |
|
| name | string | Optional. Maximum length 255. Session name (default: |
|
| user_id | string | Optional. Maximum length 255. User identifier for tracking conversation ownership. |
Request message for creating a new dataset.
| Field | Type | Label | Description |
| parent | string | Required. The agent to create the dataset for. Format: |
|
| name | string | Required. Unique name of the dataset to create. Must follow these requirements:
|
|
| description | string | Optional. Dataset description. Maximum 65,535 characters. |
|
| avatar | string | Optional. Base64-encoded avatar image in the format |
|
| 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 |
|
| embedding_model | string | Optional. Embedding model name in the format "<model_name>@<factory_name>" (uses user's default if not specified). Maximum length 255. |
Request message for creating a file or folder in RAGFlow.
| Field | Type | Label | Description |
| parent | string | Required. The agent to create the file for. Format: |
|
| 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: |
Dataset containing documents for RAG.
| Field | Type | Label | Description |
| 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. |
|
| 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 ( |
| 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). |
Request message with a single dataset ID.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list all datasets from. Format: |
|
| dataset_id | string | Required. Dataset ID. |
Response message for listing datasets.
| Field | Type | Label | Description |
| datasets | RagDataset | repeated | List of datasets. |
Request message for deleting a RAGFlow agent.
| Field | Type | Label | Description |
| parent | string | Required. The agent to delete the RAGFlow agent from. Format: |
|
| agent_id | string | Required. ID of the RAGFlow agent to delete. |
Request message for deleting agent sessions.
| Field | Type | Label | Description |
| parent | string | Required. The agent to delete agent sessions from. Format: |
|
| agent_id | string | Required. RAGFlow agent UUID. |
|
| ids | string | repeated | Optional. Session UUIDs to delete. Specify either this field or |
| delete_all | bool | optional | Optional. Delete all sessions for this agent (needed because protobuf cannot represent |
Request message for deleting chat sessions.
| Field | Type | Label | Description |
| parent | string | Required. The agent to delete chat sessions from. Format: |
|
| chat_id | string | Required. Chat assistant UUID. |
|
| ids | string | repeated | Optional. Session UUIDs to delete. Specify either this field or |
| delete_all | bool | optional | Optional. Delete all sessions for this chat (needed because protobuf cannot represent |
Request message for deleting one or more documents from a dataset.
| Field | Type | Label | Description |
| parent | string | Required. The agent to delete documents from. Format: |
|
| dataset_id | string | Required. Dataset ID containing the documents to delete. |
|
| ids | string | repeated | Optional. Document IDs to delete. If empty and |
| delete_all | bool | optional | Optional. Delete all documents in the dataset (needed because protobuf cannot represent |
Request message for deleting files or folders.
| Field | Type | Label | Description |
| parent | string | Required. The agent to delete files from. Format: |
|
| file_ids | string | repeated | Required. UUIDs of files or folders to delete. Supports batch deletion. |
Request message for deleting one or more of a RAGFlow resource.
| Field | Type | Label | Description |
| parent | string | Required. The agent to delete datasets from. Format: |
|
| ids | string | repeated | Optional. IDs of resources to delete. If empty and |
| delete_all | bool | optional | Optional. Delete all (needed because protobuf cannot represent |
Document uploaded to a dataset.
| Field | Type | Label | Description |
| id | string | Document UUID. |
|
| thumbnail | string | Base64-encoded thumbnail image in the format |
|
| 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., |
|
| type | string | File type or extension (e.g., |
|
| 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 |
| token_count | int32 | optional | Number of tokens across all chunks in this document. |
| progress | float | optional | Processing progress as a decimal value between |
| 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 ( |
|
| 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). |
Response message containing a list of documents.
| Field | Type | Label | Description |
| documents | RagDocument | repeated | List of documents. |
Request message for downloading the original document file.
| Field | Type | Label | Description |
| parent | string | Required. The agent to download the document from. Format: |
|
| dataset_id | string | Required. Dataset ID containing the document. |
|
| document_id | string | Required. Document ID to download. |
File or folder in RAGFlow file system.
| Field | Type | Label | Description |
| 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 |
|
| source_type | string | Source type indicating file origin (e.g., |
|
| 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). |
File chunk for streaming downloads.
First chunk contains metadata, subsequent chunks only contain data.
| Field | Type | Label | Description |
| data | bytes | Optional. Chunk of file content. |
|
| metadata | RagFileMetadata | Optional. File metadata (only in first chunk). |
Request message for requests that only need a file ID.
| Field | Type | Label | Description |
| parent | string | Required. The agent to rename the file for. Format: |
|
| file_id | string | Required. File ID. |
Response message containing a list of files.
| Field | Type | Label | Description |
| files | RagFile | repeated | Uploaded files. RAGFlow automatically creates intermediate folders as needed during upload. |
File metadata for streaming uploads/downloads.
| Field | Type | Label | Description |
| file_name | string | Required. Filename. Maximum length 255. |
|
| content_type | string | Optional. MIME type (e.g., |
|
| size | int64 | Optional. Minimum 0. File size in bytes (if known, 0 if unknown). |
Association between a file and a document in a dataset.
Tracks the relationship when files are converted to documents for use in RAG operations.
| Field | Type | Label | Description |
| 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). |
Response message containing a list of file-to-document associations.
| Field | Type | Label | Description |
| files_to_documents | RagFileToDocument | repeated | List of file-to-document associations created during the conversion operation. |
Request message for converting files to documents and linking them to datasets.
RAGFlow allows linking uploaded files to multiple target datasets for RAG operations.
| Field | Type | Label | Description |
| parent | string | Required. The agent to convert files to documents for. Format: |
|
| 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. |
Response message for getting a dataset's knowledge graph.
| Field | Type | Label | Description |
| graph | google.protobuf.Struct | Graph structure with nodes (max 256) and edges (max 128). |
|
| mind_map | google.protobuf.Struct | Mind map structure (optional). |
|
| additional_fields | google.protobuf.Struct | Additional fields to pass through to RAGFlow. |
Response message for getting the parent folder of a file.
| Field | Type | Label | Description |
| parent_folder | RagFile | The immediate parent folder of the requested file. |
Empty request message with only the parent field.
| Field | Type | Label | Description |
| parent | string | Required. The agent to get the parent folder for. Format: |
Response message for getting the root folder.
| Field | Type | Label | Description |
| root_folder | RagFile | The root folder of the file system. |
GraphRAG configuration.
| Field | Type | Label | Description |
| use_graphrag | bool | Optional. Default |
|
| entity_types | string | repeated | Optional. Default |
| method | RagGraphRagMethod | optional | Optional. Default |
| community | bool | Optional. Default |
|
| resolution | bool | Optional. Default |
Request message for listing agent sessions.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list agent sessions from. Format: |
|
| agent_id | string | Required. RAGFlow agent UUID. |
|
| pagination | RagPagination | Optional. Pagination parameters for paging through results. |
|
| orderby | string | Sort field (default: |
|
| desc | bool | optional | Optional. Sort in descending order (default: |
| 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. |
Request message for listing RAGFlow agents.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list RAGFlow agents from. Format: |
|
| 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: |
|
| desc | bool | optional | Optional. Sort in descending order. If |
| id | string | Optional. Filter results by specific agent ID. |
Request message for listing chat assistants.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list chat assistants from. Format: |
|
| 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: |
|
| desc | bool | optional | Optional. Sort in descending order (default: |
| additional_fields | google.protobuf.Struct | Optional. Additional fields to pass through to RAGFlow. |
Request message for listing chat sessions.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list chat sessions from. Format: |
|
| chat_id | string | Required. Chat assistant UUID. |
|
| pagination | RagPagination | Optional. Pagination parameters for paging through results. |
|
| orderby | string | Sort field (default: |
|
| desc | bool | optional | Optional. Sort in descending order (default: |
| name | string | Optional. Filter by session name. |
|
| id | string | Optional. Filter by session UUID. |
|
| user_id | string | Optional. Filter by user identifier. |
Request message for listing chunks of a document with pagination.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list chunks from. Format: |
|
| 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. |
Response message for listing chunks.
| Field | Type | Label | Description |
| 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. |
Request message for listing datasets with pagination and filtering.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list all datasets from. Format: |
|
| 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: |
|
| desc | bool | optional | Optional. Sort descending (default: |
Request message for listing documents in a dataset with pagination and filtering.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list documents from. Format: |
|
| 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: |
|
| desc | bool | optional | Optional. Sort in descending order (default: |
| keywords | string | Optional. Search keywords to filter documents (searches in document name and metadata). |
|
| suffix | string | repeated | Optional. Suffixes to filter by (e.g. |
| run_status | RagDocumentStatus | repeated | Optional. Document status to filter by. |
| create_time_from | int64 | Optional. Filter by creation time start (Unix timestamp in milliseconds, |
|
| create_time_to | int64 | Optional. Filter by creation time end (Unix timestamp in milliseconds, |
Response message for listing documents.
| Field | Type | Label | Description |
| 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. |
Request message for listing files and folders.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list files from. Format: |
|
| 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 |
|
| desc | bool | optional | Optional. Sort in descending order. Default is |
Response message for listing files and folders.
| Field | Type | Label | Description |
| 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. |
LLM configuration for chat assistant.
| Field | Type | Label | Description |
| 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. |
Message in a conversation session.
| Field | Type | Label | Description |
| role | RagMessageRole | optional | Role of the message sender. |
| content | string | Message content text. |
|
| additional_fields | google.protobuf.Struct | Additional fields returned by RAGFlow. |
Condition to filter document metadata on.
| Field | Type | Label | Description |
| name | string | Required. Metadata field name. |
|
| comparison_operator | string | Required. Comparison operator. Can be one of: |
|
| value | string | Required. Value to compare to. |
List of document metadata conditions.
| Field | Type | Label | Description |
| conditions | RagMetadataCondition | repeated | Optional. List of conditions. |
Request message for moving files or folders.
| Field | Type | Label | Description |
| parent | string | Required. The agent to move files for. Format: |
|
| 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. |
Pagination parameters for list requests.
| Field | Type | Label | Description |
| 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). |
Response message for getting all parent folders in the hierarchy.
| Field | Type | Label | Description |
| parent_folders | RagFile | repeated | All parent folders in the hierarchy, from immediate parent to root folder. |
Request message for starting document parsing.
Parsing extracts chunks from documents using the configured chunk method.
| Field | Type | Label | Description |
| parent | string | Required. The agent to parse documents for. Format: |
|
| 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). |
Document parser configuration.
Used fields depend on the chunking method of the document.
naive: uses the following fields (all optional)auto_keywordsauto_questionschunk_token_numdelimiterhtml4excellayout_recognizetag_kb_idstask_page_sizeraptorgraphragqa, manual, paper, book, laws, presentation: uses only the raptor fieldtable, picture, one, email: does not use any field (expects empty message)| Field | Type | Label | Description |
| 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 |
|
| html4excel | bool | Optional. Convert Excel documents to HTML. Default |
|
| layout_recognize | string | Optional. Default |
|
| 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 |
|
| graphrag | RagGraphRagConfig | Optional. GRAPHRAG-specific settings. Default |
On complete success: no fields set (empty message).
On partial success/failure: both fields set.
| Field | Type | Label | Description |
| success_count | int32 | Number of successful operations. |
|
| errors | string | repeated | Error messages for failed operations. |
Prompt and retrieval configuration for chat assistant.
| Field | Type | Label | Description |
| 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 |
| empty_response | string | Optional. Response to return when no relevant chunks are found in the knowledge base. |
|
| tts | bool | optional | Optional. Default |
| refine_multiturn | bool | optional | Optional. Default |
| 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. |
Prompt template variable for dynamic content insertion.
| Field | Type | Label | Description |
| key | string | Required. Variable name used in prompt template. |
|
| optional | bool | optional | Required. Whether this variable is optional in the template. |
RAPTOR configuration. Refer to RAPTOR paper for more information about RAPTOR.
| Field | Type | Label | Description |
| use_raptor | bool | Optional. Default |
|
| prompt | string | Optional. Prompt to use for RAPTOR. Default: |
|
| 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. |
Request message for generating related questions based on a user's query.
| Field | Type | Label | Description |
| parent | string | Required. The agent to generate related questions for. Format: |
|
| 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"). |
Response message containing a list of suggested related questions.
| Field | Type | Label | Description |
| questions | string | repeated | List of 5-10 related question suggestions based on the original query. |
Request message for removing one or more chunks from a document.
| Field | Type | Label | Description |
| parent | string | Required. The agent to remove chunks from. Format: |
|
| 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. |
Request message for renaming a file or folder.
| Field | Type | Label | Description |
| parent | string | Required. The agent to rename the file for. Format: |
|
| 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. |
Request message for retrieving chunks using vector similarity search.
Supports hybrid search combining vector similarity with keyword matching.
| Field | Type | Label | Description |
| parent | string | Required. The agent to retrieve chunks for. Format: |
|
| 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 |
|
| vector_similarity_weight | float | optional | Optional. Weight for vector similarity versus keyword matching between |
| top_k | int32 | Optional. Minimum 1. Maximum number of chunks to retrieve before reranking (default: |
|
| 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. |
Response message for chunk retrieval.
| Field | Type | Label | Description |
| 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. |
Request message for stopping document parsing.
Only documents currently being processed can be stopped.
| Field | Type | Label | Description |
| parent | string | Required. The agent to stop parsing for. Format: |
|
| 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 |
Status of a task.
| Field | Type | Label | Description |
| 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. |
Request message for updating an existing RAGFlow agent.
| Field | Type | Label | Description |
| parent | string | Required. The agent to update the RAGFlow agent for. Format: |
|
| agent_id | string | Required. ID of the RAGFlow agent to update. |
|
| avatar | string | Optional. Base64-encoded icon in the format |
|
| title | string | Optional. Maximum length 255. Unique agent title. Must be unique within the project. |
|
| permission | RagPermission | optional | Optional. Default |
| 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. |
Request message for updating an existing chat assistant.
| Field | Type | Label | Description |
| parent | string | Required. The agent containing the chat assistant to update. Format: |
|
| 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 |
|
| 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. |
Request message for updating an existing chat session.
| Field | Type | Label | Description |
| parent | string | Required. The agent containing the chat session to update. Format: |
|
| 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. |
Request message for updating an existing chunk's content and metadata.
Content changes trigger re-tokenization and re-generation of embeddings.
| Field | Type | Label | Description |
| parent | string | Required. The agent to update the chunk for. Format: |
|
| 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. |
Request message for updating an existing dataset.
The same field constraints as for RagCreateDatasetRequest apply here.
| Field | Type | Label | Description |
| parent | string | Required. The agent to update the dataset for. Format: |
|
| 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. |
Request message for updating an existing document's metadata and configuration.
| Field | Type | Label | Description |
| parent | string | Required. The agent to update the document for. Format: |
|
| 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 |
| 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). |
Upload chunk for streaming uploads.
Used to stream file data after metadata is sent in first message.
| Field | Type | Label | Description |
| 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. |
Request message for uploading documents to a dataset.
Documents are uploaded via streaming multipart form data.
| Field | Type | Label | Description |
| metadata | RagUploadDocumentsRequest.RagMetadata | First message: declares all files to be uploaded. |
|
| chunk | RagUploadChunk | Subsequent messages: stream file data chunks. |
Metadata for the upload (first message only).
| Field | Type | Label | Description |
| parent | string | Required. The agent to upload documents for. Format: |
|
| dataset_id | string | Required. Target dataset ID to upload documents to. |
|
| files | RagFileMetadata | repeated | Required. Metadata for all files being uploaded in this stream. |
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.
| Field | Type | Label | Description |
| metadata | RagUploadFilesRequest.RagMetadata | First message: declares all files to be uploaded. |
|
| chunk | RagUploadChunk | Subsequent messages: stream file data in chunks. |
Metadata for the upload operation (must be sent in first message only).
| Field | Type | Label | Description |
| parent | string | Required. The agent to upload files for. Format: |
|
| 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. |
Agent completion event type.
| Name | Number | Description |
| message | 0 | Regular message event. |
| message_end | 1 | Message completion event. |
Agent canvas category.
| Name | Number | Description |
| agent_canvas | 0 | agent canvas |
| dataflow_canvas | 1 | dataflow canvas |
Chunking method for documents. See https://ragflow.io/docs/dev/configure_knowledge_base#select-chunking-method for details.
| Name | Number | Description |
| naive | 0 | General (default). |
| book | 1 | Book. |
| 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. |
Available file types for file creation.
| Name | Number | Description |
| virtual | 0 | virtual file |
| folder | 1 | folder |
Document processing status.
| Name | Number | Description |
| 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. |
Knowledge graph construction methods.
| Name | Number | Description |
| light | 0 | Use prompts provided by LightRAG. |
| general | 1 | Use prompts provided by GraphRAG. |
Role of message sender in conversation.
| Name | Number | Description |
| user | 0 | Message from user. |
| assistant | 1 | Message from AI assistant. |
| system | 2 | System message. |
Access permissions for a dataset.
| Name | Number | Description |
| me | 0 | Only the current user can manage the dataset (default). |
| team | 1 | All team members of the current user can manage the dataset. |
Chat assistant prompt type.
| Name | Number | Description |
| simple | 0 | simple |
| advanced | 1 | advanced |
Session source
| Name | Number | Description |
| none | 0 | none |
| agent | 1 | agent |
| dialog | 2 | dialog |
Server project statistics
rpc GetProjectCount (.google.protobuf.Empty) returns (StatResponse)Returns the count of projects in the CAI server
rpc GetUserProjectCount (GetUserProjectCountRequest) returns (StatResponse)Returns the count of projects of a user
rpc GetUserCount (.google.protobuf.Empty) returns (StatResponse)Returns the users count within a project
| Method Name | Method | Pattern | Body |
| GetProjectCount | GET | /projects:count | |
| GetUserProjectCount | GET | /users/{user_identifier=*}/projects:count | |
| GetUserCount | GET | /users:count |
Request to get user project count
| Field | Type | Label | Description |
| user_id | string | Required. The ID of the User to count the projects from |
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.
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.
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).
rpc ListSessions (ListSessionsRequest) returns (ListSessionsResponse)ListSessions: returns list of sessions from ondewo-kb; by default returns only session IDs
rpc GetSession (GetSessionRequest) returns (Session)GetSession: returns a session(=conversation) from ondewo-kb
rpc CreateSession (CreateSessionRequest) returns (Session)CreateSession: creates and returns a session(=conversation) from ondewo-kb
rpc CreateSessionStep (CreateSessionStepRequest) returns (SessionStep)CreateSessionStep: creates a new session step for a session
rpc GetSessionStep (GetSessionStepRequest) returns (SessionStep)GetSessionStep: gets an existing session step of a session
rpc UpdateSessionStep (UpdateSessionStepRequest) returns (SessionStep)UpdateSessionStep: updates an existing session step in a session
rpc DeleteSessionStep (DeleteSessionStepRequest) returns (.google.protobuf.Empty)DeleteSessionStep: deletes an existing session step from the session
rpc DeleteSession (DeleteSessionRequest) returns (.google.protobuf.Empty)DeleteSession: delete a session(=conversation) from ondewo-kb (for testing only)
rpc ListSessionLabels (ListSessionLabelsRequest) returns (ListSessionLabelsResponse)
rpc ListSessionLabelsOfAllSessions (ListSessionLabelsOfAllSessionsRequest) returns (ListSessionLabelsResponse)
rpc ListLanguageCodesOfAllSessions (ListLanguageCodesOfAllSessionsRequest) returns (ListLanguageCodesResponse)
rpc ListMatchedIntentsOfAllSessions (ListMatchedIntentsOfAllSessionsRequest) returns (ListMatchedIntentsResponse)
rpc ListMatchedEntityTypesOfAllSessions (ListMatchedEntityTypesOfAllSessionsRequest) returns (ListMatchedEntityTypesResponse)
rpc ListUserIdsOfAllSessions (ListUserIdsOfAllSessionsRequest) returns (ListUserIdsResponse)
rpc ListIdentifiedUserIdsOfAllSessions (ListIdentifiedUserIdsOfAllSessionsRequest) returns (ListIdentifiedUserIdsResponse)
rpc ListTagsOfAllSessions (ListTagsOfAllSessionsRequest) returns (ListTagsResponse)
rpc ListInputContextsOfAllSessions (ListInputContextsOfAllSessionsRequest) returns (ListInputContextsResponse)
rpc ListOutputContextsOfAllSessions (ListOutputContextsOfAllSessionsRequest) returns (ListOutputContextsResponse)
rpc ListPlatformsOfAllSessions (ListPlatformsOfAllSessionsRequest) returns (ListPlatformsResponse)
rpc ListAccountIdsOfAllSessions (ListAccountIdsOfAllSessionsRequest) returns (ListAccountIdsResponse)
rpc ListPropertyIdsOfAllSessions (ListPropertyIdsOfAllSessionsRequest) returns (ListPropertyIdsResponse)
rpc ListDatastreamIdsOfAllSessions (ListDatastreamIdsOfAllSessionsRequest) returns (ListDatastreamIdsResponse)
rpc ListOriginIdsOfAllSessions (ListOriginIdsOfAllSessionsRequest) returns (ListOriginIdsResponse)
rpc AddSessionLabels (AddSessionLabelsRequest) returns (Session)
rpc DeleteSessionLabels (DeleteSessionLabelsRequest) returns (Session)
rpc AddSessionComment (AddSessionCommentRequest) returns (Comment)
rpc DeleteSessionComments (DeleteSessionCommentsRequest) returns (Session)
rpc UpdateSessionComments (UpdateSessionCommentsRequest) returns (Session)
rpc ListSessionComments (ListSessionCommentsRequest) returns (ListSessionCommentsResponse)
rpc ListSessionReviews (ListSessionReviewsRequest) returns (ListSessionReviewsResponse)ListSessionReviews: returns list of session reviews from ondewo-kb; by default only returns session review IDs
rpc GetSessionReview (GetSessionReviewRequest) returns (SessionReview)GetSessionReview: returns a session-review from ondewo-kb or computes the first review if none exists
rpc GetLatestSessionReview (GetLatestSessionReviewRequest) returns (SessionReview)GetLatestSessionReview: returns a session-review from ondewo-kb or computes the first review if none exists
rpc CreateSessionReview (CreateSessionReviewRequest) returns (SessionReview)CreateSessionReview: persist a session review in ondewo-kb as a side effect: also update training data in ondewo-cai
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.
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.
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.
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.
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.
| 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 | * |
This message is a request to add the audio files specified
| Field | Type | Label | Description |
| parent | string | Required. The project of this agent. Format: |
|
| session_id | string | The unique identifier of the session for which the audio files should be listed Format: |
|
| 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: |
This message is a request to add the audio files specified
| Field | Type | Label | Description |
| audio_file_resources | AudioFileResource | repeated | The unique identifier of the audio files for a specific session. Format: |
| error_message | string | error message if there are any. |
This message is a request to add a comment to a session
| Field | Type | Label | Description |
| session_id | string | The id of the session |
|
| comment | Comment | The comment to add to the session |
This message is a request to add session labels
| Field | Type | Label | Description |
| session_id | string | The id of the session |
|
| labels | string | repeated | The labels to add to the session |
| Field | Type | Label | Description |
| name | string | The unique identifier of the session for which the latest review should be returned Format: |
|
| 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 |
Message used to filter sessions based on contextual information
| Field | Type | Label | Description |
| 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 |
This message is a request to create a session
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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. |
| Field | Type | Label | Description |
| session_id | string | The unique identifier for the session under review Format: |
|
| parent_review_id | string | Optional: The unique identifier of the parent review Format: |
|
| 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 stores a session step into the session
| Field | Type | Label | Description |
| session_id | string | The unique identifier for the given review Format: . |
|
| 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. |
This message is a request to the delete audio files specified
| Field | Type | Label | Description |
| parent | string | Required. The project of this agent. Format: |
|
| names | string | repeated | The unique identifier of the audio file of the specific session Format: |
This message is a request to the delete audio files specified
| Field | Type | Label | Description |
| names | string | repeated | The unique identifier of the audio file of the specific session Format: |
| error_message | string | error message if there are any. |
This message is a request to delete a session comment
| Field | Type | Label | Description |
| session_id | string | The id of the session |
|
| comment_names | string | repeated | The comment names to delete from the session |
This message is a request to delete session labels
| Field | Type | Label | Description |
| session_id | string | The id of the session |
|
| labels | string | repeated | The labels to delete from the session |
This message is a request to delete a session
| Field | Type | Label | Description |
| session_id | string | Required. The session to be deleted Format: |
This message is a request to delete a session step of a session
| Field | Type | Label | Description |
| name | string | The unique identifier for the given session step Format: . |
The request to detect user's intent.
| Field | Type | Label | Description |
| session | string | Required. The name of the session this query is sent to. Format:
|
|
| query_params | QueryParameters | Optional. The parameters of this query. |
|
| query_input | QueryInput | Required. The input specification. It can be set to:
|
|
| input_audio | bytes | Optional. The natural language speech audio to be processed. This field
should be populated iff |
The message returned from the DetectIntent method.
| Field | Type | Label | Description |
| 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. |
This message contains a detected intent
| Field | Type | Label | Description |
| 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:
|
Represents a document file resource (e.g., text, markdown, PDF, DOCX).
| Field | Type | Label | Description |
| name | string | The unique identifier for the document file resource. Format: |
|
| 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. |
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?".
| Field | Type | Label | Description |
| 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. |
Represents a file resource that can either be an image, audio, document, or video file.
| Field | Type | Label | Description |
| 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. |
This message is a request to get one one file combining all audios of a specific session
| Field | Type | Label | Description |
| parent | string | Required. The project of this agent. Format: |
|
| session_id | string | The unique identifier of the session for which the audio files should be combined Format: |
|
| 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. |
This message is a request to get audio files specified
| Field | Type | Label | Description |
| parent | string | Required. The project of this agent. Format: |
|
| names | string | repeated | The unique identifier of the audio file of the specific session Format: |
| 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:
|
|
| sorting_mode | SortingMode | sorting mode |
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
This message is a request to retrieve the audio files specified
| Field | Type | Label | Description |
| audio_files | AudioFileResource | repeated | The unique identifier of the audio file for a specific session. Format: |
| 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 |
This message is a request to get latest session review
| Field | Type | Label | Description |
| session_id | string | The unique identifier of the session for which the latest review should be returned Format: |
|
| 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. |
This message is a request to get a session
| Field | Type | Label | Description |
| session_id | string | The session to be returned Format: |
|
| 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"] |
This message is a request to get session review
| Field | Type | Label | Description |
| 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. |
This message is a request to get a session step
| Field | Type | Label | Description |
| name | string | The unique identifier for the given session step Format: |
|
| 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"] |
| Field | Type | Label | Description |
| name | string | The unique identifier of the session for which the latest review should be returned Format: |
|
| 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. |
Instructs the speech recognizer how to process the audio content.
| Field | Type | Label | Description |
| 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. |
request to list all account_ids of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the account_ids for all sessions should be listed Format: |
|
| 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. |
This message is a response of listing session account_ids
| Field | Type | Label | Description |
| account_ids | string | repeated | The account_ids of the session |
This message is a request to list all available audio files of a session
| Field | Type | Label | Description |
| parent | string | Required. The project of this agent. Format: |
|
| session_id | string | Optional: The unique identifier of the session for which the audio files should be listed Format: |
|
| 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:
|
|
| sorting_mode | SortingMode | sorting mode |
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
This message is a request to retrieve the audio files specified
| Field | Type | Label | Description |
| audio_files | AudioFileResource | repeated | The requested audio files . Format: |
| 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. |
request to list all datastream_ids of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the datastream_ids for all sessions should be listed Format: |
|
| session_filter | SessionFilter | Optional. A filter to narrow the response down to sessions of interest. |
This message is a response of listing session datastream_ids
| Field | Type | Label | Description |
| datastream_ids | string | repeated | The datastream_ids of the session |
request to list all identified_user_ids of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the identified_user_ids for all sessions should be listed Format: |
|
| 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. |
This message is a response of listing session identified_user_ids
| Field | Type | Label | Description |
| identified_user_ids | string | repeated | The identified_user_ids of the session |
request to list all input_contexts of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the input_contexts for all sessions should be listed Format: |
|
| 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. |
This message is a response of listing session input_contexts
| Field | Type | Label | Description |
| input_contexts | string | repeated | The input_contexts ids of the session |
request to list all language codes of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the language_codes for all sessions should be listed Format: |
|
| 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. |
This message is a response of listing session language_codes
| Field | Type | Label | Description |
| language_codes | string | repeated | The language_codes of the session |
request to list all matched_entity_types of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the matched_entity_types for all sessions should be listed Format: |
|
| 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. |
This message is a response of listing session matched_entity_types
| Field | Type | Label | Description |
| matched_entity_types | string | repeated | The matched_entity_types of the session |
request to list all matched_intents of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the matched_intents for all sessions should be listed Format: |
|
| 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. |
This message is a response of listing session matched_intents
| Field | Type | Label | Description |
| matched_intents | string | repeated | The matched_intents of the session |
request to list all origin_ids of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the origin_ids for all sessions should be listed Format: |
|
| 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. |
This message is a response of listing session origin_ids
| Field | Type | Label | Description |
| origin_ids | string | repeated | The origin_ids of the session |
request to list all output_contexts of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the output_contexts for all sessions should be listed Format: |
|
| 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. |
This message is a response of listing session output_contexts
| Field | Type | Label | Description |
| output_contexts | string | repeated | The output_contexts ids of the session |
request to list all labels of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the platforms for all sessions should be listed Format: |
|
| 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. |
This message is a response of listing session platforms
| Field | Type | Label | Description |
| platforms | string | repeated | The platforms of the session |
request to list all property_ids of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the property_ids for all sessions should be listed Format: |
|
| session_filter | SessionFilter | Optional. A filter to narrow the response down to sessions of interest. |
This message is a response of listing session property_ids
| Field | Type | Label | Description |
| property_ids | string | repeated | The property_ids of the session |
This message is a request to list comments of a session
| Field | Type | Label | Description |
| session_id | string | The unique identifier for the session for which reviews should be listed Format: |
|
| 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:
|
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
This message is a request to list comments of a session
| Field | Type | Label | Description |
| comment | Comment | repeated | The comments of a specific session Format: |
| 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:
|
request to list all labels of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the labels for all sessions should be listed Format: |
|
| 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. |
This message is a request to list session labels
| Field | Type | Label | Description |
| session_id | string | The id of the session |
This message is a response of listing session labels
| Field | Type | Label | Description |
| labels | string | repeated | The labels of the session |
This message is a request to list session reviews
| Field | Type | Label | Description |
| session_id | string | The unique identifier for the session for which reviews should be listed Format: |
|
| 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:
|
This message is a response of listing session reviews
| Field | Type | Label | Description |
| 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 |
This message is a request to list sessions
| Field | Type | Label | Description |
| parent | string | Required. The project that the agent to fetch is associated with. Format: |
|
| 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:
|
|
| 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"] |
This message is a response including the listing of sessions
| Field | Type | Label | Description |
| 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 |
request to list all tags of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the tags for all sessions should be listed Format: |
|
| 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. |
This message is a response of listing session tags
| Field | Type | Label | Description |
| tags | string | repeated | The tags of the session |
request to list all user_ids of all sessions
| Field | Type | Label | Description |
| parent | string | The parent for which the user_ids for all sessions should be listed Format: |
|
| 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. |
This message is a response of listing session user_ids
| Field | Type | Label | Description |
| user_ids | string | repeated | The user_ids of the session |
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.
| Field | Type | Label | Description |
| 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. |
Represents the parameters of the conversational query.
| Field | Type | Label | Description |
| 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 language=LanguageCode.de.valuekey: timestamp
timestamp=time.time() # float python timestamp in seconds since epochkey: 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.OndewoWeightedEnsemblekey: single_ner_algorithm
single_ner_algorithm='NerMethodType.OndewoNerRegex'
=> allowed other values for |
|
| 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
|
| 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 |
Represents the result of conversational query or event processing.
| Field | Type | Label | Description |
| query_text | string | The original conversational query text:
|
|
| 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:
|
|
| 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 |
|
| webhook_payload | google.protobuf.Struct | If the query was fulfilled by a webhook call, this field is set to the
value of the |
|
| output_contexts | Context | repeated | The collection of output contexts. If applicable,
|
| intent | Intent | The intent that matched the conversational query. Some, not
all fields are filled in this message, including but not limited to:
|
|
| 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 |
Represents a speech-to-text transcription.
| Field | Type | Label | Description |
| 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 of a user interaction
| Field | Type | Label | Description |
| name | string | The unique identifier of the session Format: |
|
| 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. |
This message contains a session filter
| Field | Type | Label | Description |
| 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 |
This message contains information about session
| Field | Type | Label | Description |
| 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 |
The list of contexts of each step collected in an outer list
| Field | Type | Label | Description |
| contexts | Context | repeated | List of contexts for a session step |
This message contains a session review
| Field | Type | Label | Description |
| name | string | The unique identifier for the given review Format: |
|
| 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. |
This message contains a session review step
| Field | Type | Label | Description |
| name | string | The unique identifier for the given review step Format: |
|
| 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 is a single user interaction as part of a session
| Field | Type | Label | Description |
| name | string | The unique identifier for the given review Format: |
|
| 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 |
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.
| Field | Type | Label | Description |
| session | string | Required. The name of the session the query is sent to.
Format of the session name:
|
|
| query_params | QueryParameters | Optional. The parameters of this query. |
|
| query_input | QueryInput | Required. The input specification. It can be set to:
|
|
| single_utterance | bool | Optional. If |
|
| input_audio | bytes | Optional. The input audio content to be recognized. Must be sent if
|
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.
| Field | Type | Label | Description |
| 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. |
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:
MESSAGE_TYPE_TRANSCRIPT: transcript and possibly is_final.MESSAGE_TYPE_END_OF_SINGLE_UTTERANCE: only event_type.| Field | Type | Label | Description |
| 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 |
|
| is_final | bool | The default of 0.0 is a sentinel value indicating |
|
| 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 |
Represents the natural language text to be processed.
| Field | Type | Label | Description |
| 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. |
This message is a request to update a session comment
| Field | Type | Label | Description |
| session_id | string | The id of the session |
|
| comment | Comment | The comment of a session to be updated |
UpdateSessionStepRequest stores a session step into the session
| Field | Type | Label | Description |
| 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"] |
Represents a video file resource (e.g., MP4, AVI).
| Field | Type | Label | Description |
| name | string | The unique identifier for the video file resource. Format: |
|
| 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. |
Audio encoding of the audio content sent in the conversational query request.
Refer to the Cloud Speech API documentation for more details.
| Name | Number | Description |
| 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 |
| 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. |
| AUDIO_ENCODING_AMR_WB | 5 | Adaptive Multi-Rate wideband codec. |
| AUDIO_ENCODING_OGG_OPUS | 6 | Opus encoded audio frames in Ogg container
(OggOpus).
|
| AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE | 7 | Although the use of lossy encodings is not recommended, if a very low
bitrate encoding is required, |
File type of an audio resource
| Name | Number | Description |
| 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 |
Type of operator to compare
| Name | Number | Description |
| 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 |
Represents the options for views of resources.
| Name | Number | Description |
| 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 |
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
| Name | Number | Description |
| 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. |
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
| Name | Number | Description |
| 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. |
Type of the response message.
| Name | Number | Description |
| 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
|
| Name | Number | Description |
| TRANSCRIPTION_TYPE_UNSPECIFIED | 0 | unspecified |
| TRANSCRIPTION_TYPE_S2T | 1 | Automatic transcription by a speech to text system |
| TRANSCRIPTION_TYPE_HUMAN | 2 | Manual human transcription |
gRPC service for managing users and server roles.
rpc CreateUser (CreateUserRequest) returns (User)Creates a user.
rpc GetUser (GetUserRequest) returns (User)Retrieves a user by identifier.
rpc GetUserInfo (GetUserRequest) returns (UserInfo)Retrieves user information by identifier.
rpc DeleteUser (GetUserRequest) returns (.google.protobuf.Empty)Deletes a user by identifier.
rpc UpdateUser (UpdateUserRequest) returns (User)Updates a user.
rpc ListUsers (ListUsersRequest) returns (ListUsersResponse)Lists users.
rpc ListUserInfos (ListUsersRequest) returns (ListUserInfosResponse)Lists user information.
rpc CreateServerRole (CreateServerRoleRequest) returns (ServerRole)Creates a server role.
rpc GetServerRole (GetServerRoleRequest) returns (ServerRole)Retrieves a server role by ID.
rpc DeleteServerRole (DeleteServerRoleRequest) returns (.google.protobuf.Empty)Deletes a server role by ID.
rpc UpdateServerRole (UpdateServerRoleRequest) returns (ServerRole)Updates a server role.
rpc ListServerRoles (ListServerRolesRequest) returns (ListServerRolesResponse)Lists server roles.
rpc ListServerPermissions (ListServerPermissionsRequest) returns (ListServerPermissionsResponse)Lists server permissions.
rpc Login (LoginRequest) returns (LoginResponse)Requests login.
rpc CheckLogin (.google.protobuf.Empty) returns (.google.protobuf.Empty)Checks login.
rpc ListNotifications (ListNotificationsRequest) returns (ListNotificationsResponse)Lists notifications based on specified filters.
rpc SetNotificationsFlaggedStatus (SetNotificationsFlaggedStatusRequest) returns (ListNotificationsResponse)Sets the flagged status for multiple notifications.
rpc SetNotificationsReadStatus (SetNotificationsReadStatusRequest) returns (ListNotificationsResponse)Sets the read status for multiple notifications.
rpc GetUserPreferences (GetUserPreferencesRequest) returns (GetUserPreferencesResponse)Retrieves user preferences based on the provided request.
rpc SetUserPreferences (SetUserPreferencesRequest) returns (SetUserPreferencesResponse)Sets or updates user preferences based on the provided request.
rpc DeleteUserPreferences (DeleteUserPreferencesRequest) returns (DeleteUserPreferencesResponse)Deletes specific user preferences based on the provided request.
rpc DeleteAllUserPreferences (DeleteAllUserPreferencesRequest) returns (DeleteUserPreferencesResponse)Deletes all user preferences for a specific user, optionally filtered by a substring.
| 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 |
Request to create server role
| Field | Type | Label | Description |
| 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 |
Request to create user
| Field | Type | Label | Description |
| user | User | user_id in the User message should be given, if empty will throw an error in the backend |
|
| password | string | password |
Request to delete all user preferences with an optional filter substring.
| Field | Type | Label | Description |
| user_name | string | The name of the user. Format: |
|
| 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: |
Request to delete server role
| Field | Type | Label | Description |
| role_id | uint32 | role is identified by role id, if empty will throw an error in the backend |
Request to delete specific user preferences.
| Field | Type | Label | Description |
| user_name | string | The name of the user. Format: |
|
| keys | string | repeated | List of keys to delete from user preferences. |
| regex_include | string | Optional: In addition to the keys specified also include all |
Response to delete specific user preferences.
| Field | Type | Label | Description |
| user_name | string | The name of the user. Format: |
|
| keys | string | repeated | List of keys to delete from user preferences. |
| error_message | string | error message if there are any. |
Request to delete user
| Field | Type | Label | Description |
| user_id | string | user is identified by user id, if empty will throw an error in the backend |
Request to get server role
| Field | Type | Label | Description |
| 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. |
Request to get user preferences.
| Field | Type | Label | Description |
| user_name | string | The name of the user. Format: |
|
| 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 |
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
Response containing user preferences.
| Field | Type | Label | Description |
| user_name | string | The name of the user. Format: |
|
| key_value_pairs | KeyValuePair | repeated | List of key-value pairs representing user preferences. |
| error_message | string | error message if there are any. |
Request to get user
| Field | Type | Label | Description |
| 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 |
Server permissions
| Field | Type | Label | Description |
| 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:
|
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
Response containing list of server permissions
| Field | Type | Label | Description |
| 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 |
Request to list server roles
| Field | Type | Label | Description |
| 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:
|
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
Response containing list of server roles
| Field | Type | Label | Description |
| 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 |
Response containing list of users
| Field | Type | Label | Description |
| 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 |
Request to list all user preferences for a specific user.
| Field | Type | Label | Description |
| user_name | string | The name of the user. Format: |
|
| 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. |
Response containing a list of user preferences for a specific user with an optional filter substring.
| Field | Type | Label | Description |
| 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. |
Request to list user
| Field | Type | Label | Description |
| 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:
|
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
Response containing list of users
| Field | Type | Label | Description |
| 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 |
Authentication messages
| Field | Type | Label | Description |
| user_email | string | user email |
|
| password | string | user password |
|
| field_mask | google.protobuf.FieldMask | optional | Optional. The mask to control which fields gets returned. |
This message is a response of logging
| Field | Type | Label | Description |
| user | User | user object - user_id must be there |
|
| auth_token | string | authentication token after successful login of the user to access NLU services |
Server Role messages
| Field | Type | Label | Description |
| 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. |
Request to set or update user preferences.
| Field | Type | Label | Description |
| user_name | string | The name of the user. Format: |
|
| key_value_pairs | KeyValuePair | repeated | List of key-value pairs to set or update. |
Response to set or update user preferences.
| Field | Type | Label | Description |
| user_name | string | The name of the user. Format: |
|
| keys | string | repeated | List of keys to delete from user preferences. |
| error_message | string | error message if there are any. |
Request to update server role
| Field | Type | Label | Description |
| 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. |
Request to update user
| Field | Type | Label | Description |
| 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. |
this message contains all the fields that required for user db
| Field | Type | Label | Description |
| 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. |
This message contains information about user
| Field | Type | Label | Description |
| 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 |
| Field | Type | Label | Description |
| key | string |
|
|
| value | ProjectRole |
|
Structure of server role
| Name | Number | Description |
| 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. |
This is collection of utility endpoints, intended to language-independent operations, such as code checks, regex checks, etc. Holds a collection of utility functions
rpc ValidateRegex (ValidateRegexRequest) returns (ValidateRegexResponse)Validates the validity of python regexes
rpc ValidateEmbeddedRegex (ValidateEmbeddedRegexRequest) returns (ValidateEmbeddedRegexResponse)Validate that entity types with group references have synonyms with capturing groups.
rpc CleanAllIntents (CleanAllIntentsRequest) returns (CleanAllIntentsResponse)Cleans all intent training phrases and entity annotations of parent
rpc CleanIntent (CleanIntentRequest) returns (CleanIntentResponse)Cleans single intent training phrases and entity annotations
rpc CleanAllEntityTypes (CleanAllEntityTypesRequest) returns (CleanAllEntityTypesResponse)Cleans all entity types of parent
rpc CleanEntityType (CleanEntityTypeRequest) returns (CleanEntityTypeResponse)Cleans entity type
rpc AddTrainingPhrases (AddTrainingPhrasesRequest) returns (AddTrainingPhrasesResponse)Creates new training phrases corresponding to intent specified by its intent display name
rpc AddTrainingPhrasesFromCSV (AddTrainingPhrasesFromCSVRequest) returns (AddTrainingPhrasesResponse)Creates new training phrases corresponding to intent specified by its intent display name from csv file
Request message to AddTrainingPhraseFromCSV rpc
| Field | Type | Label | Description |
| parent | string | Required. The agent to list all intents from. Format: |
|
| 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 |
Request message to AddTrainingPhrase rpc
| Field | Type | Label | Description |
| parent | string | Required. The agent to list all intents from. Format: |
|
| 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 |
Message that contains the new training phrase, together with the intent display name and, optionally the entity annotations
| Field | Type | Label | Description |
| 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 |
Response message to AddTrainingPhrase rpc
| Field | Type | Label | Description |
| error_messages | string | repeated | Required. If something goes wrong, error messages will be conveyed via a repeated string |
Request to clean the entity types
| Field | Type | Label | Description |
| parent | string | Required. The agent to list all intents from. Format: |
|
| 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: |
| 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: |
| 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 |
Response from entity type cleaner
| Field | Type | Label | Description |
| 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 |
The request to clean the all intents.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list all intents from. Format: |
|
| 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: |
| 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 |
Response corresponding to the CleanAllIntents Request
| Field | Type | Label | Description |
| cleaned_intents | Intent | repeated | Required. List of updates performed on intents |
| intent_update_list | IntentUpdate | repeated | Optional. List of updates applied to intents |
Request to clean a single entity type
| Field | Type | Label | Description |
| parent | string | Required. The agent to list all intents from. Format: |
|
| 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: |
| 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 |
Response from entity type cleaner
| Field | Type | Label | Description |
| cleaned_entity_type | EntityType | Required. The cleaned entity type |
|
| entity_type_update | EntityTypeUpdate | Optional. The updated entity type |
The request message to clean a single intents.
| Field | Type | Label | Description |
| parent | string | Required. The agent to list all intents from. Format: |
|
| intent_name | string | Required. The name of the intent. Format: |
|
| 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: |
| 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) |
The response message to clean a single intents.
| Field | Type | Label | Description |
| cleaned_intent | Intent | Required. Cleaned Intent |
|
| intent_update | IntentUpdate | Optional. Updates applied to intent |
Stores updates applied to an entity type
| Field | Type | Label | Description |
| entity_type_name | string | The entity type name |
|
| values_update_list | EntityTypeUpdate.EntityUpdate | repeated | List of the updated entities |
Stores updates applied to an entity
| Field | Type | Label | Description |
| entity_value_update | StringUpdate | Updates made to the entity value |
|
| entity_synonym_updates | StringUpdate | repeated | Updates made to the entity synonyms |
Stores updates applied to an intent
| Field | Type | Label | Description |
| 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 |
Message to track the updates made to a training phrase
| Field | Type | Label | Description |
| 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 |
Message to keep track of updated strings
| Field | Type | Label | Description |
| new | string | New version of the string |
|
| old | string | Old version of the string |
Options for cleaning the training phrases
| Field | Type | Label | Description |
| 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 |
Validation request for entity type values
| Field | Type | Label | Description |
| entity_type | EntityType.Entity |
|
Response of the entity type validation
| Field | Type | Label | Description |
| error_messages | string | repeated | List of error message from the validation |
The request to validate regexes.
| Field | Type | Label | Description |
| regex | string | String containing the regex. |
The response of the regex validation
| Field | Type | Label | Description |
| error_messages | string | repeated | Error messages |
Encapsulates entity re-annotation options
| Name | Number | Description |
| 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 |
service to send requests to a webhook server
rpc ResponseRefinement (WebhookRequest) returns (WebhookResponse)send a request for /response_refinement/ to the webhook server fulfillment messages can be overwritten by the webhook server
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
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
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.
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.
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.
| 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 |
The request message for Webhook.CreateSessionEntityType
| Field | Type | Label | Description |
| parent | string | Required. The agent to list all intents from. Format: |
|
| 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:
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.
Required. The project that the agent to fetch is associated with.
The session to create a session entity type for.
Format: |
The request message for Webhook.DeleteSessionEntityType.
| Field | Type | Label | Description |
| name | string | Required. The name of the entity type to delete. Format:
|
The request message for Webhook.GetSessionEntityType.
| Field | Type | Label | Description |
| name | string | Required. The name of the session entity type. Format:
|
The request message for Webhook.ListSessionEntityTypes.
| Field | Type | Label | Description |
| parent | string | Required. The session to list all session entity types from.
Format: |
|
| 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:
|
The response message for Webhook.ListSessionEntityTypes.
| Field | Type | Label | Description |
| 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 |
Represents the contents of the original request that was passed to the [Streaming]DetectIntent call.
| Field | Type | Label | Description |
| source | string | The source of this request, e.g., |
|
| payload | google.protobuf.Struct | Optional. This field is set to the value of the {
"a": {
"b": "c"
}
} |
request sent for webhook ping
| Field | Type | Label | Description |
| session | string | session ID for webhook ping |
This message is a response of pinging
| Field | Type | Label | Description |
| is_reachable | bool | This is the response message of a Ping request. It's purpose is to report the reachability of a Webhook server. |
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.
| Field | Type | Label | Description |
| name | string | Required. The unique identifier of this session entity type. Format:
|
|
| 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. |
The request message for Webhook.UpdateSessionEntityType.
| Field | Type | Label | Description |
| 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. |
The request message for a webhook call.
| Field | Type | Label | Description |
| response_id | string | The unique identifier of the response. Contains the same value as
|
|
| query_result | QueryResult | The result of the conversational query or event processing. Contains the
same value as |
|
| original_detect_intent_request | OriginalDetectIntentRequest | Optional. The contents of the original request that was passed to |
|
| session | string | The unique identifier of detectIntent request session. Can be used to identify end-user inside webhook implementation. Format: |
|
| headers | google.protobuf.Struct | Optional. The headers of the request message |
The response message for a webhook call.
| Field | Type | Label | Description |
| fulfillment_text | string | Optional. The text to be shown on the screen. This value is passed directly
to |
|
| fulfillment_messages | Intent.Message | repeated | Optional. The collection of rich messages to present to the user. This
value is passed directly to |
| source | string | Optional. This value is passed directly to |
|
| payload | google.protobuf.Struct | Optional. This value is passed directly to {
"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 |
| followup_event_input | EventInput | Optional. Makes the platform immediately invoke another |
|
| 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 |
The types of modifications for a session entity type.
| Name | Number | Description |
| 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 |
gRPC service for QA functionalities.
rpc GetAnswer (GetAnswerRequest) returns (GetAnswerResponse)Retrieves an answer based on the provided request.
rpc RunScraper (RunScraperRequest) returns (RunScraperResponse)Runs a web scraper job for specified project IDs.
rpc UpdateDatabase (UpdateDatabaseRequest) returns (UpdateDatabaseResponse)Updates the database for specified project IDs.
rpc RunTraining (.google.protobuf.Empty) returns (RunTrainingResponse)Runs a training job for the QA system.
rpc GetServerState (.google.protobuf.Empty) returns (GetServerStateResponse)Retrieves the server state for QA.
rpc ListProjectIds (.google.protobuf.Empty) returns (ListProjectIdsResponse)Lists project IDs associated with QA.
rpc GetProjectConfig (GetProjectConfigRequest) returns (GetProjectConfigResponse)Retrieves the configuration of a specific project.
| 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 |
The request message
| Field | Type | Label | Description |
| session_id | string | Required. The name of the session this query is sent to. Format:
|
|
| 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. |
Message containing the response for retrieving answers.
| Field | Type | Label | Description |
| query_result | ondewo.nlu.DetectIntentResponse | The results of the conversational query or event processing. |
Message for requesting the configuration of a specific project.
| Field | Type | Label | Description |
| project_id | string | The ID of the project for which to retrieve the configuration. |
Message containing the response for getting the configuration of a project.
| Field | Type | Label | Description |
| config_serialized | string | Serialized configuration of the project. |
Message containing the response for checking the server state.
| Field | Type | Label | Description |
| server_is_ready | bool | Indicates whether the server is ready to accept requests. |
Message for listing project IDs in the response.
| Field | Type | Label | Description |
| project_ids | string | repeated | List of project IDs. |
Message for running a web scraper job.
| Field | Type | Label | Description |
| project_ids | string | repeated | List of project IDs to run the scraper on. |
Message containing the response for running a web scraper job.
| Field | Type | Label | Description |
| scraper_containers | RunScraperResponse.ScraperContainer | repeated | List of scraper containers running the jobs. |
Message representing a scraper container.
| Field | Type | Label | Description |
| container_name | string | Name of the Docker container running the job. |
|
| container_id | string | ID of the Docker container running the scraping job. |
Message containing the response for running a training job.
| Field | Type | Label | Description |
| f1 | float | F1 score as a response of the training. |
|
| accuracy | float | Accuracy as a response of the training. |
Message for requesting a database update for specific projects.
| Field | Type | Label | Description |
| project_ids | string | repeated | List of project IDs for which to update the database. |
Message containing the response for updating the database of specific projects.
| Field | Type | Label | Description |
| error_messages | string | repeated | List of error messages encountered during the database update. |
Message for defining URL filters to include and exclude from the scraping process.
| Field | Type | Label | Description |
| allowed_values | string | repeated | Optional. List of allowed values for the metadata field |
| 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. |
| .proto Type | Notes | C++ | Java | Python | Go | C# | PHP | Ruby |
| 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) |