Observabilidade do Agente através de Restartes: o padrão de recibo de transferência

A observabilidade do agente normalmente responde ao que aconteceu dentro de uma corrida. Isso é útil, mas não é suficiente quando um agente delega o trabalho, sai, reinicia, ou espera por outro agente. A solução prática é um recibo de transferência duradouro : um pequeno registo escrito fora de qualquer processo que indica quem aceitou o trabalho, que resultado é esperado e quais provas o encerrarão. Mantenha rastros para depuração. Adicionar recibos para continuidade. Um rastro pode mostrar que uma ferramenta de entrega foi devolvida com êxito; o recibo informa ao operador se o destinatário aceitou a tarefa e se o artefato prometido foi verificado posteriormente. A resposta curta: observar o limite, não apenas a corrida Uma transferência só é saudável quando se podem distinguir quatro eventos diferentes: 1. O remetente delegou uma tarefa limitada; 2. O destinatário reconheceu a mesma tarefa; 3. Foi registado um progresso útil ou uma espera legítima; 4. O resultado esperado foi verificado. Esses eventos podem ocorrer em diferentes processos e em diferentes traços. Eles podem ser separados por um atraso na fila, uma reinicialização do hospedeiro ou uma aprovação humana. Tratá los como um período de memória cria uma dependência frágil: o contexto que explica o trabalho pode desaparecer com o processo. OpenTelemetry descreve a propagação do contexto como o mecanismo que permite que os intervalos de diferentes processos sejam montados em um rastro. Ele também fornece links de espaço para operações assíncronas causalmente relacionadas, onde o trabalho posterior não pode ser um espaço infantil simples. Isso resolve a correlação. Não define as regras de promessa, aceitação ou verificação de resultados do seu pedido. O recibo preenche essa lacuna. É deliberadamente menor do que uma transcrição e mais explícita do que uma linha de registro. Onde um rastro comum deixa de ajudar. Considere um agente de pesquisa que entrega uma tarefa de verificação de fontes a um segundo trabalhador. O remetente registra um handoff bem sucedido e sai. Dez minutos depois, o trabalhador inicia um novo processo, encontra uma fonte inacessível e espera aprovação para usar uma alternativa. Três estados podem agora parecer enganosamente semelhantes: A tarefa ainda está em fila e nunca foi aceita; O trabalhador o aceitou e está legitimamente à espera; O trabalhador completou um comando, mas nunca apresentou o arquivo de provas solicitado. O espaço que envolveu a entrega não pode decidir entre eles. O seu fim bem sucedido significa que a operação de entrega foi devolvida sem erro. OpenTelemetry é explícito que o estado de span descreve a operação rastreada por esse span. Não é prova de que exista um resultado comercial posterior. O OpenAI Agents SDK ilustra o mesmo limite de outra direcção. É o registros de rastreamento embutidos de corridas, chamadas de ferramentas, entregas, guardrails e eventos personalizados. Um group id pode associar múltiplos traços, e um handoff span pode mostrar delegação. O SDK também observa que a exportação de vestígios é em lote e pode exigir uma eliminação explícita quando se trata de entrega imediata. O rastreamento rico melhora a evidência disponível para depuração; ainda precisa de uma regra externa para a inspecção aprovada. É por isso que a observabilidade do agente não deve desmoronar a conclusão do comando em conclusão do resultado. Um contrato mínimo de recibo de transferência Armazenar apenas um registro apêndice por transição de estado. O armazenamento pode ser uma tabela de banco de dados, um registro de fila durável ou um arquivo NDJSON em um único host. A propriedade importante é que nenhum dos processos participantes possui a única cópia. Aqui está uma forma compacta do evento: Seis campos carregam a maior parte do valor: O operation id é a identidade duradoura do trabalho visível ao utilizador. Ele sobrevive a retomadas e reinicializações. O handoff id identifica uma tentativa de delegação. Uma nova tentativa obtém uma nova identificação de transferência em vez de sobreescrever a história. O event é um dos delegated , accepted , progress , waiting , completed ou outcome verified . O expected artifact designa um alvo de verificação determinista. Também pode nomear um teste, condição de API ou decisão de revisão. A trace id aponta para a telemetria detalhada sem fazer o recibo depender dessa telemetria. A reason explica uma falha de espera, rejeição ou verificação em termos operacionais limitados. Não coloque pedidos, credenciais, saída de modelo ou cargas úteis de ferramentas em bruto neste registro. Um recibo é um índice e uma máquina de estado, não um segundo backend de rastreamento. O padrão razoável é apenas as transições de apêndice mais um estado de corrente derivado. A atualização de uma linha mutável é tentadora, mas destrói as evidências necessárias para distinguir um reconhecimento atrasado de um desaparecido. Reproduzir os casos de falhas antes de escolher as alertas O equipamento de acompanhamento para este artigo contém quatro operações: uma transferência verificada, uma delegação não reconhecida, uma espera legítima de aprovação e uma conclusão falsa sem artefato verificado. O classificador é intencionalmente determinista. Faça isso com: O resultado esperado é: Dois observações caem fora deste pequeno teste. Em primeiro lugar, a latência do reconhecimento e a verificação dos resultados são independentes. O op 101 pode ser aceito rapidamente e ainda falhar mais tarde; o op 102 já é insalubre antes de qualquer chamada de modelo ou execução de ferramenta começar. Um painel de controle que começa com a execução do destinatário não verá o órfão. Em segundo lugar, a espera requer uma dependência declarada. O op 103 não tem progressos recentes, mas tratá lo como preso seria errado porque o recibo indica a aprovação que precisa. A ausência de atividade só se torna activel quando combinada com o estado e a expectativa. O limite de reconhecimento de 120 segundos no dispositivo é um exemplo, não um limiar universal. Configure o a partir da latência de entrega observada da fila e da urgência da tarefa. O trabalho em lote pode tolerar minutos; uma entrega interativa pode tolerar segundos. A invariante é a transição, não o número. Preservar a causalidade sem transformar os metadados em vazamento Usar a identificação de rastreamento como um indicador e propagar apenas identificadores que os trabalhadores do fluxo inferior realmente precisam. O OpenTelemetrys Orientação de bagagem adverte que a bagagem é comumente enviada em cabeçalhos HTTP, pode chegar a terceiros não intencionais e não tem controles de integridade incorporados. Isso faz com que os objetivos brutos, o texto do cliente, os caminhos do sistema de arquivos e as credenciais sejam valores de propagação especialmente pobres. Uma fronteira mais segura parece assim: Propagar um operation id opaco e um handoff id ; criar uma ligação entre o rastro receptor e o rastro delegador quando o tempo de execução o suportar; Manter o artefato esperado e o estado de aprovação em armazenamento duradouro confiável; Resolver os identificadores em contexto sensível apenas dentro do limite de hospedeiro autorizado; autenticar os autores dos recibos, porque os metadados de correlação não são prova de identidade. Há uma troca. Um recibo mínimo não pode explicar por que um modelo escolheu uma ferramenta ou reconstruir uma conversa inteira. Isso é intencional. Usar vestígios e registos para investigação detalhada, sujeito às suas regras de conservação e privacidade. Usar recibos para responder de forma confiável a uma questão operacional menor: a responsabilidade mudou e o resultado prometido foi observado? Converter receitas em estados de operador Evite um único status vermelho ou verde. O histórico de recibos suporta cinco estados com respostas diferentes: Working : aceito com progressos úteis recentes. Não o interrompas. Waiting : uma dependência externa ou uma decisão humana é pendente. Envia o pedido em vez de tentar novamente. Stuck : aceito, não aguardado e nenhum progresso útil dentro da janela de evidências da tarefa. Prepare uma recuperação limitada. Uncertain : os registos discordam, o autor não é confiável ou as provas necessárias não estão disponíveis. Pergunte antes de atuar. Resultado falhado : execução concluída, mas a verificação do artefato falhou ou nunca ocorreu. Reabrir o resultado, não o rastro inteiro. O limite de recuperação é importante. Uma transferência órfã pode justificar a re entrega se a ação for impotente e se for conhecido o limite de retomada. Uma entrega de espera não deve ser retomada apenas porque um temporizador expirou. Um estado de falso sucesso deve executar o verificador faltante ou solicitar o artefato faltante; reproduzir todo o agente pode duplicar os efeitos colaterais. Para cada resposta automatizada, registar a autoridade, as tentativas máximas, o custo ou o limite de tempo, e as evidências que marcarão a recuperação como bem sucedida. Comando de retiro saiu de zero não é suficiente quando a promessa original foi um relatório publicado, uma mudança combinada ou uma mensagem entregue. O que isso significa para o Sidewisp Este padrão de recepção corresponde às questões operacionais que o Sidewisp está a ser concebido para esclarecer: se um agente está a trabalhar, à espera, preso, incerto ou a perder o resultado prometido. Respeita igualmente um limite de produto necessário: o diagnóstico precede qualquer recuperação e as ações consequentes exigem autoridade explícita. A Sidewisp está atualmente em prévia privada. Seu site público e sistema de artigos estão ao vivo, enquanto a coleta de agentes de produção saúde, adaptadores de tempo de execução e recuperação automática geralmente não são enviados. O padrão acima é, portanto, um projeto neutro no tempo de execução que você pode implementar e testar hoje, não uma alegação de que a Sidewisp já coleta esses recibos. Se as entregas cruzadas são onde os seus agentes se tornam opacos, junte se à prévia privada e descreva o tempo de execução, armazenamento de recibos e limite de aprovação que você precisa. Essa evidência é mais útil do que uma solicitação genérica para mais vestígios.