<p align="center">
<img src="https://raw.githubusercontent.com/1xiaoyueryuer/boss-hr-agent-toolkit/HEAD/docs/assets/boss-hr-poster.png" alt="BOSS HR Agent Toolkit: 채용 필터링을 체계적으로. 포지션 분석, 이력서 확보, 개별 점수화 및 시각화 보고서."
width="100%">
</p>
<h1 align="center">BOSS HR Agent Toolkit</h1>
<p align="center"><strong>포지션 요구사항부터 후보자 보고서까지, 채용 필터링을 명확한 워크플로우로 만듭니다.</strong></p>
<p align="center">
<a href="#빠른_시작">빠른 시작</a> ·
<a href="boss-hr-auto/SKILL.md">에이전트 Skill</a> ·
<a href="docs/CLI_WORKFLOW.md">사용 가이드</a> ·
<a href="https://github.com/1xiaoyueryuer/boss-hr-agent-toolkit/releases">소스 코드 다운로드</a>
</p>
<p align="center">Windows · Python 3.10+ · Microsoft Edge · MIT License</p>
BOSS HR Agent Toolkit은 BOSS 직직(Boss Zhipin) 채용 플랫폼을 위한 AI 자동화 도구 키트입니다. 이 도구는 포지션 분석, 후보자 이력서 확보, 개별 분석, 점수 순위 지정, HTML 보고서를 하나의 프로세스로 연결하며, 사용자의 명시적 승인 하에 인사말(打招呼) 기능도 지원합니다.
사용자가 포지션과 필터링 요구사항을 제시하면, 에이전트가 이를 이해하고 분석하며, 로컬 CLI에서 구체적인 작업을 실행합니다. 하나의 Skill과 일련의 로컬 명령어를 결합하여, 근거 기반의 필터링 과정과 추적 가능한 과정을 제공하며, 핵심 작업은 사용자가 통제할 수 있습니다.
포지션 요구사항부터 시작하기
“구조 엔지니어 10명의 이력서를 골라 보고서를 생성하고, 각 사람이 어떤 부분에서 대화할 가치가 있는지 알려줘.”
이 도구 키트는 이러한 작업을 중심으로 작동하며, 최종적으로 브라우저에서 열 수 있는 HTML 보고서를 제공합니다. 여기에는 후보자 순위, 각 차원의 점수, 강점 및 우려 사항, 그리고 각 개인을 위한 커뮤니케이션 제안이 포함됩니다.
flowchart LR
A[포지션 및 JD 이해] --> B[사용자가 필터링 조건 확인]
B --> C[후보자 이력서 확보]
...
채용 필터링을 위한 역량
| 능력 | 제공하는 기능 |
|---|
| 포지션 이해 | 채용 플랫폼의 실시간 디렉토리에서 포지션 이름이나 ID를 분석하고, JD(Job Description)를 추출하여 분석 근거를 제공합니다. |
| ... | |
| 분석에 근거가 있습니다. 후보자 개개인을 처리하며 점수 부여 이유와 커뮤니케이션 제안을 함께 전달하여 원본 증거와 비교하기 쉽습니다. | |
프로세스 통제 가능합니다. 로그인 과정은 사용자가 수행하고, 추천 필터링 조건은 사용자가 확인하며, 실제 인사말 기능은 명시적 승인이 필요합니다. 보고서 생성 후에도 작업을 직접 종료할 수 있습니다.
결과는 로컬에 저장됩니다. CLI는 이력서 파일, 점수 산출물 및 보고서를 본래의 로컬 디렉토리에 작성합니다. 에이전트가 분석을 수행할 때 사용자가 선택한 모델 서비스를 사용할 것이므로, 데이터 사용 요구사항에 따라 호스트(host)를 설정해야 합니다.
빠른 시작
Windows, Python 3.10+, Microsoft Edge, 그리고 사용 가능한 BOSS 직직 채용자 계정을 준비하세요.
1. 로컬 도구 키트 설치
git clone --branch stable/v1.2 https://github.com/1xiaoyueryuer/boss-hr-agent-toolkit.git
cd boss-hr-agent-toolkit
./install-windows.bat
...
또한 Release 소스 코드 패키지를 다운로드하여 압축을 풀고 install-windows.bat을 실행할 수도 있습니다.
설치 스크립트는 64비트 Python 3.10+를 감지하고, pip 및 빌드 종속성을 보완하며, 다운로드 실패 시 재시도하고 순차적으로 pip 설정 소스(PyPI, 청화 미러)를 시도합니다. 진단 로그는 소스 코드 디렉토리의 install-windows.log에 저장됩니다. 더블 클릭하여 실행하면 창이 유지되며, 자동화 사용 시에는 install-windows.bat --no-pause를 사용하세요. 관리자 권한은 필요하지 않습니다. 만약 Python 설치 디렉토리가 쓰기 불가능하다면, 먼저 가상 환경을 생성하고 활성화할 수 있습니다.
이것은 소스 코드 도구 키트이며 editable install 방식을 채택합니다. 전체 소스 코드 디렉토리를 보존해야 하며, 이동한 후에는 재설치해야 합니다. 현재는 독립적인 wheel 형태가 아니며 PyPI를 통해 배포되지 않습니다. Chromium을 추가로 다운로드할 필요 없이 실행 시 로컬 Edge를 사용합니다.
2. 에이전트가 Skill을 읽도록 하기
사용하는 에이전트 호스트에 boss-hr-auto/SKILL.md를 구성하거나, 작업 실행 전에 이 파일을 읽도록 할 수 있습니다. 호스트는 로컬 명령을 실행하고 CLI가 지정한 점수 파일을 읽고 쓸 수 있어야 합니다.
그런 다음 작업을 제시합니다. 예를 들어:
boss-hr-auto의 프로세스에 따라 “구조 엔지니어”를 위한 새 작업을 생성하고, 이력서 10건을 가져와 보고서를 생성하세요.
모델 분석은 호스트 에이전트가 수행하며; 도구 키트는 자체 모델 API를 내장하고 있지 않으므로 본 프로젝트에서 별도로 모델 Key를 구성할 필요가 없습니다.
3. 로그인, 확인 후 보고서 보기
에이전트는 boss-hr start "구조 엔지니어"로 시작합니다:
- 로그인: 필요할 때 전용 Edge를 실행하여 BOSS 공식 로그인 페이지를 엽니다. 이미 로그인되었거나 인증 페이지는 직접 재사용되며, start를 반복해도 QR 코드가 새로 고쳐지지 않습니다. 로그인 후 동일한 start 명령을 다시 시도합니다.
- 확인: 추천 인재 페이지에서 필터링 조건을 조정하고, “계속”이라고 응답하면 이력서 가져오기가 시작됩니다.
- 보기: 에이전트는 각 항목별로 점수를 매기고, 보고서를 생성하며 파일 경로를 제공합니다.
- 선택적 전송: 명시적으로 요청할 때만 인사하기 단계가 진행됩니다.
로그인 페이지 로드에 실패하면 먼저 네트워크, 프록시 또는 브라우저 보안 검사를 확인하고, 동일한 탭에서 수동으로 새로 고친 후 다시 시도합니다. 도구는 페이지 로드 오류를 보고하며, 로그인 페이지를 반복적으로 열지 않습니다.
정상적인 사용에는 사전에 Edge를 수동으로 시작할 필요가 없습니다. 만약 boss-hr이 PATH에 없다면 python -m boss_hr을 사용할 수 있습니다.
여덟 가지 명령, 하나의 워크플로우
| 명령어 | 용도 |
|---|
boss-hr start | 실시간으로 직무를 분석하고 새로운 필터링 작업을 시작합니다 |
| ... | |
| 후속 명령어는 이번 start에서 반환된 직무 정보와 run_id를 사용합니다. 전체 매개변수, 점수 파일 프로토콜 및 오류 처리는 CLI 사용 가이드를 참조하십시오. 에이전트는 항상 Skill에 따라 실행해야 합니다. | |
로컬 환경만 확인하고 브라우저와 완전히 연결하지 않을 때:
boss-hr doctor --skip-browser
보고서는 어떻게 산출되는가
현재 점수 평가는 학력 25%, 경력 25%, 기술 25%, 프로젝트 15%, 전문성 10%로 구성되어 있습니다. 에이전트는 이력서와 JD를 기반으로 나머지 네 가지 차원의 점수 및 이유를 제공합니다. 학력은 내장된 학교 표에 의해 보정되며, 로컬 코드가 총점과 추천 등급을 계산합니다.
총점이 70점 이상이면 추천, 60점 이상이면 대기, 나머지는 비추천입니다. 점수 세부 사항은 Skill의 점수 프로토콜을 참조하십시오. 보고서는 보조 분석용이며, 채용 담당자는 원본 이력서 및 커뮤니케이션 결과를 결합하여 재검토해야 합니다.
로컬 출력 및 구성
boss-hr-output/
└── <encryptJobId>/
├── state/ 후보자, 다운로드 및 점수 상태
...
기본 출력 루트 디렉토리는 ~/Desktop/boss-hr-output이며, 보고서 경로는 CLI가 반환하는 값에 따릅니다. 자세한 디렉토리 규칙은 파일 관리를 참조하십시오.
| 환경 변수 | 용도 |
|---|
BOSS_HR_OUTPUT_DIR | 사용자 정의 출력 루트 디렉토리 |
| ... | |
브라우저는 기본적으로 로컬 CDP 9222에 연결하며, 전용 구성 디렉토리는 %LOCALAPPDATA%oss-hr-edge-profile입니다. | |
적용 범위
현재는 한 번의 완전한 새 필터링 작업만 지원하며, continue, batch, 다중 배치 누적 또는 동일 직무 동시 실행(run)은 지원하지 않습니다. 실제 다운로드 수량은 채용 측 제한 및 작업 결과에 영향을 받습니다. 페이지 조작에는 유효한 로그인 상태가 필요하며, 이는 플랫폼 페이지, 인터페이스 및 제한 변화의 영향도 받을 수 있습니다. dry-run 역시 브라우저가 필요합니다.
지원 및 검증 범위는 행동 경계를 참조하십시오. 개발자는 유지보수 및 검증을 통해 호출 관계와 오프라인 테스트 방식을 이해할 수 있습니다.
사용 가이드 · 업데이트 기록 · MIT License
