주제 브리핑(검색+전문 자동 수집)
onegov_research_topicSearch a topic and automatically retrieve the full text of top government documents, providing summaries and excerpts for efficient research.
Instructions
한 주제에 대해 검색을 돌린 뒤, 상위 문서 몇 건의 본문까지 자동으로 받아와 한 번에 돌려준다. "이 주제 정부 자료 정리해줘" 같은 요청에서 검색→전문조회 왕복을 줄여 준다.
Args:
query (string, 필수): 조사할 주제.
depth (number, 1~5, 기본 3): 본문까지 받아올 상위 문서 수. 많을수록 느리고 응답이 길다.
doc_type (string[], 선택) / ministry (string[], 선택) / from / to: onegov_search 와 동일한 필터.
chars_per_doc (number, 1000~10000, 기본 3000): 문서당 본문 길이 상한.
response_format ('markdown'|'json', 기본 markdown)
Returns: markdown: 검색 요약(총 건수·상위 목록) + 상위 depth 건의 본문 발췌(기관·발행일·원문링크 포함). json: { query, total, candidates[], documents[] }
Examples:
"AI 기본법 관련 정부 자료 정리해줘" → query="인공지능 기본법", depth=3
단순히 목록만 필요하면 onegov_search 를 쓸 것(더 빠르다).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | 발행일 종료(YYYY-MM-DD) | |
| from | No | 발행일 시작(YYYY-MM-DD) | |
| depth | No | 본문까지 받아올 문서 수 | |
| query | Yes | 조사할 주제 | |
| doc_type | No | 문서유형 필터(여러 개 가능). press_release=보도자료, policy=정책, law=법령, statistic=통계, info_disclosure=정보공개, faq=자주묻는질문, notice=고시·공고 | |
| ministry | No | 기관코드 배열 | |
| chars_per_doc | No | 문서당 본문 길이 상한 | |
| response_format | No | 출력 형식. 'markdown'은 사람이 읽기 좋은 요약(기본값), 'json'은 API 원본에 가까운 구조화 데이터. | markdown |