💡▶ 실행하기 버튼을 눌러 API 호출이 실패하고 재시도하는 과정을 지켜보세요. 재시도 이후에는 성공 케이스와 실패해도 정직하게 안내하는 케이스 중 하나를 골라 결과를 비교해볼 수 있어요.
🛠️ 실습: 실시간 환율로 10만원 환산하기
🙋 작업 지시: "최신 환율 정보를 가져와서 10만원을 달러로 환산해줘."
🔄 환율 API 호출 중...
❌ 첫 번째 시도 실패 (응답 없음 / 타임아웃)
🔁 재시도 중...
✓ 두 번째 시도 성공 — 환율 1,350원/달러 확인. 10만원 ≈ 74.07달러예요.
❌ 재시도도 실패했어요. 이럴 때 잘 설계된 에이전트는 숫자를 지어내지 않고 이렇게 정직하게 안내해요: 🤖 "환율 정보를 지금 가져올 수 없어요. 잠시 후 다시 시도해주시겠어요?"
💬 한 줄 정리
AI 에이전트가 외부 API나 도구를 불러서 작업을 처리할 때, 그 호출은 인터넷 문제나 서버 오류로 언제든 실패할 수 있어요.
잘 만들어진 에이전트는 실패했다고 바로 멈추거나 엉뚱한 값을 지어내는 대신, 재시도(retry)를 해보거나 다른 방법을 시도해요.
그래도 계속 실패한다면, 가장 중요한 건 그럴듯해 보이는 가짜 결과를 만들어내지 않고 "지금은 확인할 수 없다"고 솔직하게 말하는 거예요.
이렇게 실패를 정직하게 인정하는 것도 훌륭한 실패 처리이며, 실제 서비스에 쓰이는 에이전트를 설계할 때 신뢰성을 지키는 핵심 원칙 중 하나예요.
🧾 이 페이지, 이런 프롬프트로 만들었어요
아래 프롬프트를 복사해서 Claude·ChatGPT(GPT)·Gemini 어디에든 붙여넣고 직접 시도해보세요. 참고로 이건 예시 없이 지시만 담은 제로샷(zero-shot) 프롬프트예요 — 원하는 결과물의 예시를 1개 넣으면 원샷(one-shot), 여러 개 넣으면 퓨샷(few-shot) 프롬프팅이 되는데, 예시를 더할수록 결과가 원하는 스타일에 더 가까워지는 경우가 많아요.
AI 에이전트의 실패 처리(failure handling) 개념을 가르치는 인터랙티브 학습 페이지를 만들어줘.
- 예시 작업으로 "최신 환율 정보를 가져와서 10만원을 달러로 환산해줘"를 사용해줘
- 버튼을 누르면 3단계가 순서대로 나타나야 해: ① "환율 API 호출 중...", ② "첫 번째 시도 실패 (응답 없음/타임아웃)"을 경고색으로 표시, ③ "재시도 중..."
- 재시도 단계 이후에는 두 개의 버튼("성공 케이스 보기" / "실패해도 정직하게 안내하는 케이스 보기")을 보여주고, 각각을 누르면 해당 결과가 나타나게 해줘: 성공 케이스는 "두 번째 시도 성공 — 환율 1,350원/달러, 10만원 ≈ 74.07달러", 실패 케이스는 "재시도도 실패 — 지어내지 않고 정직하게 '환율 정보를 지금 가져올 수 없어요. 잠시 후 다시 시도해주시겠어요?'라고 안내"
- 하단에 왜 재시도와 정직한 실패 안내가 신뢰할 수 있는 에이전트 설계의 핵심인지 초보자도 이해할 수 있게 설명하는 카드를 추가해줘
- CSS·JS 전부 인라인으로 넣은 단일 HTML 파일로, 한국어로 출력해줘