google-cloud-discovery_engine-v1beta 0.20.1 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/client.rb +27 -7
  3. data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/rest/client.rb +27 -7
  4. data/lib/google/cloud/discovery_engine/v1beta/rest.rb +1 -0
  5. data/lib/google/cloud/discovery_engine/v1beta/search_service/client.rb +16 -28
  6. data/lib/google/cloud/discovery_engine/v1beta/search_service/rest/client.rb +16 -28
  7. data/lib/google/cloud/discovery_engine/v1beta/session_service/client.rb +920 -0
  8. data/lib/google/cloud/discovery_engine/v1beta/session_service/credentials.rb +47 -0
  9. data/lib/google/cloud/discovery_engine/v1beta/session_service/paths.rb +330 -0
  10. data/lib/google/cloud/discovery_engine/v1beta/session_service/rest/client.rb +859 -0
  11. data/lib/google/cloud/discovery_engine/v1beta/session_service/rest/service_stub.rb +462 -0
  12. data/lib/google/cloud/discovery_engine/v1beta/session_service/rest.rb +52 -0
  13. data/lib/google/cloud/discovery_engine/v1beta/session_service.rb +55 -0
  14. data/lib/google/cloud/discovery_engine/v1beta/version.rb +1 -1
  15. data/lib/google/cloud/discovery_engine/v1beta.rb +1 -0
  16. data/lib/google/cloud/discoveryengine/v1beta/conversational_search_service_pb.rb +1 -1
  17. data/lib/google/cloud/discoveryengine/v1beta/session_pb.rb +3 -1
  18. data/lib/google/cloud/discoveryengine/v1beta/session_service_pb.rb +49 -0
  19. data/lib/google/cloud/discoveryengine/v1beta/session_service_services_pb.rb +64 -0
  20. data/proto_docs/google/cloud/discoveryengine/v1beta/conversational_search_service.rb +26 -5
  21. data/proto_docs/google/cloud/discoveryengine/v1beta/search_service.rb +8 -14
  22. data/proto_docs/google/cloud/discoveryengine/v1beta/session.rb +38 -4
  23. metadata +10 -1
@@ -16,7 +16,7 @@ require 'google/protobuf/empty_pb'
16
16
  require 'google/protobuf/field_mask_pb'
17
17
 
18
18
 
