gpt-5.6-sol, from the platform’s inference block — which searches authoritative sources, cross-validates claims across them, and synthesizes the results into typed sources.
What are the research modes?
mode takes one of three values, or a list of them:
The default is
["idea", "implementation"]. A list of modes returns a ResearchFindings with .ideas, .implementations and .report filled per mode; a single mode string returns that mode’s result directly — a bare list, with no .ideas attribute to reach for.
How deep should a search go?
How do I run research?
Single-mode calls
A single mode string skips theResearchFindings wrapper and returns the results directly:
Research → evolve (add context)
Use research results to provide additional context during solution building:Research → learn_knowledge (ingest into the graph)
Permanently add research findings to your knowledge graph:How are sources filtered?
The research system prioritizes sources in this order:- Official documentation — Maintainers, standards bodies
- Original papers — arXiv, peer-reviewed publications
- Major vendors — OpenAI, Google, Meta, Microsoft, NVIDIA
- Well-known engineers — Established track record
- SEO content farms
- Generic blog posts without evidence
- Single-source claims without corroboration
What comes back?
Idea content sections
EachSource.Idea contains structured content with:
- Description
- How to Apply
- When to Use
- Why Related
- Trade-offs
- Examples
- Prerequisites
- Related Concepts
Implementation content sections
EachSource.Implementation contains structured content with:
- Description
- Why Related
- When to Use
- Code Snippet
- Dependencies
- Configuration Options
- Trade-offs
- Common Pitfalls
- Performance Notes
Configuration
Research needs no API key of its own: the session runs on the coding-agent CLI named by the platform’sinference block (shipped: Codex, gpt-5.6-sol, with the CLI’s native web search). kapso doctor research verifies the CLI is installed and logged in before a run spends anything.
The full research() signature and the Source.Idea / Source.Implementation / ResearchFindings shapes are in the Python API reference.
Related
Learning Pipeline
Learn how to ingest research into your knowledge graph
Evolve System
Use research context to build better solutions
pip install leeroo-kapso · Every page as plain text: llms.txt.