REST Resource: projects.locations.dataStores.servingConfigs

Risorsa: ServingConfig

Configura i metadati utilizzati per generare i risultati del tempo di pubblicazione (ad es. risultati di ricerca o previsioni dei suggerimenti). ServingConfig viene trasmesso nella richiesta di ricerca e previsione e genera risultati.

Rappresentazione JSON 
{
  "name": string,
  "displayName": string,
  "solutionType": enum (SolutionType),
  "modelId": string,
  "diversityLevel": string,
  "embeddingConfig": {
    object (EmbeddingConfig)
  },
  "rankingExpression": string,
  "createTime": string,
  "updateTime": string,
  "filterControlIds": [
    string
  ],
  "boostControlIds": [
    string
  ],
  "redirectControlIds": [
    string
  ],
  "synonymsControlIds": [
    string
  ],
  "onewaySynonymsControlIds": [
    string
  ],
  "dissociateControlIds": [
    string
  ],
  "replacementControlIds": [
    string
  ],
  "ignoreControlIds": [
    string
  ],
  "promoteControlIds": [
    string
  ],
  "personalizationSpec": {
    object (PersonalizationSpec)
  },
  "answerGenerationSpec": {
    object (AnswerGenerationSpec)
  },

  // Union field vertical_config can be only one of the following:
  "mediaConfig": {
    object (MediaConfig)
  },
  "genericConfig": {
    object (GenericConfig)
  }
  // End of list of possible types for union field vertical_config.
}
Campi
name

string

Immutabile. Nome completo projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}/servingConfigs/{servingConfigId}
displayName

string

Obbligatorio. Il nome visualizzato della configurazione di pubblicazione leggibile. Utilizzato nell'interfaccia utente di Discovery.

Questo campo deve essere una stringa codificata in UTF-8 con un limite di lunghezza di 128 caratteri. In caso contrario, viene restituito un errore INVALID_ARGUMENT.
solutionType

enum (SolutionType)

Obbligatorio. Immutabile. Specifica il tipo di soluzione a cui può essere associata una configurazione di pubblicazione.
modelId

string

L'ID del modello da utilizzare al momento della pubblicazione. Al momento sono supportati solo i modelli di raccomandazione. Può essere modificato, ma solo con un modello compatibile (ad es. CTR di Altri che ti potrebbero piacere con TdC di Altri che ti potrebbero piacere).

Obbligatorio quando SolutionType è SOLUTION_TYPE_RECOMMENDATION.
diversityLevel

string

Il livello di diversità da utilizzare nei risultati del modello di suggerimenti, ad esempio medium-diversity o high-diversity. Valori attualmente supportati:

  • no-diversity
  • low-diversity
  • medium-diversity
  • high-diversity
  • auto-diversity

Se non viene specificato, scegliamo il valore predefinito in base al tipo di modello di raccomandazione. Valore predefinito: no-diversity.

Può essere impostato solo se SolutionType è SOLUTION_TYPE_RECOMMENDATION.
embeddingConfig

object (EmbeddingConfig)

Utilizza la tua configurazione di incorporamento. La configurazione viene utilizzata per il recupero semantico della ricerca. Il recupero si basa sul prodotto scalare di SearchRequest.EmbeddingSpec.EmbeddingVector.vector e sugli incorporamenti dei documenti forniti da questo EmbeddingConfig. Se viene fornito SearchRequest.EmbeddingSpec.EmbeddingVector.vector, questo valore sostituisce ServingConfig.embedding_config.
rankingExpression

string

L'espressione di ranking controlla il ranking personalizzato dei documenti recuperati. Per sfruttare questa funzionalità, è necessario incorporare i documenti. L'impostazione dell'espressione di ranking in ServingConfig si applica a tutte le richieste di ricerca gestite dalla configurazione di pubblicazione. Tuttavia, se viene specificato SearchRequest.ranking_expression, questo sostituisce l'espressione di ranking ServingConfig.

L'espressione di ranking è una singola funzione o più funzioni unite dal segno "+".

  • rankingExpression = function, { " + ", function };

Funzioni supportate:

  • double * relevanceScore
  • double * dotProduct(embedding_field_path)

