Insights & Reports

리포트 생성은 두 가지 경로로 도달합니다:

1. Ingest 리포트 프록시 — 플러그인과 외부 호출자를 위해 ingest 서비스(유일한 공개 표면)에 노출된 일부 리포트 엔드포인트(endpoint): GET /v1/insights/report, POST /v1/insights/report/generate, POST /v1/insights/report/quick.
2. Prompt Score v3.0 리포트 — Prism API의 /v1/score_v3/report/* 계열로, 대시보드의 v3 리포트 뷰를 뒷받침합니다.

참고

엔진의 구형 /v1/insights/report/* status/pending/cancel/history 및 /v1/insights/sessions/* 계열은 제거되었습니다. 아래 세 리포트 엔드포인트가 남은 것들이며, ingest가 호스팅하고 다른 ingest 엔드포인트와 동일한 gck_* 인증(authentication)을 사용합니다.

GET /v1/insights/report

ingest가 호스팅합니다. 가장 최근에 생성된 인사이트 리포트를 반환합니다.

GET /v1/insights/report?scope=personal
Authorization: Bearer gck_your_key

파라미터	타입	기본값	설명
scope	string	personal	리포트 범위(scope)
from	ISO8601	—	시작 시간
to	ISO8601	—	종료 시간

가장 최근 생성된 리포트를 JSON 페이로드로 반환합니다.

POST /v1/insights/report/generate

ingest가 호스팅합니다. 요청(request) 시 새 인사이트 리포트를 생성합니다. 동기적으로 실행되며 전체 리포트 페이로드를 응답(response)으로 반환합니다 — 작업 ID는 없습니다.

POST /v1/insights/report/generate?scope=personal
Authorization: Bearer gck_your_key
Accept-Language: en

파라미터	타입	기본값	설명
scope	string	personal	리포트 범위 태그 (아래 참고)
from	ISO8601	—	시작 시간
to	ISO8601	—	종료 시간

Accept-Language 헤더(기본 en)는 리포트의 출력 언어를 선택합니다.

scope 참고: scope는 리포트 행과 함께 저장되는 임의의 태그로 취급됩니다 — 고정된 enum에 대해 검증되지 않으며, personal이 일반적인 기본값입니다.

POST /v1/insights/report/quick

ingest가 호스팅합니다. 동기식, LLM 미사용 리포트 — 모델 추론을 기다리지 않고 가벼운 정리 결과를 얻는 빠른 경로입니다.

POST /v1/insights/report/quick?scope=personal
Authorization: Bearer gck_your_key

파라미터	타입	기본값	설명
scope	string	personal	리포트 범위 태그
from	ISO8601	—	시작 시간
to	ISO8601	—	종료 시간

Prompt Score v3.0 리포트

v3로 스코어링된 데이터의 리포트 생성은 Prism API에 별도의 엔드포인트 계열을 가집니다. 실패 상태 계약과 일일 범위 파라미터는 Prompt Score v3.0 페이지를 참고하세요.

엔드포인트	메서드	용도
/v1/score_v3/report	GET	최신 v3 리포트 (scope / from / to 수락)
/v1/score_v3/report/generate	POST	v3 리포트 생성; Accept-Language로 출력 언어 선택
/v1/score_v3/report/pending	GET	가장 최근 진행 중 v3 리포트, 없으면 200 {"report_id": null}
/v1/score_v3/report/status/:id	GET	진행 중인 v3 생성의 상태
/v1/score_v3/report/cancel/:id	POST	진행 중인 v3 생성 취소
/v1/score_v3/report/history	GET	과거 v3 리포트 (scope, limit)
/v1/score_v3/report/:id	GET / DELETE	단건 v3 리포트 조회 또는 삭제