에이전트 플랫폼 추적
이 추적 기능은 Agentforce 에이전트의 작업 및 성능을 포괄적으로 파악하고 다양한 서비스 간에 중요한 텔레메트리 데이터를 수집합니다. Data 360을 활용하면 사용자가 세션 정보와 이 추적 데이터를 통합하여 자세한 보고서를 만들 수 있습니다. 이러한 보고서는 핵심 성과 지표(KPI)를 모니터링하고 성능 지체 지점을 식별하고 문제의 근본 원인을 신속하게 파악하여 에이전트 구현의 신뢰도와 효율성을 최종적으로 향상하는 데 매우 유용합니다.
필수 Edition
| 지원 제품: Lightning Experience |
| 지원 제품: Enterprise, Performance, Unlimited 및 Developer Edition(Foundations 포함) 또는 Agentforce 1 또는 Einstein 1 Edition |
에이전트 플랫폼 추적 설정
세션 및 플랫폼 추적에 대한 Data 360 보고서를 생성하려면 사용자가 먼저 Data 360 및 플랫폼 추적을 활성화해야 합니다.
- 설정에서 빠른 찾기 상자를 사용하여 Einstein 생성형 AI를 검색합니다.
- Einstein 생성형 AI에서 Einstein 감사, 분석, 모니터링 설정을 클릭합니다.
- Agentforce 세션 추적이 켜져 있는지 확인합니다. Agentforce 세션 추적 설정을 참조하십시오.
- 에이전트 플랫폼 추적 토글까지 스크롤하여 활성화합니다.
데이터 모델은 몇 분 만에 프로비저닝됩니다. 그러면 데이터 수집이 즉시 시작되고 5분 간격으로 반복됩니다. 데이터 수집을 전환하면 조직의 신용 소비율이 증가합니다.
데이터 수집을 일시 중단하면 나중에 다시 시작할 수 있도록 데이터가 유지됩니다. 모든 보고서는 비활성화 후 다시 켜는 시간 간의 간격을 표시합니다.
서비스 담당자 세션 및 플랫폼 추적에 대한 Data 360 보고서
KPI 및 추세에 대한 인사이트를 얻으려면 에이전트 세션 추적 및 종단간 플랫폼 추적을 모두 통합하는 단일 Data 360 보고서를 만듭니다. 이 보고서는 거의 실시간 데이터에 대해 실행할 수 있으며, 레코드를 그룹화, 필터링, 요약할 수 있으며, 다른 사람과 공유할 수 있습니다.
에이전트 추적에는 다음 서비스의 범위가 포함됩니다.
- Apex
- Flows(플로)
- 프롬프트 빌더
- 호출 가능 작업
- 플래너
- AI 게이트웨이
- LLM 게이트웨이
- DC 쿼리 연합자
Data 360 보고서 생성
Telemetry Trace Span 및 AI Agent 상호 작용과 같은 특정 데이터 모델 개체(DMO)에 대한 보고서를 만들어 통합 데이터를 분석하고 학습합니다.
- Salesforce에서 보고서 탭으로 이동하고 새 보고서를 클릭합니다. 보고서 유형 페이지가 표시됩니다.
- 검색 막대에 보고할 데이터 모델 개체(DMO)의 이름을 입력합니다. 이 경우 Telemetry Trace Span 또는 AI 에이전트 상호 작용을 선택합니다.
- 관련 데이터 모델 개체 내에서 새 필드 관계를 만듭니다. 이 인스턴스에서 Telemetry Trace Span -Telemetry Trace → ManyToOne → AI Agent 상호 작용 - Telemetry Trace를 선택할 수 있습니다.
Data 360에서 키 필드를 사용하여 "소스 DMO"에서 "대상 DMO"로의 연결을 정의하여 DMO 간 관계를 설정합니다. 가장 빈번한 관계 유형은 소스 DMO의 여러 레코드가 대상 DMO의 단일 레코드에 해당하는 다대일입니다. 자세한 내용은 데이터 모델 개체 관계를 참조하십시오.
- DMO의 세부 사항 페이지 내에 관계 탭이 있습니다. 이 탭은 이 DMO에 대해 존재하는 모든 관계에 대한 시각적이고 구조화된 보기를 제공합니다. 관계 탭을 통해 새 DMO 관계를 확인합니다.
Telemetry 추적 스패 예제
AI 에이전트 상호 작용 예제
- 사용자 정의 보고서 유형을 만듭니다.
- 새 사용자 정의 보고서 아래의 설정에서 새 사용자 정의 보고서를 클릭합니다. 필드를 작성하여 새 사용자 정의 보고서 유형을 만듭니다. 이 경우, 세션 및 플랫폼 추적 보고서 유형을 만듭니다.
- Data Cloud 앱으로 이동하여 보고서 탭을 선택합니다.
- Data 360 보고서를 만듭니다. 새 보고서를 클릭하고 원하는 보고서 유형(즉, 세션 추적 및 플랫폼 추적)을 선택합니다.
- Start Report(보고서 시작)를 클릭합니다.
보고서가 시작되면 각 에이전트 세션의 일부로 기록된 관련 플랫폼 Telemetry 추적 범위를 시각화할 수 있어야 합니다.
에이전트 플랫폼 추적을 위한 데이터 모델
해당 기능을 활성화하면 Data 360 데이터 스트림, 데이터 레이크 개체(DLO), 데이터 모델 개체(DMO)가 자동으로 생성됩니다. 이 데이터는 감사 및 모니터링에 지정된 데이터 공간 내에 생성됩니다.
데이터 스트림에 대한 관찰 가능
관찰 가능성 범위 데이터 스트림이 추적 데이터를 수집하기 위해 자동으로 생성됩니다.
| 레이블 | API 스키마 | ID |
|---|---|---|
| cdp_sys_PartitionDate | cdp_sys_PartitionDate__c |
날짜/시간 |
| 내부 조직 | InternalOrganization__c |
텍스트 |
| 데이터 소스 개체 | DataSourceObject__c |
텍스트 |
| 데이터 소스 | DataSource__c |
텍스트 |
| 특성 | attributes__c |
텍스트 |
| durationNanos | durationNanos__c |
숫자 |
| endDateTime | endDateTime__c |
날짜/시간 |
| operationName | operationName__c |
텍스트 |
| organizationId | organizationId__c |
텍스트 |
| parentSpanId | parentSpanId__c |
텍스트 |
| serviceName | serviceName__c |
텍스트 |
| spanId | spanId__c |
텍스트 |
| spanKind | spanKind__c |
텍스트 |
| startDateTime | startDateTime__c |
날짜/시간 |
| statusCode | statusCode__c |
텍스트 |
| traceId | traceId__c |
텍스트 |
데이터 레이크 개체에 걸친 관찰 가능
ObservabilitySpans라는 새 DLO가 다음 필드와 함께 생성됩니다.
| 레이블 | API 스키마 | 데이터 유형 |
|---|---|---|
| 특성 | attributes__c |
텍스트 |
| cdp_sys_PartitionDate | cdp_sys_PartitionDate__c |
날짜/시간 |
| cdp_sys_SourceVersion | cdp_sys_SourceVersion__c |
텍스트 |
| 데이터 소스 | DataSource__c |
텍스트 |
| 데이터 소스 개체 | DataSourceObject__c |
텍스트 |
| durationNanos | durationNanos__c |
숫자 |
| endDateTime | endDateTime__c |
날짜/시간 |
| 내부 조직 | InternalOrganization__c |
텍스트 |
| KQ_parentSpanId | KQ_parentSpanId__c |
텍스트 |
| KQ_spanId | KQ_spanId__c |
텍스트 |
| operationName | operationName__c |
텍스트 |
| organizationId | organizationId__c |
텍스트 |
| parentSpanId | parentSpanId__c |
텍스트 |
| serviceName | serviceName__c |
텍스트 |
| spanId | spanId__c |
텍스트 |
| startDateTime | startDateTime__c |
날짜/시간 |
| statusCode | statusCode__c |
텍스트 |
| traceId | traceId__c |
텍스트 |
Telemetry Trace Span 데이터 모델 개체
Telemetry Trace Span이라는 새 DMO가 다음 필드와 함께 생성됩니다.
| 레이블 | API 스키마 | 데이터 유형 | 상세 설명 |
|---|---|---|---|
| 데이터 소스 | ssot__DataSourceId__c |
텍스트 | 레코드 소스에 대한 고유 참조 ID입니다. |
| 데이터 소스 개체 | ssot__DataSourceObjectId__c |
텍스트 | 클라우드 저장소 파일 또는 커넥터 엔티티와 같은 원본 개체의 고유 ID입니다. |
| 기간 번호 | ssot__DurationNumber__c |
텍스트 | 총 간격 기간(나노초)입니다. |
| 종료 일자/시간 | ssot__EndDateTime__c |
숫자 | 스패드 종료 시간. |
| 내부 조직 | ssot__InternalOrganizationId__c |
날짜/시간 | 데이터를 소유한 내부 조직 또는 부서의 식별자입니다. |
| 키 한정자 텔레메트리 상위 구간 | KQ_TelemetryParentSpanId__c |
텍스트 | 정규화된 추적 상위 구간 ID |
| 키 한정자 Telemetry 추적 스패닝 ID | KQ_Id__c |
텍스트 | 정규화된 추적 속도 ID |
| 작업 이름 | ssot__OperationName__c |
텍스트 | 외부 서비스에 수행된 작업의 이름입니다. |
| 서비스 이름 | ssot__ServiceName__c |
텍스트 | 서비스 식별자입니다. |
| 시작 일자/시간 | ssot__StartDateTime__c |
텍스트 | 스패 시작 시간. |
| 상태 코드 | ssot__StatusCode__c |
날짜/시간 | 스팽의 실행 결과입니다. |
| 텔레메트리 상위 구간 | ssot__TelemetryParentSpanId__c |
텍스트 | 중첩된 하위 작업을 추적하는 데 사용되는 상위 스페인의 고유 식별자입니다. |
| Telemetry Span 특성 | ssot__TelemetrySpanAttributeText__c |
텍스트 | 스판에 대한 운영 컨텍스트를 제공하는 키 값 메타데이터입니다. |
| Telemetry Span 이벤트 | ssot__TelemetrySpanEventText__c |
텍스트 | 스탠 기간 동안 의미 있는 단일 이벤트를 기록합니다. |
| 텔레메트리 추적 | ssot__TelemetryTrace__c |
텍스트 | 모든 관련 범위에서 전체 요청을 추적하는 데 사용되는 고유 식별자입니다. |
| Telemetry 추적 확장 ID | ssot__Id__c |
텍스트 | 단일 작업 단위를 나타내는 개별 스페인에 대한 고유 ID입니다. |
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 100추적 예제
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

