Admin API모집·랭킹 에이전트 API
모집·랭킹 에이전트 API
캠페인에 맞는 크리에이터 후보를 자동 발굴·평가·랭킹하는 에이전트 연동 API
모집·랭킹 에이전트 API
캠페인에 적합한 인플루언서(크리에이터) 후보를 자동으로 발굴 → AI 적합성 평가 → 점수·랭킹하는
에이전트(glowb-agent-api) 연동 API입니다. 실제 발굴·평가·점수·저장은 Python 에이전트가 자체 DB(PostgreSQL)에서
수행하고, glowb-server는 이를 프록시합니다.
Base URL: /ai/admin/recruit-agent · 실제 에이전트 호출은 설정값 agent.api.url(glowb-agent-api)로 전달됩니다.
운영자 수동 트리거 방식입니다. 캠페인 모집은 운영자가 어드민에서 직접 실행합니다(자동 트리거 미적용).
두 가지 모집
| 구분 | 설명 |
|---|---|
| 캠페인 모집 (온디맨드 E2E) | 특정 캠페인에 대해 수십 분~수 시간 도는 무거운 비동기 작업. 트리거 → 진행 폴링 → 랭킹 조회. |
| 상시 모집 (백그라운드) | 에이전트가 스케줄러로 크리에이터 풀을 계속 확장. 운영자는 seed/seed-category로 발굴 방향을 우선순위 조향. |
캠페인 모집 플로우 (비동기 3단계)
POST /campaign/{collabNo} (즉시 응답: started/already_running)
│ 백그라운드 모집 (수십 분~수 시간, Cloud Run Job)
▼
GET /campaign/{collabNo}/progress (진행바 폴링 — status: running → completed)
▼
GET /campaign/{collabNo}/rankings (후보 리스트 + 점수·추천사유)완료 시점에는 에이전트가 백엔드 내부 콜백(POST /internal/recruit-agent/callback)으로 통보하고,
백엔드가 캠페인 알리미 Slack 채널에 완료/실패 노티를 발송합니다. (콜백 참고)
엔드포인트 목록
캠페인 모집
| 메서드 | 경로 | 설명 |
|---|---|---|
POST | /ai/admin/recruit-agent/campaign/{collabNo} | 모집 시작 (목표 인원 입력, 비동기) |
GET | /ai/admin/recruit-agent/campaign/{collabNo}/progress | 진행 상태 폴링 |
GET | /ai/admin/recruit-agent/campaign/{collabNo}/rankings | 후보 결과(랭킹) 조회 |
POST | /ai/admin/recruit-agent/campaign/{collabNo}/rank | 재랭킹 (발굴 없이 점수 재계산) |
상시 모집 조향
| 메서드 | 경로 | 설명 |
|---|---|---|
POST | /ai/admin/recruit-agent/seed | 운영자 키워드(해시태그) 주입 |
POST | /ai/admin/recruit-agent/seed-category | 운영자 카테고리 주입(LLM이 해시태그 생성) |
GET | /ai/admin/recruit-agent/status | 큐 현황 + API 사용량 |
응답 규약
모든 응답은 표준 ApiResponse 래퍼입니다. data 안에 에이전트 응답(snake_case)이 그대로 담깁니다.
{ "status": 200, "code": null, "message": "...", "data": { /* 에이전트 응답 */ } }