19
- descriptor_data = "\nGgoogle/cloud/discoveryengine/v1beta/conversational_search_service.proto\x12#google.cloud.discoveryengine.v1beta\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x30google/cloud/discoveryengine/v1beta/answer.proto\x1a\x36google/cloud/discoveryengine/v1beta/conversation.proto\x1a\x38google/cloud/discoveryengine/v1beta/search_service.proto\x1a\x31google/cloud/discoveryengine/v1beta/session.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\"\xb1\x05\n\x1b\x43onverseConversationRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+discoveryengine.googleapis.com/Conversation\x12\x42\n\x05query\x18\x02 \x01(\x0b\x32..google.cloud.discoveryengine.v1beta.TextInputB\x03\xe0\x41\x02\x12I\n\x0eserving_config\x18\x03 \x01(\tB1\xfa\x41.\n,discoveryengine.googleapis.com/ServingConfig\x12G\n\x0c\x63onversation\x18\x05 \x01(\x0b\x32\x31.google.cloud.discoveryengine.v1beta.Conversation\x12\x13\n\x0bsafe_search\x18\x06 \x01(\x08\x12\x65\n\x0buser_labels\x18\x07 \x03(\x0b\x32P.google.cloud.discoveryengine.v1beta.ConverseConversationRequest.UserLabelsEntry\x12\x66\n\x0csummary_spec\x18\x08 \x01(\x0b\x32P.google.cloud.discoveryengine.v1beta.SearchRequest.ContentSearchSpec.SummarySpec\x12\x0e\n\x06\x66ilter\x18\t \x01(\t\x12P\n\nboost_spec\x18\n \x01(\x0b\x32<.google.cloud.discoveryengine.v1beta.SearchRequest.BoostSpec\x1a\x31\n\x0fUserLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x97\x02\n\x1c\x43onverseConversationResponse\x12\x39\n\x05reply\x18\x01 \x01(\x0b\x32*.google.cloud.discoveryengine.v1beta.Reply\x12G\n\x0c\x63onversation\x18\x02 \x01(\x0b\x32\x31.google.cloud.discoveryengine.v1beta.Conversation\x12\x19\n\x11related_questions\x18\x06 \x03(\t\x12X\n\x0esearch_results\x18\x03 \x03(\x0b\x32@.google.cloud.discoveryengine.v1beta.SearchResponse.SearchResult\"\xab\x01\n\x19\x43reateConversationRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(discoveryengine.googleapis.com/DataStore\x12L\n\x0c\x63onversation\x18\x02 \x01(\x0b\x32\x31.google.cloud.discoveryengine.v1beta.ConversationB\x03\xe0\x41\x02\"\x9a\x01\n\x19UpdateConversationRequest\x12L\n\x0c\x63onversation\x18\x01 \x01(\x0b\x32\x31.google.cloud.discoveryengine.v1beta.ConversationB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\"^\n\x19\x44\x65leteConversationRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+discoveryengine.googleapis.com/Conversation\"[\n\x16GetConversationRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+discoveryengine.googleapis.com/Conversation\"\xa5\x01\n\x18ListConversationsRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(discoveryengine.googleapis.com/DataStore\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t\x12\x10\n\x08order_by\x18\x05 \x01(\t\"~\n\x19ListConversationsResponse\x12H\n\rconversations\x18\x01 \x03(\x0b\x32\x31.google.cloud.discoveryengine.v1beta.Conversation\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\xc5&\n\x12\x41nswerQueryRequest\x12L\n\x0eserving_config\x18\x01 \x01(\tB4\xe0\x41\x02\xfa\x41.\n,discoveryengine.googleapis.com/ServingConfig\x12>\n\x05query\x18\x02 \x01(\x0b\x32*.google.cloud.discoveryengine.v1beta.QueryB\x03\xe0\x41\x02\x12<\n\x07session\x18\x03 \x01(\tB+\xfa\x41(\n&discoveryengine.googleapis.com/Session\x12W\n\x0bsafety_spec\x18\x04 \x01(\x0b\x32\x42.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SafetySpec\x12l\n\x16related_questions_spec\x18\x05 \x01(\x0b\x32L.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.RelatedQuestionsSpec\x12\x62\n\x0egrounding_spec\x18\x06 \x01(\x0b\x32\x45.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.GroundingSpecB\x03\xe0\x41\x01\x12l\n\x16\x61nswer_generation_spec\x18\x07 \x01(\x0b\x32L.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.AnswerGenerationSpec\x12W\n\x0bsearch_spec\x18\x08 \x01(\x0b\x32\x42.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec\x12p\n\x18query_understanding_spec\x18\t \x01(\x0b\x32N.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.QueryUnderstandingSpec\x12\x1d\n\x11\x61synchronous_mode\x18\n \x01(\x08\x42\x02\x18\x01\x12\x16\n\x0euser_pseudo_id\x18\x0c \x01(\t\x12\\\n\x0buser_labels\x18\r \x03(\x0b\x32G.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.UserLabelsEntry\x1a\x1c\n\nSafetySpec\x12\x0e\n\x06\x65nable\x18\x01 \x01(\x08\x1a&\n\x14RelatedQuestionsSpec\x12\x0e\n\x06\x65nable\x18\x01 \x01(\x08\x1a\x92\x02\n\rGroundingSpec\x12\'\n\x1ainclude_grounding_supports\x18\x02 \x01(\x08\x42\x03\xe0\x41\x01\x12r\n\x0f\x66iltering_level\x18\x03 \x01(\x0e\x32T.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.GroundingSpec.FilteringLevelB\x03\xe0\x41\x01\"d\n\x0e\x46ilteringLevel\x12\x1f\n\x1b\x46ILTERING_LEVEL_UNSPECIFIED\x10\x00\x12\x17\n\x13\x46ILTERING_LEVEL_LOW\x10\x01\x12\x18\n\x14\x46ILTERING_LEVEL_HIGH\x10\x02\x1a\xab\x04\n\x14\x41nswerGenerationSpec\x12j\n\nmodel_spec\x18\x01 \x01(\x0b\x32V.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.AnswerGenerationSpec.ModelSpec\x12l\n\x0bprompt_spec\x18\x02 \x01(\x0b\x32W.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.AnswerGenerationSpec.PromptSpec\x12\x19\n\x11include_citations\x18\x03 \x01(\x08\x12\x1c\n\x14\x61nswer_language_code\x18\x04 \x01(\t\x12 \n\x18ignore_adversarial_query\x18\x05 \x01(\x08\x12\'\n\x1fignore_non_answer_seeking_query\x18\x06 \x01(\x08\x12(\n\x1bignore_low_relevant_content\x18\x07 \x01(\x08H\x00\x88\x01\x01\x12\'\n\x1aignore_jail_breaking_query\x18\x08 \x01(\x08\x42\x03\xe0\x41\x01\x1a\"\n\tModelSpec\x12\x15\n\rmodel_version\x18\x01 \x01(\t\x1a\x1e\n\nPromptSpec\x12\x10\n\x08preamble\x18\x01 \x01(\tB\x1e\n\x1c_ignore_low_relevant_content\x1a\x9c\x12\n\nSearchSpec\x12h\n\rsearch_params\x18\x01 \x01(\x0b\x32O.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchParamsH\x00\x12q\n\x12search_result_list\x18\x02 \x01(\x0b\x32S.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultListH\x00\x1a\x80\x04\n\x0cSearchParams\x12\x1a\n\x12max_return_results\x18\x01 \x01(\x05\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12P\n\nboost_spec\x18\x03 \x01(\x0b\x32<.google.cloud.discoveryengine.v1beta.SearchRequest.BoostSpec\x12\x10\n\x08order_by\x18\x04 \x01(\t\x12q\n\x12search_result_mode\x18\x05 \x01(\x0e\x32U.google.cloud.discoveryengine.v1beta.SearchRequest.ContentSearchSpec.SearchResultMode\x12Z\n\x10\x64\x61ta_store_specs\x18\x07 \x03(\x0b\x32@.google.cloud.discoveryengine.v1beta.SearchRequest.DataStoreSpec\x12\x90\x01\n)natural_language_query_understanding_spec\x18\x08 \x01(\x0b\x32X.google.cloud.discoveryengine.v1beta.SearchRequest.NaturalLanguageQueryUnderstandingSpecB\x03\xe0\x41\x01\x1a\xa4\x0c\n\x10SearchResultList\x12x\n\x0esearch_results\x18\x01 \x03(\x0b\x32`.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult\x1a\x95\x0b\n\x0cSearchResult\x12\x9f\x01\n\x1aunstructured_document_info\x18\x01 \x01(\x0b\x32y.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult.UnstructuredDocumentInfoH\x00\x12\x80\x01\n\nchunk_info\x18\x02 \x01(\x0b\x32j.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult.ChunkInfoH\x00\x1a\xb2\x06\n\x18UnstructuredDocumentInfo\x12>\n\x08\x64ocument\x18\x01 \x01(\tB,\xfa\x41)\n\'discoveryengine.googleapis.com/Document\x12\x0b\n\x03uri\x18\x02 \x01(\t\x12\r\n\x05title\x18\x03 \x01(\t\x12\xa5\x01\n\x11\x64ocument_contexts\x18\x04 \x03(\x0b\x32\x89\x01.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult.UnstructuredDocumentInfo.DocumentContext\x12\xa9\x01\n\x13\x65xtractive_segments\x18\x05 \x03(\x0b\x32\x8b\x01.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult.UnstructuredDocumentInfo.ExtractiveSegment\x12\xab\x01\n\x12\x65xtractive_answers\x18\x06 \x03(\x0b\x32\x8a\x01.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult.UnstructuredDocumentInfo.ExtractiveAnswerB\x02\x18\x01\x1a;\n\x0f\x44ocumentContext\x12\x17\n\x0fpage_identifier\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x1a=\n\x11\x45xtractiveSegment\x12\x17\n\x0fpage_identifier\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x1a<\n\x10\x45xtractiveAnswer\x12\x17\n\x0fpage_identifier\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x1a\x9f\x02\n\tChunkInfo\x12\x38\n\x05\x63hunk\x18\x01 \x01(\tB)\xfa\x41&\n$discoveryengine.googleapis.com/Chunk\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x12\x96\x01\n\x11\x64ocument_metadata\x18\x04 \x01(\x0b\x32{.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult.ChunkInfo.DocumentMetadata\x1a.\n\x10\x44ocumentMetadata\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12\r\n\x05title\x18\x02 \x01(\tB\t\n\x07\x63ontentB\x07\n\x05input\x1a\x8e\x05\n\x16QueryUnderstandingSpec\x12\x89\x01\n\x19query_classification_spec\x18\x01 \x01(\x0b\x32\x66.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.QueryUnderstandingSpec.QueryClassificationSpec\x12\x7f\n\x14query_rephraser_spec\x18\x02 \x01(\x0b\x32\x61.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.QueryUnderstandingSpec.QueryRephraserSpec\x1a\xa3\x02\n\x17QueryClassificationSpec\x12z\n\x05types\x18\x01 \x03(\x0e\x32k.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.QueryUnderstandingSpec.QueryClassificationSpec.Type\"\x8b\x01\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x15\n\x11\x41\x44VERSARIAL_QUERY\x10\x01\x12\x1c\n\x18NON_ANSWER_SEEKING_QUERY\x10\x02\x12\x17\n\x13JAIL_BREAKING_QUERY\x10\x03\x12\x1f\n\x1bNON_ANSWER_SEEKING_QUERY_V2\x10\x04\x1a\x41\n\x12QueryRephraserSpec\x12\x0f\n\x07\x64isable\x18\x01 \x01(\x08\x12\x1a\n\x12max_rephrase_steps\x18\x02 \x01(\x05\x1a\x31\n\x0fUserLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xad\x01\n\x13\x41nswerQueryResponse\x12;\n\x06\x61nswer\x18\x01 \x01(\x0b\x32+.google.cloud.discoveryengine.v1beta.Answer\x12=\n\x07session\x18\x02 \x01(\x0b\x32,.google.cloud.discoveryengine.v1beta.Session\x12\x1a\n\x12\x61nswer_query_token\x18\x03 \x01(\t\"O\n\x10GetAnswerRequest\x12;\n\x04name\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%discoveryengine.googleapis.com/Answer\"\x9c\x01\n\x14\x43reateSessionRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(discoveryengine.googleapis.com/DataStore\x12\x42\n\x07session\x18\x02 \x01(\x0b\x32,.google.cloud.discoveryengine.v1beta.SessionB\x03\xe0\x41\x02\"\x8b\x01\n\x14UpdateSessionRequest\x12\x42\n\x07session\x18\x01 \x01(\x0b\x32,.google.cloud.discoveryengine.v1beta.SessionB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\"T\n\x14\x44\x65leteSessionRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&discoveryengine.googleapis.com/Session\"Q\n\x11GetSessionRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&discoveryengine.googleapis.com/Session\"\xa0\x01\n\x13ListSessionsRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(discoveryengine.googleapis.com/DataStore\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t\x12\x10\n\x08order_by\x18\x05 \x01(\t\"o\n\x14ListSessionsResponse\x12>\n\x08sessions\x18\x01 \x03(\x0b\x32,.google.cloud.discoveryengine.v1beta.Session\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xd7)\n\x1b\x43onversationalSearchService\x12\xbf\x03\n\x14\x43onverseConversation\x12@.google.cloud.discoveryengine.v1beta.ConverseConversationRequest\x1a\x41.google.cloud.discoveryengine.v1beta.ConverseConversationResponse\"\xa1\x02\xda\x41\nname,query\x82\xd3\xe4\x93\x02\x8d\x02\"K/v1beta/{name=projects/*/locations/*/dataStores/*/conversations/*}:converse:\x01*Z^\"Y/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/conversations/*}:converse:\x01*Z[\"V/v1beta/{name=projects/*/locations/*/collections/*/engines/*/conversations/*}:converse:\x01*\x12\xba\x03\n\x12\x43reateConversation\x12>.google.cloud.discoveryengine.v1beta.CreateConversationRequest\x1a\x31.google.cloud.discoveryengine.v1beta.Conversation\"\xb0\x02\xda\x41\x13parent,conversation\x82\xd3\xe4\x93\x02\x93\x02\"B/v1beta/{parent=projects/*/locations/*/dataStores/*}/conversations:\x0c\x63onversationZ`\"P/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/conversations:\x0c\x63onversationZ]\"M/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/conversations:\x0c\x63onversation\x12\xe6\x02\n\x12\x44\x65leteConversation\x12>.google.cloud.discoveryengine.v1beta.DeleteConversationRequest\x1a\x16.google.protobuf.Empty\"\xf7\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\xe9\x01*B/v1beta/{name=projects/*/locations/*/dataStores/*/conversations/*}ZR*P/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/conversations/*}ZO*M/v1beta/{name=projects/*/locations/*/collections/*/engines/*/conversations/*}\x12\xe6\x03\n\x12UpdateConversation\x12>.google.cloud.discoveryengine.v1beta.UpdateConversationRequest\x1a\x31.google.cloud.discoveryengine.v1beta.Conversation\"\xdc\x02\xda\x41\x18\x63onversation,update_mask\x82\xd3\xe4\x93\x02\xba\x02\x32O/v1beta/{conversation.name=projects/*/locations/*/dataStores/*/conversations/*}:\x0c\x63onversationZm2]/v1beta/{conversation.name=projects/*/locations/*/collections/*/dataStores/*/conversations/*}:\x0c\x63onversationZj2Z/v1beta/{conversation.name=projects/*/locations/*/collections/*/engines/*/conversations/*}:\x0c\x63onversation\x12\xfb\x02\n\x0fGetConversation\x12;.google.cloud.discoveryengine.v1beta.GetConversationRequest\x1a\x31.google.cloud.discoveryengine.v1beta.Conversation\"\xf7\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\xe9\x01\x12\x42/v1beta/{name=projects/*/locations/*/dataStores/*/conversations/*}ZR\x12P/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/conversations/*}ZO\x12M/v1beta/{name=projects/*/locations/*/collections/*/engines/*/conversations/*}\x12\x8e\x03\n\x11ListConversations\x12=.google.cloud.discoveryengine.v1beta.ListConversationsRequest\x1a>.google.cloud.discoveryengine.v1beta.ListConversationsResponse\"\xf9\x01\xda\x41\x06parent\x82\xd3\xe4\x93\x02\xe9\x01\x12\x42/v1beta/{parent=projects/*/locations/*/dataStores/*}/conversationsZR\x12P/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/conversationsZO\x12M/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/conversations\x12\xb2\x03\n\x0b\x41nswerQuery\x12\x37.google.cloud.discoveryengine.v1beta.AnswerQueryRequest\x1a\x38.google.cloud.discoveryengine.v1beta.AnswerQueryResponse\"\xaf\x02\x82\xd3\xe4\x93\x02\xa8\x02\"T/v1beta/{serving_config=projects/*/locations/*/dataStores/*/servingConfigs/*}:answer:\x01*Zg\"b/v1beta/{serving_config=projects/*/locations/*/collections/*/dataStores/*/servingConfigs/*}:answer:\x01*Zd\"_/v1beta/{serving_config=projects/*/locations/*/collections/*/engines/*/servingConfigs/*}:answer:\x01*\x12\xf8\x02\n\tGetAnswer\x12\x35.google.cloud.discoveryengine.v1beta.GetAnswerRequest\x1a+.google.cloud.discoveryengine.v1beta.Answer\"\x86\x02\xda\x41\x04name\x82\xd3\xe4\x93\x02\xf8\x01\x12G/v1beta/{name=projects/*/locations/*/dataStores/*/sessions/*/answers/*}ZW\x12U/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/sessions/*/answers/*}ZT\x12R/v1beta/{name=projects/*/locations/*/collections/*/engines/*/sessions/*/answers/*}\x12\x88\x03\n\rCreateSession\x12\x39.google.cloud.discoveryengine.v1beta.CreateSessionRequest\x1a,.google.cloud.discoveryengine.v1beta.Session\"\x8d\x02\xda\x41\x0eparent,session\x82\xd3\xe4\x93\x02\xf5\x01\"=/v1beta/{parent=projects/*/locations/*/dataStores/*}/sessions:\x07sessionZV\"K/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/sessions:\x07sessionZS\"H/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/sessions:\x07session\x12\xcd\x02\n\rDeleteSession\x12\x39.google.cloud.discoveryengine.v1beta.DeleteSessionRequest\x1a\x16.google.protobuf.Empty\"\xe8\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\xda\x01*=/v1beta/{name=projects/*/locations/*/dataStores/*/sessions/*}ZM*K/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/sessions/*}ZJ*H/v1beta/{name=projects/*/locations/*/collections/*/engines/*/sessions/*}\x12\xa5\x03\n\rUpdateSession\x12\x39.google.cloud.discoveryengine.v1beta.UpdateSessionRequest\x1a,.google.cloud.discoveryengine.v1beta.Session\"\xaa\x02\xda\x41\x13session,update_mask\x82\xd3\xe4\x93\x02\x8d\x02\x32\x45/v1beta/{session.name=projects/*/locations/*/dataStores/*/sessions/*}:\x07sessionZ^2S/v1beta/{session.name=projects/*/locations/*/collections/*/dataStores/*/sessions/*}:\x07sessionZ[2P/v1beta/{session.name=projects/*/locations/*/collections/*/engines/*/sessions/*}:\x07session\x12\xdd\x02\n\nGetSession\x12\x36.google.cloud.discoveryengine.v1beta.GetSessionRequest\x1a,.google.cloud.discoveryengine.v1beta.Session\"\xe8\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\xda\x01\x12=/v1beta/{name=projects/*/locations/*/dataStores/*/sessions/*}ZM\x12K/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/sessions/*}ZJ\x12H/v1beta/{name=projects/*/locations/*/collections/*/engines/*/sessions/*}\x12\xf0\x02\n\x0cListSessions\x12\x38.google.cloud.discoveryengine.v1beta.ListSessionsRequest\x1a\x39.google.cloud.discoveryengine.v1beta.ListSessionsResponse\"\xea\x01\xda\x41\x06parent\x82\xd3\xe4\x93\x02\xda\x01\x12=/v1beta/{parent=projects/*/locations/*/dataStores/*}/sessionsZM\x12K/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/sessionsZJ\x12H/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/sessions\x1aR\xca\x41\x1e\x64iscoveryengine.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xa7\x02\n\'com.google.cloud.discoveryengine.v1betaB ConversationalSearchServiceProtoP\x01ZQcloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb\xa2\x02\x0f\x44ISCOVERYENGINE\xaa\x02#Google.Cloud.DiscoveryEngine.V1Beta\xca\x02#Google\\Cloud\\DiscoveryEngine\\V1beta\xea\x02&Google::Cloud::DiscoveryEngine::V1betab\x06proto3"
19
+ descriptor_data = "\nGgoogle/cloud/discoveryengine/v1beta/conversational_search_service.proto\x12#google.cloud.discoveryengine.v1beta\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x30google/cloud/discoveryengine/v1beta/answer.proto\x1a\x36google/cloud/discoveryengine/v1beta/conversation.proto\x1a\x38google/cloud/discoveryengine/v1beta/search_service.proto\x1a\x31google/cloud/discoveryengine/v1beta/session.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\"\xb1\x05\n\x1b\x43onverseConversationRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+discoveryengine.googleapis.com/Conversation\x12\x42\n\x05query\x18\x02 \x01(\x0b\x32..google.cloud.discoveryengine.v1beta.TextInputB\x03\xe0\x41\x02\x12I\n\x0eserving_config\x18\x03 \x01(\tB1\xfa\x41.\n,discoveryengine.googleapis.com/ServingConfig\x12G\n\x0c\x63onversation\x18\x05 \x01(\x0b\x32\x31.google.cloud.discoveryengine.v1beta.Conversation\x12\x13\n\x0bsafe_search\x18\x06 \x01(\x08\x12\x65\n\x0buser_labels\x18\x07 \x03(\x0b\x32P.google.cloud.discoveryengine.v1beta.ConverseConversationRequest.UserLabelsEntry\x12\x66\n\x0csummary_spec\x18\x08 \x01(\x0b\x32P.google.cloud.discoveryengine.v1beta.SearchRequest.ContentSearchSpec.SummarySpec\x12\x0e\n\x06\x66ilter\x18\t \x01(\t\x12P\n\nboost_spec\x18\n \x01(\x0b\x32<.google.cloud.discoveryengine.v1beta.SearchRequest.BoostSpec\x1a\x31\n\x0fUserLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x97\x02\n\x1c\x43onverseConversationResponse\x12\x39\n\x05reply\x18\x01 \x01(\x0b\x32*.google.cloud.discoveryengine.v1beta.Reply\x12G\n\x0c\x63onversation\x18\x02 \x01(\x0b\x32\x31.google.cloud.discoveryengine.v1beta.Conversation\x12\x19\n\x11related_questions\x18\x06 \x03(\t\x12X\n\x0esearch_results\x18\x03 \x03(\x0b\x32@.google.cloud.discoveryengine.v1beta.SearchResponse.SearchResult\"\xab\x01\n\x19\x43reateConversationRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(discoveryengine.googleapis.com/DataStore\x12L\n\x0c\x63onversation\x18\x02 \x01(\x0b\x32\x31.google.cloud.discoveryengine.v1beta.ConversationB\x03\xe0\x41\x02\"\x9a\x01\n\x19UpdateConversationRequest\x12L\n\x0c\x63onversation\x18\x01 \x01(\x0b\x32\x31.google.cloud.discoveryengine.v1beta.ConversationB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\"^\n\x19\x44\x65leteConversationRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+discoveryengine.googleapis.com/Conversation\"[\n\x16GetConversationRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+discoveryengine.googleapis.com/Conversation\"\xa5\x01\n\x18ListConversationsRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(discoveryengine.googleapis.com/DataStore\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t\x12\x10\n\x08order_by\x18\x05 \x01(\t\"~\n\x19ListConversationsResponse\x12H\n\rconversations\x18\x01 \x03(\x0b\x32\x31.google.cloud.discoveryengine.v1beta.Conversation\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\xc5&\n\x12\x41nswerQueryRequest\x12L\n\x0eserving_config\x18\x01 \x01(\tB4\xe0\x41\x02\xfa\x41.\n,discoveryengine.googleapis.com/ServingConfig\x12>\n\x05query\x18\x02 \x01(\x0b\x32*.google.cloud.discoveryengine.v1beta.QueryB\x03\xe0\x41\x02\x12<\n\x07session\x18\x03 \x01(\tB+\xfa\x41(\n&discoveryengine.googleapis.com/Session\x12W\n\x0bsafety_spec\x18\x04 \x01(\x0b\x32\x42.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SafetySpec\x12l\n\x16related_questions_spec\x18\x05 \x01(\x0b\x32L.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.RelatedQuestionsSpec\x12\x62\n\x0egrounding_spec\x18\x06 \x01(\x0b\x32\x45.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.GroundingSpecB\x03\xe0\x41\x01\x12l\n\x16\x61nswer_generation_spec\x18\x07 \x01(\x0b\x32L.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.AnswerGenerationSpec\x12W\n\x0bsearch_spec\x18\x08 \x01(\x0b\x32\x42.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec\x12p\n\x18query_understanding_spec\x18\t \x01(\x0b\x32N.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.QueryUnderstandingSpec\x12\x1d\n\x11\x61synchronous_mode\x18\n \x01(\x08\x42\x02\x18\x01\x12\x16\n\x0euser_pseudo_id\x18\x0c \x01(\t\x12\\\n\x0buser_labels\x18\r \x03(\x0b\x32G.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.UserLabelsEntry\x1a\x1c\n\nSafetySpec\x12\x0e\n\x06\x65nable\x18\x01 \x01(\x08\x1a&\n\x14RelatedQuestionsSpec\x12\x0e\n\x06\x65nable\x18\x01 \x01(\x08\x1a\x92\x02\n\rGroundingSpec\x12\'\n\x1ainclude_grounding_supports\x18\x02 \x01(\x08\x42\x03\xe0\x41\x01\x12r\n\x0f\x66iltering_level\x18\x03 \x01(\x0e\x32T.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.GroundingSpec.FilteringLevelB\x03\xe0\x41\x01\"d\n\x0e\x46ilteringLevel\x12\x1f\n\x1b\x46ILTERING_LEVEL_UNSPECIFIED\x10\x00\x12\x17\n\x13\x46ILTERING_LEVEL_LOW\x10\x01\x12\x18\n\x14\x46ILTERING_LEVEL_HIGH\x10\x02\x1a\xab\x04\n\x14\x41nswerGenerationSpec\x12j\n\nmodel_spec\x18\x01 \x01(\x0b\x32V.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.AnswerGenerationSpec.ModelSpec\x12l\n\x0bprompt_spec\x18\x02 \x01(\x0b\x32W.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.AnswerGenerationSpec.PromptSpec\x12\x19\n\x11include_citations\x18\x03 \x01(\x08\x12\x1c\n\x14\x61nswer_language_code\x18\x04 \x01(\t\x12 \n\x18ignore_adversarial_query\x18\x05 \x01(\x08\x12\'\n\x1fignore_non_answer_seeking_query\x18\x06 \x01(\x08\x12(\n\x1bignore_low_relevant_content\x18\x07 \x01(\x08H\x00\x88\x01\x01\x12\'\n\x1aignore_jail_breaking_query\x18\x08 \x01(\x08\x42\x03\xe0\x41\x01\x1a\"\n\tModelSpec\x12\x15\n\rmodel_version\x18\x01 \x01(\t\x1a\x1e\n\nPromptSpec\x12\x10\n\x08preamble\x18\x01 \x01(\tB\x1e\n\x1c_ignore_low_relevant_content\x1a\x9c\x12\n\nSearchSpec\x12h\n\rsearch_params\x18\x01 \x01(\x0b\x32O.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchParamsH\x00\x12q\n\x12search_result_list\x18\x02 \x01(\x0b\x32S.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultListH\x00\x1a\x80\x04\n\x0cSearchParams\x12\x1a\n\x12max_return_results\x18\x01 \x01(\x05\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12P\n\nboost_spec\x18\x03 \x01(\x0b\x32<.google.cloud.discoveryengine.v1beta.SearchRequest.BoostSpec\x12\x10\n\x08order_by\x18\x04 \x01(\t\x12q\n\x12search_result_mode\x18\x05 \x01(\x0e\x32U.google.cloud.discoveryengine.v1beta.SearchRequest.ContentSearchSpec.SearchResultMode\x12Z\n\x10\x64\x61ta_store_specs\x18\x07 \x03(\x0b\x32@.google.cloud.discoveryengine.v1beta.SearchRequest.DataStoreSpec\x12\x90\x01\n)natural_language_query_understanding_spec\x18\x08 \x01(\x0b\x32X.google.cloud.discoveryengine.v1beta.SearchRequest.NaturalLanguageQueryUnderstandingSpecB\x03\xe0\x41\x01\x1a\xa4\x0c\n\x10SearchResultList\x12x\n\x0esearch_results\x18\x01 \x03(\x0b\x32`.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult\x1a\x95\x0b\n\x0cSearchResult\x12\x9f\x01\n\x1aunstructured_document_info\x18\x01 \x01(\x0b\x32y.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult.UnstructuredDocumentInfoH\x00\x12\x80\x01\n\nchunk_info\x18\x02 \x01(\x0b\x32j.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult.ChunkInfoH\x00\x1a\xb2\x06\n\x18UnstructuredDocumentInfo\x12>\n\x08\x64ocument\x18\x01 \x01(\tB,\xfa\x41)\n\'discoveryengine.googleapis.com/Document\x12\x0b\n\x03uri\x18\x02 \x01(\t\x12\r\n\x05title\x18\x03 \x01(\t\x12\xa5\x01\n\x11\x64ocument_contexts\x18\x04 \x03(\x0b\x32\x89\x01.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult.UnstructuredDocumentInfo.DocumentContext\x12\xa9\x01\n\x13\x65xtractive_segments\x18\x05 \x03(\x0b\x32\x8b\x01.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult.UnstructuredDocumentInfo.ExtractiveSegment\x12\xab\x01\n\x12\x65xtractive_answers\x18\x06 \x03(\x0b\x32\x8a\x01.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult.UnstructuredDocumentInfo.ExtractiveAnswerB\x02\x18\x01\x1a;\n\x0f\x44ocumentContext\x12\x17\n\x0fpage_identifier\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x1a=\n\x11\x45xtractiveSegment\x12\x17\n\x0fpage_identifier\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x1a<\n\x10\x45xtractiveAnswer\x12\x17\n\x0fpage_identifier\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x1a\x9f\x02\n\tChunkInfo\x12\x38\n\x05\x63hunk\x18\x01 \x01(\tB)\xfa\x41&\n$discoveryengine.googleapis.com/Chunk\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x12\x96\x01\n\x11\x64ocument_metadata\x18\x04 \x01(\x0b\x32{.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.SearchSpec.SearchResultList.SearchResult.ChunkInfo.DocumentMetadata\x1a.\n\x10\x44ocumentMetadata\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12\r\n\x05title\x18\x02 \x01(\tB\t\n\x07\x63ontentB\x07\n\x05input\x1a\x8e\x05\n\x16QueryUnderstandingSpec\x12\x89\x01\n\x19query_classification_spec\x18\x01 \x01(\x0b\x32\x66.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.QueryUnderstandingSpec.QueryClassificationSpec\x12\x7f\n\x14query_rephraser_spec\x18\x02 \x01(\x0b\x32\x61.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.QueryUnderstandingSpec.QueryRephraserSpec\x1a\xa3\x02\n\x17QueryClassificationSpec\x12z\n\x05types\x18\x01 \x03(\x0e\x32k.google.cloud.discoveryengine.v1beta.AnswerQueryRequest.QueryUnderstandingSpec.QueryClassificationSpec.Type\"\x8b\x01\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x15\n\x11\x41\x44VERSARIAL_QUERY\x10\x01\x12\x1c\n\x18NON_ANSWER_SEEKING_QUERY\x10\x02\x12\x17\n\x13JAIL_BREAKING_QUERY\x10\x03\x12\x1f\n\x1bNON_ANSWER_SEEKING_QUERY_V2\x10\x04\x1a\x41\n\x12QueryRephraserSpec\x12\x0f\n\x07\x64isable\x18\x01 \x01(\x08\x12\x1a\n\x12max_rephrase_steps\x18\x02 \x01(\x05\x1a\x31\n\x0fUserLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xad\x01\n\x13\x41nswerQueryResponse\x12;\n\x06\x61nswer\x18\x01 \x01(\x0b\x32+.google.cloud.discoveryengine.v1beta.Answer\x12=\n\x07session\x18\x02 \x01(\x0b\x32,.google.cloud.discoveryengine.v1beta.Session\x12\x1a\n\x12\x61nswer_query_token\x18\x03 \x01(\t\"O\n\x10GetAnswerRequest\x12;\n\x04name\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%discoveryengine.googleapis.com/Answer\"\x9c\x01\n\x14\x43reateSessionRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(discoveryengine.googleapis.com/DataStore\x12\x42\n\x07session\x18\x02 \x01(\x0b\x32,.google.cloud.discoveryengine.v1beta.SessionB\x03\xe0\x41\x02\"\x8b\x01\n\x14UpdateSessionRequest\x12\x42\n\x07session\x18\x01 \x01(\x0b\x32,.google.cloud.discoveryengine.v1beta.SessionB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\"T\n\x14\x44\x65leteSessionRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&discoveryengine.googleapis.com/Session\"v\n\x11GetSessionRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&discoveryengine.googleapis.com/Session\x12#\n\x16include_answer_details\x18\x02 \x01(\x08\x42\x03\xe0\x41\x01\"\xa0\x01\n\x13ListSessionsRequest\x12@\n\x06parent\x18\x01 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(discoveryengine.googleapis.com/DataStore\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t\x12\x10\n\x08order_by\x18\x05 \x01(\t\"o\n\x14ListSessionsResponse\x12>\n\x08sessions\x18\x01 \x03(\x0b\x32,.google.cloud.discoveryengine.v1beta.Session\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xd7)\n\x1b\x43onversationalSearchService\x12\xbf\x03\n\x14\x43onverseConversation\x12@.google.cloud.discoveryengine.v1beta.ConverseConversationRequest\x1a\x41.google.cloud.discoveryengine.v1beta.ConverseConversationResponse\"\xa1\x02\xda\x41\nname,query\x82\xd3\xe4\x93\x02\x8d\x02\"K/v1beta/{name=projects/*/locations/*/dataStores/*/conversations/*}:converse:\x01*Z^\"Y/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/conversations/*}:converse:\x01*Z[\"V/v1beta/{name=projects/*/locations/*/collections/*/engines/*/conversations/*}:converse:\x01*\x12\xba\x03\n\x12\x43reateConversation\x12>.google.cloud.discoveryengine.v1beta.CreateConversationRequest\x1a\x31.google.cloud.discoveryengine.v1beta.Conversation\"\xb0\x02\xda\x41\x13parent,conversation\x82\xd3\xe4\x93\x02\x93\x02\"B/v1beta/{parent=projects/*/locations/*/dataStores/*}/conversations:\x0c\x63onversationZ`\"P/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/conversations:\x0c\x63onversationZ]\"M/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/conversations:\x0c\x63onversation\x12\xe6\x02\n\x12\x44\x65leteConversation\x12>.google.cloud.discoveryengine.v1beta.DeleteConversationRequest\x1a\x16.google.protobuf.Empty\"\xf7\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\xe9\x01*B/v1beta/{name=projects/*/locations/*/dataStores/*/conversations/*}ZR*P/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/conversations/*}ZO*M/v1beta/{name=projects/*/locations/*/collections/*/engines/*/conversations/*}\x12\xe6\x03\n\x12UpdateConversation\x12>.google.cloud.discoveryengine.v1beta.UpdateConversationRequest\x1a\x31.google.cloud.discoveryengine.v1beta.Conversation\"\xdc\x02\xda\x41\x18\x63onversation,update_mask\x82\xd3\xe4\x93\x02\xba\x02\x32O/v1beta/{conversation.name=projects/*/locations/*/dataStores/*/conversations/*}:\x0c\x63onversationZm2]/v1beta/{conversation.name=projects/*/locations/*/collections/*/dataStores/*/conversations/*}:\x0c\x63onversationZj2Z/v1beta/{conversation.name=projects/*/locations/*/collections/*/engines/*/conversations/*}:\x0c\x63onversation\x12\xfb\x02\n\x0fGetConversation\x12;.google.cloud.discoveryengine.v1beta.GetConversationRequest\x1a\x31.google.cloud.discoveryengine.v1beta.Conversation\"\xf7\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\xe9\x01\x12\x42/v1beta/{name=projects/*/locations/*/dataStores/*/conversations/*}ZR\x12P/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/conversations/*}ZO\x12M/v1beta/{name=projects/*/locations/*/collections/*/engines/*/conversations/*}\x12\x8e\x03\n\x11ListConversations\x12=.google.cloud.discoveryengine.v1beta.ListConversationsRequest\x1a>.google.cloud.discoveryengine.v1beta.ListConversationsResponse\"\xf9\x01\xda\x41\x06parent\x82\xd3\xe4\x93\x02\xe9\x01\x12\x42/v1beta/{parent=projects/*/locations/*/dataStores/*}/conversationsZR\x12P/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/conversationsZO\x12M/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/conversations\x12\xb2\x03\n\x0b\x41nswerQuery\x12\x37.google.cloud.discoveryengine.v1beta.AnswerQueryRequest\x1a\x38.google.cloud.discoveryengine.v1beta.AnswerQueryResponse\"\xaf\x02\x82\xd3\xe4\x93\x02\xa8\x02\"T/v1beta/{serving_config=projects/*/locations/*/dataStores/*/servingConfigs/*}:answer:\x01*Zg\"b/v1beta/{serving_config=projects/*/locations/*/collections/*/dataStores/*/servingConfigs/*}:answer:\x01*Zd\"_/v1beta/{serving_config=projects/*/locations/*/collections/*/engines/*/servingConfigs/*}:answer:\x01*\x12\xf8\x02\n\tGetAnswer\x12\x35.google.cloud.discoveryengine.v1beta.GetAnswerRequest\x1a+.google.cloud.discoveryengine.v1beta.Answer\"\x86\x02\xda\x41\x04name\x82\xd3\xe4\x93\x02\xf8\x01\x12G/v1beta/{name=projects/*/locations/*/dataStores/*/sessions/*/answers/*}ZW\x12U/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/sessions/*/answers/*}ZT\x12R/v1beta/{name=projects/*/locations/*/collections/*/engines/*/sessions/*/answers/*}\x12\x88\x03\n\rCreateSession\x12\x39.google.cloud.discoveryengine.v1beta.CreateSessionRequest\x1a,.google.cloud.discoveryengine.v1beta.Session\"\x8d\x02\xda\x41\x0eparent,session\x82\xd3\xe4\x93\x02\xf5\x01\"=/v1beta/{parent=projects/*/locations/*/dataStores/*}/sessions:\x07sessionZV\"K/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/sessions:\x07sessionZS\"H/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/sessions:\x07session\x12\xcd\x02\n\rDeleteSession\x12\x39.google.cloud.discoveryengine.v1beta.DeleteSessionRequest\x1a\x16.google.protobuf.Empty\"\xe8\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\xda\x01*=/v1beta/{name=projects/*/locations/*/dataStores/*/sessions/*}ZM*K/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/sessions/*}ZJ*H/v1beta/{name=projects/*/locations/*/collections/*/engines/*/sessions/*}\x12\xa5\x03\n\rUpdateSession\x12\x39.google.cloud.discoveryengine.v1beta.UpdateSessionRequest\x1a,.google.cloud.discoveryengine.v1beta.Session\"\xaa\x02\xda\x41\x13session,update_mask\x82\xd3\xe4\x93\x02\x8d\x02\x32\x45/v1beta/{session.name=projects/*/locations/*/dataStores/*/sessions/*}:\x07sessionZ^2S/v1beta/{session.name=projects/*/locations/*/collections/*/dataStores/*/sessions/*}:\x07sessionZ[2P/v1beta/{session.name=projects/*/locations/*/collections/*/engines/*/sessions/*}:\x07session\x12\xdd\x02\n\nGetSession\x12\x36.google.cloud.discoveryengine.v1beta.GetSessionRequest\x1a,.google.cloud.discoveryengine.v1beta.Session\"\xe8\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\xda\x01\x12=/v1beta/{name=projects/*/locations/*/dataStores/*/sessions/*}ZM\x12K/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/sessions/*}ZJ\x12H/v1beta/{name=projects/*/locations/*/collections/*/engines/*/sessions/*}\x12\xf0\x02\n\x0cListSessions\x12\x38.google.cloud.discoveryengine.v1beta.ListSessionsRequest\x1a\x39.google.cloud.discoveryengine.v1beta.ListSessionsResponse\"\xea\x01\xda\x41\x06parent\x82\xd3\xe4\x93\x02\xda\x01\x12=/v1beta/{parent=projects/*/locations/*/dataStores/*}/sessionsZM\x12K/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/sessionsZJ\x12H/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/sessions\x1aR\xca\x41\x1e\x64iscoveryengine.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xa7\x02\n\'com.google.cloud.discoveryengine.v1betaB ConversationalSearchServiceProtoP\x01ZQcloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb\xa2\x02\x0f\x44ISCOVERYENGINE\xaa\x02#Google.Cloud.DiscoveryEngine.V1Beta\xca\x02#Google\\Cloud\\DiscoveryEngine\\V1beta\xea\x02&Google::Cloud::DiscoveryEngine::V1betab\x06proto3"
20
20
 
