triplej-ai

Triple J AI 레포지토리입니다.

Description

triplej-ai 레포지토리는 아래와 같은 구조를 따릅니다.

• main.py
• pickin_api.py
• pickin_service.py
• schema/*_request.py

주요 기능은 아래와 같습니다.

• 지원자와 채용공고 간 유사도 기반 Pickin 지수 예측
• 자기소개서 기반 정량/정성 피드백 제공

pickin_api.py 내용을 기반으로, 각 API 별 호출 url을 확인할 수 있습니다.

How to Install

Requirements

• Python 3.8+
• Java (JDK) — KoNLPy 사용 시 필요

# 가상환경 설치 및 활성화
$ sudo apt install python3-venv -y
$ python3 -m venv venv
$ source venv/bin/activate

# 패키지 설치
$ pip install --upgrade pip
$ pip install \
  uvicorn fastapi joblib pandas sentence-transformers openpyxl \
  keybert konlpy kobert_transformers openai python-dotenv

How to Run

$ uvicorn main:app --reload --port 8000

서버는 8000번 port에서 실행됩니다.

주요 API

1. POST /predict

지원자의 ID(applicant_id)를 기반으로 Pickin 지수 계산

• Request Body:

{
  "applicant_id": 1
}

• Response 예시

[
  { "채용공고id": 1, "pickin지수": 0.9606 },
  { "채용공고id": 2, "pickin지수": 0.7242 }
]

2. POST /feedback

두 문장의 유사도를 정량적으로 계산해 반환

• Request Body:

{
  "missing_keywords" : [],
  "similarity": 0.72385824,
  "job": "삼성전자 DS부문 반도체 R&D 분야 외국인 경력사원 채용 모집대상:",
  "letter": "[고객 중심의 글로벌 시장 전문가로 성장하겠습니다]삼성전자 전 세계 고객의 삶을 연구하며, 고객 친화형 기술과 디자인을 개발 통해 지속 가능한 고객 중심 경쟁력을 갖추고 있습니다.저는 다양한 문화와 사람들에 대한 깊은 관심을 바탕으로, 각국의 문화적 차이를 존중하고 시너지를 발휘할 수 있는 글로벌 마인드를 기르기 위해 한국학과 국제학을 전공했습니다. 이를 통해 문화적 차이를 이해하고 조화를 이루는 방법을 배웠으며, 이러한 역량을 바탕으로 글로벌 시장에서 '고객 중심' 전략 강화에 기여하고자 합니다.특히 현지 시장에 대한 깊은 이해를 바탕으로 고객의 요구에 부합하는 맞춤형 전략을 수립하여, 삼성전자의 글로벌 확장에 기여하고자 합니다."
}

• Response 예시

{
  "before": "[고객 중심의 글로벌 시장 전문가로 성장하겠습니다]삼성전자 전 세계 고객의 삶을 연구하며, 고객 친화형 기술과 디자인을 개발 통해 지속 가능한 고객 중심 경쟁력을 갖추고 있습니다.저는 다양한 문화와 사람들에 대한 깊은 관심을 바탕으로, 각국의 문화적 차이를 존중하고 시너지를 발휘할 수 있는 글로벌 마인드를 기르기 위해 한국학과 국제학을 전공했습니다. 이를 통해 문화적 차이를 이해하고 조화를 이루는 방법을 배웠으며, 이러한 역량을 바탕으로 글로벌 시장에서 '고객 중심' 전략 강화에 기여하고자 합니다.특히 현지 시장에 대한 깊은 이해를 바탕으로 고객의 요구에 부합하는 맞춤형 전략을 수립하여, 삼성전자의 글로벌 확장에 기여하고자 합니다.",
  "after": "[\n{before: \"삼성전자 전 세계 고객의 삶을 연구하며, 고객 친화형 기술과 디자인을 개발 통해 지속 가능한 고객 중심 경쟁력을 갖추고 있습니다.\", after: \"삼성전자는 전 세계 고객의 삶을 연구하며, 고객 친화형 기술과 디자인을 개발하여 지속 가능한 고객 중심 경쟁력을 갖추고 있습니다.\", reason: \"어법 및 문장 구조를 자연스럽게 다듬음.\"},\n{before: \"저는 다양한 문화와 사람들에 대한 깊은 관심을 바탕으로, 각국의 문화적 차이를 존중하고 시너지를 발휘할 수 있는 글로벌 마인드를 기르기 위해 한국학과 국제학을 전공했습니다.\", after: \"저는 다양한 문화와 사람들에 대한 깊은 관심을 바탕으로, 각국의 문화적 차이를 존중하고 시너지를 발휘할 수 있는 글로벌 마인드를 기르기 위해 한국학과 국제학을 전공했습니다.\", reason: \"문장 내용이 적절하여 변경하지 않음.\"},\n{before: \"이를 통해 문화적 차이를 이해하고 조화를 이루는 방법을 배웠으며, 이러한 역량을 바탕으로 글로벌 시장에서 '고객 중심' 전략 강화에 기여하고자 합니다.\", after: \"이를 통해 문화적 차이를 이해하고 조화를 이루는 방법을 배웠으며, 이러한 역량과 더불어 다양한 국적의 동료들과 협업하는 팀워크를 자연스럽게 익혔습니다.\", reason: \"'팀워크' 키워드를 자연스럽게 추가함.\"},\n{before: \"특히 현지 시장에 대한 깊은 이해를 바탕으로 고객의 요구에 부합하는 맞춤형 전략을 수립하여, 삼성전자의 글로벌 확장에 기여하고자 합니다.\", after: \"또한, 현지 시장에 대한 깊은 이해를 바탕으로 고객의 요구에 부합하는 맞춤형 전략을 수립하고, 글로벌 커뮤니케이션 역량을 발휘해 다양한 국가의 고객 및 동료와 소통하며 삼성전자의 글로벌 확장에 기여하고자 합니다.\", reason: \"'글로벌 커뮤니케이션' 키워드와 글로벌 조직 내 소통 역량을 강조함.\"}\n]"
}