n8n 공부 정리: OPIc 스크립트 AI 평가 연동

틀 연습(opic2) 화면에서 말하기 스크립트를 n8n 웹훅으로 보내고, OpenAI가 OPIc 기준으로 평가한 결과를 받아 화면에 보여 주기까지 만든 과정을 정리한 문서입니다.


1. 전체 구조

[GitHub Pages 앱 (opic2)]
   │  POST JSON { question, kind, transcript, seconds }
   ▼
[n8n Webhook 노드]  ── CORS 허용: https://chrisna2.github.io
   ▼
[Code: 입력 검증 + 프롬프트 구성]
   ▼
[IF: ok 인가?] ── 아니면 ──────────────────────────┐
   ▼ 맞으면                                       │
[HTTP Request: OpenAI Chat Completions]           │
   ▼                                              │
[Code: 응답 파싱 + 기록 형식 보정]                 │
   ▼                                              │
[Respond to Webhook: JSON 응답] ◀─────────────────┘
   ▼
[앱: 결과 표시 + localStorage 날짜별 저장]

2. n8n 핵심 개념 정리

개념 설명 이번 프로젝트에서
Webhook 노드 외부에서 HTTP 요청을 받는 시작점 POST, path opic-eval, Respond 모드 “Respond to Webhook node”
Test URL vs Production URL 테스트: /webhook-test/..., 운영: /webhook/... 테스트 주소는 Execute를 누른 뒤 한 번만 응답함. 운영은 Active면 계속 응답
Execute workflow 편집 화면에서 테스트 웹훅을 대기 상태로 만드는 버튼 운영 주소로 바꾸면 불필요
Active 스위치 워크플로우를 운영 상태로 켜는 스위치 켜야 운영 주소가 동작함
Allowed Origins (CORS) 어느 웹 페이지가 이 웹훅을 호출해도 되는지 지정 https://chrisna2.github.io (경로 없이 origin만)
Code 노드 JavaScript로 데이터를 가공 입력 검증, 프롬프트 구성, 응답 파싱
IF 노드 조건에 따라 분기 ok가 true면 OpenAI 호출, 아니면 바로 응답
HTTP Request 노드 임의의 API 호출 OpenAI Chat Completions 호출
Respond to Webhook 웹훅 요청자에게 응답을 돌려줌 결과 또는 오류 JSON 반환
Credentials (자격증명) 키를 워크플로우 밖에 안전하게 보관 OpenAI account(openAiApi)

웹훅 데이터 위치


3. 과정에서 겪은 문제와 원인

(1) “매번 Execute를 눌러야 동작함”

(2) CORS 오류: No 'Access-Control-Allow-Origin' header

(3) 파일을 고쳐도 n8n에는 반영되지 않음

(4) 자격증명이 “비어 있음”으로 보임

(5) Windows에서 curl이 인증서 검사로 실패


4. API 키와 구독은 별개


5. 모델 선택


6. 빠른 점검 체크리스트


7. 테스트 방법

  1. 빈 입력 테스트 (OpenAI 비용 없음)
    curl -X POST "https://<인스턴스>/webhook/opic-eval" \
      -H "Content-Type: application/json" \
      -d '{"transcript":"","question":"test","kind":"survey"}'
    

    → {"ok":false,"error":"스크립트가 비어 있어요."}가 나오면 웹훅과 검증 로직은 정상입니다.

  2. 실제 평가 테스트 (OpenAI 호출, 비용 발생)
    • 8단어 이상 영어 스크립트로 앱의 AI 평가 버튼을 누릅니다.
    • 응답은 {"result":{"grade","summary","good","problems","actions"}} 형태입니다.
  3. 실행 기록 확인
    • n8n의 Executions 탭에서 각 노드 입출력을 볼 수 있습니다. 오류 원인은 여기서 찾는 것이 가장 빠릅니다.

8. 앞으로 할 일