> ## Documentation Index > Fetch the complete documentation index at: https://docs.orkestral.pro/llms.txt > Use this file to discover all available pages before exploring further. # Acompanhando os agentes > Acompanhe os agentes ao vivo: sessões, traces e atividade. Quando uma equipe de agentes trabalha no seu código, você quer ver o que está acontecendo sem adivinhar. O Orkestral oferece três visões ao vivo que respondem a três perguntas diferentes: o que o agente está fazendo nesta conversa, quais passos o agente deu em uma única issue, e o que esse agente já fez ao longo de todas as sessões e execuções. Esta página percorre as três para que você sempre saiba onde olhar. O chat onde você acompanha o agente responder, planejar e atualizar o progresso em tempo real. Uma linha do tempo passo a passo do que o agente fez ao executar uma issue. Cada execução que um agente conduziu: chats, heartbeats, revisões de código e execuções de issues. ## As três visões em resumo As três visões se atualizam sozinhas. Você não precisa recarregar nada. As sessões transmitem tokens conforme chegam, os traces enviam cada passo por um canal de eventos, e o feed de atividade rebusca os dados em um intervalo curto. Abra a partir de uma conversa na barra lateral. Melhor para acompanhar a resposta de um único agente, ver um plano tomar forma e aprovar o trabalho sem sair do chat. Abra a partir de uma issue, na aba **Activity**. Melhor para entender exatamente quais passos rodaram durante uma execução e onde algum falhou. Abra a partir do perfil de um agente, no dashboard. Melhor para uma visão geral das execuções recentes de um agente e da taxa de sucesso. ## Acompanhe uma sessão ao vivo A visão de sessão é o chat entre você e um agente. Enquanto o agente está respondendo, a conversa fica em estado de streaming e o compositor mostra que está ocupado. Clique em uma conversa na barra lateral. A barra de ferramentas superior mostra o título da sessão e um subtítulo com o agente ativo (nome, adaptador e modelo, quando não é o padrão). A mensagem do agente vai sendo preenchida token a token. O botão de enviar se transforma em um controle de parar enquanto uma execução está ativa. Se você digitar enquanto o agente ainda está trabalhando, sua mensagem é enfileirada em vez de cortar a execução. O item enfileirado aparece como um chip no compositor e sobrevive a um reload, porque a fila vive no processo principal. Quando o orquestrador produz um plano para esta sessão, um banner de aprovação aparece acima do compositor. Abra-o para revisar o épico e suas sub-issues em um painel, depois aprove e execute sem sair do chat. ### O painel de progresso Quando o agente abre issues, lê arquivos ou consulta uma base de conhecimento nesta sessão, um painel de progresso aparece à direita (em janelas largas). Ele abre por conta própria no momento em que há algo para mostrar, e você pode alterná-lo na barra de ferramentas. Um checklist das issues abertas nesta sessão, com uma barra de progresso. Cada linha mostra um status ao vivo: pendente, enfileirada, em execução, em revisão, concluída, bloqueada ou cancelada. Clique em uma linha para pular para a issue. O mesmo cartão também é renderizado na parte inferior do chat enquanto um plano executa, para que a conversa nunca pareça travada. Páginas da base de conhecimento que o agente realmente abriu, resolvidas de identificadores brutos para títulos legíveis. As consultas de busca não são listadas aqui, apenas as páginas que foram recuperadas. Arquivos que o agente leu ou editou, derivados das chamadas de ferramenta do agente e dos arquivos anexados às issues da sessão. Arquivos editados levam uma tag **edited**. Caminhos longos são encurtados para seus dois últimos segmentos. ### Mudanças de código e desfazer Quando uma execução escreve código, uma barra fina aparece acima do compositor resumindo quantos arquivos mudaram, com as contagens de linhas adicionadas e removidas. A partir dali você pode revisar (**Review**) o diff na fonte, ou desfazer (**Undo**) para descartar essas mudanças. **Undo** descarta as mudanças da working tree para os arquivos afetados. Use **Review** primeiro se quiser ler o diff antes de decidir. ### Seja notificado quando uma execução terminar Se uma execução continuar em streaming por um tempo, o Orkestral se oferece para notificar você quando ela terminar. Aceite uma vez e o app arma uma notificação de conclusão para essa sessão, para que você possa trocar de tela e receber um aviso quando o agente terminar. Você pode dispensar o aviso e ele não vai insistir novamente para aquela execução. A escolha é lembrada por sessão. ## Leia um trace de agente Um trace é o registro passo a passo do que um agente fez ao executar uma issue. Você o encontra na página da issue, na aba **Activity**, renderizado como uma linha do tempo. Cada passo na linha do tempo carrega um tipo, um status, um título, um resumo opcional de uma linha, e uma duração assim que termina. O ponto do cabeçalho pulsa em azul enquanto algum passo ainda está rodando e fica verde quando tudo se estabiliza. O passo está em andamento. Aparece em azul com um indicador pulsante. O passo terminou com sucesso. Aparece em verde, com sua duração medida à direita. O passo foi pulado intencionalmente. Aparece esmaecido. O passo falhou. Aparece em vermelho para que você encontre exatamente onde a execução quebrou. O trace é persistido, então ele sobrevive a sair da issue e voltar. Conforme novos passos chegam, a página se atualiza ao vivo por um canal de eventos, em vez de esperar por uma rebusca. A linha do tempo mostra os passos mais recentes e mantém uma contagem corrente no cabeçalho. ### Trace versus a linha do tempo ao vivo Enquanto uma execução está rodando ativamente, a aba **Chat** da issue também pode mostrar uma linha do tempo ao vivo mais leve das ações do agente (enfileirada, uso de ferramenta, iniciada, finalizada, erro). Essa visão ao vivo não é persistida e desaparece ao recarregar. O trace da aba **Activity** é o registro durável ao qual você volta depois. Se um passo tem um resumo curto, você o vê sob o título do passo. Para passos de ferramenta, esse resumo costuma ser a pista mais útil sobre o que o agente estava de fato fazendo naquele momento. ## Examine o feed de atividade O feed de atividade fica no perfil de um agente. Ele responde "o que esse agente tem feito ultimamente" mesclando quatro fontes em uma única lista cronológica, do mais novo para o mais antigo. Respostas que o agente deu em sessões de chat. A linha leva direto àquela sessão. Execuções de heartbeat agendadas ou manuais. O subtítulo informa qual delas foi. Revisões de pull request em que esse agente foi o revisor. A linha leva à revisão. Execuções de issue em que os executores (a Forge ou um modelo premium) fizeram o trabalho. A linha leva à issue. ### Lendo uma linha Cada linha mostra um ícone para seu tipo, um título, um subtítulo opcional, o status da execução, a duração, e há quanto tempo ela começou. Uma linha vermelha aparece sob o título quando a execução carregou uma mensagem de erro. Linhas que têm um destino são clicáveis e levam você à sessão, à revisão ou à issue. Os status são normalizados entre as quatro fontes em um conjunto comum: **enfileirada**, **em execução** (azul pulsante), **concluída** (verde), **erro** (vermelho) e **cancelada** (esmaecida). Assim, uma execução de issue que falhou e uma execução de chat que falhou se leem da mesma forma à primeira vista. Acima da lista recente, cartões de estatística resumem aproximadamente as últimas duas semanas: total de execuções, taxa de sucesso, tempo médio de execução e o último heartbeat. O detalhamento conta cada tipo (issue, chat, revisão, heartbeat) para que você saiba o que o agente faz na maior parte do tempo. A lista completa de atividade permite filtrar por tipo, para que você possa isolar apenas as execuções de issue ou apenas as revisões de código quando um agente tem um histórico movimentado. O feed busca cada fonte de forma independente e então mescla e ordena os resultados, para que um heartbeat, uma resposta de chat e uma execução de issue caiam todos na mesma linha do tempo na ordem certa. ## Qual visão você deve usar? Use a **sessão ao vivo**. Acompanhe a resposta, enfileire um acompanhamento e aprove o plano inline. Use o **trace do agente** na issue. Encontre o passo exato que falhou e leia seu resumo. Use o **feed de atividade** no agente. Verifique a taxa de sucesso e examine as execuções recentes. ## O que fazer em seguida Aprenda como o orquestrador transforma um pedido em um épico com sub-issues para a equipe. Veja como o modelo local embutido aplica mudanças de código a custo zero de API. Acompanhe épicos e sub-issues, e abra qualquer um para ler seu trace completo. Abra o perfil de um agente para ver seu dashboard, estatísticas e histórico completo de atividade.