0.2. AI Coach 온보딩 튜토리얼

AI Coach는 TFlow에 처음 접속한 사용자가 주요 기능을 빠르게 익힐 수 있도록 화면 위에서 직접 안내하는 인터랙티브 가이드 시스템입니다. 2026-04 업데이트부터 TutorialEngine 기반으로 전환되어, 단순 말풍선 안내를 넘어서 실제 샘플 프로젝트 위에서 무역 전체 흐름을 따라 해볼 수 있습니다.

1. AI Coach란?

텍스트 매뉴얼을 읽는 대신, 실제 화면의 버튼과 메뉴를 하이라이트하며 단계별로 설명을 제공합니다. AI가 사용자의 현재 페이지를 인식하고, 해당 페이지에서 할 수 있는 작업을 안내합니다. Coach 모드에서는 Lyra가 DOM 인터랙션 도구(get_page_elements/inspect_element/act_element)를 사용해 실제 요소를 짚어주거나 대신 수행할 수 있습니다. (Lyra Coach DOM 도구 자세히)

2. 튜토리얼 시작 방법

자동 시작 + 샘플 프로젝트 생성 ✨ NEW

처음 회원 가입 후 로그인하면:

AI Coach 튜토리얼이 자동으로 시작됩니다.
학습용 샘플 프로젝트가 자동으로 생성되어 내 프로젝트 목록에 추가됩니다. (실제 데이터가 아닌 가상 거래, 삭제 가능)
코스를 진행하는 동안 이 샘플 프로젝트를 무대로 실제 문서를 열고 버튼을 눌러 견적 → PO → 선적 → 분석의 전 과정을 체험합니다.

무역 워크플로우 코스 ✨ NEW

기존 '메뉴 소개' 중심 튜토리얼에서 벗어나, 다음과 같은 실전 코스가 추가되었습니다.

코스	내용
견적~PO 발행	Quotation 작성 → PI 확인 → PO 발행 순서 체험
문서 분석	CI/PL/BL 업로드 → LC와 교차 검증 → 리포트 확인
LC 분석 (LEO)	LC 업로드 → 멀티스테이지 분석 실행 → EVA 검증 결과 해석
에스크로 결제	마일스톤 설정 → 잠금 → 서류 검증 → 해제
Storefront 데뷔	Storefront 슬러그 발급 → 상품 등록 → RFQ 수신 흐름

수동 시작 / 재개

이전에 튜토리얼을 건너뛴 경우, 다시 시작할 수 있습니다.

화면 우측 하단의 챗봇(Lyra) 을 열고 "튜토리얼 다시 보여줘" 또는 "가이드 시작"이라고 입력하세요.
Resume 버튼 ✨ NEW: 중간에 나간 경우 마지막으로 본 단계부터 이어집니다.
코스 진행 중 언어를 바꿔도 말풍선이 즉시 새로운 언어로 재렌더링됩니다.

3. 튜토리얼 진행

AI Coach는 다음과 같은 방식으로 안내합니다.

하이라이트: 현재 설명 중인 UI 요소(버튼, 메뉴, 입력 필드)가 강조 표시됩니다.
말풍선 설명: 하이라이트된 요소 옆에 해당 기능에 대한 간결한 설명이 표시됩니다.
단계 진행: 설명을 읽은 후 다음 버튼을 눌러 다음 단계로 넘어갑니다.
Coach 대신 실행: 일부 단계에서 Lyra가 "이 버튼 대신 눌러드릴까요?"라고 물어보고, 확인하면 실제로 클릭해줍니다. (act_element)
새 문서 하이라이트: 튜토리얼 도중 생성된 새 문서는 목록에서 반짝임 애니메이션으로 표시됩니다.
건너뛰기(Skip): 언제든 건너뛰기 버튼을 눌러 튜토리얼을 종료할 수 있습니다.

4. 주요 안내 내용

AI Coach 튜토리얼에서 안내하는 핵심 기능은 다음과 같습니다.

사이드바 메뉴 구성: 프로젝트, 이메일, 결제, Storefront 등 주요 메뉴 위치
프로젝트 생성 방법: New Project(새 프로젝트) 버튼과 생성 모달 안내
챗봇(Lyra) 사용법: AI 챗봇에 질문하는 방법, Coach 도구 활용
알림 확인: 상단 알림 뱃지와 Notification Inbox(알림 센터) 사용법
페이지별 도움말: 각 페이지에서 AI Coach가 해당 페이지의 핵심 기능을 추가 안내
튜토리얼 문서 뷰어 통합: 특정 단계에서 가이드 문서(docs/guides/)가 자동으로 열려 Lyra가 해당 맥락을 반영해 대화합니다.

💡 문제 해결 (FAQ)

Q: "튜토리얼을 다시 보고 싶습니다."
- 에러코드/현상: COACH_TUTORIAL_RESTART
- A: 챗봇(Lyra)에게 "튜토리얼 다시 보여줘"라고 말하면 처음부터 다시 시작됩니다. 중간부터 이어가고 싶으면 Resume 버튼을 이용하세요.
Q: "AI Coach 말풍선이 다른 화면 요소를 가립니다."
- 에러코드/현상: COACH_UI_OVERLAP
- A: 말풍선의 건너뛰기(Skip) 버튼을 누르면 즉시 사라집니다. 필요할 때 다시 시작할 수 있습니다.
Q: "샘플 프로젝트가 실제 목록에 섞여 있어서 헷갈립니다."
- A: 샘플 프로젝트 카드에는 Sample 배지가 붙어 있고, 설명에도 학습용임이 명시됩니다. 튜토리얼이 끝난 뒤 언제든 삭제할 수 있습니다. 삭제해도 튜토리얼 진행 이력은 남습니다.
Q: "토큰 게이지·온보딩·푸시 배너가 안 보입니다."
- A: 2026-04 업데이트에서 신규 유저 초기 배너 노출 로직이 수정되었습니다. 그래도 안 보이면 상단 메뉴 Refresh 또는 재로그인으로 해결됩니다.