21
21
  pool = Google::Protobuf::DescriptorPool.generated_pool
22
22
 
@@ -6,10 +6,11 @@ require 'google/protobuf'
6
6
 
7
7
  require 'google/api/field_behavior_pb'
8
8
  require 'google/api/resource_pb'
9
+ require 'google/cloud/discoveryengine/v1beta/answer_pb'
9
10
  require 'google/protobuf/timestamp_pb'
10
11
 
11
12
 
12
- descriptor_data = "\n1google/cloud/discoveryengine/v1beta/session.proto\x12#google.cloud.discoveryengine.v1beta\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xa7\x06\n\x07Session\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x05\x12\x41\n\x05state\x18\x02 \x01(\x0e\x32\x32.google.cloud.discoveryengine.v1beta.Session.State\x12\x16\n\x0euser_pseudo_id\x18\x03 \x01(\t\x12@\n\x05turns\x18\x04 \x03(\x0b\x32\x31.google.cloud.discoveryengine.v1beta.Session.Turn\x12\x33\n\nstart_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x31\n\x08\x65nd_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x1a}\n\x04Turn\x12\x39\n\x05query\x18\x01 \x01(\x0b\x32*.google.cloud.discoveryengine.v1beta.Query\x12:\n\x06\x61nswer\x18\x02 \x01(\tB*\xfa\x41\'\n%discoveryengine.googleapis.com/Answer\"/\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0f\n\x0bIN_PROGRESS\x10\x01:\xd3\x02\xea\x41\xcf\x02\n&discoveryengine.googleapis.com/Session\x12Rprojects/{project}/locations/{location}/dataStores/{data_store}/sessions/{session}\x12kprojects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/sessions/{session}\x12\x64projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}\"4\n\x05Query\x12\x0e\n\x04text\x18\x02 \x01(\tH\x00\x12\x10\n\x08query_id\x18\x01 \x01(\tB\t\n\x07\x63ontentB\x93\x02\n\'com.google.cloud.discoveryengine.v1betaB\x0cSessionProtoP\x01ZQcloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb\xa2\x02\x0f\x44ISCOVERYENGINE\xaa\x02#Google.Cloud.DiscoveryEngine.V1Beta\xca\x02#Google\\Cloud\\DiscoveryEngine\\V1beta\xea\x02&Google::Cloud::DiscoveryEngine::V1betab\x06proto3"
13
+ descriptor_data = "\n1google/cloud/discoveryengine/v1beta/session.proto\x12#google.cloud.discoveryengine.v1beta\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x30google/cloud/discoveryengine/v1beta/answer.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xd4\x08\n\x07Session\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x05\x12\x19\n\x0c\x64isplay_name\x18\x07 \x01(\tB\x03\xe0\x41\x01\x12\x41\n\x05state\x18\x02 \x01(\x0e\x32\x32.google.cloud.discoveryengine.v1beta.Session.State\x12\x16\n\x0euser_pseudo_id\x18\x03 \x01(\t\x12@\n\x05turns\x18\x04 \x03(\x0b\x32\x31.google.cloud.discoveryengine.v1beta.Session.Turn\x12\x33\n\nstart_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x31\n\x08\x65nd_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x16\n\tis_pinned\x18\x08 \x01(\x08\x42\x03\xe0\x41\x01\x1a\xe3\x02\n\x04Turn\x12>\n\x05query\x18\x01 \x01(\x0b\x32*.google.cloud.discoveryengine.v1beta.QueryB\x03\xe0\x41\x01\x12=\n\x06\x61nswer\x18\x02 \x01(\tB-\xe0\x41\x01\xfa\x41\'\n%discoveryengine.googleapis.com/Answer\x12I\n\x0f\x64\x65tailed_answer\x18\x07 \x01(\x0b\x32+.google.cloud.discoveryengine.v1beta.AnswerB\x03\xe0\x41\x03\x12]\n\x0cquery_config\x18\x10 \x03(\x0b\x32\x42.google.cloud.discoveryengine.v1beta.Session.Turn.QueryConfigEntryB\x03\xe0\x41\x01\x1a\x32\n\x10QueryConfigEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"/\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0f\n\x0bIN_PROGRESS\x10\x01:\xe6\x02\xea\x41\xe2\x02\n&discoveryengine.googleapis.com/Session\x12Rprojects/{project}/locations/{location}/dataStores/{data_store}/sessions/{session}\x12kprojects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/sessions/{session}\x12\x64projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}*\x08sessions2\x07session\"9\n\x05Query\x12\x0e\n\x04text\x18\x02 \x01(\tH\x00\x12\x15\n\x08query_id\x18\x01 \x01(\tB\x03\xe0\x41\x03\x42\t\n\x07\x63ontentB\x93\x02\n\'com.google.cloud.discoveryengine.v1betaB\x0cSessionProtoP\x01ZQcloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb\xa2\x02\x0f\x44ISCOVERYENGINE\xaa\x02#Google.Cloud.DiscoveryEngine.V1Beta\xca\x02#Google\\Cloud\\DiscoveryEngine\\V1beta\xea\x02&Google::Cloud::DiscoveryEngine::V1betab\x06proto3"
13
14
 
