본문 바로가기
C.W.K.
Stream
Lesson 06 of 10 · published

도구 오류 — 모델이 복구하게 만들어

~14 min · tools, error-handling

Level 0수련생
0 XP0/100 lessons0/14 achievements
0/120 XP to next level120 XP to go0% complete

도구는 실패하고, 모델은 그다음을 알아야 해

도구가 오류를 돌려주면 모델은 tool_result를 읽고 다음 행동을 정해. 안내가 없으면 같은 호출을 계속 되풀이하거나, 너무 빨리 포기하거나, 실패한 결과 대신 데이터를 꾸며낼 수 있어. 모두 프롬프트에서 미리 막을 수 있는 고장이야.

오류도 일정한 모양으로 돌려줘

모델이 읽을 수 있는 구조화 JSON을 써. {"error": "<code>", "message": "<text>", "retry": true|false, "hint": "<what to try>"}처럼 코드가 해석할 신호와 사람이 읽을 다음 행동을 함께 담아.

복구 규칙을 프롬프트에 적어

  • 도구가 retry: true를 돌려주면 같은 인수로 한 번만 다시 시도해.
  • retry: false라면 다른 접근을 찾거나 상위 단계로 넘겨.
  • ‘not found’라면 데이터를 꾸며내지 말고 조회에 실패했다고 사용자에게 알려.
  • 같은 도구가 두 번 실패하면 멈추고 실패를 드러내.

Code

구조화된 도구 오류·json
{
  "error": "customer_not_found",
  "message": "No customer matches CUST-9999.",
  "retry": false,
  "hint": "Check the customer ID format. Ask the user to confirm."
}

External links

Exercise

에이전트 반복에서 서로 다른 도구 다섯 개에 일부러 오류를 일으켜 모델의 행동을 관찰해봐. 명시적인 복구 규칙을 더한 뒤 같은 시험을 다시 해.

Progress

Progress is local-only — sign in to sync across devices.
이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

댓글 0

🔔 답글 알림 (로그인 필요)
로그인댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.