Questa pagina descrive come scoprire se varie metriche per i dati multimediali soddisfano le relative soglie di requisiti.
Informazioni sul controllo della qualità dei dati multimediali
Poiché gli eventi utente recenti sono molto importanti per i consigli sui contenuti multimediali, devi controllare regolarmente la qualità dei dati importati e degli eventi utente. Per farlo, consulta la scheda Ottimizzazione dell'app di suggerimenti sui contenuti multimediali per determinare quali miglioramenti puoi apportare ai dati al fine di ottimizzare per consigli di qualità migliore.
Se la soglia di una metrica non viene raggiunta, la metrica ha uno stato di avviso. Poi, devi esaminare la metrica e la relativa descrizione per determinare quali azioni devi intraprendere per migliorare la qualità dei tuoi contenuti multimediali.
Tutti i modelli e gli scopi devono superare le soglie della metrica Qualità generale. Alcuni modelli e obiettivi hanno metriche e soglie aggiuntive per la qualità specifica dell'app. Le metriche generali della qualità sono le stesse per tutte le app che utilizzano lo stesso datastore, ma le metriche della qualità specifiche per app variano in base al modello e agli scopi dell'app.
Per informazioni sui modelli e sugli obiettivi dei consigli, consulta Informazioni sui tipi di consigli per le app multimediali.
Controlla la qualità dei dati
Console
Per controllare la qualità dei dati dei consigli sui contenuti multimediali:
Nella console Google Cloud, vai alla pagina Agent Builder.
Fai clic sul nome dell'app di consigli sui contenuti multimediali per la quale vuoi controllare la qualità dei dati.
Nel menu di navigazione, fai clic su Qualità dei dati e poi sulla scheda Ottimizzazione. Questa pagina mostra lo stato di varie metriche per i dati associati alla tua app.
Esamina gli stati Qualità generale e Qualità specifica app nella parte superiore della pagina. Lo stato di riepilogo nella parte superiore della pagina viene visualizzato come avviso se una o più metriche hanno superato la soglia.
Le due tabelle delle metriche (Qualità generale e Qualità specifica per app) elencano le singole metriche.
Nelle tabelle delle metriche, fai clic su Visualizza dettagli per ulteriori informazioni sulle metriche nello stato di avviso.
(Facoltativo) Se vuoi visualizzare la soglia per una metrica conforme, fai clic su Visualizza dettagli. Le soglie per le metriche conformi non vengono mostrate nella tabella delle metriche.
REST
Utilizza il metodo requirements:checkRequirement
per verificare la qualità dei dati dei consigli sui contenuti multimediali, come mostrato.
Per controllare la qualità dalla riga di comando:
Trova l'ID del tuo datastore. Se hai già l'ID del tuo datastore, vai al passaggio successivo.
Nella console Google Cloud, vai alla pagina Agent Builder e nel menu di navigazione fai clic su Data Store.
Fai clic sul nome del tuo datastore.
Nella pagina Dati del tuo datastore, ottieni l'ID datastore.
Esegui il seguente comando curl per scoprire se i tuoi consigli sui contenuti multimediali soddisfano le soglie per le metriche generali:
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-GFE-SSL: yes" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/requirements:checkRequirement" \ -d '{ "location": "projects/PROJECT_ID/locations/global", "requirementType": "discoveryengine.googleapis.com/media_recs/general/all/warning", "resources": [ { "labels": { "branch_id": "0", "collection_id": "default_collection", "datastore_id": "DATA_STORE_ID", "location_id": "global", "project_number": "PROJECT_ID" }, "type": "discoveryengine.googleapis.com/Branch" }, { "labels": { "collection_id": "default_collection", "datastore_id": "DATA_STORE_ID", "location_id": "global", "project_number": "PROJECT_ID" }, "type": "discoveryengine.googleapis.com/DataStore" } ] }'
- PROJECT_ID: l'ID del tuo progetto Google Cloud.
- DATA_STORE_ID: l'ID dello datastore di Vertex AI Search.
Esamina l'output:
Cerca il valore di
result
:Se il valore è
SUCCESS
, i dati soddisfano i requisiti generali. Vai al passaggio 4.Se il valore è
WARNING
, vai al passaggio b.Se non vedi
result
nell'output, i motivi possono essere due:PROJECT_ID
oDATA_STORE_ID
nella richiesta non è corretto.Alcuni valori delle metriche non sono disponibili. Riprova tra 6 ore o rivolgiti a un tecnico dell'assistenza clienti per ricevere assistenza.
Cerca l'espressione (
requirement.Condition.Expression
): se il valore di questa expression è false, significa che c'è un problema con i dati.Il valore delle metriche si trova nel
requirementCondition.metricResults.value
campo. I valori della soglia di avviso si trovano nei campithresholdBindings.thresholdValues
. I campidescription
possono aiutarti a comprendere lo scopo della metrica.Ad esempio, il valore di
doc_with_same_title_percentage
è30.47
e la soglia di avviso perdoc_with_same_title_percentage_threshold
è1
. Si è verificato un problema con i dati: molti dei titoli nel datastore sono uguali e questo deve essere esaminato.
Se la combinazione di modello e scopo utilizzata per l'app di consigli appare in questa tabella, devi anche chiamare il metodo di controllo dei requisiti, aggiornato con i valori per il modello e lo scopo:
Modello Obiettivo MODEL_OBJ
Altri che potrebbero piacerti Tasso di conversione oyml/cvr
Consigliate per te Tasso di conversione rfy/cvr
Altri simili Tasso di conversione mlt/cvr
I più popolari Tasso di conversione mp/cvr
Altri che potrebbero piacerti Durata riproduzione per sessione oyml/wdps
Consigliate per te Durata riproduzione per sessione rfy/wdps
Altri simili Durata riproduzione per sessione mlt/wdps
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-GFE-SSL: yes" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/requirements:checkRequirement" \ -d '{ "location": "projects/PROJECT_ID/locations/global", "requirementType": "discoveryengine.googleapis.com/media_recs/MODEL_OBJ/warning", "resources": [ { "labels": { "branch_id": "0", "collection_id": "default_collection", "datastore_id": "DATA_STORE_ID", "location_id": "global", "project_number": "PROJECT_ID" }, "type": "discoveryengine.googleapis.com/Branch" }, { "labels": { "collection_id": "default_collection", "datastore_id": "DATA_STORE_ID", "location_id": "global", "project_number": "PROJECT_ID" }, "type": "discoveryengine.googleapis.com/DataStore" } ] }'
- PROJECT_ID: l'ID del tuo progetto Google Cloud.
- DATA_STORE_ID: l'ID dello datastore di Vertex AI Search.
- MODEL_OBJ: consulta la tabella precedente per scegliere il valore corretto per la tua app di consigli.
Esamina l'output:
Cerca il valore di
result
:Se il valore è
SUCCESS
, significa che i dati sono sufficienti.Se il valore è
WARNING
, vai al passaggio b.Se non vedi
result
nell'output, i motivi possono essere due:PROJECT_ID
oDATA_STORE_ID
nella richiesta non è corretto.Alcuni valori delle metriche non sono disponibili. Riprova tra 6 ore o rivolgiti a un tecnico dell'assistenza clienti per ricevere assistenza.
Esamina l'espressione (
requirement.Condition.Expression
). Se il valore di questa expression è false, significa che c'è un problema con i dati.Il valore delle metriche è disponibile nel campo
requirementCondition.metricResults.value
, mentre i valori della soglia di avviso sono disponibili nei campithresholdBindings.thresholdValues
. I campidescription
possono aiutarti a comprendere lo scopo della metrica.