14
15
  pool = Google::Protobuf::DescriptorPool.generated_pool
15
16
 
@@ -25,6 +26,7 @@ rescue TypeError
25
26
  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
26
27
  imports = [
27
28
  ["google.protobuf.Timestamp", "google/protobuf/timestamp.proto"],
29
+ ["google.cloud.discoveryengine.v1beta.Answer", "google/cloud/discoveryengine/v1beta/answer.proto"],
28
30
  ]
29
31
  imports.each do |type_name, expected_filename|
30
32
  import_file = pool.lookup(type_name).file_descriptor
@@ -0,0 +1,49 @@
1
+ # frozen_string_literal: true
2
+ # Generated by the protocol buffer compiler. DO NOT EDIT!
3
+ # source: google/cloud/discoveryengine/v1beta/session_service.proto
4
+
5
+ require 'google/protobuf'
6
+
7
+ require 'google/api/annotations_pb'
8
+ require 'google/api/client_pb'
9
+ require 'google/api/field_behavior_pb'
10
+ require 'google/api/resource_pb'
11
+ require 'google/cloud/discoveryengine/v1beta/conversational_search_service_pb'
12
+ require 'google/cloud/discoveryengine/v1beta/session_pb'
13
+ require 'google/protobuf/empty_pb'
14
+
15
+
16
+ descriptor_data = "\n9google/cloud/discoveryengine/v1beta/session_service.proto\x12#google.cloud.discoveryengine.v1beta\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1aGgoogle/cloud/discoveryengine/v1beta/conversational_search_service.proto\x1a\x31google/cloud/discoveryengine/v1beta/session.proto\x1a\x1bgoogle/protobuf/empty.proto2\xba\x0f\n\x0eSessionService\x12\x88\x03\n\rCreateSession\x12\x39.google.cloud.discoveryengine.v1beta.CreateSessionRequest\x1a,.google.cloud.discoveryengine.v1beta.Session\"\x8d\x02\xda\x41\x0eparent,session\x82\xd3\xe4\x93\x02\xf5\x01\"=/v1beta/{parent=projects/*/locations/*/dataStores/*}/sessions:\x07sessionZV\"K/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/sessions:\x07sessionZS\"H/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/sessions:\x07session\x12\xcd\x02\n\rDeleteSession\x12\x39.google.cloud.discoveryengine.v1beta.DeleteSessionRequest\x1a\x16.google.protobuf.Empty\"\xe8\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\xda\x01*=/v1beta/{name=projects/*/locations/*/dataStores/*/sessions/*}ZM*K/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/sessions/*}ZJ*H/v1beta/{name=projects/*/locations/*/collections/*/engines/*/sessions/*}\x12\xa5\x03\n\rUpdateSession\x12\x39.google.cloud.discoveryengine.v1beta.UpdateSessionRequest\x1a,.google.cloud.discoveryengine.v1beta.Session\"\xaa\x02\xda\x41\x13session,update_mask\x82\xd3\xe4\x93\x02\x8d\x02\x32\x45/v1beta/{session.name=projects/*/locations/*/dataStores/*/sessions/*}:\x07sessionZ^2S/v1beta/{session.name=projects/*/locations/*/collections/*/dataStores/*/sessions/*}:\x07sessionZ[2P/v1beta/{session.name=projects/*/locations/*/collections/*/engines/*/sessions/*}:\x07session\x12\xdd\x02\n\nGetSession\x12\x36.google.cloud.discoveryengine.v1beta.GetSessionRequest\x1a,.google.cloud.discoveryengine.v1beta.Session\"\xe8\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\xda\x01\x12=/v1beta/{name=projects/*/locations/*/dataStores/*/sessions/*}ZM\x12K/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/sessions/*}ZJ\x12H/v1beta/{name=projects/*/locations/*/collections/*/engines/*/sessions/*}\x12\xf0\x02\n\x0cListSessions\x12\x38.google.cloud.discoveryengine.v1beta.ListSessionsRequest\x1a\x39.google.cloud.discoveryengine.v1beta.ListSessionsResponse\"\xea\x01\xda\x41\x06parent\x82\xd3\xe4\x93\x02\xda\x01\x12=/v1beta/{parent=projects/*/locations/*/dataStores/*}/sessionsZM\x12K/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/sessionsZJ\x12H/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/sessions\x1aR\xca\x41\x1e\x64iscoveryengine.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x9a\x02\n\'com.google.cloud.discoveryengine.v1betaB\x13SessionServiceProtoP\x01ZQcloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb\xa2\x02\x0f\x44ISCOVERYENGINE\xaa\x02#Google.Cloud.DiscoveryEngine.V1Beta\xca\x02#Google\\Cloud\\DiscoveryEngine\\V1beta\xea\x02&Google::Cloud::DiscoveryEngine::V1betab\x06proto3"
17
+
18
+ pool = Google::Protobuf::DescriptorPool.generated_pool
19
+
20
+ begin
21
+ pool.add_serialized_file(descriptor_data)
22
+ rescue TypeError
23
+ # Compatibility code: will be removed in the next major version.
24
+ require 'google/protobuf/descriptor_pb'
25
+ parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
26
+ parsed.clear_dependency
27
+ serialized = parsed.class.encode(parsed)
28
+ file = pool.add_serialized_file(serialized)
29
+ warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
30
+ imports = [
31
+ ]
32
+ imports.each do |type_name, expected_filename|
33
+ import_file = pool.lookup(type_name).file_descriptor
34
+ if import_file.name != expected_filename
35
+ warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
36
+ end
37
+ end
38
+ warn "Each proto file must use a consistent fully-qualified name."
39
+ warn "This will become an error in the next major version."
40
+ end
41
+
42
+ module Google
43
+ module Cloud
44
+ module DiscoveryEngine
45
+ module V1beta
46
+ end
47
+ end
48
+ end
49
+ end
@@ -0,0 +1,64 @@
1
+ # Generated by the protocol buffer compiler. DO NOT EDIT!
2
+ # Source: google/cloud/discoveryengine/v1beta/session_service.proto for package 'Google.Cloud.DiscoveryEngine.V1beta'
3
+ # Original file comments:
4
+ # Copyright 2025 Google LLC
5
+ #
6
+ # Licensed under the Apache License, Version 2.0 (the "License");
7
+ # you may not use this file except in compliance with the License.
8
+ # You may obtain a copy of the License at
9
+ #
10
+ # http://www.apache.org/licenses/LICENSE-2.0
11
+ #
12
+ # Unless required by applicable law or agreed to in writing, software
13
+ # distributed under the License is distributed on an "AS IS" BASIS,
14
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
+ # See the License for the specific language governing permissions and
16
+ # limitations under the License.
17
+ #
18
+
19
+ require 'grpc'
20
+ require 'google/cloud/discoveryengine/v1beta/session_service_pb'
21
+
22
+ module Google
23
+ module Cloud
24
+ module DiscoveryEngine
25
+ module V1beta
26
+ module SessionService
27
+ # Service for managing Sessions and Session-related resources.
28
+ class Service
29
+
30
+ include ::GRPC::GenericService
31
+
32
+ self.marshal_class_method = :encode
33
+ self.unmarshal_class_method = :decode
34
+ self.service_name = 'google.cloud.discoveryengine.v1beta.SessionService'
35
+
36
+ # Creates a Session.
37
+ #
38
+ # If the [Session][google.cloud.discoveryengine.v1beta.Session] to create
39
+ # already exists, an ALREADY_EXISTS error is returned.
40
+ rpc :CreateSession, ::Google::Cloud::DiscoveryEngine::V1beta::CreateSessionRequest, ::Google::Cloud::DiscoveryEngine::V1beta::Session
41
+ # Deletes a Session.
42
+ #
43
+ # If the [Session][google.cloud.discoveryengine.v1beta.Session] to delete
44
+ # does not exist, a NOT_FOUND error is returned.
45
+ rpc :DeleteSession, ::Google::Cloud::DiscoveryEngine::V1beta::DeleteSessionRequest, ::Google::Protobuf::Empty
46
+ # Updates a Session.
47
+ #
48
+ # [Session][google.cloud.discoveryengine.v1beta.Session] action type cannot
49
+ # be changed. If the [Session][google.cloud.discoveryengine.v1beta.Session]
50
+ # to update does not exist, a NOT_FOUND error is returned.
51
+ rpc :UpdateSession, ::Google::Cloud::DiscoveryEngine::V1beta::UpdateSessionRequest, ::Google::Cloud::DiscoveryEngine::V1beta::Session
52
+ # Gets a Session.
53
+ rpc :GetSession, ::Google::Cloud::DiscoveryEngine::V1beta::GetSessionRequest, ::Google::Cloud::DiscoveryEngine::V1beta::Session
54
+ # Lists all Sessions by their parent
55
+ # [DataStore][google.cloud.discoveryengine.v1beta.DataStore].
56
+ rpc :ListSessions, ::Google::Cloud::DiscoveryEngine::V1beta::ListSessionsRequest, ::Google::Cloud::DiscoveryEngine::V1beta::ListSessionsResponse
57
+ end
58
+
59
+ Stub = Service.rpc_stub_class
60
+ end
61
+ end
62
+ end
63
+ end
64
+ end
@@ -791,6 +791,10 @@ module Google
791
791
  # @return [::String]
