작업 / 데모

기존 Express API에 Claude 기능 추가

예시 쇼핑몰 API에 Claude 기능 세 가지를 덧붙인 데모, 형식 검사를 거친 JSON 응답과 스트리밍

역할
설계와 개발
기술
Node.jsTypeScriptExpressClaudeOpenAIzodVitest

상황

이미 Node.js API를 운영하는 팀은 코드를 새로 짜지 않고 AI 기능만 더하고 싶어 합니다. 이 데모는 작은 쇼핑몰 API에서 시작해 기존 경로 옆에 AI 기능을 추가합니다.

만든 것

  • 상품 설명 생성: 상품 정보를 넣으면 정해진 JSON 형식으로 결과를 돌려줌
  • 문의 분류: 유형, 우선순위, 감정을 판단하고 사람이 검토할 답변 초안을 붙임
  • 긴 글 요약: 한 번에 받거나 스트리밍으로 받고 사용자가 연결을 끊으면 AI 요청도 멈춤
  • AI 응답은 형식을 검사한 뒤에만 돌려줌
  • 요청 시간 제한과 재시도 횟수를 설정으로 두어 비용과 지연을 예측할 수 있게 함
  • AI 제공사를 한 곳에 감싸 Claude와 OpenAI를 바꿔 쓸 수 있게 함

결과

API 키 없이 테스트 38개가 돌아가고 데모 스크립트가 모든 기능을 차례로 호출합니다. 화면 이미지는 모의 모드 결과이고 이미지에도 그렇게 표시돼 있습니다.

상품 설명 생성 API의 요청과 응답
상품 정보를 넣으면 제목, 설명, 핵심 문구, 검색 키워드가 형식 검사를 거친 JSON으로 나옵니다.
유형, 우선순위, 감정으로 분류된 고객 문의
문의 분류는 유형, 우선순위, 감정과 함께 상담원이 검토할 답변 초안을 돌려줍니다.
Server-Sent Events로 스트리밍되는 요약
요약은 한 번에 받거나 Server-Sent Events 스트림으로 받습니다.

전체 작업 보기