프로젝트 초기 설정

Step 1: 디렉토리 생성

# 프로젝트 루트 생성
mkdir -p manufacturing-ai-assistant
cd manufacturing-ai-assistant

# 디렉토리 구조 생성
mkdir -p app/pages app/components
mkdir -p core/agent core/rag core/kg core/llm
mkdir -p config data/documents data/sample data/chroma_db
mkdir -p tests

# __init__.py 생성
touch core/__init__.py core/agent/__init__.py
touch core/rag/__init__.py core/kg/__init__.py
touch core/llm/__init__.py

Step 2: pyproject.toml 작성

의존성은 최소한으로 시작한다. 나중에 추가하면 된다.

Step 3: 설정 파일 작성

Pydantic Settings를 사용하면:

• .env 파일에서 자동으로 읽어옴
• 타입 검증 자동 수행
• IDE 자동완성 지원

Step 4: 프롬프트 관리

프롬프트는 코드에 하드코딩하지 말고 별도 파일로 관리한다. 프롬프트에 적은 도구 목록과 KG 스키마는 나중에 실제로 만들 것과 같아야 한다. 프롬프트에만 있고 구현이 없는 도구를 적어 두면 LLM 이 그 이름을 부르고 실행 노드가 찾지 못해 실패한다. 스키마도 마찬가지여서, 프롬프트가 알려 준 라벨과 관계가 시드와 다르면 자연어에서 만든 Cypher 가 언제나 빈 결과를 돌려준다.

아래 starterCode 를 읽는 법

네 파일이 한 블록에 들어 있다. # 파일 N: 주석이 파일 경계다. 그대로 한 파일에 붙여 넣지 말고 경계대로 나눠 저장한다. 맨 아래 확인 블록은 파일 2의 끝에 들어간다.