@google-cloud/discoveryengine 1.4.0 → 1.4.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (107) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +13 -0
  3. package/build/protos/google/cloud/discoveryengine/v1alpha/acl_config.proto +49 -0
  4. package/build/protos/google/cloud/discoveryengine/v1alpha/acl_config_service.proto +79 -0
  5. package/build/protos/google/cloud/discoveryengine/v1alpha/chunk.proto +72 -0
  6. package/build/protos/google/cloud/discoveryengine/v1alpha/chunk_service.proto +137 -0
  7. package/build/protos/google/cloud/discoveryengine/v1alpha/common.proto +77 -4
  8. package/build/protos/google/cloud/discoveryengine/v1alpha/completion.proto +52 -0
  9. package/build/protos/google/cloud/discoveryengine/v1alpha/completion_service.proto +44 -2
  10. package/build/protos/google/cloud/discoveryengine/v1alpha/conversational_search_service.proto +6 -1
  11. package/build/protos/google/cloud/discoveryengine/v1alpha/data_store.proto +44 -0
  12. package/build/protos/google/cloud/discoveryengine/v1alpha/data_store_service.proto +80 -1
  13. package/build/protos/google/cloud/discoveryengine/v1alpha/document.proto +83 -0
  14. package/build/protos/google/cloud/discoveryengine/v1alpha/document_processing_config.proto +127 -0
  15. package/build/protos/google/cloud/discoveryengine/v1alpha/document_service.proto +6 -0
  16. package/build/protos/google/cloud/discoveryengine/v1alpha/engine.proto +13 -8
  17. package/build/protos/google/cloud/discoveryengine/v1alpha/engine_service.proto +3 -2
  18. package/build/protos/google/cloud/discoveryengine/v1alpha/estimate_billing_service.proto +130 -0
  19. package/build/protos/google/cloud/discoveryengine/v1alpha/import_config.proto +64 -0
  20. package/build/protos/google/cloud/discoveryengine/v1alpha/purge_config.proto +66 -0
  21. package/build/protos/google/cloud/discoveryengine/v1alpha/recommendation_service.proto +3 -1
  22. package/build/protos/google/cloud/discoveryengine/v1alpha/schema.proto +3 -0
  23. package/build/protos/google/cloud/discoveryengine/v1alpha/search_service.proto +74 -13
  24. package/build/protos/google/cloud/discoveryengine/v1alpha/search_tuning_service.proto +24 -20
  25. package/build/protos/google/cloud/discoveryengine/v1alpha/serving_config.proto +271 -0
  26. package/build/protos/google/cloud/discoveryengine/v1alpha/serving_config_service.proto +147 -0
  27. package/build/protos/google/cloud/discoveryengine/v1alpha/site_search_engine.proto +9 -3
  28. package/build/protos/google/cloud/discoveryengine/v1alpha/site_search_engine_service.proto +7 -4
  29. package/build/protos/google/cloud/discoveryengine/v1alpha/user_event.proto +4 -3
  30. package/build/protos/google/cloud/discoveryengine/v1beta/conversational_search_service.proto +5 -0
  31. package/build/protos/google/cloud/discoveryengine/v1beta/data_store.proto +22 -0
  32. package/build/protos/google/cloud/discoveryengine/v1beta/document.proto +9 -0
  33. package/build/protos/google/cloud/discoveryengine/v1beta/document_processing_config.proto +94 -0
  34. package/build/protos/google/cloud/discoveryengine/v1beta/purge_config.proto +3 -0
  35. package/build/protos/google/cloud/discoveryengine/v1beta/search_service.proto +19 -4
  36. package/build/protos/google/cloud/discoveryengine/v1beta/search_tuning_service.proto +151 -0
  37. package/build/protos/google/cloud/discoveryengine/v1beta/serving_config.proto +4 -3
  38. package/build/protos/google/cloud/discoveryengine/v1beta/serving_config_service.proto +6 -5
  39. package/build/protos/protos.d.ts +15133 -7787
  40. package/build/protos/protos.js +50444 -32043
  41. package/build/protos/protos.json +4132 -2305
  42. package/build/src/v1alpha/acl_config_service_client.d.ts +1233 -0
  43. package/build/src/v1alpha/acl_config_service_client.js +1765 -0
  44. package/build/src/v1alpha/acl_config_service_client_config.json +34 -0
  45. package/build/src/v1alpha/chunk_service_client.d.ts +1350 -0
  46. package/build/src/v1alpha/chunk_service_client.js +1886 -0
  47. package/build/src/v1alpha/chunk_service_client_config.json +34 -0
  48. package/build/src/v1alpha/completion_service_client.d.ts +588 -3
  49. package/build/src/v1alpha/completion_service_client.js +831 -2
  50. package/build/src/v1alpha/completion_service_client_config.json +10 -0
  51. package/build/src/v1alpha/conversational_search_service_client.d.ts +233 -1
  52. package/build/src/v1alpha/conversational_search_service_client.js +316 -0
  53. package/build/src/v1alpha/data_store_service_client.d.ts +451 -3
  54. package/build/src/v1alpha/data_store_service_client.js +562 -2
  55. package/build/src/v1alpha/data_store_service_client_config.json +8 -0
  56. package/build/src/v1alpha/document_service_client.d.ts +382 -0
  57. package/build/src/v1alpha/document_service_client.js +514 -0
  58. package/build/src/v1alpha/engine_service_client.d.ts +375 -2
  59. package/build/src/v1alpha/engine_service_client.js +514 -0
  60. package/build/src/v1alpha/estimate_billing_service_client.d.ts +1367 -0
  61. package/build/src/v1alpha/estimate_billing_service_client.js +2028 -0
  62. package/build/src/v1alpha/estimate_billing_service_client_config.json +30 -0
  63. package/build/src/v1alpha/index.d.ts +4 -0
  64. package/build/src/v1alpha/index.js +9 -1
  65. package/build/src/v1alpha/recommendation_service_client.d.ts +231 -1
  66. package/build/src/v1alpha/recommendation_service_client.js +316 -0
  67. package/build/src/v1alpha/schema_service_client.d.ts +372 -0
  68. package/build/src/v1alpha/schema_service_client.js +514 -0
  69. package/build/src/v1alpha/search_service_client.d.ts +258 -15
  70. package/build/src/v1alpha/search_service_client.js +336 -10
  71. package/build/src/v1alpha/search_tuning_service_client.d.ts +373 -1
  72. package/build/src/v1alpha/search_tuning_service_client.js +514 -0
  73. package/build/src/v1alpha/serving_config_service_client.d.ts +1369 -0
  74. package/build/src/v1alpha/serving_config_service_client.js +1935 -0
  75. package/build/src/v1alpha/serving_config_service_client_config.json +38 -0
  76. package/build/src/v1alpha/site_search_engine_service_client.d.ts +372 -0
  77. package/build/src/v1alpha/site_search_engine_service_client.js +514 -0
  78. package/build/src/v1alpha/user_event_service_client.d.ts +372 -0
  79. package/build/src/v1alpha/user_event_service_client.js +514 -0
  80. package/build/src/v1beta/completion_service_client.d.ts +75 -0
  81. package/build/src/v1beta/completion_service_client.js +104 -0
  82. package/build/src/v1beta/conversational_search_service_client.d.ts +79 -0
  83. package/build/src/v1beta/conversational_search_service_client.js +104 -0
  84. package/build/src/v1beta/data_store_service_client.d.ts +75 -0
  85. package/build/src/v1beta/data_store_service_client.js +104 -0
  86. package/build/src/v1beta/document_service_client.d.ts +75 -0
  87. package/build/src/v1beta/document_service_client.js +104 -0
  88. package/build/src/v1beta/engine_service_client.d.ts +75 -0
  89. package/build/src/v1beta/engine_service_client.js +104 -0
  90. package/build/src/v1beta/index.d.ts +1 -0
  91. package/build/src/v1beta/index.js +3 -1
  92. package/build/src/v1beta/recommendation_service_client.d.ts +75 -0
  93. package/build/src/v1beta/recommendation_service_client.js +104 -0
  94. package/build/src/v1beta/schema_service_client.d.ts +75 -0
  95. package/build/src/v1beta/schema_service_client.js +104 -0
  96. package/build/src/v1beta/search_service_client.d.ts +81 -0
  97. package/build/src/v1beta/search_service_client.js +108 -0
  98. package/build/src/v1beta/search_tuning_service_client.d.ts +1196 -0
  99. package/build/src/v1beta/search_tuning_service_client.js +1781 -0
  100. package/build/src/v1beta/search_tuning_service_client_config.json +30 -0
  101. package/build/src/v1beta/serving_config_service_client.d.ts +123 -8
  102. package/build/src/v1beta/serving_config_service_client.js +166 -5
  103. package/build/src/v1beta/site_search_engine_service_client.d.ts +75 -0
  104. package/build/src/v1beta/site_search_engine_service_client.js +104 -0
  105. package/build/src/v1beta/user_event_service_client.d.ts +75 -0
  106. package/build/src/v1beta/user_event_service_client.js +104 -0
  107. package/package.json +3 -3
