jobpilot-agent은(는) 무엇을 하나요?
다중 에이전트 AI 구직 도우미: 결정론적 FastAPI 파이프라인(검색, TF-IDF/스킬 점수 계산, 피드백 학습)과 Claude Agent SDK/MCP 에이전트를 통한 채용 공고 발견, 매칭 설명, 이력서 맞춤화 및 대화형 도우미입니다.
개요
이 시스템은 구직 활동을 자동화하고 최적화하기 위해 설계된 다중 에이전트 AI 어시스턴트입니다. 핵심 구성 요소는 다음과 같습니다:
- FastAPI 파이프라인: 결정론적 검색, TF-IDF 기반 스킬 점수 계산, 피드백 학습 모듈을 포함한 백엔드 서비스
- Claude Agent SDK 에이전트: 채용 공고 발견, 매칭 설명, 이력서 맞춤화, 대화형 구직 도우미 역할을 수행하는 전문화된 에이전트
- MCP 에이전트: 상황 인식 기능을 통해 더욱 정교한 상호작용을 제공
주요 기능
- 채용 공고 검색: 다양한 소스에서 채용 공고를 수집하고 필터링합니다.
- 스킬 매칭 점수: TF-IDF와 사용자 정의 스킬 점수 알고리즘을 사용하여 지원자의 역량과 채용 공고의 적합도를 평가합니다.
- 피드백 학습: 사용자 피드백을 기반으로 매칭 정확도를 지속적으로 개선합니다.
- 맞춤형 이력서: 특정 채용 공고에 최적화된 이력서를 생성합니다.
- 대화형 도우미: 자연어 질문에 응답하고 구직 프로세스를 안내합니다.
설치 및 설정
- 저장소 클론:
git clone https://github.com/ravinpandey/jobpilot-agent.git
cd jobpilot-agent
- 가상 환경 생성 및 활성화:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
- 의존성 설치:
pip install -r requirements.txt
- 환경 변수 설정:
.env 파일을 생성하고 필요한 API 키와 설정을 추가합니다:
OPENAI_API_KEY=your_openai_api_key
CLAUDE_API_KEY=your_claude_api_key
DATABASE_URL=your_database_url
사용법
FastAPI 서버 실행
uvicorn main:app --reload
API 엔드포인트
| 엔드포인트 | 설명 |
|---|---|
/search | 채용 공고 검색 |
/match | 지원자-채용 공고 매칭 점수 계산 |
/feedback | 피드백 제출 및 학습 |
/tailor-resume | 이력서 맞춤화 |
/chat | 대화형 도우미 |
예시 요청:
curl -X POST "http://localhost:8000/search" \
-H "Content-Type: application/json" \
-d '{"query": "소프트웨어 엔지니어", "location": "서울"}'
Claude Agent SDK 에이전트
각 에이전트는 특정 작업을 전문적으로 수행합니다.
1. 발견 에이전트 (discovery_agent.py)
- 사용자 프로필에 기반한 새로운 채용 공고 발견
- 키워드 및 위치 기반 검색
- 알림 설정 관리
2. 매칭 설명 에이전트 (match_explainer_agent.py)
- 매칭 점수에 대한 상세 설명 제공
- 강점 및 약점 분석
- 개선 제안
3. 이력서 맞춤화 에이전트 (resume_tailor_agent.py)
- 채용 공고 분석 및 키워드 추출
- 이력서 내용 최적화
- 다양한 형식 지원 (PDF, Word)
4. 대화형 도우미 에이전트 (chat_assistant_agent.py)
- 구직 관련 질문 응답
- 면접 준비 도움
- 경력 조언
MCP 에이전트
MCP (Model Context Protocol) 에이전트는 Claude의 컨텍스트 이해 능력을 활용하여 더욱 정확하고 개인화된 응답을 제공합니다.
기여 방법
- 이 저장소를 포크합니다.
- 새 기능 브랜치를 생성합니다:
git checkout -b feature/새로운-기능 - 변경 사항을 커밋합니다:
git commit -m '새로운 기능 추가' - 브랜치에 푸시합니다:
git push origin feature/새로운-기능 - 풀 리퀘스트를 생성합니다.
라이선스
이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.
연락처
질문이나 제안 사항이 있으면 GitHub Issues를 통해 알려주세요.