- Ressource : WidgetConfig
- Représentation JSON
- UIComponentField
- DeviceVisibility
- FacetField
- DataStoreType
- ResultDisplayType
- DataStoreUiConfig
- CollectionComponent
- DataStoreComponent
- DataStoreConfigType
- UiSettings
- InteractionType
- GenerativeAnswerConfig
- ImageSource
- FeatureState
- AccessSettings
- UiBrandingSettings
- Image
- HomepageSetting
- Raccourci
- AssistantSettings
- WebGroundingType
- CustomerProvidedConfig
- CustomerType
- Méthodes
Ressource : WidgetConfig
WidgetConfig capture les configurations au niveau du widget.
Représentation JSON |
---|
{ "name": string, "displayName": string, "createTime": string, "updateTime": string, "enableAutocomplete": boolean, "fieldsUiComponentsMap": { string: { object ( |
Champs | |
---|---|
name |
Immuable. Nom complet de la ressource de configuration du widget. Format : Ce champ doit être une chaîne encodée au format UTF-8, dont la longueur ne doit pas dépasser 1 024 caractères. |
displayName |
Obligatoire. Nom à afficher de la configuration du widget, lisible par l'utilisateur. Utilisé dans l'UI Discovery. Ce champ doit être une chaîne encodée au format UTF-8 et ne doit pas dépasser 128 caractères. Dans le cas contraire, une erreur INVALID_ARGUMENT est renvoyée. |
createTime |
Uniquement en sortie. Code temporel de création de Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
updateTime |
Uniquement en sortie. Le code temporel Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
enableAutocomplete |
Indique s'il faut activer ou non la saisie semi-automatique. |
fieldsUiComponentsMap |
La clé est le composant d'UI. Mock. Cette valeur correspond au nom du champ ainsi qu'à la visibilité de l'appareil. Les trois champs personnalisés sont facultatifs et peuvent être ajoutés ou supprimés. |
facetField[] |
Configuration et apparence des facettes dans la vue de l'utilisateur final. |
dataStoreType |
Uniquement en sortie. Type du data store parent. |
contentSearchSpec |
Spécification de la recherche de contenu qui configure le comportement souhaité de la recherche de contenu. |
enableSummarization |
Activez ou désactivez la synthèse pour la réponse de recherche. |
enableSnippetResultSummary |
Activez ou désactivez le résumé pour chaque résultat d'extrait. |
configId |
Uniquement en sortie. Identifiant obscurci unique d'un |
enableQualityFeedback |
Activez ou désactivez la collecte des commentaires des utilisateurs finaux sur la qualité des résultats de recherche. |
solutionType |
Obligatoire. Immuable. Spécifie le type de solution pour lequel cette WidgetConfig peut être utilisée. |
industryVertical |
Uniquement en sortie. Secteur d'activité auquel WidgetConfig est associé. Le secteur d'activité WidgetConfig est basé sur le |
allowPublicAccess |
Indique si l'intégration sans authentification avec le widget est autorisée. Si la valeur est définie sur "true", l'accès public à la recherche ou à d'autres solutions à partir du widget est autorisé sans jeton d'authentification fourni par le serveur backend hébergé par le client. |
allowlistedDomains[] |
Domaines ajoutés à la liste d'autorisation pouvant charger ce widget. |
enableSafeSearch |
Indique si la recherche sécurisée doit être activée. |
enableConversationalSearch |
Indique si la recherche conversationnelle (LLM, multitours) est autorisée ou non (non-LLM, monotour). |
llmEnabled |
Uniquement en sortie. Indique si le LLM est activé dans le data store correspondant. |
enableResultScore |
Indique s'il faut afficher le score du résultat. |
resultDisplayType |
Type d'extrait à afficher dans le widget UCS.
|
minimumDataTermAccepted |
Uniquement en sortie. Indique si le client a accepté les conditions d'utilisation des données. |
enableWebApp |
Indique si l'application Web autonome doit être activée. |
dataStoreUiConfigs[] |
Configurations d'UI configurables par data store. |
collectionComponents[] |
Uniquement en sortie. Les composants de collecte qui listent toutes les collections et tous les magasins de données enfants associés à la configuration du widget. Ces sources de données peuvent être utilisées pour le filtrage dans les API du service de widget. Les utilisateurs peuvent renvoyer des résultats à partir des sources de données sélectionnées. |
enableSearchAsYouType |
Indique si le comportement de saisie semi-automatique doit être activé pour le widget de recherche. |
defaultSearchRequestOrderBy |
Ordre par défaut des résultats de recherche, le cas échéant. Utilisé pour définir SearchRequest#orderBy sur les requêtes applicables. https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1alpha/projects.locations.dataStores.servingConfigs/search#request-body |
experimentalFeatures |
Permet d'activer/désactiver les fonctionnalités instables/expérimentales dans le widget (ou l'application Web) |
uiSettings |
Décrit les paramètres généraux de recherche de widgets tels qu'ils apparaissent sur la page de configuration des widgets de la console cloud. Remplace les propriétés de premier niveau obsolètes. |
accessSettings |
Sera utilisé pour tous les paramètres d'accès aux widgets affichés sur la page d'intégration de la console Cloud. Remplace les propriétés de premier niveau obsolètes. |
uiBranding |
Décrit les paramètres de branding de l'UI du widget Recherche, tels que le titre, le logo, les favicons et les couleurs du widget. |
homepageSetting |
Facultatif. Décrit les paramètres de la page d'accueil du widget. |
assistantSettings |
Facultatif. Uniquement en sortie. Décrit les paramètres de l'assistant du widget. |
customerProvidedConfig |
Facultatif. Uniquement en sortie. Décrit les configurations liées au client, actuellement utilisées uniquement pour les clients gouvernementaux. Ce champ ne peut pas être modifié une fois le projet intégré. |
enablePrivateKnowledgeGraph |
Facultatif. Uniquement en sortie. Indique si le Knowledge Graph privé doit être activé. |
UIComponentField
Champ de facette mappé à un composant d'UI.
Représentation JSON |
---|
{
"field": string,
"deviceVisibility": [
enum ( |
Champs | |
---|---|
field |
Obligatoire. Nom de champ enregistré. Il a le format suivant : |
deviceVisibility[] |
Visibilité des champs sur différents types d'appareils |
displayTemplate |
Modèle permettant de personnaliser l'affichage du champ. Par exemple, une valeur peut être une chaîne qui ressemble à ceci : "Prix : {value}". |
DeviceVisibility
Visibilité du champ sur différents types d'appareils.
Enums | |
---|---|
DEVICE_VISIBILITY_UNSPECIFIED |
Valeur par défaut si aucune valeur n'est spécifiée. Le serveur renvoie INVALID_ARGUMENT si elle est utilisée dans les requêtes. |
MOBILE |
Le composant d'UI est visible sur les appareils mobiles. |
DESKTOP |
Le composant d'UI est visible sur le client basé sur le navigateur. |
FacetField
Champs de facette qui stockent le mappage des champs à l'apparence du widget pour l'utilisateur final.
Représentation JSON |
---|
{ "field": string, "displayName": string } |
Champs | |
---|---|
field |
Obligatoire. Nom de champ enregistré. Il a le format suivant : |
displayName |
Facultatif. Nom du champ que les utilisateurs finaux verront. |
DataStoreType
Type du data store parent du widget.
Enums | |
---|---|
DATA_STORE_TYPE_UNSPECIFIED |
Type de data store non spécifié. |
SITE_SEARCH |
Le data store parent contient un moteur de recherche de site. |
STRUCTURED |
Le data store parent contient un moteur de recherche pour les données structurées. |
UNSTRUCTURED |
Le data store parent contient un moteur de recherche pour les données non structurées. |
BLENDED |
Le data store parent est utilisé pour la recherche combinée avec plusieurs datastores. |
ResultDisplayType
Type de résultat à afficher dans le widget UCS.
Enums | |
---|---|
RESULT_DISPLAY_TYPE_UNSPECIFIED |
Type d'affichage non spécifié (l'extrait s'affiche par défaut). |
SNIPPET |
Afficher les résultats du champ "Extrait". |
EXTRACTIVE_ANSWER |
Afficher les résultats du champ "Réponses extractives". |
DataStoreUiConfig
Configuration des composants d'interface utilisateur pour le data store.
Représentation JSON |
---|
{ "name": string, "id": string, "facetField": [ { object ( |
Champs | |
---|---|
name |
Nom du data store. Il doit s'agir du nom de ressource du data store. Format : |
id |
Sortie uniquement. Identifiant du data store, utilisé pour le service de widgets. Pour l'instant, il fait référence à dataStoreId. À l'avenir, nous migrerons le champ vers le nom chiffré du data store (UUID). |
facetField[] |
Champs de facette qui stockent le mappage des champs à l'apparence du widget pour l'utilisateur final. |
fieldsUiComponentsMap |
La clé est le composant d'UI. Mock. Cette valeur correspond au nom du champ ainsi qu'à la visibilité de l'appareil. Les trois champs personnalisés sont facultatifs et peuvent être ajoutés ou supprimés. |
CollectionComponent
Composant de collection en lecture seule qui contient des champs de collection du data store pouvant être utilisés pour le filtrage
Représentation JSON |
---|
{
"name": string,
"id": string,
"displayName": string,
"dataStoreComponents": [
{
object ( |
Champs | |
---|---|
name |
Nom de la collection. Il doit s'agir du nom de ressource de la collection. Format : |
id |
Uniquement en sortie. Identifiant de la collection, utilisé pour le service de widgets. Pour l'instant, il fait référence à collectionId. À l'avenir, nous migrerons le champ vers l'UUID du nom de la collection chiffrée. |
displayName |
Nom à afficher de la collection. |
dataStoreComponents[] |
Pour la collection de data store, liste des datastores enfants. |
dataSource |
Nom de la source de données, récupéré à partir de |
dataSourceDisplayName |
Uniquement en sortie. Nom à afficher de la source de données. |
connectorIconLink |
Uniquement en sortie. Lien vers l'icône de la source du connecteur. |
DataStoreComponent
Composant de data store en lecture seule qui contient les champs de datastores pouvant être utilisés pour le filtrage. Il s'agit de l'enfant de CollectionComponent
.
Représentation JSON |
---|
{ "name": string, "id": string, "displayName": string, "entityName": string, "workspaceType": enum ( |
Champs | |
---|---|
name |
Nom du data store. Il doit s'agir du nom de ressource du data store. Format : |
id |
Sortie uniquement. Identifiant du data store, utilisé pour le service de widgets. Pour l'instant, il fait référence à dataStoreId. À l'avenir, nous migrerons le champ vers le nom chiffré du data store (UUID). |
displayName |
Nom à afficher du data store. |
entityName |
Nom de l'entité, récupéré à partir de |
workspaceType |
Uniquement en sortie. Types de sources Workspace pour les données Workspace, récupérés à partir de |
contentConfig |
Uniquement en sortie. Configuration du contenu du data store. |
dataStoreConfigType |
Uniquement en sortie. Type de configuration du data store. |
DataStoreConfigType
Type de configuration du data store.
Enums | |
---|---|
DATA_STORE_CONFIG_TYPE_UNSPECIFIED |
Valeur par défaut. Cette valeur n'est pas utilisée. |
ALLOW_DB_CONFIG |
Le data store est connecté à AlloyDB |
THIRD_PARTY_OAUTH_CONFIG |
Le data store est connecté à une source de données tierce. |
NOTEBOOKLM_CONFIG |
Le data store est connecté à NotebookLM Enterprise. |
UiSettings
Décrit les paramètres généraux de l'UI des widgets (ou des applications Web) tels qu'ils apparaissent sur la page de configuration de l'UI de la console cloud.
Représentation JSON |
---|
{ "interactionType": enum ( |
Champs | |
---|---|
interactionType |
Décrit le type d'interaction avec le widget (ou l'application Web) |
generativeAnswerConfig |
Décrit la configuration des réponses génératives. |
resultDescriptionType |
Contrôle si l'extrait de résultat est affiché et comment (extrait ou réponse extractive). La valeur par défaut est "aucun résultat" si aucune valeur n'est spécifiée. |
enableAutocomplete |
Indique s'il faut activer ou non la saisie semi-automatique. |
enableSafeSearch |
Indique si la recherche sécurisée doit être activée. |
enableQualityFeedback |
Activez ou désactivez la collecte des commentaires des utilisateurs finaux sur la qualité des résultats de recherche. |
enableSearchAsYouType |
Indique si le comportement de saisie semi-automatique doit être activé pour le widget de recherche. |
defaultSearchRequestOrderBy |
Ordre par défaut des résultats de recherche, le cas échéant. Utilisé pour définir SearchRequest#orderBy sur les requêtes applicables. https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1alpha/projects.locations.dataStores.servingConfigs/search#request-body |
dataStoreUiConfigs[] |
Configuration par data store. |
disableUserEventsCollection |
Si la valeur est "true", le widget ne collectera pas les événements utilisateur. |
enableVisualContentSummary |
Si la valeur est définie sur "True", le widget activera le résumé du contenu visuel pour les demandes de recherche applicables. Utilisé uniquement par la recherche de soins de santé. |
enablePeopleSearch |
Facultatif. Si la valeur est définie sur "true", le widget active la recherche de personnes. |
enableCreateAgentButton |
Facultatif. Si la valeur est définie sur "true", le widget active le bouton "Créer un agent". |
features |
Uniquement en sortie. Configuration des fonctionnalités permettant au moteur d'activer ou de désactiver des fonctionnalités. Clés compatibles :
|
InteractionType
Décrit le type d'interaction.
Enums | |
---|---|
INTERACTION_TYPE_UNSPECIFIED |
Non spécifié. La valeur par défaut est SEARCH_ONLY. |
SEARCH_ONLY |
Effectuez une recherche sans réponse générative. |
SEARCH_WITH_ANSWER |
Recherchez avec la réponse générative. |
SEARCH_WITH_FOLLOW_UPS |
Recherchez avec la réponse générative qui permet de poser des questions complémentaires. Également appelée recherche multitours. |
GenerativeAnswerConfig
Décrit la configuration de la réponse générative.
Représentation JSON |
---|
{
"resultCount": integer,
"modelVersion": string,
"modelPromptPreamble": string,
"maxRephraseSteps": integer,
"languageCode": string,
"disableRelatedQuestions": boolean,
"ignoreNonAnswerSeekingQuery": boolean,
"ignoreAdversarialQuery": boolean,
"ignoreLowRelevantContent": boolean,
"imageSource": enum ( |
Champs | |
---|---|
resultCount |
Nombre de meilleurs résultats à partir desquels générer la réponse. Jusqu'à 10. |
modelVersion |
Version du modèle utilisée pour générer la réponse. |
modelPromptPreamble |
Texte au début de la requête qui indique au modèle comment générer la réponse. |
maxRephraseSteps |
Nombre maximal d'étapes de reformulation. Le nombre maximal d'étapes est de cinq. Si elle n'est pas définie ou est inférieure à 1, elle est définie par défaut sur 1. |
languageCode |
Code de langue du résumé. Utilisez les balises de langue définies par BCP47. Remarque : Il s'agit d'une fonctionnalité expérimentale. |
disableRelatedQuestions |
Indique si la réponse générée contient des questions associées suggérées. |
ignoreNonAnswerSeekingQuery |
Facultatif. Indique s'il faut filtrer les requêtes qui ne cherchent pas de réponse. La valeur par défaut est Aucune réponse n'est renvoyée si la requête de recherche est classée comme requête ne cherchant pas de réponse. Si ce champ est défini sur |
ignoreAdversarialQuery |
Facultatif. Indique s'il faut filtrer les requêtes adversariales. |
ignoreLowRelevantContent |
Facultatif. Indique s'il faut filtrer les requêtes qui ne sont pas pertinentes pour le contenu. |
imageSource |
Facultatif. Source de l'image renvoyée dans la réponse. |
ImageSource
Source de l'image renvoyée dans la réponse.
Enums | |
---|---|
IMAGE_SOURCE_UNSPECIFIED |
Source d'image non spécifiée (la fonctionnalité multimodale est désactivée par défaut) |
ALL_AVAILABLE_SOURCES |
Comportement lorsque le service détermine la sélection à partir de toutes les sources disponibles. |
CORPUS_IMAGE_ONLY |
Incluez une image du corpus dans la réponse. |
FIGURE_GENERATION_ONLY |
Déclenche la génération de figures dans la réponse. |
FeatureState
État de la fonctionnalité pour le moteur.
Enums | |
---|---|
FEATURE_STATE_UNSPECIFIED |
L'état de la fonctionnalité n'est pas spécifié. |
FEATURE_STATE_ON |
La fonctionnalité est activée pour être accessible. |
FEATURE_STATE_OFF |
La fonctionnalité est désactivée et donc inaccessible. |
AccessSettings
Décrit les paramètres d'accès aux widgets.
Représentation JSON |
---|
{ "allowPublicAccess": boolean, "allowlistedDomains": [ string ], "enableWebApp": boolean, "workforceIdentityPoolProvider": string, "languageCode": string } |
Champs | |
---|---|
allowPublicAccess |
Indique si l'accès public non authentifié est autorisé. |
allowlistedDomains[] |
Liste des domaines autorisés à intégrer le widget de recherche. |
enableWebApp |
Indique si l'accès à l'application Web est activé. |
workforceIdentityPoolProvider |
Facultatif. Fournisseur de pool d'identités de personnel utilisé pour accéder au widget. |
languageCode |
Facultatif. Code de langue de l'interface utilisateur. Utilisez les balises de langue définies par BCP47. Si elle n'est pas définie, le code de langue par défaut est "en-US". |
UiBrandingSettings
Décrit les paramètres de branding de l'UI du widget.
Représentation JSON |
---|
{
"logo": {
object ( |
Champs | |
---|---|
logo |
Image du logo. |
Image
Options de stockage d'une image.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union storage_method . Différentes façons de stocker une image (par exemple, sous forme d'URL ou de chaîne encodée en base64). storage_method ne peut être qu'un des éléments suivants : |
|
url |
URL de l'image. |
HomepageSetting
Décrit le paramètre de page d'accueil du widget. Il inclut tous les paramètres et configurations liés à la page d'accueil, comme les raccourcis.
Représentation JSON |
---|
{
"shortcuts": [
{
object ( |
Champs | |
---|---|
shortcuts[] |
Facultatif. Raccourcis à afficher sur la page d'accueil. LINT.IfChange(max_shortcuts_number) LINT.ThenChange(//depot/google3/cloud/console/web/ai/unified_cloud_search/components/widget_preview/widget_homepage_shortcut_config_form.ts:max_shortcuts_number) |
Raccourci
Décrit une entité de raccourci (également appelée contenu épinglé) sur la page d'accueil. La page d'accueil affichera ces raccourcis dans le même ordre que celui renvoyé par l'API. Si un client souhaite réorganiser ou supprimer un raccourci, l'UI doit toujours fournir la nouvelle liste complète des raccourcis.
Représentation JSON |
---|
{
"title": string,
"icon": {
object ( |
Champs | |
---|---|
title |
Facultatif. Titre du raccourci. |
icon |
Facultatif. URL de l'icône du raccourci. |
destinationUri |
Facultatif. URL de destination du raccourci. |
AssistantSettings
Décrit les paramètres de l'assistant du widget.
Représentation JSON |
---|
{
"googleSearchGroundingEnabled": boolean,
"webGroundingType": enum ( |
Champs | |
---|---|
googleSearchGroundingEnabled |
Indique si le bouton bascule d'ancrage de la recherche Google est affiché ou non. Obsolète. Utilisez plutôt |
webGroundingType |
Facultatif. Type d'ancrage Web à utiliser. |
defaultWebGroundingToggleOff |
Uniquement en sortie. Ce champ contrôle le bouton bascule de l'ancrage Web par défaut pour les utilisateurs finaux si |
disableLocationContext |
Facultatif. Uniquement en sortie. Indique s'il faut désactiver le contexte de la position de l'utilisateur. |
WebGroundingType
Type d'ancrage Web à utiliser.
Enums | |
---|---|
WEB_GROUNDING_TYPE_UNSPECIFIED |
Paramètre par défaut non spécifié. Cela revient à désactiver la fonctionnalité. |
WEB_GROUNDING_TYPE_DISABLED |
L'ancrage Web est désactivé. |
WEB_GROUNDING_TYPE_GOOGLE_SEARCH |
L'ancrage avec la recherche Google est activé. |
WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH |
L'ancrage avec la recherche Web Enterprise est activé. |
CustomerProvidedConfig
Configurations fournies par le client.
Représentation JSON |
---|
{
"customerType": enum ( |
Champs | |
---|---|
customerType |
Type de client. |
CustomerType
Type de client.
Enums | |
---|---|
DEFAULT_CUSTOMER |
Type de client par défaut. |
GOVERNMENT_CUSTOMER |
Type de client "Administration". Certaines fonctionnalités sont désactivées pour les clients du secteur public en raison d'exigences légales. |
Méthodes |
|
---|---|
|
Récupère un WidgetConfig . |