@@ -0,0 +1,130 @@
1
+ // Copyright 2022 Google LLC
2
+ //
3
+ // Licensed under the Apache License, Version 2.0 (the "License");
4
+ // you may not use this file except in compliance with the License.
5
+ // You may obtain a copy of the License at
6
+ //
7
+ // http://www.apache.org/licenses/LICENSE-2.0
8
+ //
9
+ // Unless required by applicable law or agreed to in writing, software
10
+ // distributed under the License is distributed on an "AS IS" BASIS,
11
+ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ // See the License for the specific language governing permissions and
13
+ // limitations under the License.
14
+
15
+ syntax = "proto3";
16
+
17
+ package google.cloud.discoveryengine.v1alpha;
18
+
19
+ import "google/api/annotations.proto";
20
+ import "google/api/client.proto";
21
+ import "google/api/field_behavior.proto";
22
+ import "google/api/resource.proto";
23
+ import "google/cloud/discoveryengine/v1alpha/import_config.proto";
24
+ import "google/longrunning/operations.proto";
25
+ import "google/protobuf/timestamp.proto";
26
+
27
+ option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Alpha";
28
+ option go_package = "cloud.google.com/go/discoveryengine/apiv1alpha/discoveryenginepb;discoveryenginepb";
29
+ option java_multiple_files = true;
30
+ option java_outer_classname = "EstimateBillingServiceProto";
31
+ option java_package = "com.google.cloud.discoveryengine.v1alpha";
32
+ option objc_class_prefix = "DISCOVERYENGINE";
33
+ option php_namespace = "Google\\Cloud\\DiscoveryEngine\\V1alpha";
34
+ option ruby_package = "Google::Cloud::DiscoveryEngine::V1alpha";
35
+
36
+ // Service for managing billing estimations resources.
37
+ service EstimateBillingService {
38
+ option (google.api.default_host) = "discoveryengine.googleapis.com";
39
+ option (google.api.oauth_scopes) =
40
+ "https://www.googleapis.com/auth/cloud-platform";
41
+
42
+ // Estimates the data size to be used by a customer.
43
+ rpc EstimateDataSize(EstimateDataSizeRequest)
44
+ returns (google.longrunning.Operation) {
45
+ option (google.api.http) = {
46
+ post: "/v1alpha/{location=projects/*/locations/*}:estimateDataSize"
47
+ body: "*"
48
+ };
49
+ option (google.longrunning.operation_info) = {
50
+ response_type: "google.cloud.discoveryengine.v1alpha.EstimateDataSizeResponse"
51
+ metadata_type: "google.cloud.discoveryengine.v1alpha.EstimateDataSizeMetadata"
52
+ };
53
+ }
54
+ }
55
+
56
+ // Request message for
57
+ // [EstimateBillingService.EstimateDataSize][google.cloud.discoveryengine.v1alpha.EstimateBillingService.EstimateDataSize]
58
+ // method
59
+ message EstimateDataSizeRequest {
60
+ // Data source is a set of website patterns that we crawl to get
61
+ // the total number of websites.
62
+ message WebsiteDataSource {
63
+ // URI patterns that we use to crawl.
64
+ message EstimatorUriPattern {
65
+ // User provided URI pattern. For example, `foo.com/bar/*`.
66
+ string provided_uri_pattern = 1;
67
+
68
+ // Whether we infer the generated URI or use the exact provided one.
69
+ bool exact_match = 2;
70
+
71
+ // Whether the pattern is exclusive or not. If set to true, the pattern is
72
+ // considered exclusive. If unset or set to false, the pattern is
73
+ // considered inclusive by default.
74
+ bool exclusive = 3;
75
+ }
76
+
77
+ // Required. The URI patterns to estimate the data sizes. At most 10
78
+ // patterns are allowed, otherwise an INVALID_ARGUMENT error is thrown.
79
+ repeated EstimatorUriPattern estimator_uri_patterns = 1
80
+ [(google.api.field_behavior) = REQUIRED];
81
+ }
82
+
83
+ // Data source contains files either in Cloud Storage or BigQuery.
84
+ message FileDataSource {
85
+ // Which source contains the files to be used.
86
+ oneof source {
87
+ // Cloud Storage location for the input content.
88
+ GcsSource gcs_source = 1;
89
+
90
+ // BigQuery input source.
91
+ BigQuerySource bigquery_source = 2;
92
+ }
93
+ }
94
+
95
+ // Data source for which we are estimating its size.
96
+ oneof data_source {
97
+ // Website data.
98
+ WebsiteDataSource website_data_source = 2;
99
+
100
+ // Structured or unstructured data.
101
+ FileDataSource file_data_source = 3;
102
+ }
103
+
104
+ // Required. Full resource name of the location, such as
105
+ // `projects/{project}/locations/{location}`.
106
+ string location = 1 [
107
+ (google.api.field_behavior) = REQUIRED,
108
+ (google.api.resource_reference) = {
109
+ type: "discoveryengine.googleapis.com/Location"
110
+ }
111
+ ];
112
+ }
113
+
114
+ // Response of the EstimateDataSize request. If the long running
115
+ // operation was successful, then this message is returned by the
116
+ // google.longrunning.Operations.response field if the operation was successful.
117
+ message EstimateDataSizeResponse {
118
+ // Data size in terms of bytes.
119
+ int64 data_size_bytes = 1;
120
+
121
+ // Total number of documents.
122
+ int64 document_count = 2;
123
+ }
124
+
125
+ // Metadata related to the progress of the EstimateDataSize operation. This is
126
+ // returned by the google.longrunning.Operation.metadata field.
127
+ message EstimateDataSizeMetadata {
128
+ // Operation create time.
129
+ google.protobuf.Timestamp create_time = 1;
130
+ }
@@ -18,6 +18,7 @@ package google.cloud.discoveryengine.v1alpha;
18
18
 
