Rastreo de plataforma de agente
Esta función de rastreo proporciona visibilidad integral de las acciones y el desempeño de Agentforce Agents, capturando datos de telemetría cruciales entre varios servicios. Aprovechando Data 360, los usuarios pueden unificar estos datos de rastreo con información de sesión para crear reportes detallados. Estos reportes son inestimables para monitorear Indicadores clave de desempeño (KPI), identificar cuellos de botella de desempeño y determinar rápidamente la causa raíz de los problemas, mejorando en última instancia la fiabilidad y la eficiencia de las implementaciones de Agentes.
Ediciones necesarias
| Disponible en: Lightning Experience |
| Disponible en: Ediciones Enterprise, Performance, Unlimited y Developer Edition con Foundations o Agentforce 1 o Einstein 1 |
Configurar Rastreo de plataforma de agente
Para generar reportes de Data 360 para Rastreo de sesión y 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 Einstein, haga clic en Einstein Audit, Analytics and Monitoring Setup.
- Confirme que Rastreo de sesiones Agentforce está activado. Consulte Configurar Rastreo de sesiones de Agentforce.
- Desplácese hasta el 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 la conversión de 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 reanudarlos más adelante. Cualquier reporte muestra un intervalo entre el momento en que lo desactiva y lo vuelve a activar.
Reportes de Data 360 para sesiones de representantes de servicio y rastreos de plataforma
Para obtener perspectivas sobre los indicadores clave de desempeño y las tendencias, cree un reporte único de Data 360 que integre tanto los rastreos de Sesión de agente como los rastreos de Plataforma de extremo a extremo. Este reporte 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 DC
Generar un reporte de Data 360
Cree reportes sobre objetos de modelo de datos (DMO) específicos, como Espacio de rastreo de telemetría e Interacción de agente de IA, para analizar y aprender de datos unificados.
- Navegue a la ficha Reportes en Salesforce y haga clic en Nuevo reporte. Se muestra la página Tipos de reporte.
- En la barra de búsqueda, escriba el nombre del objeto de modelo de datos (DMO) sobre el que desea crear un reporte. En este caso, seleccionaría Interacción de agente de rastreo de telemetría o IA.
- Cree una nueva relación de campo dentro de los objetos de modelo de datos relevantes. En esta instancia, puede seleccionar Espacio 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.
- En 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 reporte personalizado.
- Haga clic en Nuevo reporte personalizado en Configuración debajo de Nuevo reporte personalizado. Rellene los campos para crear un nuevo tipo de reporte personalizado. En este caso, crearía un tipo de reporte Sesión y Rastreo de plataforma.
- Vaya a la aplicación Data Cloud y seleccione la ficha Reportes.
- Cree un reporte de Data 360. Haga clic en Nuevo reporte y seleccione el tipo de reporte que desee (por ejemplo, Rastros de sesión y Rastreo de plataforma).
- Haga clic en Iniciar reporte.
Una vez iniciado el reporte, debe 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 agente
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 monitoreo.
Transmisión de datos de intervalos de observabilidad
La Transmisión de datos de intervalos de observabilidad se crea automáticamente para capturar los datos de rastreo:
| Etiqueta | Esquema 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 espacios de observabilidad
Se crea un nuevo DLO denominado ObservabilitySpans con los siguientes campos:
| Etiqueta | Esquema 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 de intervalo de rastreo de telemetría
Se crea un nuevo DMO denominado Telemetry Trace Span con los siguientes campos:
| Etiqueta | Esquema API | Tipo de datos | Descripción |
|---|---|---|---|
| Origen de datos | ssot__DataSourceId__c |
Texto | Un Id. de referencia exclusivo para el origen del 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 conectora. |
| 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 de intervalo. |
| Organización interna | ssot__InternalOrganizationId__c |
Fecha y hora | Identificador para la organización interna o el departamento propietario de los datos. |
| Calificador clave Telemetría Intervalo principal | KQ_TelemetryParentSpanId__c |
Texto | Id. de intervalo principal de rastreo completamente cualificado |
| Id. de intervalo de rastreo de telemetría de calificador clave | KQ_Id__c |
Texto | Id. de intervalo 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 de intervalo. |
| Código de estado | ssot__StatusCode__c |
Fecha y hora | El resultado de ejecución de un intervalo. |
| Intervalo 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 intervalo. |
| 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

