딥 리서치 워크플로

조사는 메인 에이전트 루프에서 실행되며 deep-research skill을 미리 불러옵니다. apps/agent/src/deep-research/index.ts의 공통 지시는 명시적인 조사 요청에 워크플로 완료와 보고서 파일 생성을 요구합니다. 범위 설정, 계획, 수집, 분석, 종합, 전달 단계를 따르며 증거에 따라 이전 단계로 돌아갈 수 있습니다.

Deep Research는 질문의 복잡성, 증거의 공백, 사용 목적에 따라 조사 깊이를 조정합니다. 출처, 반증, 비교 가능성, 불확실성을 검토합니다. 연구 목표, 장, 시각 자료의 수는 과제에 따라 정하며 고정된 할당량은 없습니다. 짧은 답변에도 충분한 검증이 필요할 수 있습니다.

Chat의 Deep Research 스위치 또는 /deep <주제>로 한 번의 조사를 시작합니다. /deep-research와 /dr은 별칭입니다. 주제를 생략하면 이후 일반 메시지에 적용할 Deep Research를 켜거나 끕니다. 깊이를 선택할 필요가 없습니다.

minara research "BTC ETF flows this quarter"

Chat 요청은 deep_research: { enabled: true }로 조사를 활성화하고 일반 턴에서는 이를 생략합니다. 세션 설정은 deepResearchEnabled를 저장하며 session_mode.deep_research_enabled는 입력창의 스위치 상태를 전달합니다. 턴 메타데이터는 Retry를 위해 조사 상태를 보존합니다. Plan Mode와 Deep Research는 동시에 활성화할 수 없습니다.

{ "message": "Compare gold and BTC", "deep_research": { "enabled": true } }

POST /v1/research:

{ "topic": "BTC ETF flows this quarter" }

skill은 보고서 원문을 파일에 저장하고 render_report로 필요한 형식을 생성합니다. 요청된 언어, 길이, 형식을 유지합니다. 일반 skill 라우팅으로 시작한 조사는 출처가 있는 채팅 답변으로 마칠 수 있습니다. 명시적인 Deep Research 진입점에서는 보고서 파일이 필요합니다.

워크플로는 apps/agent/src/skills/builtin/deep-research/SKILL.md에 있습니다. 간결한 references/research-guidance.md가 증거 수집 계획과 검토를 다루며, 별도의 분야별 참고 자료는 관련이 있을 때만 읽습니다. 보고서 구조와 렌더링은 references/report-shape.md에 있습니다. 별도의 깊이 프로필이나 고정 수집 예산은 없습니다.