19
19
  import "google/api/field_behavior.proto";
20
20
  import "google/api/resource.proto";
21
+ import "google/cloud/discoveryengine/v1alpha/completion.proto";
21
22
  import "google/cloud/discoveryengine/v1alpha/document.proto";
22
23
  import "google/cloud/discoveryengine/v1alpha/user_event.proto";
23
24
  import "google/protobuf/timestamp.proto";
@@ -341,3 +342,66 @@ message ImportDocumentsResponse {
341
342
  // Echoes the destination for the complete errors in the request if set.
342
343
  ImportErrorConfig error_config = 2;
343
344
  }
345
+
346
+ // Request message for
347
+ // [CompletionService.ImportSuggestionDenyListEntries][google.cloud.discoveryengine.v1alpha.CompletionService.ImportSuggestionDenyListEntries]
348
+ // method.
349
+ message ImportSuggestionDenyListEntriesRequest {
350
+ // The inline source for SuggestionDenyListEntry.
351
+ message InlineSource {
352
+ // Required. A list of all denylist entries to import. Max of 1000 items.
353
+ repeated SuggestionDenyListEntry entries = 1
354
+ [(google.api.field_behavior) = REQUIRED];
355
+ }
356
+
357
+ // The source of the updated SuggestionDenyList.
358
+ oneof source {
359
+ // The Inline source for the input content for suggestion deny list entries.
360
+ InlineSource inline_source = 2;
361
+
362
+ // Cloud Storage location for the input content.
363
+ //
364
+ // Only 1 file can be specified that contains all entries to import.
365
+ // Supported values `gcs_source.schema` for autocomplete suggestion deny
366
+ // list entry imports:
367
+ //
368
+ // * `suggestion_deny_list` (default): One JSON [SuggestionDenyListEntry]
369
+ // per line.
370
+ GcsSource gcs_source = 3;
371
+ }
372
+
373
+ // Required. The parent data store resource name for which to import denylist
374
+ // entries. Follows pattern projects/*/locations/*/collections/*/dataStores/*.
375
+ string parent = 1 [
376
+ (google.api.field_behavior) = REQUIRED,
377
+ (google.api.resource_reference) = {
378
+ type: "discoveryengine.googleapis.com/DataStore"
379
+ }
380
+ ];
381
+ }
382
+
383
+ // Response message for
384
+ // [CompletionService.ImportSuggestionDenyListEntries][google.cloud.discoveryengine.v1alpha.CompletionService.ImportSuggestionDenyListEntries]
385
+ // method.
386
+ message ImportSuggestionDenyListEntriesResponse {
387
+ // A sample of errors encountered while processing the request.
388
+ repeated google.rpc.Status error_samples = 1;
389
+
390
+ // Count of deny list entries successfully imported.
391
+ int64 imported_entries_count = 2;
392
+
393
+ // Count of deny list entries that failed to be imported.
394
+ int64 failed_entries_count = 3;
395
+ }
396
+
397
+ // Metadata related to the progress of the ImportSuggestionDenyListEntries
398
+ // operation. This is returned by the google.longrunning.Operation.metadata
399
+ // field.
400
+ message ImportSuggestionDenyListEntriesMetadata {
401
+ // Operation create time.
402
+ google.protobuf.Timestamp create_time = 1;
403
+
404
+ // Operation last update time. If the operation is done, this is also the
405
+ // finish time.
406
+ google.protobuf.Timestamp update_time = 2;
407
+ }
@@ -18,7 +18,9 @@ package google.cloud.discoveryengine.v1alpha;
18
18
 
