Todos os produtos
Search
Central de documentação

Simple Log Service:Consultar uma única trajetória

Última atualização: Oct 20, 2026

A página Single Trajectory organiza os dados de execução em uma lista de trajetórias pesquisável e fornece a topologia do agente, as etapas de execução e os detalhes de cada etapa. Este tópico descreve como encontrar uma execução e visualize as evidências camada por camada.

Pré-requisitos

Os dados no formato selecionado foram ingeridos, e os resultados correspondentes do processamento de trajetórias e os índices de consulta estão disponíveis. Se os dados brutos acabaram de ser exibidos, aguarde o tempo necessário para o processamento.

Encontrar uma trajetória

  1. Abra o SessionStore de destino e selecione Single Trajectory.

  2. Defina o intervalo de tempo.

  3. Insira uma condição de pesquisa do SLS na caixa de pesquisa e clique em Search & Analyze. Se nenhuma condição for necessária, use *.

  4. Como alternativa, abra o painel de filtros, defina as condições e clique em Search.

  5. Na Trajectory List, clique em ID ou em Details da trajetória de destino.

Por padrão, a lista exibe 20 entradas por página. Selecione 20, 50 ou 100 entradas por página. Uma nova consulta com um intervalo de tempo relativo é atualizada para a nova janela de tempo, enquanto a paginação usa a janela de tempo da consulta enviada.

Condições de consulta comuns

Finalidade

Exemplo

Encontrar uma trajetória pelo ID da trajetória externa

trajectory_id:"demo-trajectory-001"

Encontrar uma trajetória pelo trace ID

trace_id:"demo-trace-001"

Encontrar trajetórias que pertencem à mesma sessão

session_id:"demo-session-001"

Encontrar trajetórias que contêm um agente específico

agent_names:"main-agent"

Encontrar trajetórias que contêm uma ferramenta específica

tool_names:"search_order"

Você pode usar AND para combinar várias condições. Exemplo:

session_id:"demo-session-001" AND tool_names:"search_order"
Nota: A caixa de pesquisa da lista de trajetórias é usada para condições de pesquisa, e não para inserir instruções analíticas SQL completas. Para consultar registros de log ou usar as instruções SQL ou SPL compatíveis com o service atual, mude para o Log View. Colar apenas um ID não equivale a uma consulta exata pelo campo ID.

A lista de trajetórias e o Log View mantêm seus próprios estados de consulta e tempo, e as mesmas condições não são necessariamente mantidas após a alternância entre eles. Para comparar a mesma consulta, insira as mesmas condições de pesquisa após alternar, verifique se o intervalo de tempo absoluto é o mesmo e clique em Search & Analyze.

Usar filtros estruturados

O painel de filtros oferece condições como agente, modelo, ferramenta, número de etapas, duração, identificador de trajetória ou sessão, e conteúdo de entrada e saída. Defina a duração em segundos ou minutos como uma condição de maior que, menor que ou intervalo.

Vários valores de modelo ou ferramenta na mesma dimensão são combinados usando OR, e dimensões diferentes são combinadas usando AND. O filtro Representative Agent encontra, na verdade, trajetórias que contêm o agente selecionado, e não se limita ao único agente representativo exibido no cartão.

A lista de candidatos é obtida a partir de amostras dentro do intervalo de tempo atual e não é uma lista completa. Para valores que não aparecem na lista de candidatos, insira os identificadores reais para consultar.

Importante

Envie novas condições de consulta ao clicar em Search no painel de filtros, em vez de anexar automaticamente as condições ao final da sua consulta escrita manualmente. Caso modifique manualmente uma consulta, verifique as condições que deseja manter. Redefinir os filtros não significa que o sistema execute a consulta novamente.

Correspondência semântica de entradas e saídas

Se os campos de destino do recurso atual tiverem embeddings e índices vetoriais, selecione a correspondência semântica nas condições de entrada ou saída. Se não existir um índice correspondente, use a correspondência por palavras-chave.

A distância semântica varia de 0 a 1. Uma distância menor indica maior similaridade. Um limiar menor torna a condição mais restrita, em vez de aumentar a revocação. A disponibilidade da correspondência semântica e a possibilidade de recuperação dos dados de destino também dependem dos índices e do status de processamento dos dados.

