AI Observabilidade do Agente para as temporadas das ferramentas: Verificar o Efeito

Um tempo de espera da ferramenta diz lhe que o telefonista parou de esperar. Znot diz lhe se a ferramenta realizou o seu efeito colateral. Para um agente AI que pode enviar uma mensagem, criar um bilhete, reservar um espaço ou cobrar uma conta, tratar timeout como failed pode transformar uma falha de rede comum em uma ação duplicada no mundo real. O padrão razoável é congelar os retos cegos, manter uma identidade operacional estável e conciliar o efeito pretendido. Aceitar uma das três respostas: verificada aplicada, verificada não aplicada ou indeterminada. Apenas a segunda resposta pode introduzir uma decisão de retomada, e mesmo assim o contrato de fornecedor deve apoiar uma retomada com a mesma identidade e os mesmos parâmetros inalterados. Este é um problema de observabilidade porque um veredicto saudável depende de evidências além do período de chamada de ferramentas. O agente precisa de um recibo do que pretendia, do transporte devolvido e do que o sistema externo agora contém. Uma pausa deixa três fatos diferentes. Um agente geralmente registra um fato conveniente: a chamada à ferramenta levantou um tempo de espera. O registro operacional útil tem três camadas: 1. Intent a operação lógica exata que o agente se comprometeu a realizar. 2. Transport se o chamador recebeu uma resposta, rejeição ou nenhuma resposta. 3. Effect se o sistema alvo contém o resultado pretendido, não contém nenhum resultado ou não pode ser consultado com confiança. Essas camadas podem discordar. Um pedido pode chegar ao provedor, criar o objeto e perder a resposta no caminho de volta. Pode falhar antes do envio. Pode retornar o sucesso, enquanto um passo descorrente assíncrono nunca produz o resultado prometido. Nenhum desses casos é bem descrito por um único campo success: true false . O Documentação avançada de manipulação de erros da Stripe torna a ambiguidade explícita: após um erro de rede, o cliente não sabe se o servidor recebeu o pedido. O seu caminho recomendado de retest reutiliza a mesma chave de idempotencia e os mesmos parâmetros até que o cliente receba um resultado definitivo. A mesma página trata uma resposta 500 como indeterminada porque uma solicitação ainda pode produzir um efeito colateral visível ao usuário. A AWS documenta uma fronteira relacionada no seu Orientações para execução duradoura. A repetição, pelo menos uma vez, é segura para operações idempotentes; os efeitos colaterais externos necessitam de uma manipulação ou de um contrato de idempotência do lado de serviço. A AWS também adverte que nenhuma semântica por tentativa significa exatamente uma vez para todo o fluxo de trabalho. A conclusão prática é mais estreita do que adicionar repetidas tentativas. Decidir primeiro se a operação é segura para repetir. Uma leitura, um upsert teclado por uma identificação de registro estável, e uma chamada de provedor com uma chave de idempotencia documentada são diferentes do envio de uma notificação de um tiro através de uma API que não tem contrato de deduplicação. Registrar um recibo de efeito antes de adicionar repetidas tentativas Um recibo de efeito é um pequeno registro local criado antes da expedição . Não é só a resposta do prestador. Relaciona a intenção cometida com provas posteriores: O operation id identifica a ação lógica em todas as reinicializações do processo. O request hash impede que um agente reutilize essa identidade para os parâmetros alterados. A chave de idempotency é separada porque nem todos os provedores suportam um, e os provedores definem diferentes janelas de retenção e comportamento de repetição. A sonda descreve como o efeito foi verificado; um ponto final da lista em cache é uma evidência mais fraca do que uma leitura direta por uma referência externa única. Não armazenar segredos, corpos de instruções, conteúdo de mensagens ou argumentos completos de ferramentas neste registro. Hash uma intenção canônica, editada e reter apenas os campos necessários para conciliar o efeito. Se o fornecedor aceitar metadados do cliente, anexe o ID de operação estável para que um webhook ou leitura posterior possa correlacionar um objeto mesmo quando a resposta original desapareceu. O veredicto deve usar evidências explícitas. O veredicto Evidências Ação seguinte verified applied Um efeito de correspondência ou um recibo de fornecedor de reprodução confiável Não tente novamente; continue a verificar os resultados verified not applied Uma consulta autorizada prova zero efeitos de correspondência Consulte o contrato de fornecedor antes de uma nova tentativa limitada indeterminate A resposta está ausente e não há verificação de efeito autorizada disponível. Esperem, reconciliem se, ou perguntem a um ser humano; não inventem a certeza. duplicate effect Existem mais de um efeito de correspondência Parar as retas e entrar em um caminho de reparação compensatória ou humana false success O transporte devolveu sucesso mas o efeito prometido está ausente Trata a corrida como insalubre mesmo que o comando tenha terminado unsafe retry A mesma intenção foi tentada novamente sob uma nova chave ou hash de solicitação alterada Parar; o limite de deduplicação foi quebrado Esta tabela separa a actividade do progresso útil. Outra tentativa é a atividade. Um único efeito confirmado é o progresso. Uma janela legítima de reconciliação está à espera, enquanto repetidas chaves frescas sem recibo estável é execução insegura. Execute o classificador de seis casos Eu construí um dispositivo NDJSON de seis casos para testar a regra. Inclui uma resposta perdida com um recibo do fornecedor correspondente, um timeout com evidências indisponíveis, um fornecedor que cria dois efeitos apesar de uma chave repetida, uma resposta de sucesso sem objeto resultante, um resultado autorizado de efeito zero e uma nova tentativa de chave alterada. A classificação do núcleo é deliberadamente pequena: A correlação resolve se a um caso em cada estado: Todas as seis afirmações esperadas passam. O resultado mais importante é a segunda linha, não o caminho feliz: um tempo sem um caminho de leitura autorizado permanece indeterminate . Uma nova tentativa tornaria o painel mais ocupado enquanto tornava mais difícil recuperar o estado do mundo real. O dispositivo também pega um atalho tentador. Um recibo do fornecedor é útil somente quando se vincula ao hash original da solicitação. Um recibo para uma carga útil diferente não pode provar que o efeito pretendido ocorreu. Da mesma forma, um transporte 200 não é verificação de resultados; o caso ack without deliverable é false success porque o objeto externo está ausente. Na produção, executar a reconciliação em um cronograma limitado. Pesquisar pela identificação de operação estável ou chave de independência do fornecedor, registar a frescura das provas e parar após um prazo fixo. Se o resultado permanecer indeterminado, encaminhe a decisão para alguém com autoridade sobre o sistema afetado. Não permita que uma política genérica de retomada de até três vezes atravesse um limite de efeitos colaterais. Quando o contrato termina Um recibo de efeito reduz a ambigüidade; não cria uma garantia de uma vez. O provedor pode expirar as chaves de idempotency, ignorá las em alguns endpoints, aceitar um pedido antes de uma falha assíncrona interna, ou expor um modelo de leitura que está atrasado na escrita. Uma sonda também pode ser errada por causa do cache, permissões parciais ou uma busca não única. Coloque esses limites ao lado do veredicto: manter a janela e o âmbito de aplicação documentados da independência do prestador; Usar a mesma chave and , a mesma solicitação canónica durante uma nova tentativa autorizada; Confiança e frescura das sondas de rotulagem; distinguir um zero autorizado de ainda não visível; Tempo máximo de reconciliação e contagem de retestes; Requerem aprovação humana para a realização de acções compensatórias ou irreversíveis; Verificar o resultado pretendido pelo utilizador após a confirmação do efeito. Este padrão é especialmente valioso para agentes de longa duração porque a recuperação do processo muitas vezes perde a resposta de transporte enquanto o trabalho externo continua. A persistência do recibo antes da expedição dá a um agente reiniciado um lugar estável para retomar a investigação. Deve ser retomado a partir de indeterminate , não de probablemente falhado. Para a observabilidade do agente AI, a regra operacional é simples: um tempo de espera é uma observação de transporte, não um veredicto de efeito. Preservar a identidade de uma operação, correlacionar o fornecedor e a evidência do lado de leitura e recusar chamar a corrida de saudável até que o resultado externo pretendido seja verificado. A direção do produto da Sidewisp inclui a saúde dos resultados, falhas de ferramentas, retestes, evidências e limites de aprovação humana. Este artigo descreve um padrão de funcionamento, não um monitor enviado. A Sidewisp está atualmente em prévia privada. A recolha de agentes de produção para a saúde, os adaptadores de tempo de execução, o monitoramento do recebimento de efeitos e a recuperação não são geralmente enviados. O site público e a biblioteca de artigos estão ao vivo, e os leitores podem participar de acesso precoce sem conceder autoridade à Sidewisp sobre seus agentes.