19
19
  import "google/api/field_behavior.proto";
20
20
  import "google/api/resource.proto";
21
+ import "google/cloud/discoveryengine/v1alpha/import_config.proto";
21
22
  import "google/protobuf/timestamp.proto";
23
+ import "google/rpc/status.proto";
22
24
 
23
25
  option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Alpha";
24
26
  option go_package = "cloud.google.com/go/discoveryengine/apiv1alpha/discoveryenginepb;discoveryenginepb";
@@ -102,10 +104,31 @@ message PurgeUserEventsMetadata {
102
104
  int64 failure_count = 4;
103
105
  }
104
106
 
107
+ // Configuration of destination for Purge related errors.
108
+ message PurgeErrorConfig {
109
+ // Required. Errors destination.
110
+ oneof destination {
111
+ // Cloud Storage prefix for purge errors. This must be an empty,
112
+ // existing Cloud Storage directory. Purge errors are written to
113
+ // sharded files in this directory, one per line, as a JSON-encoded
114
+ // `google.rpc.Status` message.
115
+ string gcs_prefix = 1;
116
+ }
117
+ }
118
+
105
119
  // Request message for
106
120
  // [DocumentService.PurgeDocuments][google.cloud.discoveryengine.v1alpha.DocumentService.PurgeDocuments]
