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,
  "rankingExpression": string,
  "createTime": string,
  "updateTime": string,
  "filterControlIds": [
    string
  ],
  "boostControlIds": [
    string
  ],
  "redirectControlIds": [
    string
  ],
  "synonymsControlIds": [
    string
  ],
  "onewaySynonymsControlIds": [
    string
  ],
  "dissociateControlIds": [
    string
  ],
  "replacementControlIds": [
    string
  ],
  "ignoreControlIds": [
    string
  ],
  "promoteControlIds": [
    string
  ],
  "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.
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.
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.

MediaConfig

Specifica le configurazioni necessarie per il rilevamento dei contenuti multimediali. Al momento supportiamo:

  • demote_content_watched: Soglia per la declassificazione dei contenuti guardati. I clienti possono specificare se utilizzare la retrocessione dei contenuti visualizzati o la pagina dei dettagli visualizzata. Se i clienti specificano che i minuti o la percentuale di contenuti guardati superano la soglia, i contenuti verranno retrocessi nel risultato del suggerimento.
  • promote_fresh_content: giorni limite per la promozione di nuovi contenuti. I clienti possono specificare se utilizzare la promozione della freschezza dei contenuti. Se i contenuti sono stati pubblicati entro i giorni limite, verranno promossi nel risultato del consiglio. Può essere impostato solo se SolutionType è SOLUTION_TYPE_RECOMMENDATION.
Rappresentazione JSON 
{
  "demotionEventType": string,
  "demoteContentWatchedPastDays": integer,
  "contentFreshnessCutoffDays": integer,

  // Union field demote_content_watched can be only one of the following:
  "contentWatchedPercentageThreshold": number,
  "contentWatchedSecondsThreshold": number
  // End of list of possible types for union field demote_content_watched.
}
Campi
demotionEventType

string

Specifica il tipo di evento utilizzato per la retrocessione del risultato del suggerimento. Valori attualmente supportati:

  • view-item: Articolo visualizzato.
  • media-play: avvia/riprendi la riproduzione di un video, di un brano e così via.
  • media-complete: Ha terminato o interrotto a metà un video, un brano e così via.

Se il criterio non viene configurato, la retrocessione della cronologia delle visualizzazioni non verrà applicata. La retrocessione della novità dei contenuti verrà comunque applicata.
demoteContentWatchedPastDays

integer

Facoltativo. Specifica il numero di giorni da prendere in considerazione per la retrocessione dei contenuti guardati. Se è impostato su zero o non è impostato, il valore predefinito è il massimo di 365 giorni.
contentFreshnessCutoffDays

integer

Specifica la freschezza dei contenuti utilizzata per il risultato del consiglio. I contenuti verranno retrocessi se sono stati pubblicati da più giorni rispetto al limite di aggiornamento dei contenuti.
Campo unione demote_content_watched. Specifica la soglia per la retrocessione dei contenuti visualizzati. La soglia può essere un valore percentuale o in minuti. Questo valore deve essere impostato per il tipo di evento media-complete. demote_content_watched può essere solo uno dei seguenti:
contentWatchedPercentageThreshold

number

Specifica la soglia della percentuale di contenuti visualizzati per la retrocessione. Il valore di soglia deve essere compreso tra [0, 1] inclusi.
contentWatchedSecondsThreshold

number

Specifica la soglia dei minuti di visualizzazione dei contenuti per la retrocessione.

GenericConfig

Specifica le configurazioni necessarie per il rilevamento generico.Al momento supportiamo:

  • contentSearchSpec: configurazione per la ricerca di contenuti generici.
Rappresentazione JSON 
{
  "contentSearchSpec": {
    object (ContentSearchSpec)
  }
}
Campi
contentSearchSpec

object (ContentSearchSpec)

Specifica il comportamento previsto della ricerca di contenuti. Valido solo per il datastore con ricerca dei contenuti abilitata.

AnswerGenerationSpec

La specifica per la generazione delle risposte.

Rappresentazione JSON 
{
  "userDefinedClassifierSpec": {
    object (UserDefinedClassifierSpec)
  }
}
Campi
userDefinedClassifierSpec

object (UserDefinedClassifierSpec)

Facoltativo. La specifica per la specifica del classificatore specificato dall'utente.

UserDefinedClassifierSpec

La specifica per il classificatore definito dall'utente.

Rappresentazione JSON 
{
  "enableUserDefinedClassifier": boolean,
  "preamble": string,
  "modelId": string,
  "taskMarker": string,
  "topP": number,
  "topK": string,
  "temperature": number,
  "seed": integer
}
Campi
enableUserDefinedClassifier

boolean

Facoltativo. Indica se attivare e includere il classificatore definito dall'utente.
preamble

string

Facoltativo. Il preambolo da utilizzare per il classificatore definito dall'utente.
modelId

string

Facoltativo. L'ID modello da utilizzare per il classificatore definito dall'utente.
taskMarker

string

Facoltativo. Il marcatore dell'attività da utilizzare per il classificatore definito dall'utente.
topP

number

Facoltativo. Il valore top-p da utilizzare per il classificatore definito dall'utente.
topK

string (int64 format)

Facoltativo. Il valore top-k da utilizzare per il classificatore definito dall'utente.
temperature

number

Facoltativo. Il valore della temperatura da utilizzare per il classificatore definito dall'utente.
seed

integer

Facoltativo. Il valore iniziale da utilizzare per il classificatore definito dall'utente.