792
792
  # Required. The resource name of the Session to get. Format:
793
793
  # `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`
794
+ # @!attribute [rw] include_answer_details
795
+ # @return [::Boolean]
796
+ # Optional. If set to true, the full session including all answer details
797
+ # will be returned.
794
798
  class GetSessionRequest
795
799
  include ::Google::Protobuf::MessageExts
796
800
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -811,23 +815,40 @@ module Google
811
815
  # Provide this to retrieve the subsequent page.
812
816
  # @!attribute [rw] filter
813
817
  # @return [::String]
814
- # A filter to apply on the list results. The supported features are:
815
- # user_pseudo_id, state.
818
+ # A comma-separated list of fields to filter by, in EBNF grammar.
819
+ # The supported fields are:
820
+ # * `user_pseudo_id`
821
+ # * `state`
822
+ # * `display_name`
823
+ # * `starred`
824
+ # * `is_pinned`
825
+ # * `labels`
826
+ # * `create_time`
827
+ # * `update_time`
816
828
  #
817
- # Example:
829
+ # Examples:
818
830
  # "user_pseudo_id = some_id"
831
+ # "display_name = \"some_name\""
832
+ # "starred = true"
833
+ # "is_pinned=true AND (NOT labels:hidden)"
834
+ # "create_time > \"1970-01-01T12:00:00Z\""
819
835
  # @!attribute [rw] order_by
