@@ -72,85 +72,6 @@ pnpm start
7272- `src/pickaxe-client.ts` - Pickaxe client configuration
7373- `results/` - Generated research reports from trigger sessions
7474
75- ## How Deep Research Works
76-
77- The deep research agent performs sophisticated multi-iteration research:
78-
79- 1. **Query Planning**: Analyzes your question and plans targeted search queries
80- 2. **Web Search**: Searches the web using OpenAI's search preview tool
81- 3. **Content Extraction**: Converts web pages to clean markdown format
82- 4. **Fact Extraction**: Identifies and extracts key facts from each source
83- 5. **Gap Analysis**: Evaluates what information is still missing
84- 6. **Iterative Refinement**: Repeats the process focusing on missing aspects
85- 7. **Synthesis**: Creates a comprehensive summary with full source attribution
86-
87- ## Available Tools
88-
89- ### Search Tool
90- Performs web searches using OpenAI's advanced search preview.
91- - Provides high-quality, recent web results
92- - Includes source URLs and titles
93- - Optimized for research queries
94-
95- ### Plan Search Tool
96- Intelligently plans search queries based on existing knowledge and gaps.
97- - Analyzes what information we already have
98- - Identifies missing aspects that need investigation
99- - Generates targeted search queries for maximum information gain
100-
101- ### Website to Markdown Tool
102- Converts web pages to clean, readable markdown format.
103- - Removes ads, navigation, and clutter
104- - Preserves important content structure
105- - Maintains links and formatting for citations
106-
107- ### Extract Facts Tool
108- Identifies and extracts key facts from source material.
109- - Focuses on information relevant to the research query
110- - Attributes facts to specific sources
111- - Filters out opinions and maintains objectivity
112-
113- ### Judge Facts Tool
114- Evaluates whether we have sufficient information to answer the query.
115- - Assesses completeness of gathered facts
116- - Identifies specific missing aspects
117- - Determines if additional research iterations are needed
118-
119- ### Judge Results Tool
120- Assesses the quality and completeness of the final research.
121- - Evaluates if the research adequately addresses the original query
122- - Provides reasoning for completeness assessment
123- - Ensures research meets quality standards
124-
125- ### Summarize Tool
126- Synthesizes all gathered information into a coherent, comprehensive summary.
127- - Combines facts from multiple sources
128- - Maintains source attribution
129- - Creates readable, well-structured reports
130-
131- ## Environment Variables
132-
133- | Variable | Required | Description |
134- |----------|----------|-------------|
135- | `OPENAI_API_KEY` | Yes | Your OpenAI API key for language model and search |
136- | `HATCHET_CLIENT_TOKEN` | Yes | Your Hatchet API token for orchestration |
137-
138- ## Example Research Queries
139-
140- - "What are the latest developments in quantum computing and their potential applications?"
141- - "How has climate change affected Arctic ice coverage over the past decade?"
142- - "What are the key differences between various machine learning frameworks?"
143- - "What are the economic impacts of remote work on urban centers?"
144- - "How do different countries approach renewable energy policy?"
145-
146- ## Research Features
147-
148- - **Multi-Source Analysis**: Gathers information from multiple web sources
149- - **Iterative Refinement**: Performs multiple research rounds to fill knowledge gaps
150- - **Source Attribution**: Maintains detailed citations for all facts
151- - **Quality Assessment**: Evaluates research completeness and reliability
152- - **Comprehensive Reporting**: Generates detailed reports with summaries and sources
153-
15475## Scripts
15576
15677- `pnpm run trigger` - Run the interactive deep research CLI
0 commit comments