107
121
  // method.
108
122
  message PurgeDocumentsRequest {
123
+ // The desired input source for the purging documents based on document ids.
124
+ oneof source {
125
+ // Cloud Storage location for the input content.
126
+ // Supported `data_schema`:
127
+ // * `document_id`: One valid
128
+ // [Document.id][google.cloud.discoveryengine.v1alpha.Document.id] per line.
129
+ GcsSource gcs_source = 5;
130
+ }
131
+
109
132
  // Required. The parent resource name, such as
110
133
  // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
111
134
  string parent = 1 [
@@ -120,6 +143,9 @@ message PurgeDocumentsRequest {
120
143
  // `*` (all items).
121
144
  string filter = 2 [(google.api.field_behavior) = REQUIRED];
122
145
 
146
+ // The desired location of errors incurred during the purge.
147
+ PurgeErrorConfig error_config = 7;
148
+
123
149
  // Actually performs the purge. If `force` is set to false, return the
124
150
  // expected purge count without deleting any documents.
125
151
  bool force = 3;
@@ -156,4 +182,44 @@ message PurgeDocumentsMetadata {
156
182
 
157
183
  // Count of entries that encountered errors while processing.
158
184
  int64 failure_count = 4;
185
+
186
+ // Count of entries that were ignored as entries were not found.
187
+ int64 ignored_count = 5;
188
+ }
189
+
190
+ // Request message for
191
+ // [CompletionService.PurgeSuggestionDenyListEntries][google.cloud.discoveryengine.v1alpha.CompletionService.PurgeSuggestionDenyListEntries]
192
+ // method.
193
+ message PurgeSuggestionDenyListEntriesRequest {
194
+ // Required. The parent data store resource name for which to import denylist
195
+ // entries. Follows pattern projects/*/locations/*/collections/*/dataStores/*.
196
+ string parent = 1 [
197
+ (google.api.field_behavior) = REQUIRED,
198
+ (google.api.resource_reference) = {
199
+ type: "discoveryengine.googleapis.com/DataStore"
200
+ }
201
+ ];
202
+ }
203
+
204
+ // Response message for
205
+ // [CompletionService.PurgeSuggestionDenyListEntries][google.cloud.discoveryengine.v1alpha.CompletionService.PurgeSuggestionDenyListEntries]
206
+ // method.
207
+ message PurgeSuggestionDenyListEntriesResponse {
208
+ // Number of suggestion deny list entries purged.
209
+ int64 purge_count = 1;
210
+
211
+ // A sample of errors encountered while processing the request.
212
+ repeated google.rpc.Status error_samples = 2;
213
+ }
214
+
215
+ // Metadata related to the progress of the PurgeSuggestionDenyListEntries
216
+ // operation. This is returned by the google.longrunning.Operation.metadata
217
+ // field.
218
+ message PurgeSuggestionDenyListEntriesMetadata {
219
+ // Operation create time.
220
+ google.protobuf.Timestamp create_time = 1;
221
+
222
+ // Operation last update time. If the operation is done, this is also the
223
+ // finish time.
224
+ google.protobuf.Timestamp update_time = 2;
159
225
  }
@@ -68,7 +68,9 @@ message RecommendRequest {
68
68
  // config. For example, for Engine
69
69
  // `projects/*/locations/global/collections/*/engines/my-engine`, you can use
70
70
  // `projects/*/locations/global/collections/*/engines/my-engine/servingConfigs/my-engine`
71
- // for your [Recommend][] requests.
71
+ // for your
72
+ // [RecommendationService.Recommend][google.cloud.discoveryengine.v1alpha.RecommendationService.Recommend]
73
+ // requests.
72
74
  string serving_config = 1 [
73
75
  (google.api.field_behavior) = REQUIRED,
74
76
  (google.api.resource_reference) = {
@@ -86,6 +86,9 @@ message FieldConfig {
86
86
 
87
87
  // Field value type is Geolocation.
88
88
  GEOLOCATION = 6;
89
+
90
+ // Field value type is Datetime.
91
+ DATETIME = 7;
89
92
  }
90
93
 
91
94
  // The setting of Indexable options in schema.
@@ -20,6 +20,7 @@ import "google/api/annotations.proto";
20
20
  import "google/api/client.proto";
21
21
  import "google/api/field_behavior.proto";
22
22
  import "google/api/resource.proto";
23
+ import "google/cloud/discoveryengine/v1alpha/chunk.proto";
23
24
  import "google/cloud/discoveryengine/v1alpha/common.proto";
24
25
  import "google/cloud/discoveryengine/v1alpha/document.proto";
25
26
  import "google/protobuf/struct.proto";
@@ -69,6 +70,19 @@ message SearchRequest {
69
70
  }
70
71
  }
71
72
 
73
+ // A struct to define data stores to filter on in a search call.
74
+ message DataStoreSpec {
75
+ // Required. Full resource name of
76
+ // [DataStore][google.cloud.discoveryengine.v1alpha.DataStore], such as
77
+ // `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.
78
+ string data_store = 1 [
79
+ (google.api.field_behavior) = REQUIRED,
80
+ (google.api.resource_reference) = {
81
+ type: "discoveryengine.googleapis.com/DataStore"
82
+ }
83
+ ];
84
+ }
85
+
72
86
  // A facet specification to perform faceted search.
73
87
  message FacetSpec {
74
88
  // Specifies how a facet is computed.
@@ -212,9 +226,8 @@ message SearchRequest {
212
226
  // Examples:
213
227
  //
214
228
  // * To boost documents with document ID "doc_1" or "doc_2", and
215
- // color
216
- // "Red" or "Blue":
217
- // * (id: ANY("doc_1", "doc_2")) AND (color: ANY("Red","Blue"))
229
+ // color "Red" or "Blue":
230
+ // `(document_id: ANY("doc_1", "doc_2")) AND (color: ANY("Red", "Blue"))`
218
231
  string condition = 1;
219
232
 
220
233
  // Strength of the condition boost, which should be in [-1, 1]. Negative
@@ -330,8 +343,16 @@ message SearchRequest {
330
343
 
331
344
  // Specification of the model.
332
345
  message ModelSpec {
333
- // The string format of the model version.
334
- // e.g. stable, preview, etc.
346
+ // The model version used to generate the summary.
347
+ //
348
+ // Supported values are:
349
+ //
350
+ // * `stable`: string. Default value when no value is specified. Uses a
351
+ // generally available, fine-tuned version of the text-bison@001
352
+ // model.
353
+ // * `preview`: string. (Public preview) Uses a fine-tuned version of
354
+ // the text-bison@002 model. This model works only for summaries in
355
+ // English.
335
356
  string version = 1;
336
357
  }
337
358
 
@@ -339,7 +360,7 @@ message SearchRequest {
339
360
  // of results returned is less than `summaryResultCount`, the summary is
340
361
  // generated from all of the results.
341
362
  //
342
- // At most five results can be used to generate a summary.
363
+ // At most 10 results can be used to generate a summary.
343
364
  int32 summary_result_count = 1;
344
365
 
345
366
  // Specifies whether to include citations in the summary. The default
@@ -414,7 +435,7 @@ message SearchRequest {
414
435
  // `max_extractive_answer_count`, return all of the answers. Otherwise,
415
436
  // return the `max_extractive_answer_count`.
416
437
  //
417
- // At most one answer is returned for each
438
+ // At most five answers are returned for each
418
439
  // [SearchResult][google.cloud.discoveryengine.v1alpha.SearchResponse.SearchResult].
419
440
  int32 max_extractive_answer_count = 1;
420
441
 
@@ -455,6 +476,24 @@ message SearchRequest {
455
476
  int32 num_next_segments = 5;
456
477
  }
457
478
 
479
+ // Specifies the search result mode. If unspecified, the
480
+ // search result mode is based on
481
+ // [DataStore.DocumentProcessingConfig.chunking_config][]:
482
+ // * If [DataStore.DocumentProcessingConfig.chunking_config][] is specified,
483
+ // it defaults to `CHUNKS`.
484
+ // * Otherwise, it defaults to `DOCUMENTS`.
485
+ enum SearchResultMode {
486
+ // Default value.
487
+ SEARCH_RESULT_MODE_UNSPECIFIED = 0;
488
+
489
+ // Returns documents in the search result.
490
+ DOCUMENTS = 1;
491
+
492
+ // Returns chunks in the search result. Only available if the
493
+ // [DataStore.DocumentProcessingConfig.chunking_config][] is specified.
494
+ CHUNKS = 2;
495
+ }
496
+
458
497
  // If `snippetSpec` is not specified, snippets are not included in the
459
498
  // search response.
460
499
  SnippetSpec snippet_spec = 1;
@@ -466,6 +505,14 @@ message SearchRequest {
466
505
  // If there is no extractive_content_spec provided, there will be no
467
506
  // extractive answer in the search response.
468
507
  ExtractiveContentSpec extractive_content_spec = 3;
508
+
509
+ // Specifies the search result mode. If unspecified, the
510
+ // search result mode is based on
511
+ // [DataStore.DocumentProcessingConfig.chunking_config][]:
512
+ // * If [DataStore.DocumentProcessingConfig.chunking_config][] is specified,
513
+ // it defaults to `CHUNKS`.
514
+ // * Otherwise, it defaults to `DOCUMENTS`.
515
+ SearchResultMode search_result_mode = 4;
469
516
  }
470
517
 
471
518
  // The specification that uses customized query embedding vector to do
@@ -540,6 +587,9 @@ message SearchRequest {
540
587
  // If this field is negative, an `INVALID_ARGUMENT` is returned.
541
588
  int32 offset = 6;
542
589
 
590
+ // A list of data store specs to apply on a search call.
591
+ repeated DataStoreSpec data_store_specs = 32;
592
+
543
593
  // The filter syntax consists of an expression language for constructing a
544
594
  // predicate from one or more fields of the documents being filtered. Filter
545
595
  // expression is case-sensitive.
@@ -645,12 +695,13 @@ message SearchRequest {
645
695
 
646
696
  // Uses the provided embedding to do additional semantic document retrieval.
647
697
  // The retrieval is based on the dot product of
648
- // [SearchRequest.embedding_spec.embedding_vectors.vector][] and the document
649
- // embedding that is provided in
650
- // [SearchRequest.embedding_spec.embedding_vectors.field_path][].
698
+ // [SearchRequest.EmbeddingSpec.EmbeddingVector.vector][google.cloud.discoveryengine.v1alpha.SearchRequest.EmbeddingSpec.EmbeddingVector.vector]
699
+ // and the document embedding that is provided in
700
+ // [SearchRequest.EmbeddingSpec.EmbeddingVector.field_path][google.cloud.discoveryengine.v1alpha.SearchRequest.EmbeddingSpec.EmbeddingVector.field_path].
651
701
  //
652
- // If [SearchRequest.embedding_spec.embedding_vectors.field_path][] is not
653
- // provided, it will use [ServingConfig.embedding_config.field_paths][].
702
+ // If
703
+ // [SearchRequest.EmbeddingSpec.EmbeddingVector.field_path][google.cloud.discoveryengine.v1alpha.SearchRequest.EmbeddingSpec.EmbeddingVector.field_path]
704
+ // is not provided, it will use [ServingConfig.EmbeddingConfig.field_path][].
654
705
  EmbeddingSpec embedding_spec = 23;
655
706
 
656
707
  // The ranking expression controls the customized ranking on retrieval
@@ -697,6 +748,9 @@ message SearchRequest {
697
748
  // Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
698
749
  // for more details.
699
750
  map<string, string> user_labels = 22;
751
+
752
+ // Custom fine tuning configs.
753
+ CustomFineTuningSpec custom_fine_tuning_spec = 34;
700
754
  }
701
755
 
702
756
  // Response message for
@@ -713,6 +767,12 @@ message SearchResponse {
713
767
  // marked as retrievable are populated.
714
768
  Document document = 2;
715
769
 
770
+ // The chunk data in the search response if the
771
+ // [SearchRequest.ContentSearchSpec.search_result_mode][google.cloud.discoveryengine.v1alpha.SearchRequest.ContentSearchSpec.search_result_mode]
772
+ // is set to
773
+ // [CHUNKS][google.cloud.discoveryengine.v1alpha.SearchRequest.ContentSearchSpec.SearchResultMode.CHUNKS].
774
+ Chunk chunk = 18;
775
+
716
776
  // Google provided available scores.
717
777
  map<string, DoubleList> model_scores = 4;
718
778
  }
@@ -822,7 +882,7 @@ message SearchResponse {
822
882
  }
823
883
  ];
824
884
 
825
- // GCS or HTTP uri for the document.
885
+ // Cloud Storage or HTTP uri for the document.
826
886
  string uri = 3;
827
887
  }
828
888
 
@@ -887,6 +947,7 @@ message SearchResponse {
887
947
  // confidence scores.
888
948
  SafetyAttributes safety_attributes = 3;
889
949
 
950
+ // Summary with metadata information.
890
951
  SummaryWithMetadata summary_with_metadata = 4;
891
952
  }
892
953
 
@@ -58,41 +58,45 @@ service SearchTuningService {
58
58
  // [SearchTuningService.TrainCustomModel][google.cloud.discoveryengine.v1alpha.SearchTuningService.TrainCustomModel]
59
59
  // method.
60
60
  message TrainCustomModelRequest {
61
- // Gcs training data input.
61
+ // Cloud Storage training data input.
62
62
  message GcsTrainingInput {
63
- // The gcs corpus data which could be associated in train data.
64
- // The data path format is gs://<bucket_to_data>/<jsonl_file_name>.
63
+ // The Cloud Storage corpus data which could be associated in train data.
64
+ // The data path format is `gs://<bucket_to_data>/<jsonl_file_name>`.
65
65
  // A newline delimited jsonl/ndjson file.
66
- // * For search-tuning model, each line should have the _id, title
67
- // and text. Example: {"_id": "doc1", title: "relevant doc", "text":
68
- // "relevant text"}
66
+ //
67
+ // For search-tuning model, each line should have the _id, title
68
+ // and text. Example: {"_id": "doc1", title: "relevant doc", "text":
69
+ // "relevant text"}
69
70
  string corpus_data_path = 1;
70
71
 
71
72
  // The gcs query data which could be associated in train data.
72
- // The data path format is gs://<bucket_to_data>/<jsonl_file_name>.
73
+ // The data path format is `gs://<bucket_to_data>/<jsonl_file_name>`.
73
74
  // A newline delimited jsonl/ndjson file.
74
- // * For search-tuning model, each line should have the _id
75
- // and text. Example: {"_id": "query1", "text": "example query"}
75
+ //
76
+ // For search-tuning model, each line should have the _id
77
+ // and text. Example: {"_id": "query1", "text": "example query"}
76
78
  string query_data_path = 2;
77
79
 
78
- // Gcs training data path whose format should be
79
- // gs://<bucket_to_data>/<tsv_file_name>. The file should be in tsv format.
80
- // Each line should have the doc_id and query_id and score (number).
81
- // * For search-tuning model, it should have the query-id corpus-id
82
- // score as tsv file header. The score should be a number in [0, inf+). The
83
- // larger the number is, the more relevant the pair is. Example:
84
- // query-id\tcorpus-id\tscore
85
- // query1\tdoc1\t1
80
+ // Cloud Storage training data path whose format should be
81
+ // `gs://<bucket_to_data>/<tsv_file_name>`. The file should be in tsv
82
+ // format. Each line should have the doc_id and query_id and score (number).
83
+ //
84
+ // For search-tuning model, it should have the query-id corpus-id
85
+ // score as tsv file header. The score should be a number in `[0, inf+)`.
86
+ // The larger the number is, the more relevant the pair is. Example:
87
+ //
88
+ // * `query-id\tcorpus-id\tscore`
89
+ // * `query1\tdoc1\t1`
86
90
  string train_data_path = 3;
87
91
 
88
- // Gcs test data. Same format as train_data_path. If not provided, a
89
- // random 80/20 train/test split will be performed on train_data_path.
92
+ // Cloud Storage test data. Same format as train_data_path. If not provided,
93
+ // a random 80/20 train/test split will be performed on train_data_path.
90
94
  string test_data_path = 4;
91
95
  }
92
96
 
93
97
  // Model training input.
94
98
  oneof training_input {
95
- // Gcs training input.
99
+ // Cloud Storage training input.
96
100
  GcsTrainingInput gcs_training_input = 2;
97
101
  }
98
102