820
836
  # @return [::String]
821
837
  # A comma-separated list of fields to order by, sorted in ascending order.
822
838
  # Use "desc" after a field name for descending.
823
839
  # Supported fields:
840
+ #
824
841
  # * `update_time`
825
842
  # * `create_time`
826
843
  # * `session_name`
844
+ # * `is_pinned`
827
845
  #
828
846
  # Example:
829
- # "update_time desc"
830
- # "create_time"
847
+ #
848
+ # * "update_time desc"
849
+ # * "create_time"
850
+ # * "is_pinned desc,update_time desc": list sessions by is_pinned first, then
851
+ # by update_time.
831
852
  class ListSessionsRequest
832
853
  include ::Google::Protobuf::MessageExts
833
854
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -286,22 +286,16 @@ module Google
286
286
  # between /search API calls and /answer API calls.
287
287
  #
288
288
  # Example #1 (multi-turn /search API calls):
289
- # 1. Call /search API with the auto-session mode (see below).
290
- # 2. Call /search API with the session ID generated in the first call.
291
- # Here, the previous search query gets considered in query
292
- # standing. I.e., if the first query is "How did Alphabet do in 2022?"
293
- # and the current query is "How about 2023?", the current query will
294
- # be interpreted as "How did Alphabet do in 2023?".
289
+ # Call /search API with the session ID generated in the first call.
290
+ # Here, the previous search query gets considered in query
291
+ # standing. I.e., if the first query is "How did Alphabet do in 2022?"
292
+ # and the current query is "How about 2023?", the current query will
293
+ # be interpreted as "How did Alphabet do in 2023?".
295
294
  #
