Tracciamento piattaforma agente
Questa funzionalità di tracciamento offre una visibilità completa sulle azioni e le prestazioni degli agenti Agentforce, acquisendo dati di telemetria cruciali in vari servizi. Sfruttando Data 360, gli utenti possono unificare questi dati di traccia con le informazioni della sessione per creare rapporti dettagliati. Questi rapporti sono preziosi per monitorare gli indicatori di prestazione chiave (KPI), identificare i colli di bottiglia delle prestazioni e individuare rapidamente la causa principale dei problemi, migliorando in ultima analisi l'affidabilità e l'efficienza delle implementazioni degli agenti.
Versioni (Edition) richieste
| Disponibile nelle versioni: Lightning Experience |
| Disponibile in: Edizioni Enterprise Edition, Performance Edition, Unlimited Edition e Developer Edition with Foundations o Agenteforce 1 o Einstein 1 Edition |
Impostazione del tracciamento piattaforma agente
Per generare rapporti Data 360 per i tracciati di sessioni e piattaforme, gli utenti devono prima abilitare Data 360 e Tracciamento piattaforma.
- In Imposta, utilizzare la casella Ricerca veloce per cercare AI generativa Einstein.
- Da AI generativa Einstein, fare clic su Impostazione Einstein Audit, Analytics e monitoraggio.
- Verificare che il tracciamento delle sessioni Agentforce sia attivato. Vedere Impostazione del tracciamento sessione Agentforce.
- Scorrere fino al selettore Tracciamento piattaforma agente e attivarlo.
Il provisioning del modello di dati avviene in pochi minuti. La raccolta dei dati inizia immediatamente e ricorre a intervalli di cinque minuti. Tenere presente che trasformare la raccolta dati aumenta la percentuale di consumo di credito dell'organizzazione.
Sospendendo la raccolta dei dati si conservano i dati in modo che possano essere ripresi in seguito. Tutti i rapporti mostrano un intervallo tra il momento in cui viene disattivato e il momento in cui viene riattivato.
Rapporti di Data 360 per le sessioni degli agenti di assistenza e le tracce della piattaforma
Per ottenere informazioni approfondite su KPI e tendenze, creare un unico rapporto Data 360 che integri sia le tracce della sessione agente che le tracce della piattaforma end-to-end. Questo rapporto può essere eseguito per i dati quasi in tempo reale, consente di raggruppare, filtrare e riepilogare i record e può essere condiviso con altri.
Il tracciamento degli agenti include i seguenti servizi:
- Apex
- Flussi
- Generatore di prompt
- Azioni invocabili
- Pianificatore
- Gateway AI
- Gateway LLM
- Federatore di query DC
Generazione di un rapporto Data 360
Creare rapporti su oggetti modello di dati (DMO) specifici, ad esempio Telemetry Trace Span e AI Agent Interaction, per analizzare e imparare dai dati unificati.
- Accedere alla scheda Rapporti in Salesforce e fare clic su Nuovo rapporto. Viene visualizzata la pagina Tipi di rapporto.
- Nella barra di ricerca, digitare il nome dell'oggetto modello di dati (DMO) su cui si desidera eseguire il rapporto. In questo caso, si selezionerebbe Estensione traccia telemetrica o Interazione agente AI.
- Creare una nuova relazione di campo all'interno degli oggetti modello di dati pertinenti. In questo caso, è possibile selezionare Estensione traccia telemetrica - Traccia telemetrica → ManyToOne → Interazione agente AI - Traccia telemetrica.
In Data 360, le relazioni tra i DMO vengono stabilite definendo una connessione da un "DMO di origine" a un "DMO di destinazione" utilizzando campi chiave. Il tipo di relazione più frequente è Molti a uno, dove più record del DMO di origine corrispondono a un singolo record nel DMO di destinazione. Per ulteriori informazioni, vedere Relazioni tra gli oggetti modello di dati.
- All'interno della pagina dei dettagli del DMO è presente una scheda Relazioni. Questa scheda offre una visualizzazione visiva e strutturata di tutte le relazioni esistenti per questo DMO. Verificare le nuove relazioni tra i DMO tramite la scheda Relazioni.
Esempio di estensione di traccia telemetrica
Esempio di interazione agente AI
- Creare un tipo di rapporto personalizzato.
- Fare clic su Nuovo rapporto personalizzato in Imposta sotto a Nuovo rapporto personalizzato. Compilare i campi per creare un nuovo tipo di rapporto personalizzato. In questo caso, si creerebbe un tipo di rapporto Session & Platform Traces.
- Accedere all'app Data Cloud e selezionare la scheda Rapporti.
- Creare un rapporto Data 360. Fare clic su Nuovo rapporto e selezionare il tipo di rapporto desiderato (ad esempio Tracce sessione e Tracce piattaforma).
- Fare clic su Inizia rapporto.
Una volta avviato il rapporto, è necessario essere in grado di visualizzare i campi di traccia telemetria piattaforma correlati registrati nell'ambito di ogni sessione agente.
Modello di dati per il tracciamento piattaforma agente
L'abilitazione di queste funzioni genera automaticamente uno stream di dati di Data 360, un oggetto data lake (DLO) e un oggetto modello di dati (DMO). Questi dati vengono creati all'interno dello spazio dati specificato in Controllo e monitoraggio.
L'osservabilità si estende allo stream di dati
Lo stream di dati Observability Spans viene creato automaticamente per acquisire i dati di traccia:
| Etichetta | API Schema | REFERENTE |
|---|---|---|
| cdp_sys_PartitionDate | cdp_sys_PartitionDate__c |
DateTime |
| Organizzazione interna | InternalOrganization__c |
Testo |
| Oggetto fonte di dati | DataSourceObject__c |
Testo |
| Fonte di dati | DataSource__c |
Testo |
| attributi | attributes__c |
Testo |
| durationNanos | durationNanos__c |
Numero |
| endDateTime | endDateTime__c |
DateTime |
| operationName | operationName__c |
Testo |
| organizationId | organizationId__c |
Testo |
| parentSpanId | parentSpanId__c |
Testo |
| serviceName | serviceName__c |
Testo |
| spanId | spanId__c |
Testo |
| spanKind | spanKind__c |
Testo |
| startDateTime | startDateTime__c |
DateTime |
| statusCode | statusCode__c |
Testo |
| traceId | traceId__c |
Testo |
L'osservabilità si estende all'oggetto data lake
Viene creato un nuovo DLO denominato ObservabilitySpans con i seguenti campi:
| Etichetta | API Schema | Tipo di dati |
|---|---|---|
| attributi | attributes__c |
Testo |
| cdp_sys_PartitionDate | cdp_sys_PartitionDate__c |
DateTime |
| cdp_sys_SourceVersion | cdp_sys_SourceVersion__c |
Testo |
| Fonte di dati | DataSource__c |
Testo |
| Oggetto fonte di dati | DataSourceObject__c |
Testo |
| durationNanos | durationNanos__c |
Numero |
| endDateTime | endDateTime__c |
DateTime |
| Organizzazione interna | InternalOrganization__c |
Testo |
| KQ_parentSpanId | KQ_parentSpanId__c |
Testo |
| KQ_spanId | KQ_spanId__c |
Testo |
| operationName | operationName__c |
Testo |
| organizationId | organizationId__c |
Testo |
| parentSpanId | parentSpanId__c |
Testo |
| serviceName | serviceName__c |
Testo |
| spanId | spanId__c |
Testo |
| startDateTime | startDateTime__c |
DateTime |
| statusCode | statusCode__c |
Testo |
| traceId | traceId__c |
Testo |
Oggetto modello di dati dell'estensione della traccia telemetrica
Viene creato un nuovo DMO denominato Telemetry Trace Span con i seguenti campi:
| Etichetta | API Schema | Tipo di dati | Descrizione |
|---|---|---|---|
| Fonte di dati | ssot__DataSourceId__c |
Testo | ID riferimento univoco per l'origine del record. |
| Oggetto fonte di dati | ssot__DataSourceObjectId__c |
Testo | ID univoco dell'oggetto di origine, ad esempio un file di archiviazione cloud o un'entità connettore. |
| Numero durata | ssot__DurationNumber__c |
Testo | Durata totale dell'intervallo in nano secondi. |
| Data ora finale | ssot__EndDateTime__c |
Numero | Estensione dell'ora di fine. |
| Organizzazione interna | ssot__InternalOrganizationId__c |
DateTime | Identificatore dell'organizzazione interna o del reparto titolare dei dati. |
| Ambito controllante qualificatore chiave telemetria | KQ_TelemetryParentSpanId__c |
Testo | ID estensione controllante traccia completo |
| ID intervallo traccia telemetria qualificatore chiave | KQ_Id__c |
Testo | ID intervallo di traccia completo |
| Nome operazione | ssot__OperationName__c |
Testo | Nome dell'operazione eseguita sul servizio esterno. |
| Nome servizio | ssot__ServiceName__c |
Testo | Identificatore del servizio. |
| Data ora iniziale | ssot__StartDateTime__c |
Testo | Estensione dell'ora di inizio. |
| Codice stato | ssot__StatusCode__c |
DateTime | Risultato dell'esecuzione di una campata. |
| Campo controllante telemetria | ssot__TelemetryParentSpanId__c |
Testo | Identificatore univoco per un'estensione controllante, utilizzato per tenere traccia delle operazioni secondarie nidificate. |
| Attributi dell'estensione telemetrica | ssot__TelemetrySpanAttributeText__c |
Testo | Metadati chiave-valore che forniscono il contesto operativo per un'estensione. |
| Eventi estensione telemetria | ssot__TelemetrySpanEventText__c |
Testo | Registra un evento singolare e significativo durante la durata di un intervallo. |
| Tracce telemetriche | ssot__TelemetryTrace__c |
Testo | Identificatore univoco utilizzato per tenere traccia di una richiesta completa in tutti gli ambiti correlati. |
| ID estensione traccia telemetrica | ssot__Id__c |
Testo | ID univoco per un singolo intervallo, che rappresenta una singola unità di lavoro. |
Esempi di SOQL
DLO SOQL
SELECT attributes__c, cdp_sys_PartitionDate__c, cdp_sys_SourceVersion__c, DataSource__c, DataSourceObject__c,
durationNanos__c, endDateTime__c, InternalOrganization__c, KQ_parentSpanId__c, KQ_spanId__c
FROM ObservabilitySpans__dll LIMIT 100DMO SOQL
SELECT ssot__DataSourceId__c, ssot__DataSourceObjectId__c, ssot__DurationNumber__c, ssot__EndDateTime__c,
ssot__InternalOrganizationId__c, KQ_TelemetryParentSpanId__c, KQ_Id__c, ssot__OperationName__c, ssot__ServiceName__c,
ssot__SpanKind__c FROM ssot__TelemetryTraceSpan__dlm LIMIT 100Esempio di traccia
Trace ID: a744ad5ccf0f61c2
run.interaction [Atlas Reasoning Engine] [ROOT]
(spanId: 9dcc09221a05d4cf)
│
├── run.action.AnswerQuestionsWithKnowledge_179gL0000019Ah7 [Atlas Reasoning Engine]
│ (spanId: 90a3808ba7a67fe8)
│ │
│ └── run.invokeActions.STREAM_KNOWLEDGE_SEARCH [InvocableAction]
│ (spanId: 95499b41725eb82a)
│ │
│ └── run.einstein_gpt__answerWithKnowledge.1 [PromptTemplate]
│ (spanId: a9a8b8f2e1fd35cb)
│ 📋 Attributes:
│ • prompt_template.execution.api.version: 66.0
│ • prompt_template.execution.step: 66.0
│ • prompt_template.api.name: einstein_gpt__answerWithKnowledge
│ • prompt_template.api.version: 1
│ │
│ └── run.invokeActions.EINSTEIN_RETRIEVER_GET_RESULTS [InvocableAction]
│ (spanId: 82559a5dedaff638)
│ │
│ ├── run.step.einstein_gpt__answerWithKnowledge [PromptTemplate]
│ │ (spanId: 934afceaac15c6d4)
│ │ 📋 Attributes:
│ │ • prompt_template.step.start_time: 1774049705404
│ │ • prompt_template.step.end_time: 1774049705430
│ │ • prompt_template.step: resolve_template
│ │ │
│ │ └── run.step.einstein_gpt__answerWithKnowledge [PromptTemplate]
│ │ (spanId: b93e831b1c492cf9)
│ │ 📋 Attributes:
│ │ • prompt_template.step.start_time: 1774049705447
│ │ • prompt_template.step.end_time: 1774049705449
│ │ • prompt_template.step: mask_template
│ │ │
│ │ └── run.step.einstein_gpt__answerWithKnowledge [PromptTemplate]
│ │ (spanId: 8380c9b813f64afa)
│ │ 📋 Attributes:
│ │ • prompt_template.step.start_time: 1774049705500
│ │ • prompt_template.step.end_time: 1774049705502
│ │ • prompt_template.step: generation
│ │
│ └── run.retriever.File_ADL_File_ADL_1Cx_Xl7d6d114de [Einstein AI Gateway]
│ (spanId: a0f6b9721e1049a3)
│ 📋 Attributes:
│ • retriever.numberofresults: 10
│ • retriever.isadvancedmode: False
│ • retriever.retrievername: File_ADL_File_ADL_1Cx_Xl7d6d114de
│ │
│ └── run.hybridsearch.ADL_File_ADL_index__dlm [Data Cloud]
│ (spanId: 86aa7512858c1aa9)
│
├── run.topic.GeneralFAQ_16jgL000001ATzR [Atlas Reasoning Engine]
│ (spanId: a3709c000d5d6a2e)
│ │
│ ├── run.llmstep [Atlas Reasoning Engine]
│ │ (spanId: 9829763b4362466f)
│ │
│ ├── run.llmstep [Atlas Reasoning Engine]
│ │ (spanId: 9a29b1009ea0f4c6)
│ │
│ └── run.llmstep [Atlas Reasoning Engine]
│ (spanId: bf63506e4fccff9f)
│
└── run.llmstep [Atlas Reasoning Engine]
(spanId: 9f31edde2c62d1dc)
Summary:
- 15 total spans in this trace
- 5 spans with attributes (marked with 📋)
- 10 spans without attributes
- All spans share trace ID: a744ad5ccf0f61c2

