@maxim_mazurok/gapi.client.discoveryengine-v1beta 0.0.20241123 → 0.0.20241204
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.
- package/index.d.ts +372 -4
- package/package.json +1 -1
package/index.d.ts
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
// This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
|
|
10
10
|
// In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
|
|
11
11
|
// Generated from: https://discoveryengine.googleapis.com/$discovery/rest?version=v1beta
|
|
12
|
-
// Revision:
|
|
12
|
+
// Revision: 20241204
|
|
13
13
|
|
|
14
14
|
/// <reference types="gapi.client" />
|
|
15
15
|
|
|
@@ -182,6 +182,10 @@ declare namespace gapi.client {
|
|
|
182
182
|
completeTime?: string;
|
|
183
183
|
/** Output only. Answer creation timestamp. */
|
|
184
184
|
createTime?: string;
|
|
185
|
+
/** A score in the range of [0, 1] describing how grounded the answer is by the reference chunks. */
|
|
186
|
+
groundingScore?: number;
|
|
187
|
+
/** Optional. Grounding supports. */
|
|
188
|
+
groundingSupports?: GoogleCloudDiscoveryengineV1alphaAnswerGroundingSupport[];
|
|
185
189
|
/** Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*/answers/*` */
|
|
186
190
|
name?: string;
|
|
187
191
|
/** Query understanding information. */
|
|
@@ -207,6 +211,18 @@ declare namespace gapi.client {
|
|
|
207
211
|
/** ID of the citation source. */
|
|
208
212
|
referenceId?: string;
|
|
209
213
|
}
|
|
214
|
+
interface GoogleCloudDiscoveryengineV1alphaAnswerGroundingSupport {
|
|
215
|
+
/** Required. End of the claim, exclusive. */
|
|
216
|
+
endIndex?: string;
|
|
217
|
+
/** Indicates that this claim required grounding check. When the system decided this claim didn't require attribution/grounding check, this field is set to false. In that case, no grounding check was done for the claim and therefore `grounding_score`, `sources` is not returned. */
|
|
218
|
+
groundingCheckRequired?: boolean;
|
|
219
|
+
/** A score in the range of [0, 1] describing how grounded is a specific claim by the references. Higher value means that the claim is better supported by the reference chunks. */
|
|
220
|
+
groundingScore?: number;
|
|
221
|
+
/** Optional. Citation sources for the claim. */
|
|
222
|
+
sources?: GoogleCloudDiscoveryengineV1alphaAnswerCitationSource[];
|
|
223
|
+
/** Required. Index indicates the start of the claim, measured in bytes (UTF-8 unicode). */
|
|
224
|
+
startIndex?: string;
|
|
225
|
+
}
|
|
210
226
|
interface GoogleCloudDiscoveryengineV1alphaAnswerQueryUnderstandingInfo {
|
|
211
227
|
/** Query classification information. */
|
|
212
228
|
queryClassificationInfo?: GoogleCloudDiscoveryengineV1alphaAnswerQueryUnderstandingInfoQueryClassificationInfo[];
|
|
@@ -560,6 +576,10 @@ declare namespace gapi.client {
|
|
|
560
576
|
/** Operation last update time. If the operation is done, this is also the finish time. */
|
|
561
577
|
updateTime?: string;
|
|
562
578
|
}
|
|
579
|
+
interface GoogleCloudDiscoveryengineV1alphaDeleteSessionRequest {
|
|
580
|
+
/** Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` */
|
|
581
|
+
name?: string;
|
|
582
|
+
}
|
|
563
583
|
interface GoogleCloudDiscoveryengineV1alphaDeleteSitemapMetadata {
|
|
564
584
|
/** Operation create time. */
|
|
565
585
|
createTime?: string;
|
|
@@ -785,6 +805,10 @@ declare namespace gapi.client {
|
|
|
785
805
|
/** If searchable_option is SEARCHABLE_ENABLED, field values are searchable by text queries in SearchService.Search. If SEARCHABLE_ENABLED but field type is numerical, field values will not be searchable by text queries in SearchService.Search, as there are no text values associated to numerical fields. If searchable_option is unset, the server behavior defaults to SEARCHABLE_DISABLED for fields that support setting searchable options. Only `string` fields that have no key property mapping support setting searchable_option. For those fields that do not support setting searchable options, the server will skip searchable option setting, and setting searchable_option for those fields will throw `INVALID_ARGUMENT` error. */
|
|
786
806
|
searchableOption?: string;
|
|
787
807
|
}
|
|
808
|
+
interface GoogleCloudDiscoveryengineV1alphaGetSessionRequest {
|
|
809
|
+
/** Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` */
|
|
810
|
+
name?: string;
|
|
811
|
+
}
|
|
788
812
|
interface GoogleCloudDiscoveryengineV1alphaGetUriPatternDocumentDataResponse {
|
|
789
813
|
/** Document data keyed by URI pattern. For example: document_data_map = { "www.url1.com/*": { "Categories": ["category1", "category2"] }, "www.url2.com/*": { "Categories": ["category3"] } } */
|
|
790
814
|
documentDataMap?: {[P in string]: {[P in string]: any}};
|
|
@@ -913,6 +937,24 @@ declare namespace gapi.client {
|
|
|
913
937
|
/** List of custom tuning models. */
|
|
914
938
|
models?: GoogleCloudDiscoveryengineV1alphaCustomTuningModel[];
|
|
915
939
|
}
|
|
940
|
+
interface GoogleCloudDiscoveryengineV1alphaListSessionsRequest {
|
|
941
|
+
/** A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id" */
|
|
942
|
+
filter?: string;
|
|
943
|
+
/** A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: "update_time desc" "create_time" */
|
|
944
|
+
orderBy?: string;
|
|
945
|
+
/** Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000. */
|
|
946
|
+
pageSize?: number;
|
|
947
|
+
/** A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page. */
|
|
948
|
+
pageToken?: string;
|
|
949
|
+
/** Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` */
|
|
950
|
+
parent?: string;
|
|
951
|
+
}
|
|
952
|
+
interface GoogleCloudDiscoveryengineV1alphaListSessionsResponse {
|
|
953
|
+
/** Pagination token, if not returned indicates the last page. */
|
|
954
|
+
nextPageToken?: string;
|
|
955
|
+
/** All the Sessions for a given data store. */
|
|
956
|
+
sessions?: GoogleCloudDiscoveryengineV1alphaSession[];
|
|
957
|
+
}
|
|
916
958
|
interface GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig {
|
|
917
959
|
/** Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED. */
|
|
918
960
|
mode?: string;
|
|
@@ -1269,6 +1311,8 @@ declare namespace gapi.client {
|
|
|
1269
1311
|
version?: string;
|
|
1270
1312
|
}
|
|
1271
1313
|
interface GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec {
|
|
1314
|
+
/** Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results) */
|
|
1315
|
+
boostSpec?: GoogleCloudDiscoveryengineV1alphaSearchRequestBoostSpec;
|
|
1272
1316
|
/** Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. */
|
|
1273
1317
|
dataStore?: string;
|
|
1274
1318
|
/** Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) */
|
|
@@ -1452,6 +1496,12 @@ declare namespace gapi.client {
|
|
|
1452
1496
|
/** Operation last update time. If the operation is done, this is also the finish time. */
|
|
1453
1497
|
updateTime?: string;
|
|
1454
1498
|
}
|
|
1499
|
+
interface GoogleCloudDiscoveryengineV1alphaUpdateSessionRequest {
|
|
1500
|
+
/** Required. The Session to update. */
|
|
1501
|
+
session?: GoogleCloudDiscoveryengineV1alphaSession;
|
|
1502
|
+
/** Indicates which fields in the provided Session to update. The following are NOT supported: * Session.name If not set or empty, all supported fields are updated. */
|
|
1503
|
+
updateMask?: string;
|
|
1504
|
+
}
|
|
1455
1505
|
interface GoogleCloudDiscoveryengineV1alphaUpdateTargetSiteMetadata {
|
|
1456
1506
|
/** Operation create time. */
|
|
1457
1507
|
createTime?: string;
|
|
@@ -1582,6 +1632,10 @@ declare namespace gapi.client {
|
|
|
1582
1632
|
completeTime?: string;
|
|
1583
1633
|
/** Output only. Answer creation timestamp. */
|
|
1584
1634
|
createTime?: string;
|
|
1635
|
+
/** A score in the range of [0, 1] describing how grounded the answer is by the reference chunks. */
|
|
1636
|
+
groundingScore?: number;
|
|
1637
|
+
/** Optional. Grounding supports. */
|
|
1638
|
+
groundingSupports?: GoogleCloudDiscoveryengineV1betaAnswerGroundingSupport[];
|
|
1585
1639
|
/** Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*/answers/*` */
|
|
1586
1640
|
name?: string;
|
|
1587
1641
|
/** Query understanding information. */
|
|
@@ -1607,6 +1661,18 @@ declare namespace gapi.client {
|
|
|
1607
1661
|
/** ID of the citation source. */
|
|
1608
1662
|
referenceId?: string;
|
|
1609
1663
|
}
|
|
1664
|
+
interface GoogleCloudDiscoveryengineV1betaAnswerGroundingSupport {
|
|
1665
|
+
/** Required. End of the claim, exclusive. */
|
|
1666
|
+
endIndex?: string;
|
|
1667
|
+
/** Indicates that this claim required grounding check. When the system decided this claim didn't require attribution/grounding check, this field is set to false. In that case, no grounding check was done for the claim and therefore `grounding_score`, `sources` is not returned. */
|
|
1668
|
+
groundingCheckRequired?: boolean;
|
|
1669
|
+
/** A score in the range of [0, 1] describing how grounded is a specific claim by the references. Higher value means that the claim is better supported by the reference chunks. */
|
|
1670
|
+
groundingScore?: number;
|
|
1671
|
+
/** Optional. Citation sources for the claim. */
|
|
1672
|
+
sources?: GoogleCloudDiscoveryengineV1betaAnswerCitationSource[];
|
|
1673
|
+
/** Required. Index indicates the start of the claim, measured in bytes (UTF-8 unicode). */
|
|
1674
|
+
startIndex?: string;
|
|
1675
|
+
}
|
|
1610
1676
|
interface GoogleCloudDiscoveryengineV1betaAnswerQueryRequest {
|
|
1611
1677
|
/** Answer generation specification. */
|
|
1612
1678
|
answerGenerationSpec?: GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpec;
|
|
@@ -2622,6 +2688,8 @@ declare namespace gapi.client {
|
|
|
2622
2688
|
gcsStagingDir?: string;
|
|
2623
2689
|
/** The FHIR resource types to import. The resource types should be a subset of all [supported FHIR resource types](https://cloud.google.com/generative-ai-app-builder/docs/fhir-schema-reference#resource-level-specification). Default to all supported FHIR resource types if empty. */
|
|
2624
2690
|
resourceTypes?: string[];
|
|
2691
|
+
/** Optional. Whether to update the DataStore schema to the latest predefined schema. If true, the DataStore schema will be updated to include any FHIR fields or resource types that have been added since the last import and corresponding FHIR resources will be imported from the FHIR store. Note this field cannot be used in conjunction with `resource_types`. It should be used after initial import. */
|
|
2692
|
+
updateFromLatestPredefinedSchema?: boolean;
|
|
2625
2693
|
}
|
|
2626
2694
|
interface GoogleCloudDiscoveryengineV1betaFirestoreSource {
|
|
2627
2695
|
/** Required. The Firestore collection (or entity) to copy the data from with a length limit of 1,500 characters. */
|
|
@@ -3389,6 +3457,8 @@ declare namespace gapi.client {
|
|
|
3389
3457
|
version?: string;
|
|
3390
3458
|
}
|
|
3391
3459
|
interface GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec {
|
|
3460
|
+
/** Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results) */
|
|
3461
|
+
boostSpec?: GoogleCloudDiscoveryengineV1betaSearchRequestBoostSpec;
|
|
3392
3462
|
/** Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. */
|
|
3393
3463
|
dataStore?: string;
|
|
3394
3464
|
/** Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) */
|
|
@@ -4416,6 +4486,130 @@ declare namespace gapi.client {
|
|
|
4416
4486
|
/** Required. The URL for the page the user wants to promote. */
|
|
4417
4487
|
uri?: string;
|
|
4418
4488
|
}
|
|
4489
|
+
interface GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpec {
|
|
4490
|
+
/** Specifies the chunk spec to be returned from the search response. Only available if the SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS */
|
|
4491
|
+
chunkSpec?: GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecChunkSpec;
|
|
4492
|
+
/** If there is no extractive_content_spec provided, there will be no extractive answer in the search response. */
|
|
4493
|
+
extractiveContentSpec?: GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecExtractiveContentSpec;
|
|
4494
|
+
/** Specifies the search result mode. If unspecified, the search result mode defaults to `DOCUMENTS`. */
|
|
4495
|
+
searchResultMode?: string;
|
|
4496
|
+
/** If `snippetSpec` is not specified, snippets are not included in the search response. */
|
|
4497
|
+
snippetSpec?: GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecSnippetSpec;
|
|
4498
|
+
/** If `summarySpec` is not specified, summaries are not included in the search response. */
|
|
4499
|
+
summarySpec?: GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecSummarySpec;
|
|
4500
|
+
}
|
|
4501
|
+
interface GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecChunkSpec {
|
|
4502
|
+
/** The number of next chunks to be returned of the current chunk. The maximum allowed value is 3. If not specified, no next chunks will be returned. */
|
|
4503
|
+
numNextChunks?: number;
|
|
4504
|
+
/** The number of previous chunks to be returned of the current chunk. The maximum allowed value is 3. If not specified, no previous chunks will be returned. */
|
|
4505
|
+
numPreviousChunks?: number;
|
|
4506
|
+
}
|
|
4507
|
+
interface GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecExtractiveContentSpec {
|
|
4508
|
+
/** The maximum number of extractive answers returned in each search result. An extractive answer is a verbatim answer extracted from the original document, which provides a precise and contextually relevant answer to the search query. If the number of matching answers is less than the `max_extractive_answer_count`, return all of the answers. Otherwise, return the `max_extractive_answer_count`. At most five answers are returned for each SearchResult. */
|
|
4509
|
+
maxExtractiveAnswerCount?: number;
|
|
4510
|
+
/** The max number of extractive segments returned in each search result. Only applied if the DataStore is set to DataStore.ContentConfig.CONTENT_REQUIRED or DataStore.solution_types is SOLUTION_TYPE_CHAT. An extractive segment is a text segment extracted from the original document that is relevant to the search query, and, in general, more verbose than an extractive answer. The segment could then be used as input for LLMs to generate summaries and answers. If the number of matching segments is less than `max_extractive_segment_count`, return all of the segments. Otherwise, return the `max_extractive_segment_count`. */
|
|
4511
|
+
maxExtractiveSegmentCount?: number;
|
|
4512
|
+
/** Return at most `num_next_segments` segments after each selected segments. */
|
|
4513
|
+
numNextSegments?: number;
|
|
4514
|
+
/** Specifies whether to also include the adjacent from each selected segments. Return at most `num_previous_segments` segments before each selected segments. */
|
|
4515
|
+
numPreviousSegments?: number;
|
|
4516
|
+
/** Specifies whether to return the confidence score from the extractive segments in each search result. This feature is available only for new or allowlisted data stores. To allowlist your data store, contact your Customer Engineer. The default value is `false`. */
|
|
4517
|
+
returnExtractiveSegmentScore?: boolean;
|
|
4518
|
+
}
|
|
4519
|
+
interface GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecSnippetSpec {
|
|
4520
|
+
/** [DEPRECATED] This field is deprecated. To control snippet return, use `return_snippet` field. For backwards compatibility, we will return snippet if max_snippet_count > 0. */
|
|
4521
|
+
maxSnippetCount?: number;
|
|
4522
|
+
/** [DEPRECATED] This field is deprecated and will have no affect on the snippet. */
|
|
4523
|
+
referenceOnly?: boolean;
|
|
4524
|
+
/** If `true`, then return snippet. If no snippet can be generated, we return "No snippet is available for this page." A `snippet_status` with `SUCCESS` or `NO_SNIPPET_AVAILABLE` will also be returned. */
|
|
4525
|
+
returnSnippet?: boolean;
|
|
4526
|
+
}
|
|
4527
|
+
interface GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecSummarySpec {
|
|
4528
|
+
/** Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead. */
|
|
4529
|
+
ignoreAdversarialQuery?: boolean;
|
|
4530
|
+
/** Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead. */
|
|
4531
|
+
ignoreJailBreakingQuery?: boolean;
|
|
4532
|
+
/** Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers. */
|
|
4533
|
+
ignoreLowRelevantContent?: boolean;
|
|
4534
|
+
/** Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead. */
|
|
4535
|
+
ignoreNonSummarySeekingQuery?: boolean;
|
|
4536
|
+
/** Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results. */
|
|
4537
|
+
includeCitations?: boolean;
|
|
4538
|
+
/** Language code for Summary. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Note: This is an experimental feature. */
|
|
4539
|
+
languageCode?: string;
|
|
4540
|
+
/** If specified, the spec will be used to modify the prompt provided to the LLM. */
|
|
4541
|
+
modelPromptSpec?: GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecSummarySpecModelPromptSpec;
|
|
4542
|
+
/** If specified, the spec will be used to modify the model specification provided to the LLM. */
|
|
4543
|
+
modelSpec?: GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecSummarySpecModelSpec;
|
|
4544
|
+
/** The number of top results to generate the summary from. If the number of results returned is less than `summaryResultCount`, the summary is generated from all of the results. At most 10 results for documents mode, or 50 for chunks mode, can be used to generate a summary. The chunks mode is used when SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS. */
|
|
4545
|
+
summaryResultCount?: number;
|
|
4546
|
+
/** If true, answer will be generated from most relevant chunks from top search results. This feature will improve summary quality. Note that with this feature enabled, not all top search results will be referenced and included in the reference list, so the citation source index only points to the search results listed in the reference list. */
|
|
4547
|
+
useSemanticChunks?: boolean;
|
|
4548
|
+
}
|
|
4549
|
+
interface GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecSummarySpecModelPromptSpec {
|
|
4550
|
+
/** Text at the beginning of the prompt that instructs the assistant. Examples are available in the user guide. */
|
|
4551
|
+
preamble?: string;
|
|
4552
|
+
}
|
|
4553
|
+
interface GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecSummarySpecModelSpec {
|
|
4554
|
+
/** The model version used to generate the summary. Supported values are: * `stable`: string. Default value when no value is specified. Uses a generally available, fine-tuned model. For more information, see [Answer generation model versions and lifecycle](https://cloud.google.com/generative-ai-app-builder/docs/answer-generation-models). * `preview`: string. (Public preview) Uses a preview model. For more information, see [Answer generation model versions and lifecycle](https://cloud.google.com/generative-ai-app-builder/docs/answer-generation-models). */
|
|
4555
|
+
version?: string;
|
|
4556
|
+
}
|
|
4557
|
+
interface GoogleCloudDiscoveryengineV1ServingConfig {
|
|
4558
|
+
/** Boost controls to use in serving path. All triggered boost controls will be applied. Boost controls must be in the same data store as the serving config. Maximum of 20 boost controls. */
|
|
4559
|
+
boostControlIds?: string[];
|
|
4560
|
+
/** Output only. ServingConfig created timestamp. */
|
|
4561
|
+
createTime?: string;
|
|
4562
|
+
/** Required. The human readable serving config display name. Used in Discovery UI. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. */
|
|
4563
|
+
displayName?: string;
|
|
4564
|
+
/** Condition do not associate specifications. If multiple do not associate conditions match, all matching do not associate controls in the list will execute. Order does not matter. Maximum number of specifications is 100. Can only be set if SolutionType is SOLUTION_TYPE_SEARCH. */
|
|
4565
|
+
dissociateControlIds?: string[];
|
|
4566
|
+
/** How much diversity to use in recommendation model results e.g. `medium-diversity` or `high-diversity`. Currently supported values: * `no-diversity` * `low-diversity` * `medium-diversity` * `high-diversity` * `auto-diversity` If not specified, we choose default based on recommendation model type. Default value: `no-diversity`. Can only be set if SolutionType is SOLUTION_TYPE_RECOMMENDATION. */
|
|
4567
|
+
diversityLevel?: string;
|
|
4568
|
+
/** Filter controls to use in serving path. All triggered filter controls will be applied. Filter controls must be in the same data store as the serving config. Maximum of 20 filter controls. */
|
|
4569
|
+
filterControlIds?: string[];
|
|
4570
|
+
/** The GenericConfig of the serving configuration. */
|
|
4571
|
+
genericConfig?: GoogleCloudDiscoveryengineV1ServingConfigGenericConfig;
|
|
4572
|
+
/** Condition ignore specifications. If multiple ignore conditions match, all matching ignore controls in the list will execute. Order does not matter. Maximum number of specifications is 100. */
|
|
4573
|
+
ignoreControlIds?: string[];
|
|
4574
|
+
/** The MediaConfig of the serving configuration. */
|
|
4575
|
+
mediaConfig?: GoogleCloudDiscoveryengineV1ServingConfigMediaConfig;
|
|
4576
|
+
/** The id of the model to use at serving time. Currently only RecommendationModels are supported. Can be changed but only to a compatible model (e.g. others-you-may-like CTR to others-you-may-like CVR). Required when SolutionType is SOLUTION_TYPE_RECOMMENDATION. */
|
|
4577
|
+
modelId?: string;
|
|
4578
|
+
/** Immutable. Fully qualified name `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}/servingConfigs/{serving_config_id}` */
|
|
4579
|
+
name?: string;
|
|
4580
|
+
/** Condition oneway synonyms specifications. If multiple oneway synonyms conditions match, all matching oneway synonyms controls in the list will execute. Maximum number of specifications is 100. Can only be set if SolutionType is SOLUTION_TYPE_SEARCH. */
|
|
4581
|
+
onewaySynonymsControlIds?: string[];
|
|
4582
|
+
/** Condition promote specifications. Maximum number of specifications is 100. */
|
|
4583
|
+
promoteControlIds?: string[];
|
|
4584
|
+
/** The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if SearchRequest.ranking_expression is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by "+". * ranking_expression = function, { " + ", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. */
|
|
4585
|
+
rankingExpression?: string;
|
|
4586
|
+
/** IDs of the redirect controls. Only the first triggered redirect action is applied, even if multiple apply. Maximum number of specifications is 100. Can only be set if SolutionType is SOLUTION_TYPE_SEARCH. */
|
|
4587
|
+
redirectControlIds?: string[];
|
|
4588
|
+
/** Condition replacement specifications. Applied according to the order in the list. A previously replaced term can not be re-replaced. Maximum number of specifications is 100. Can only be set if SolutionType is SOLUTION_TYPE_SEARCH. */
|
|
4589
|
+
replacementControlIds?: string[];
|
|
4590
|
+
/** Required. Immutable. Specifies the solution type that a serving config can be associated with. */
|
|
4591
|
+
solutionType?: string;
|
|
4592
|
+
/** Condition synonyms specifications. If multiple synonyms conditions match, all matching synonyms controls in the list will execute. Maximum number of specifications is 100. Can only be set if SolutionType is SOLUTION_TYPE_SEARCH. */
|
|
4593
|
+
synonymsControlIds?: string[];
|
|
4594
|
+
/** Output only. ServingConfig updated timestamp. */
|
|
4595
|
+
updateTime?: string;
|
|
4596
|
+
}
|
|
4597
|
+
interface GoogleCloudDiscoveryengineV1ServingConfigGenericConfig {
|
|
4598
|
+
/** Specifies the expected behavior of content search. Only valid for content-search enabled data store. */
|
|
4599
|
+
contentSearchSpec?: GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpec;
|
|
4600
|
+
}
|
|
4601
|
+
interface GoogleCloudDiscoveryengineV1ServingConfigMediaConfig {
|
|
4602
|
+
/** Specifies the content freshness used for recommendation result. Contents will be demoted if contents were published for more than content freshness cutoff days. */
|
|
4603
|
+
contentFreshnessCutoffDays?: number;
|
|
4604
|
+
/** Specifies the content watched percentage threshold for demotion. Threshold value must be between [0, 1.0] inclusive. */
|
|
4605
|
+
contentWatchedPercentageThreshold?: number;
|
|
4606
|
+
/** Specifies the content watched minutes threshold for demotion. */
|
|
4607
|
+
contentWatchedSecondsThreshold?: number;
|
|
4608
|
+
/** Optional. Specifies the number of days to look back for demoting watched content. If set to zero or unset, defaults to the maximum of 365 days. */
|
|
4609
|
+
demoteContentWatchedPastDays?: number;
|
|
4610
|
+
/** Specifies the event type used for demoting recommendation result. Currently supported values: * `view-item`: Item viewed. * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc. If unset, watch history demotion will not be applied. Content freshness demotion will still be applied. */
|
|
4611
|
+
demotionEventType?: string;
|
|
4612
|
+
}
|
|
4419
4613
|
interface GoogleCloudDiscoveryengineV1SiteVerificationInfo {
|
|
4420
4614
|
/** Site verification state indicating the ownership and validity. */
|
|
4421
4615
|
siteVerificationState?: string;
|
|
@@ -6570,6 +6764,64 @@ declare namespace gapi.client {
|
|
|
6570
6764
|
},
|
|
6571
6765
|
body: GoogleCloudDiscoveryengineV1betaSearchRequest
|
|
6572
6766
|
): Request<GoogleCloudDiscoveryengineV1betaSearchResponse>;
|
|
6767
|
+
/** Answer query method (streaming). It takes one AnswerQueryRequest and returns multiple AnswerQueryResponse messages in a stream. */
|
|
6768
|
+
streamAnswer(request: {
|
|
6769
|
+
/** V1 error format. */
|
|
6770
|
+
'$.xgafv'?: string;
|
|
6771
|
+
/** OAuth access token. */
|
|
6772
|
+
access_token?: string;
|
|
6773
|
+
/** Data format for response. */
|
|
6774
|
+
alt?: string;
|
|
6775
|
+
/** JSONP */
|
|
6776
|
+
callback?: string;
|
|
6777
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
6778
|
+
fields?: string;
|
|
6779
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
6780
|
+
key?: string;
|
|
6781
|
+
/** OAuth 2.0 token for the current user. */
|
|
6782
|
+
oauth_token?: string;
|
|
6783
|
+
/** Returns response with indentations and line breaks. */
|
|
6784
|
+
prettyPrint?: boolean;
|
|
6785
|
+
/** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
|
|
6786
|
+
quotaUser?: string;
|
|
6787
|
+
/** Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search. */
|
|
6788
|
+
servingConfig: string;
|
|
6789
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
6790
|
+
upload_protocol?: string;
|
|
6791
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
6792
|
+
uploadType?: string;
|
|
6793
|
+
/** Request body */
|
|
6794
|
+
resource: GoogleCloudDiscoveryengineV1betaAnswerQueryRequest;
|
|
6795
|
+
}): Request<GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>;
|
|
6796
|
+
streamAnswer(
|
|
6797
|
+
request: {
|
|
6798
|
+
/** V1 error format. */
|
|
6799
|
+
'$.xgafv'?: string;
|
|
6800
|
+
/** OAuth access token. */
|
|
6801
|
+
access_token?: string;
|
|
6802
|
+
/** Data format for response. */
|
|
6803
|
+
alt?: string;
|
|
6804
|
+
/** JSONP */
|
|
6805
|
+
callback?: string;
|
|
6806
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
6807
|
+
fields?: string;
|
|
6808
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
6809
|
+
key?: string;
|
|
6810
|
+
/** OAuth 2.0 token for the current user. */
|
|
6811
|
+
oauth_token?: string;
|
|
6812
|
+
/** Returns response with indentations and line breaks. */
|
|
6813
|
+
prettyPrint?: boolean;
|
|
6814
|
+
/** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
|
|
6815
|
+
quotaUser?: string;
|
|
6816
|
+
/** Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search. */
|
|
6817
|
+
servingConfig: string;
|
|
6818
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
6819
|
+
upload_protocol?: string;
|
|
6820
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
6821
|
+
uploadType?: string;
|
|
6822
|
+
},
|
|
6823
|
+
body: GoogleCloudDiscoveryengineV1betaAnswerQueryRequest
|
|
6824
|
+
): Request<GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>;
|
|
6573
6825
|
}
|
|
6574
6826
|
interface AnswersResource {
|
|
6575
6827
|
/** Gets a Answer. */
|
|
@@ -7690,7 +7942,7 @@ declare namespace gapi.client {
|
|
|
7690
7942
|
key?: string;
|
|
7691
7943
|
/** OAuth 2.0 token for the current user. */
|
|
7692
7944
|
oauth_token?: string;
|
|
7693
|
-
/** Required. The parent
|
|
7945
|
+
/** Required. The parent resource name. If the collect user event action is applied in DataStore level, the format is: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`. If the collect user event action is applied in Location level, for example, the event with Document across multiple DataStore, the format is: `projects/{project}/locations/{location}`. */
|
|
7694
7946
|
parent: string;
|
|
7695
7947
|
/** Returns response with indentations and line breaks. */
|
|
7696
7948
|
prettyPrint?: boolean;
|
|
@@ -9204,6 +9456,64 @@ declare namespace gapi.client {
|
|
|
9204
9456
|
},
|
|
9205
9457
|
body: GoogleCloudDiscoveryengineV1betaSearchRequest
|
|
9206
9458
|
): Request<GoogleCloudDiscoveryengineV1betaSearchResponse>;
|
|
9459
|
+
/** Answer query method (streaming). It takes one AnswerQueryRequest and returns multiple AnswerQueryResponse messages in a stream. */
|
|
9460
|
+
streamAnswer(request: {
|
|
9461
|
+
/** V1 error format. */
|
|
9462
|
+
'$.xgafv'?: string;
|
|
9463
|
+
/** OAuth access token. */
|
|
9464
|
+
access_token?: string;
|
|
9465
|
+
/** Data format for response. */
|
|
9466
|
+
alt?: string;
|
|
9467
|
+
/** JSONP */
|
|
9468
|
+
callback?: string;
|
|
9469
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
9470
|
+
fields?: string;
|
|
9471
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
9472
|
+
key?: string;
|
|
9473
|
+
/** OAuth 2.0 token for the current user. */
|
|
9474
|
+
oauth_token?: string;
|
|
9475
|
+
/** Returns response with indentations and line breaks. */
|
|
9476
|
+
prettyPrint?: boolean;
|
|
9477
|
+
/** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
|
|
9478
|
+
quotaUser?: string;
|
|
9479
|
+
/** Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search. */
|
|
9480
|
+
servingConfig: string;
|
|
9481
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
9482
|
+
upload_protocol?: string;
|
|
9483
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
9484
|
+
uploadType?: string;
|
|
9485
|
+
/** Request body */
|
|
9486
|
+
resource: GoogleCloudDiscoveryengineV1betaAnswerQueryRequest;
|
|
9487
|
+
}): Request<GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>;
|
|
9488
|
+
streamAnswer(
|
|
9489
|
+
request: {
|
|
9490
|
+
/** V1 error format. */
|
|
9491
|
+
'$.xgafv'?: string;
|
|
9492
|
+
/** OAuth access token. */
|
|
9493
|
+
access_token?: string;
|
|
9494
|
+
/** Data format for response. */
|
|
9495
|
+
alt?: string;
|
|
9496
|
+
/** JSONP */
|
|
9497
|
+
callback?: string;
|
|
9498
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
9499
|
+
fields?: string;
|
|
9500
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
9501
|
+
key?: string;
|
|
9502
|
+
/** OAuth 2.0 token for the current user. */
|
|
9503
|
+
oauth_token?: string;
|
|
9504
|
+
/** Returns response with indentations and line breaks. */
|
|
9505
|
+
prettyPrint?: boolean;
|
|
9506
|
+
/** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
|
|
9507
|
+
quotaUser?: string;
|
|
9508
|
+
/** Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search. */
|
|
9509
|
+
servingConfig: string;
|
|
9510
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
9511
|
+
upload_protocol?: string;
|
|
9512
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
9513
|
+
uploadType?: string;
|
|
9514
|
+
},
|
|
9515
|
+
body: GoogleCloudDiscoveryengineV1betaAnswerQueryRequest
|
|
9516
|
+
): Request<GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>;
|
|
9207
9517
|
}
|
|
9208
9518
|
interface AnswersResource {
|
|
9209
9519
|
/** Gets a Answer. */
|
|
@@ -11744,6 +12054,64 @@ declare namespace gapi.client {
|
|
|
11744
12054
|
},
|
|
11745
12055
|
body: GoogleCloudDiscoveryengineV1betaSearchRequest
|
|
11746
12056
|
): Request<GoogleCloudDiscoveryengineV1betaSearchResponse>;
|
|
12057
|
+
/** Answer query method (streaming). It takes one AnswerQueryRequest and returns multiple AnswerQueryResponse messages in a stream. */
|
|
12058
|
+
streamAnswer(request: {
|
|
12059
|
+
/** V1 error format. */
|
|
12060
|
+
'$.xgafv'?: string;
|
|
12061
|
+
/** OAuth access token. */
|
|
12062
|
+
access_token?: string;
|
|
12063
|
+
/** Data format for response. */
|
|
12064
|
+
alt?: string;
|
|
12065
|
+
/** JSONP */
|
|
12066
|
+
callback?: string;
|
|
12067
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
12068
|
+
fields?: string;
|
|
12069
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
12070
|
+
key?: string;
|
|
12071
|
+
/** OAuth 2.0 token for the current user. */
|
|
12072
|
+
oauth_token?: string;
|
|
12073
|
+
/** Returns response with indentations and line breaks. */
|
|
12074
|
+
prettyPrint?: boolean;
|
|
12075
|
+
/** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
|
|
12076
|
+
quotaUser?: string;
|
|
12077
|
+
/** Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search. */
|
|
12078
|
+
servingConfig: string;
|
|
12079
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
12080
|
+
upload_protocol?: string;
|
|
12081
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
12082
|
+
uploadType?: string;
|
|
12083
|
+
/** Request body */
|
|
12084
|
+
resource: GoogleCloudDiscoveryengineV1betaAnswerQueryRequest;
|
|
12085
|
+
}): Request<GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>;
|
|
12086
|
+
streamAnswer(
|
|
12087
|
+
request: {
|
|
12088
|
+
/** V1 error format. */
|
|
12089
|
+
'$.xgafv'?: string;
|
|
12090
|
+
/** OAuth access token. */
|
|
12091
|
+
access_token?: string;
|
|
12092
|
+
/** Data format for response. */
|
|
12093
|
+
alt?: string;
|
|
12094
|
+
/** JSONP */
|
|
12095
|
+
callback?: string;
|
|
12096
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
12097
|
+
fields?: string;
|
|
12098
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
12099
|
+
key?: string;
|
|
12100
|
+
/** OAuth 2.0 token for the current user. */
|
|
12101
|
+
oauth_token?: string;
|
|
12102
|
+
/** Returns response with indentations and line breaks. */
|
|
12103
|
+
prettyPrint?: boolean;
|
|
12104
|
+
/** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
|
|
12105
|
+
quotaUser?: string;
|
|
12106
|
+
/** Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search. */
|
|
12107
|
+
servingConfig: string;
|
|
12108
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
12109
|
+
upload_protocol?: string;
|
|
12110
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
12111
|
+
uploadType?: string;
|
|
12112
|
+
},
|
|
12113
|
+
body: GoogleCloudDiscoveryengineV1betaAnswerQueryRequest
|
|
12114
|
+
): Request<GoogleCloudDiscoveryengineV1betaAnswerQueryResponse>;
|
|
11747
12115
|
}
|
|
11748
12116
|
interface AnswersResource {
|
|
11749
12117
|
/** Gets a Answer. */
|
|
@@ -12678,7 +13046,7 @@ declare namespace gapi.client {
|
|
|
12678
13046
|
key?: string;
|
|
12679
13047
|
/** OAuth 2.0 token for the current user. */
|
|
12680
13048
|
oauth_token?: string;
|
|
12681
|
-
/** Required. The parent
|
|
13049
|
+
/** Required. The parent resource name. If the collect user event action is applied in DataStore level, the format is: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`. If the collect user event action is applied in Location level, for example, the event with Document across multiple DataStore, the format is: `projects/{project}/locations/{location}`. */
|
|
12682
13050
|
parent: string;
|
|
12683
13051
|
/** Returns response with indentations and line breaks. */
|
|
12684
13052
|
prettyPrint?: boolean;
|
|
@@ -14132,7 +14500,7 @@ declare namespace gapi.client {
|
|
|
14132
14500
|
key?: string;
|
|
14133
14501
|
/** OAuth 2.0 token for the current user. */
|
|
14134
14502
|
oauth_token?: string;
|
|
14135
|
-
/** Required. The parent
|
|
14503
|
+
/** Required. The parent resource name. If the collect user event action is applied in DataStore level, the format is: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`. If the collect user event action is applied in Location level, for example, the event with Document across multiple DataStore, the format is: `projects/{project}/locations/{location}`. */
|
|
14136
14504
|
parent: string;
|
|
14137
14505
|
/** Returns response with indentations and line breaks. */
|
|
14138
14506
|
prettyPrint?: boolean;
|