296
295
  # Example #2 (coordination between /search API calls and /answer API calls):
297
- # 1. Call /search API with the auto-session mode (see below).
298
- # 2. Call /answer API with the session ID generated in the first call.
299
- # Here, the answer generation happens in the context of the search
300
- # results from the first search call.
301
- #
302
- # Auto-session mode: when `projects/.../sessions/-` is used, a new session
303
- # gets automatically created. Otherwise, users can use the create-session API
304
- # to create a session manually.
296
+ # Call /answer API with the session ID generated in the first call.
297
+ # Here, the answer generation happens in the context of the search
298
+ # results from the first search call.
305
299
  #
306
300
  # Multi-turn Search feature is currently at private GA stage. Please use
307
301
  # v1alpha or v1beta version instead before we launch this feature to public
@@ -26,6 +26,12 @@ module Google
26
26
  # @return [::String]
27
27
  # Immutable. Fully qualified name
28
28
  # `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*`
29
+ # @!attribute [rw] display_name
30
+ # @return [::String]
31
+ # Optional. The display name of the session.
32
+ #
33
+ # This field is used to identify the session in the UI.
34
+ # By default, the display name is the first turn query text in the session.
29
35
  # @!attribute [rw] state
30
36
  # @return [::Google::Cloud::DiscoveryEngine::V1beta::Session::State]
