Rastreo de plataforma de agente
Esta función de rastreo proporciona visibilidad integral de las acciones y el rendimiento de Agentforce Agents, capturando datos de telemetría cruciales entre varios servicios. Al aprovechar Data 360, los usuarios pueden unificar estos datos de rastreo con información de sesión para crear informes detallados. Estos informes son inestimables para supervisar indicadores clave de rendimiento (KPI), identificar cuellos de botella de rendimiento y determinar rápidamente la causa raíz de los problemas, mejorando en última instancia la fiabilidad y eficiencia de las implementaciones de agentes.
Ediciones necesarias
| Disponible en: Lightning Experience |
| Disponible en: Ediciones Enterprise, Performance, Unlimited y Developer Edition con Foundations o Agenciaforce 1 o Einstein 1 |
Configurar Rastreo de plataforma de agente
Para generar informes de Data 360 para Sesión y Rastreo de plataforma, los usuarios deben activar primero Data 360 y Rastreo de plataforma.
- En Configuración, utilice el cuadro Búsqueda rápida para buscar IA generativa de Einstein.
- Desde IA generativa de Einstein, haga clic en Einstein Audit, Analytics and Monitoring Setup (Configuración de auditoría, análisis y supervisión de Einstein).
- Confirme que Rastreo de sesiones Agentforce está activado. Consulte Configurar Rastreo de sesiones de Agentforce.
- Desplácese al conmutador Rastreo de plataforma de agente y actívelo.
Su modelo de datos se aprovisiona en solo unos minutos. La recopilación de datos se inicia inmediatamente y se repite a intervalos de cinco minutos. Tenga en cuenta que convertir la recopilación de datos aumenta el índice de consumo de crédito de su organización.
Suspender la recopilación de datos mantiene sus datos de modo que pueda reanudar más adelante. Cualquier informe muestra un intervalo entre el momento en que lo desactiva y lo vuelve a activar.
Informes de Data 360 para sesiones de representantes de servicio y rastreos de plataforma
Para obtener perspectivas sobre los indicadores clave de rendimiento y las tendencias, cree un informe único de Data 360 que integre tanto las trazas de Sesión de agente como las trazas de Plataforma de extremo a extremo. Este informe se puede ejecutar para datos casi en tiempo real, permite agrupar, filtrar y resumir registros y se puede compartir con otros.
Rastreo de agentes incluye intervalos de los siguientes servicios:
- Apex
- Flujos
- Generador de solicitudes
- Acciones invocables
- Planner
- AI Gateway
- Pasarela LLM
- Federador de consultas de DC
Generar un informe de Data 360
Cree informes sobre objetos de modelo de datos (DMO) específicos, como Periodo de rastreo de telemetría e Interacción de agente de IA, para analizar y aprender de datos unificados.
- Navegue a la ficha Informes en Salesforce y haga clic en Nuevo informe. Se muestra la página Tipos de informe.
- En la barra de búsqueda, escriba el nombre del Objeto de modelo de datos (DMO) sobre el que desea crear un informe. En este caso, seleccionaría Plazo de rastreo de telemetría o Interacción de agente de IA.
- Cree una nueva relación de campo dentro de los objetos del modelo de datos relevantes. En este caso, puede seleccionar Plazo de rastreo de telemetría - Rastreo de telemetría → ManyToOne → Interacción de agente de IA - Rastreo de telemetría.
En Data 360, las relaciones entre DMO se establecen definiendo una conexión desde un "DMO de origen" a un "DMO de destino" utilizando campos clave. El tipo de relación más frecuente es Muchos a uno, donde múltiples registros desde el DMO de origen corresponden a un único registro en el DMO de destino. Consulte Relaciones de objetos de modelo de datos para obtener más información.
- Dentro de la página de detalles del DMO, hay una ficha Relaciones. Esta ficha proporciona una vista visual y estructurada de todas las relaciones que existen para este DMO. Verifique las nuevas relaciones de DMO a través de la ficha Relaciones.
Ejemplo de intervalo de rastreo de telemetría
Ejemplo de interacción de agente de IA
- Cree un tipo de informe personalizado.
- Haga clic en Nuevo informe personalizado en Configuración debajo de Nuevo informe personalizado. Rellene los campos para crear un nuevo tipo de informe personalizado. En este caso, crearía un tipo de informe Sesión y Rastreo de plataforma.
- Vaya a la aplicación Data Cloud y seleccione la ficha Informes.
- Cree un informe de Data 360. Haga clic en Nuevo informe y seleccione el tipo de informe que desee (por ejemplo, Rastreos de sesión y Rastreo de plataforma).
- Haga clic en Iniciar informe.
Una vez iniciado el informe, debería poder visualizar los intervalos de rastreo de telemetría de plataforma correlacionados registrados como parte de cada sesión de agente.
Modelo de datos para Rastreo de plataforma de agentes
La activación de estas funciones genera automáticamente una transmisión de datos de Data 360, un Objeto de lago de datos (DLO) y un Objeto de modelo de datos (DMO). Estos datos se crean dentro del espacio de datos especificado en Auditoría y supervisión.
Transmisión de datos de intervalos de observabilidad
La transmisión de datos Plazos de observabilidad se crea automáticamente para capturar los datos de rastreo:
| Etiqueta | Esquema de API | ID |
|---|---|---|
| cdp_sys_PartitionDate | cdp_sys_PartitionDate__c |
Fecha y hora |
| Organización interna | InternalOrganization__c |
Texto |
| Objeto de origen de datos | DataSourceObject__c |
Texto |
| Origen de datos | DataSource__c |
Texto |
| atributos | attributes__c |
Texto |
| durationNanos | durationNanos__c |
Número |
| endDateTime | endDateTime__c |
Fecha y hora |
| operationName | operationName__c |
Texto |
| organizationId | organizationId__c |
Texto |
| parentSpanId | parentSpanId__c |
Texto |
| serviceName | serviceName__c |
Texto |
| spanId | spanId__c |
Texto |
| spanKind | spanKind__c |
Texto |
| startDateTime | startDateTime__c |
Fecha y hora |
| statusCode | statusCode__c |
Texto |
| traceId | traceId__c |
Texto |
Objeto Lago de datos de intervalos de observabilidad
Se crea un nuevo DLO denominado ObservabilitySpans con los siguientes campos:
| Etiqueta | Esquema de API | Tipo de datos |
|---|---|---|
| atributos | attributes__c |
Texto |
| cdp_sys_PartitionDate | cdp_sys_PartitionDate__c |
Fecha y hora |
| cdp_sys_SourceVersion | cdp_sys_SourceVersion__c |
Texto |
| Origen de datos | DataSource__c |
Texto |
| Objeto de origen de datos | DataSourceObject__c |
Texto |
| durationNanos | durationNanos__c |
Número |
| endDateTime | endDateTime__c |
Fecha y hora |
| Organización interna | InternalOrganization__c |
Texto |
| KQ_parentSpanId | KQ_parentSpanId__c |
Texto |
| KQ_spanId | KQ_spanId__c |
Texto |
| operationName | operationName__c |
Texto |
| organizationId | organizationId__c |
Texto |
| parentSpanId | parentSpanId__c |
Texto |
| serviceName | serviceName__c |
Texto |
| spanId | spanId__c |
Texto |
| startDateTime | startDateTime__c |
Fecha y hora |
| statusCode | statusCode__c |
Texto |
| traceId | traceId__c |
Texto |
Objeto de modelo de datos Periodo de rastreo de telemetría
Se crea un nuevo DMO denominado Periodo de rastreo de telemetría con los siguientes campos:
| Etiqueta | Esquema de API | Tipo de datos | Descripción |
|---|---|---|---|
| Origen de datos | ssot__DataSourceId__c |
Texto | Un Id. de referencia exclusivo para el origen de registro. |
| Objeto de origen de datos | ssot__DataSourceObjectId__c |
Texto | Id. exclusivo para el objeto de origen, como un archivo de almacenamiento en la nube o una entidad de conector. |
| Número de duración | ssot__DurationNumber__c |
Texto | Duración total del intervalo en nanosegundos. |
| Fecha y hora de finalización | ssot__EndDateTime__c |
Número | Hora de finalización. |
| Organización interna | ssot__InternalOrganizationId__c |
Fecha y hora | Identificador de la organización interna o departamento que posee los datos. |
| Plazo principal de telemetría de calificador clave | KQ_TelemetryParentSpanId__c |
Texto | Id. de periodo principal de rastreo completamente cualificado |
| Id. de Periodo de rastreo de telemetría de calificador clave | KQ_Id__c |
Texto | Id. de periodo de rastreo completamente cualificado |
| Nombre de operación | ssot__OperationName__c |
Texto | Nombre de la operación realizada en el servicio externo. |
| Nombre de servicio | ssot__ServiceName__c |
Texto | Identificador de servicio. |
| Fecha y hora de inicio | ssot__StartDateTime__c |
Texto | Hora de inicio del plazo. |
| Código de estado | ssot__StatusCode__c |
Fecha y hora | El resultado de ejecución de un intervalo. |
| Periodo principal de telemetría | ssot__TelemetryParentSpanId__c |
Texto | Identificador exclusivo para un intervalo principal, utilizado para realizar un seguimiento de suboperaciones anidadas. |
| Atributos de intervalo de telemetría | ssot__TelemetrySpanAttributeText__c |
Texto | Metadatos de valor clave que proporcionan contexto operativo para un intervalo. |
| Eventos de intervalo de telemetría | ssot__TelemetrySpanEventText__c |
Texto | Registra un evento singular y significativo durante la duración de un periodo. |
| Trazas de telemetría | ssot__TelemetryTrace__c |
Texto | Identificador exclusivo utilizado para realizar un seguimiento de una solicitud completa en todos los intervalos relacionados. |
| Id. de intervalo de rastreo de telemetría | ssot__Id__c |
Texto | Un Id. exclusivo para un intervalo individual, que representa una única unidad de trabajo. |
Ejemplos de SOQL
SOQL DE DLO
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 100Ejemplo de rastreo
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