O índice de trajetória do sistema atual é somente leitura na página SessionStore; portanto, não ative seu índice vetorial nesta página. Se necessário, entre em contato com o administrador do service para confirme a capacidade.

Ler os detalhes da trajetória

A página de detalhes consiste em três seções vinculadas.

Seção

Operação

Conteúdo

Topologia da trajetória

Selecione um nó de agente

Os agentes e suas relações fornecidos explicitamente no snapshot atual.

Etapas de execução

Selecione uma etapa ou use a pesquisa de etapas

Os eventos de execução do nó selecionado. A pesquisa de etapas consulta apenas o conteúdo carregado atualmente.

Detalhes da etapa

Alterne entre Overview, Request Parameters, Result e Raw Data

As entradas e saídas, parâmetros da ferramenta, resultados e a estrutura bruta da etapa atual.

Ajuste a largura de uma seção ou maximize uma seção para ler entradas e saídas longas.

Modelos, ferramentas e parâmetros de solicitação

A aba Overview exibe conteúdos como modelos, tokens, duração, chamadas de ferramenta e texto do corpo com base nos dados coletados. Visualize os parâmetros de ferramenta coletados na aba Request Parameters. Essa aba não contém necessariamente todos os parâmetros das solicitações do modelo.

Se Request Parameters Not Collected for exibido ou se um campo estiver vazio, isso indica apenas que os dados atuais não fornecem a informação. Não interprete valores ausentes como ausência de parâmetros, ausência de consumo ou ausência de chamadas no negócio.

Contexto histórico

O contexto histórico indica mensagens transferidas de trajetórias anteriores e geralmente é exibido em grupos recolhidos. Não é uma evidência de que a trajetória atual foi executada novamente e não pode ser simplesmente adicionado às etapas de execução reais como o número de chamadas nesta execução.

Relações de agentes e intervalo de tempo

Os contêineres de agregação na topologia são usados para organizar dados e não representam chamadas reais de agentes. O sistema exibe preferencialmente relações que possuem evidências explícitas. Se os dados de relação estiverem incompletos, uma mensagem poderá ser exibida ou a exibição poderá ser rebaixada.

A linha do tempo exibe o intervalo de tempo e a cobertura de etapas visíveis no snapshot atual. Os intervalos e a cobertura entre etapas não podem ser usados diretamente como o tempo de computação do modelo ou o ciclo de vida completo do agente. O status rebaixado indica que a qualidade de exibição dos dados é limitada e não significa que a execução da tarefa falhou.

Visualize o snapshot JSON da trajetória

Use Trajectory Snapshot JSON e visualize todo o registro selecionado atualmente. Isso é adequado para verificar campos ou para que você envie informações de diagnóstico anonimizadas. Esta entrada não é uma lista de versões históricas; portanto, não modifique o conteúdo da trajetória com ela.

Entender as diferenças entre a lista e os detalhes

A mesma trajetória pode gerar vários snapshots. Dentro do intervalo de tempo atual e do conjunto de resultados de pesquisa, a lista de trajetórias seleciona o snapshot mais recente de cada trajetória e não combina os nós de snapshots antigos e novos em uma execução completa.

Portanto, observe os seguintes itens:

  • O número de trajetórias na lista pode ser diferente do número de registros no Log View. Uma trajetória pode corresponder a vários logs de snapshot.

  • Se as condições de pesquisa corresponderem apenas a um snapshot antigo, uma correspondência na lista não significa necessariamente que o status mais recente da trajetória ainda atenda às condições.

  • Ao abrir os detalhes de uma trajetória regular, o sistema consulta os dados novamente. Os detalhes podem ser mais recentes que o snapshot exibido na lista. Para solucionar problemas de um status histórico exato, verifique o horário do registro e a versão de processamento.

O status da página e o horário de término, por si sós, não podem comprovar o sucesso do negócio. Faça um julgamento com base nas entradas e saídas reais, nos resultados da ferramenta e nos registros do lado do negócio.