Deep Search

Summary

The Deep Search Agent takes a research question, searches the web, and then critiques its own findings — re-searching to close gaps until the question is fully answered. It returns an answer grounded only in the sources it found, with a citation for every claim. Reach for it whenever a single search isn't enough and you need a verified, sourced answer.

Install

bunnpmpnpmyarn
$ pnpm dlx shadcn@latest add @agentcn/flue/deep-search
Copy

Composition

Copyagents/
└── deep-search.ts        # Orchestrator + searcher/evaluator subagents
workflows/
└── deep-search.ts        # Bounded iteration returning a cited answer
tools/
└── search.ts             # Web search via the Exa API
skills/
└── research/
    └── SKILL.md          # Iterative research procedure

Customization

• Swap the search provider. Edit tools/search.ts to call a different search API — keep the parameters and return shape.
• Tune the loop. Adjust maxRounds in workflows/deep-search.ts to trade depth for cost.
• Reshape the answer. Edit the Answer valibot schema to add fields such as confidence or a source list.
• Swap the model. Change the model on the orchestrator or subagents.