Variabili della funzione:

  • relevanceScore: parole chiave predefinite, utilizzate per misurare la pertinenza tra query e documento.
  • embedding_field_path: il campo di incorporamento del documento utilizzato con il vettore di incorporamento della query.
  • dotProduct: funzione di embedding tra embedding_field_path e il vettore di embedding della query.

Espressione di ranking di esempio:

Se il documento ha un campo di incorporamento doc_embedding, l'espressione di ranking potrebbe essere 0.5 * relevanceScore + 0.3 * dotProduct(doc_embedding).
createTime

string (Timestamp format)

Solo output. Timestamp di creazione di ServingConfig.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'aggiornamento di ServingConfig.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
filterControlIds[]

string

Filtra i controlli da utilizzare nel percorso di pubblicazione. Verranno applicati tutti i controlli dei filtri attivati. I controlli dei filtri devono trovarsi nello stesso datastore della configurazione di pubblicazione. Massimo 20 controlli filtro.
boostControlIds[]

string

Controlli di boost da utilizzare nel percorso di pubblicazione. Verranno applicati tutti i controlli di boost attivati. I controlli di boost devono trovarsi nello stesso datastore della configurazione di pubblicazione. Massimo 20 controlli di potenziamento.
redirectControlIds[]

string

ID dei controlli reindirizzamento. Viene applicata solo la prima azione di reindirizzamento attivata, anche se ne sono presenti più di una. Il numero massimo di specifiche è 100.

Può essere impostato solo se SolutionType è SOLUTION_TYPE_SEARCH.
synonymsControlIds[]

string

Specifiche dei sinonimi delle condizioni. Se corrispondono più condizioni di sinonimi, verranno eseguiti tutti i controlli dei sinonimi corrispondenti nell'elenco. Il numero massimo di specifiche è 100.

Può essere impostato solo se SolutionType è SOLUTION_TYPE_SEARCH.
onewaySynonymsControlIds[]

string

Specifiche dei sinonimi unidirezionali della condizione. Se corrispondono più condizioni di sinonimi unidirezionali, vengono eseguiti tutti i controlli di sinonimi unidirezionali corrispondenti nell'elenco. Il numero massimo di specifiche è 100.

Può essere impostato solo se SolutionType è SOLUTION_TYPE_SEARCH.
dissociateControlIds[]

string

La condizione non associa le specifiche. Se corrispondono più condizioni di non associazione, verranno eseguiti tutti i controlli di non associazione corrispondenti nell'elenco. L'ordine non è importante. Il numero massimo di specifiche è 100.

Può essere impostato solo se SolutionType è SOLUTION_TYPE_SEARCH.
replacementControlIds[]

string

Specifiche di sostituzione della condizione. Applicate in base all'ordine nell'elenco. Un termine sostituito in precedenza non può essere sostituito di nuovo. Il numero massimo di specifiche è 100.

Può essere impostato solo se SolutionType è SOLUTION_TYPE_SEARCH.
ignoreControlIds[]

string

Ignora le specifiche della condizione. Se corrispondono più condizioni di ignoramento, verranno eseguiti tutti i controlli di ignoramento corrispondenti nell'elenco. L'ordine non è importante. Il numero massimo di specifiche è 100.
promoteControlIds[]

string

Specifiche della promozione con condizione.

Il numero massimo di specifiche è 100.
personalizationSpec

object (PersonalizationSpec)

La specifica per la specifica di personalizzazione.

Tieni presente che se sono impostati sia ServingConfig.personalization_spec che SearchRequest.personalization_spec, SearchRequest.personalization_spec sostituisce ServingConfig.personalization_spec.
answerGenerationSpec

object (AnswerGenerationSpec)

Facoltativo. La specifica per la generazione delle risposte.
Campo unione vertical_config. Configurazione specifica per verticale di settore. vertical_config può essere solo uno dei seguenti:
mediaConfig

object (MediaConfig)

MediaConfig della configurazione di pubblicazione.
genericConfig

object (GenericConfig)

GenericConfig della configurazione di pubblicazione.

Metodi

answer

 Metodo di query di risposta.

get

 Recupera una ServingConfig.

list

 Elenca tutti i ServingConfig collegati a questo datastore.

patch

 Aggiorna un oggetto ServingConfig.

recommend

 Fornisce un suggerimento, che richiede un evento utente contestuale.
Esegue una ricerca.

searchLite

 Esegue una ricerca.

streamAnswer

 Metodo di query di risposta (streaming).