31
37
  # The state of the session.
@@ -41,6 +47,10 @@ module Google
41
47
  # @!attribute [r] end_time
42
48
  # @return [::Google::Protobuf::Timestamp]
43
49
  # Output only. The time the session finished.
50
+ # @!attribute [rw] is_pinned
51
+ # @return [::Boolean]
52
+ # Optional. Whether the session is pinned, pinned session will be displayed
53
+ # on the top of the session list.
44
54
  class Session
45
55
  include ::Google::Protobuf::MessageExts
46
56
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -49,16 +59,40 @@ module Google
49
59
  # answer from service.
50
60
  # @!attribute [rw] query
51
61
  # @return [::Google::Cloud::DiscoveryEngine::V1beta::Query]
52
- # The user query.
62
+ # Optional. The user query. May not be set if this turn is merely
63
+ # regenerating an answer to a different turn
53
64
  # @!attribute [rw] answer
54
65
  # @return [::String]
55
- # The resource name of the answer to the user query.
66
+ # Optional. The resource name of the answer to the user query.
56
67
  #
57
68
  # Only set if the answer generation (/answer API call) happened in this
58
69
  # turn.
70
+ # @!attribute [r] detailed_answer
71
+ # @return [::Google::Cloud::DiscoveryEngine::V1beta::Answer]
72
+ # Output only. In
73
+ # {::Google::Cloud::DiscoveryEngine::V1beta::ConversationalSearchService::Client#get_session ConversationalSearchService.GetSession}
74
+ # API, if
75
+ # {::Google::Cloud::DiscoveryEngine::V1beta::GetSessionRequest#include_answer_details GetSessionRequest.include_answer_details}
76
+ # is set to true, this field will be populated when getting answer query
77
+ # session.
78
+ # @!attribute [rw] query_config
79
+ # @return [::Google::Protobuf::Map{::String => ::String}]
80
+ # Optional. Represents metadata related to the query config, for example
81
+ # LLM model and version used, model parameters (temperature, grounding
82
+ # parameters, etc.). The prefix "google." is reserved for Google-developed
83
+ # functionality.
59
84
  class Turn
60
85
  include ::Google::Protobuf::MessageExts
61
86
  extend ::Google::Protobuf::MessageExts::ClassMethods
87
+
88
+ # @!attribute [rw] key
89
+ # @return [::String]
90
+ # @!attribute [rw] value
91
+ # @return [::String]
92
+ class QueryConfigEntry
93
+ include ::Google::Protobuf::MessageExts
94
+ extend ::Google::Protobuf::MessageExts::ClassMethods
95
+ end
62
96
  end
63
97
 
64
98
  # Enumeration of the state of the session.
@@ -75,9 +109,9 @@ module Google
75
109
  # @!attribute [rw] text
76
110
  # @return [::String]
77
111
  # Plain text.
78
- # @!attribute [rw] query_id
112
+ # @!attribute [r] query_id
79
113
  # @return [::String]
80
- # Unique Id for the query.
114
+ # Output only. Unique Id for the query.
81
115
  class Query
82
116
  include ::Google::Protobuf::MessageExts
83
117
  extend ::Google::Protobuf::MessageExts::ClassMethods
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-discovery_engine-v1beta
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.20.1
4
+ version: 0.21.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -204,6 +204,13 @@ files:
204
204
  - lib/google/cloud/discovery_engine/v1beta/serving_config_service/rest.rb
205
205
  - lib/google/cloud/discovery_engine/v1beta/serving_config_service/rest/client.rb
206
206
  - lib/google/cloud/discovery_engine/v1beta/serving_config_service/rest/service_stub.rb
207
+ - lib/google/cloud/discovery_engine/v1beta/session_service.rb
208
+ - lib/google/cloud/discovery_engine/v1beta/session_service/client.rb
209
+ - lib/google/cloud/discovery_engine/v1beta/session_service/credentials.rb
210
+ - lib/google/cloud/discovery_engine/v1beta/session_service/paths.rb
211
+ - lib/google/cloud/discovery_engine/v1beta/session_service/rest.rb
212
+ - lib/google/cloud/discovery_engine/v1beta/session_service/rest/client.rb
213
+ - lib/google/cloud/discovery_engine/v1beta/session_service/rest/service_stub.rb
207
214
  - lib/google/cloud/discovery_engine/v1beta/site_search_engine_service.rb
208
215
  - lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/client.rb
209
216
  - lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/credentials.rb
@@ -278,6 +285,8 @@ files:
278
285
  - lib/google/cloud/discoveryengine/v1beta/serving_config_service_pb.rb
279
286
  - lib/google/cloud/discoveryengine/v1beta/serving_config_service_services_pb.rb
280
287
  - lib/google/cloud/discoveryengine/v1beta/session_pb.rb
288
+ - lib/google/cloud/discoveryengine/v1beta/session_service_pb.rb
289
+ - lib/google/cloud/discoveryengine/v1beta/session_service_services_pb.rb
281
290
  - lib/google/cloud/discoveryengine/v1beta/site_search_engine_pb.rb
282
291
  - lib/google/cloud/discoveryengine/v1beta/site_search_engine_service_pb.rb
283
292
  - lib/google/cloud/discoveryengine/v1beta/site_search_engine_service_services_pb.rb