Rastreamento de plataforma do agente

Configurar rastreamento de plataforma do agente

Para gerar relatórios do Data 360 para Sessão e Rastreamentos de plataforma, os usuários devem primeiro habilitar o Data 360 e o Rastreamento de plataforma.

1. Em Configuração, use a caixa Busca rápida para pesquisar a IA generativa do Einstein.
2. Em IA generativa do Einstein, clique em Configuração de auditoria, análise e monitoramento do Einstein.
3. Confirme se o Rastreamento de sessão do Agentforce está ativado. Consulte Configurar rastreamento de sessão do Agentforce.
4. Role até a opção Rastreamento de plataforma do agente e ative-a.

Seu modelo de dados é provisionado em apenas alguns minutos. A coleta de dados então começa imediatamente e recorre a intervalos de cinco minutos. Observe que a ativação da coleta de dados aumenta a taxa de consumo de crédito da sua organização.

A suspensão da coleta de dados mantém seus dados para que você possa retomar mais tarde. Quaisquer relatórios mostram uma lacuna entre o tempo em que você a desativa e a reativa.

Relatórios do Data 360 para sessões do representante de serviço e rastreamentos de plataforma

Para obter percepções sobre KPIs e tendências, crie um único relatório do Data 360 que integre rastreamentos de sessão do agente e rastreamentos de plataforma de ponta a ponta. Esse relatório pode ser executado para dados quase em tempo real, permite agrupar, filtrar e resumir registros e pode ser compartilhado com outras pessoas.

O Rastreamento de agente inclui intervalos dos seguintes serviços:

• Apex
• Fluxos
• Criador de prompts
• Ações invocáveis
• Planejador
• Gateway de IA
• Gateway de LLM
• Federador de consulta DC

Gerar um relatório do Data 360

Crie relatórios sobre objetos de modelo de dados (DMOs) específicos, como Interação do agente de IA e Distância de rastreamento de telemetria, para analisar e aprender com dados unificados.

1. Navegue até a guia Relatórios no Salesforce e clique em Novo relatório. A página Tipos de relatório é exibida.
2. Na barra de pesquisa, digite o nome do Objeto de modelo de dados (DMO) sobre o qual você deseja relatar. Nesse caso, você selecionaria Interação de rastreamento de telemetria ou Interação do agente de IA.
3. Crie um novo relacionamento de campo nos objetos de modelo de dados relevantes. Nesse caso, você poderia selecionar Intervalo de rastreamento de telemetria – Rastreamento de telemetria → ManyToOne → Interação do agente de IA – Rastreamento de telemetria.

   No Data 360, os relacionamentos entre DMOs são estabelecidos definindo uma conexão de um "DMO de origem" para um "DMO de destino" usando campos-chave. O tipo de relacionamento mais frequente é Muitos para um, em que vários registros do DMO de origem correspondem a um único registro no DMO de destino. Consulte Relacionamentos de objeto do modelo de dados para obter mais informações.

4. Na página de detalhes do DMO, há uma guia Relacionamentos. Essa guia fornece uma visualização visual e estruturada de todos os relacionamentos que existem para esse DMO. Verifique os novos relacionamentos de DMO por meio da guia Relacionamentos.

   Exemplo de span de rastreamento de telemetria

   Exemplo de interação do agente de IA

5. Crie um tipo de relatório personalizado.
6. Clique em Novo relatório personalizado em Configuração abaixo de Novo relatório personalizado. Preencha os campos para criar um novo tipo de relatório personalizado. Nesse caso, você criaria um tipo de relatório de Rastreamentos de sessão e plataforma.
7. Acesse o aplicativo Data Cloud e selecione a guia Relatórios.
8. Crie um relatório do Data 360. Clique em Novo relatório e selecione o tipo de relatório desejado (por exemplo, Rastreamentos de sessão e Rastreamentos de plataforma).
9. Clique em Iniciar relatório.

Depois que o relatório for iniciado, você poderá visualizar os intervalos de rastreamento de telemetria da plataforma correlacionada registrados como parte de cada Sessão do agente.

Nota Os relatórios do Data 360 exibem no máximo 2 mil linhas no modo de execução. Você pode exportar até 50 mil linhas. Para obter mais informações, consulte Relatórios e painéis do Data 360 e Relatórios e painéis do Data Cloud: Limites e limitações.

Modelo de dados para rastreamento de plataforma do agente

Habilitar esses recursos gera automaticamente um fluxo de dados do Data 360, um Objeto de Data Lake (DLO) e um Objeto de modelo de dados (DMO). Esses dados são criados dentro do espaço de dados especificado em Auditoria e monitoramento.

Fluxo de dados de capacidade de observação

O fluxo de dados de capacidade de observação é criado automaticamente para capturar os dados de rastreamento:

Objeto do Data Lake de capacidade de observação

Um novo DLO chamado ObservabilitySpans é criado com os seguintes campos:

Objeto de modelo de dados de span de rastreamento de telemetria

Um novo DMO chamado Espanha de rastreamento de telemetria é criado com os seguintes campos:

Exemplos 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 100

DMO 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

Exemplo de rastreamento

  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