Modello di dati per dati e metriche di qualità Knowledge/RAG
Utilizzare i dati di questi DLO/DMO per creare rapporti, cruscotti digitali e query che offrono approfondimenti sugli eventi di recupero Knowledge.
Versioni (Edition) richieste
| Disponibile nelle versioni: Lightning Experience |
| Disponibile in: Enterprise Edition, Performance Edition, Unlimited Edition e Developer Edition. Le licenze aggiuntive richieste variano a seconda del tipo di agente. |
Informazioni sul modello di dati e metriche di qualità Knowledge/RAG
Il modello di dati per i dati e le metriche di qualità Knowledge/RAG è una raccolta di DLO (oggetti data lake) e DMO (oggetti modello di dati) che contengono dati e metriche di qualità.
Dati e metriche di qualità Knowledge/RAG
| DLO/DMO | Descrizione |
|---|---|
AIRetrieverRequest
|
Rappresenta una richiesta al retriever. |
AIRetrieverResponse
|
Rappresenta una risposta dal retriever. |
AIRetrieverQualityMetric
|
Rappresenta i punteggi di qualità derivati dal confronto tra la richiesta e la risposta. |
I dati vengono trasmessi in streaming ai DLO in Data 360 e quindi mappati ai DMO applicabili.
AIRetrieverRequest DLO
DLO di Data 360 che acquisisce i dettagli della richiesta di recupero. L'oggetto AIRetrieverRequest ha i seguenti attributi.
| Etichetta campo | Nome API campo | Tipo di dati | Descrizione |
|---|---|---|---|
AI Retriever Request Id
|
Id
|
Testo | Chiave principale. Identificatore univoco della richiesta AI retriever. |
Created By
|
CreatedById
|
Testo - Riferimento - ID (ricerca) | Utente che ha creato questo record. |
Created Date
|
CreatedDate
|
Data - ora | Indicazione oraria (data/ora) di creazione del record. |
External Record Id
|
ExternalRecordId
|
Testo | ID record corrispondente da un sistema di fonti di dati esterne. |
External Source Id
|
ExternalSourceId
|
Testo | ID di un sistema di fonti di dati esterne. |
Feature
|
FeatureText
|
Testo | Etichetta della funzione coinvolta nell'origine dell'evento. Identifica, nei registri, la capacità o la funzionalità che ha attivato la chiamata retriever o di cui si tiene traccia. Esempi: DocumentRetrieval, KnowledgeSearch |
Last Modified By
|
LastModifiedById
|
Testo - Riferimento - ID (ricerca) | Utente che ha modificato più di recente questo record. |
Last Modified Date
|
LastModifiedDate
|
Data - ora | Indicazione oraria (data/ora) dell'ultima modifica apportata da un utente a questo record. |
Query
|
QueryText
|
Testo | Query utente inviata al retriever. |
Request Information
|
RequestInfoText
|
Testo | Informazioni aggiuntive nella richiesta (coppie chiave-valore in formato JSON). |
Request Timestamp
|
RequestTimestamp
|
Data - ora | Indicazione oraria (data/ora) in cui si è verificata la richiesta di recupero. |
Retriever API Name
|
RetrieverApiName
|
Testo | Nome API del retriever associato alla richiesta |
Retriever ReferenceId
|
RequestReferenceId
|
Testo | ID riferimento del componente, servizio o processo chiamante che ha inviato la richiesta al retriever per recuperare le informazioni pertinenti. Esempi: agente, prompt o classe Apex. |
SessionId
|
SessionId
|
Testo | ID sessione dell'agente che ha chiamato il retriever. |
Source Additional Information
|
SourceAdditionalInfoTxt
|
Testo | Informazioni aggiuntive associate all'asset di origine che ha originato questa chiamata (coppie chiave-valore in formato JSON). Esempio: PROMPT |
Source Asset API Name
|
SourceAssetApiName
|
Testo | Nome API dell'asset di origine che ha originato questa chiamata. Esempio: PROMPT |
Source Asset Type
|
SourceAssetTypeName
|
Testo | Tipo dell'asset di origine che ha originato la chiamata. Esempio: PROMPT |
Source Asset Version
|
SourceAssetVersion
|
Testo | Versione dell'asset di origine che ha originato questa chiamata. Esempio: PROMPT |
SpanId
|
SpanId
|
Testo | L'ID span viene generato dal componente che ha chiamato direttamente il retriever. |
System Modified Stamp
|
SystemModstamp
|
Data - ora | Indicazione oraria (data/ora) dell'ultima modifica apportata a questo record da un utente o da un processo automatico. |
TraceId
|
TraceId
|
Testo | ID traccia della sessione agente in cui si è verificata la chiamata retriever. |
DLO AIRetrieverResponse
DLO di Data 360 che acquisisce i dettagli delle risposte del retriever. L'oggetto AIRetrieverResponse ha i seguenti attributi.
| Etichetta campo | Nome API campo | Tipo di dati | Descrizione |
|---|---|---|---|
AI Retriever Response Id
|
Id
|
Testo - Chiave principale | Chiave principale. Identificatore univoco della risposta AI retriever. |
AI Retriever Request
|
AiRetrieverRequestId
|
Testo - Riferimento - ID (controllante) | Riferimento chiave esterna a AIRetrieverRequestId che corrisponde alla risposta del retriever. |
Created By
|
CreatedById
|
Testo - Riferimento - ID (ricerca) | Utente che ha creato questo record. |
Created Date
|
CreatedDate
|
Data - ora | Indicazione oraria (data/ora) di creazione del record. |
External Record Id
|
ExternalRecordId
|
Testo | ID record corrispondente da un sistema di fonti di dati esterne. |
External Source Id
|
ExternalSourceId
|
Testo | ID di un sistema di fonti di dati esterne. |
Last Modified By
|
LastModifiedById
|
Testo - Riferimento - ID (ricerca) | Utente che ha modificato più di recente questo record. |
Last Modified Date
|
LastModifiedDate
|
Data - ora | Indicazione oraria (data/ora) dell'ultima modifica apportata da un utente a questo record. |
Response Information
|
xResponseInfoText
|
Testo | Informazioni aggiuntive nella risposta (coppie chiave/valore in formato JSON). |
Response Timestamp
|
ResponseTimestamp
|
Data - ora | Timestamp (data/ora) in cui è stata emessa la risposta. |
Result
|
ResultText
|
Testo | Rappresentazione JSON della risposta del retriever, inclusi blocco, SourceRecordId e così via. |
Sort Index
|
SortIndexNumber
|
Numero - intero | SortIndex dei blocchi restituiti dal retriever. |
Source Record
|
SourceRecordId
|
Testo | Riferimento documento collegato al blocco. |
System Modified Stamp
|
SystemModstamp
|
Data - ora | Indicazione oraria (data/ora) quando questo record è stato modificato più di recente da un utente o da un processo automatico. |
AIRetrieverQualityMetric DMO
DMO di Data 360 che acquisisce i dettagli delle metriche di qualità del retriever. Viene utilizzato come base per rapporti, cruscotti digitali e query. L'oggetto AIRetrieverQualityMetric ha i seguenti attributi.
| Etichetta campo | Nome API campo | Tipo di dati | Descrizione |
|---|---|---|---|
AI Retriever Quality Metric Id
|
Id
|
Testo | Chiave principale. Identificatore univoco associato al risultato della metrica. |
Agent Generated Response
|
AgentGeneratedResponseText
|
Testo | Contesto estratto da ResponseText in AI Response Generation. |
AI Gateway Request
|
CustomDMORef_AiGatewayRequestId
|
Testo - Riferimento - ID (ricerca) | Riferimento chiave esterna al GenAIGatewayRequestId associato al risultato della metrica. |
AI Gateway Request Id
|
AiGatewayRequestId
|
Testo | Riferimento a GenAIGatewayRequestId associato a questo risultato della metrica. |
AI Response Generation
|
CustomDMORef_AiResponseGenerationId
|
Testo | Riferimento chiave esterna a AIResponseGeneration (Custom DMO GenAIGeneration) associato a questo risultato della metrica. |
AI Response Generation Id
|
AiResponseGenerationId
|
Testo | Riferimento a AIResponseGeneration associato al risultato della metrica. |
AI Retriever Request
|
CustomDMORef_AiRetrieverRequestId
|
Testo | Riferimento chiave esterna a AIRetrieverRequestId associato al risultato della metrica |
AI Retriever Request Id
|
AI Retriever Request Id
|
Testo | Riferimento a AIRetrieverRequestId associato a questo risultato della metrica. |
Answer Relevancy Score
|
AnswerRelevancyScoreNumber
|
Numero - Decimale | Rispondere al punteggio di pertinenza. Quanto completamente e quanto bene viene data risposta alla domanda? |
Context Precision Score
|
ContextPrecisionScoreNumber
|
Numero - Decimale | Punteggio di precisione contesto. Quale proporzione della Knowledge corretta è stata trovata? |
Created By
|
CreatedById
|
Testo - Riferimento - ID (ricerca) | Utente che ha creato il record. |
Created Date
|
CreatedDate
|
Data - ora | Indicazione oraria (data/ora) di creazione del record. |
External Record Id
|
ExternalRecordId
|
Testo | ID record corrispondente da un sistema di fonti di dati esterne. |
External Source Id
|
ExternalSourceId
|
Testo | ID di un sistema di fonti di dati esterne. |
Faithfulness Relevancy Score
|
FaithfulnessRelevancyScoreNumber
|
Numero - Decimale | Punteggio di pertinenza fedeltà. In che misura l'agente ha utilizzato la Knowledge trovata? |
Last Modified By
|
LastModifiedById
|
Testo - Riferimento - ID (ricerca) | Utente che ha modificato più di recente questo record. |
Last Modified Date
|
LastModifiedDate
|
Data - ora | Indicazione oraria (data/ora) dell'ultima modifica apportata da un utente a questo record. |
Last Processed Request Timestamp
|
LastProcessedReqTimestamp
|
Data - ora | Indicazione oraria (data/ora) dell'ultima richiesta AIRetrieverRequest elaborata per la valutazione delle metriche. |
Metric Created Timestamp
|
MetricCreatedTimestamp
|
Data - ora | Indicazione oraria (data/ora) in cui è stato generato il risultato della metrica. |
Retrieved Context Id List
|
RetrievedContextIdListText
|
Testo | Elenco degli ID contesto (Top-K) estratti da ResultText nella risposta del retriever. Utilizzato per la creazione di rapporti. |
Retriever Api Name
|
RetrieverApiName
|
Testo | Nome API del retriever associato alla richiesta. |
Retriever Trace Id
|
RetrieverTraceId
|
Testo | ID traccia (ad esempio, da OTel) generato durante la richiesta di recupero. |
Retriever Trace Span Id
|
RetrieverTraceSpanId
|
Testo | Trace Span Id (ad esempio, da OTel) generato durante la richiesta di recupero. Riferimento al DMO Telemetry Trace. |
Source Document Id List
|
SourceDocumentIdListText
|
Testo | Elenco degli ID record di origine della risposta del retriever. Utilizzato per la creazione di rapporti. |
System Modified Stamp
|
SystemModstamp
|
Data - ora | Indicazione oraria (data/ora) dell'ultima modifica apportata a questo record da un utente o da un processo automatico. |
UserUtterance
|
UserUtteranceText
|
Testo | Contesto estratto dall'enunciazione dell'utente nella richiesta retriever. Utilizzato per la creazione di rapporti. |
