에이전트 오류를 로컬에서 되감아보는 파이썬 도구
에이전트가 도구를 반복 호출하다가 실패하면, 클라우드 대시보드의 긴 만 보고 원인을 찾기 어렵다. 이 사례는 실행 중 오간 , 응답 머리글, 난수값, 시간값을 로컬 추적 파일에 저장한 뒤 같은 흐름을 다시 재생하는 방식이다.
명령줄에서 `replay-proxy record agent.py`로 실행을 기록하고, 실패 뒤에는 인터넷을 끈 상태에서 `replay-proxy replay .json`로 같은 실행 경로를 되살린다. 이렇게 하면 개발자가 pdb나 로 에이전트가 어디서 꼬이는지 한 단계씩 확인할 수 있다.
내부 구현은 unittest.mock.patch로 연결 부분을 가로채고, time.time()과 random.seed()도 실행 중 바꾼다. 표준 비동기 루프는 처리하지만, 무거운 문서 분석을 위해 ProcessPoolExecutor로 작업을 나누는 경우에는 깨진다.
핵심 포인트
- 에이전트 실패 원인을 긴 만으로 찾는 문제를 줄이려는 도구다.
- , 응답 머리글, 시간값, 난수값을 로컬 추적 파일에 저장한다.
- 기록한 실행을 인터넷 없이 다시 재생해 같은 실패 흐름을 되살린다.
- pdb나 로 을 한 단계씩 확인할 수 있다.
- ProcessPoolExecutor로 나눈 작업은 현재 제대로 처리하지 못한다.