A2A Application 오류의 failed 응답 변환

에이전트 예외를 분류하고 가능한 checkpoint의 중간 산출물을 복구해 표준 failed 응답으로 만듭니다.

01 / 에이전트 코드 02 / CustomAgentExecutor 03 / 오류 분류 04 / Flow 상태 복구 05 / A2A 응답 예외 포착 분류 · 복구 프로토콜 응답 Python 예외 에이전트 코드에서 raise execute() 예외 포착 failed 응답 준비 executor helper fallback 금지 오류 분류 앱 오류 보존 · Python 매핑 code + reason Checkpoint 조회 중간 artifacts 복구 best effort 그대로 전파 이미 data 주입됨 ServerError failed 응답 text + DataPart Legend User UI Agent logic Policy Tool action Context / trace

프로토콜 오류는 별도

  • • ServerError는 이미 공개 DataPart가 주입된 protocol-level 오류이므로 그대로 전파합니다.
  • • input-required와 auth-required는 오류가 아니라 HITL 제어 흐름입니다.
  • • StreamPartialFailure는 부분 성공으로 강등하지 않고 같은 failed 경로로 보냅니다.

오류 코드 선택

  • • LlamonApplicationError는 code, reason, extra를 그대로 보존합니다.
  • • 그 밖의 Python 예외는 중앙 매핑표로 공개 오류 코드에 변환합니다.
  • • 내부 traceback이나 비공개 구현 세부는 응답에 노출하지 않습니다.

중간 산출물 복구

  • • 가능하면 thread checkpoint에서 flow error context를 읽습니다.
  • • 복구한 중간 artifacts를 먼저 추가한 뒤 failed 상태를 전송합니다.
  • • checkpoint 조회 실패가 원래 오류 응답을 가리지 않도록 best effort로 처리합니다.

Workflow diagram • Built with Archify • Press T for theme and E for export