Loading pattern preview
PatternsReal-world Examples
HIL Agentic Context Builder
HIL Agentic Context Builder
Build brand context through AI-guided questioning and web research. Gathers insights to create detailed brand profiles.
Loading pattern preview
Problems solved
Technical challenges this implementation handles out of the box.
- Build brand context through guided AI questioning and web research
- Stop the agent loop when a completion tool is called
- Share AsyncLocalStorage context across a rich toolset
- Synthesize competitive and audience insights into a brand profile
Use cases
Products and workflows this pattern is designed to support.
- Brand discovery interviews
- Marketing strategy intake agents
- Competitive landscape research sessions
- Campaign briefing copilots
Setup
Requirements, wiring steps, and what this pattern adds to your project.
Getting started
Pick how you want to pull this pattern in. Then wire env vars and routes the same way.
- 1
Install from the preview toolbar
Copy the install command above and run it in your project — Pro patterns include a short-lived token.
- 2
Add environment variables to .env.local
OPENAI_API_KEY, EXA_API_KEY
- 3
Point client fetches at your API routes
Replace preview `/view/.../api/...` paths with `/api/...` in the installed files.
- 4
Customize the agent and tool files
Adapt prompts, tools, and stop conditions for your product — Copy for AI in the toolbar helps seed that work.
- 5
Run your dev server and open the pattern route
Install dependencies if needed, then start the app and verify responses.
Environment variables
Capabilities
AI SDK APIs
streamTexttoolconvertToModelMessagesgenerateObjectProviders
OpenAI
External services
Upstash
Files added
6 filesapp/page.tsxapp/layout.tsxapp/api/marketing-context/route.tslib/ai/tools/index.tslib/ai/tools/marketing-context.tsREADME.md
Dependencies
23 totalnpm packages
7AISDKExalucide-reactNext.jsReactsonnerZod
Registry components
alertavatarbadgebuttoncardcheckboxemptyinputlabelprogressresizableseparatorskeletontabstextareatooltip
Critical files
marketing-context/route.tsAPI route for the agentic context builder. Uses runWithContext for AsyncLocalStorage, streamText with a rich toolset. Uses hasToolCall stop condition alongside stepCountIs(20).
tools/brand-artifact.tsDefines 8 tools for the brand context builder agent: question-gathering tools, Exa API-powered research tools, completeness scoring, and final artifact generator using BrandArtifact.create().
tools/marketing-context.tsAlternative tool implementations with generator pattern. Contains brandIdentifyTool (streams progressive artifact updates), askQuestionTool, webResearchTool (Exa API), and reviewMarketingContextTool.
artifacts/brand-artifact.tsDefines the BrandArtifact using artifact() helper. Schema captures marketing context data: company info, target audience, marketing channels, competitors, research, progress, and stage.
ai/context.tsAsyncLocalStorage-based context management providing runWithContext, getContext, getWriter, and getCurrentUser.
Requirements
- Complexity
- Advanced
- Setup time
- ~20 minutes
- Node
- 24+
- Memory
- 512MB
Upstash Redis
