Agent 실행 추적과 회복

개요

실패를 재현하고 최소 수정으로 개선한다.

먼저 기억과 Context 관리, 다중 Agent와 사람의 개입의 핵심 개념을 확인하세요.

핵심 개요

실행 추적은 요청·도구·결과·상태 변화를 연결해 어느 단계에서 실패했는지 찾는 기록입니다. 중단 후에는 마지막으로 확정된 상태에서 재개하고 이미 발생한 외부 효과를 다시 만들지 않도록 해야 합니다.

복구 방식은 읽기 실패·변경 실패·결과 불명에 따라 다릅니다. 제한 없는 자동 재시도는 비용 증가와 중복 변경을 만들 수 있습니다.

필요한 용어

• 체크포인트: 재개 가능한 확정 상태의 저장 지점
• 결과 불명: 성공 여부를 현재 응답만으로 확정할 수 없는 상태

작동 과정

1. 요청 ID와 단계별 입력·결과·버전을 기록합니다.
2. 확정 상태와 미확정 외부 효과를 구분합니다.
3. 상태 조회·제한 재시도·보류 중 복구를 선택합니다.

풀이 예제

아래 입력과 기록은 직접 만든 교육용 가상 자료입니다.

입력·조건

보고서 계산은 끝났고 메일 발송 뒤 연결이 끊겼습니다.

판단·결과

메일 상태를 확인하기 전 새 발송을 반복하지 않습니다.

이렇게 판단한 이유

외부 효과는 로컬 실행의 중단과 독립적으로 성공했을 수 있습니다. 체크포인트는 결과 불명을 정직하게 보존해야 합니다.

흔한 실패와 복구

로그에 민감 원문·토큰을 모두 남기지 않습니다. 진단에 필요한 구조와 식별자를 보존하면서 접근·보관을 제한합니다.

확인 문제

참고 자료

1. Anthropic: Building effective agents  — 고정 workflow와 자율 agent의 설계 패턴.
2. Anthropic: Agent evaluations  — 과제·시도·실행 결과·평가자 검증.
3. MCP: Security best practices  — 권한·토큰·세션의 신뢰 경계.

자료 확인: 2026-10-21. 사례·문항·실습은 자체 제작했습니다. 외부 서비스 호출과 실제 모델 품질 측정은 학습자가 별도 환경에서 수행합니다.

Agent가 재시작될 때마다 같은 티켓을 생성합니다. 원인과 상태·멱등 설계를 제안하세요.