설계: Agent 아키텍처 가이드

권장 아키텍처

equipment_agent/
├── main.py              # 진입점, Agent 실행
├── tools/
│   ├── __init__.py
│   ├── equipment.py     # 설비 상태 조회 Tool
│   ├── manual.py        # 매뉴얼 검색 Tool
│   ├── inventory.py     # 재고 확인 Tool
│   └── production.py    # 생산 실적 Tool
├── data/
│   ├── equipment_db.py  # 설비 시뮬레이션 데이터
│   ├── manual_db.py     # 매뉴얼 데이터
│   ├── inventory_db.py  # 재고 데이터
│   └── production_db.py # 생산 데이터
├── core/
│   ├── agent.py         # ReAct Agent 로직
│   ├── cache.py         # 캐싱 시스템
│   └── monitor.py       # 모니터링
├── prompts/
│   └── system.py        # 시스템 프롬프트
└── tests/
    └── test_scenarios.py # 테스트 시나리오

팁: 처음에는 main.py 하나로 시작하고, 동작이 확인되면 파일을 분리하자.

데이터 흐름

사용자 질문
    │
    ▼
┌──────────────────────────────┐
│      ReAct Agent             │
│                              │
│  Thought: 무엇을 조회할까?   │
│      │                       │
│      ▼                       │
│  Tool 선택 & 실행            │
│      │                       │
│  ┌───┼───┬───┬───────┐      │
│  │   │   │   │       │      │
│  ▼   ▼   ▼   ▼       ▼      │
│ 설비 매뉴얼 재고 생산 기타   │
│  │   │   │   │       │      │
│  └───┼───┴───┴───────┘      │
│      │                       │
│      ▼                       │
│  Observation: 결과 분석      │
│      │                       │
│      ▼                       │
│  충분? ──No──> (반복)        │
│      │                       │
│      Yes                     │
│      │                       │
│      ▼                       │
│  최종 응답 생성              │
└──────────────────────────────┘
    │
    ▼
사용자에게 전달

핵심 설계 결정

1. 데이터 소스

소스	구현 방식	이유
MES	시뮬레이션 dict	실제 MES 없이도 동작
매뉴얼	시뮬레이션 dict	RAG는 Week 6에서 다룸
ERP	시뮬레이션 dict	실제 ERP 없이도 동작

2. Agent 프레임워크

방식	장점	단점
OpenAI 직접	완전 제어	코드 많음
LangChain	코드 적음, 편리	추상화 (디버깅 어려움)
권장: 둘 다	직접 구현 이해 + LangChain 활용

3. 프롬프트 전략

SYSTEM_PROMPT = """당신은 제조 공장의 설비 관리 AI Agent입니다.

## 역할
공장 엔지니어의 질문에 정확하고 유용한 답변을 제공합니다.

## 사용 가능한 Tool
- get_equipment_status: 설비 상태 조회
- search_manual: 매뉴얼 검색 (알람 코드, SOP)
- check_inventory: 부품 재고 확인
- get_production_data: 생산 실적 조회

## 행동 규칙
1. 항상 실제 데이터를 조회한 후 답변하세요.
2. 추측하지 마세요. 데이터가 없으면 "확인할 수 없습니다"라고 하세요.
3. 문제 설비에 집중하세요. 정상 설비는 건너뛰세요.
4. 알람 발생 시: 설비 상태 -> 매뉴얼 검색 -> 재고 확인 순서로 진행하세요.
5. 응답은 한국어로, 구체적인 조치 방안과 함께 제공하세요.

## 응답 형식
- 현황 요약 (표 형식 권장)
- 문제점 분석
- 구체적 조치 방안 (우선순위 포함)
- 필요 부품/재고 상태 (해당 시)
"""

이 프롬프트를 기반으로 시작하고, 테스트 결과에 따라 반복 개선하세요.