Framework-to-Insight
Execute structured analytical queries with precise control. This is the preferred method when the LLM has sufficient context.
Overview
The Framework-to-Insight tool bypasses the NER interpretation layer and uses exact parameters specified in the framework. This provides a direct path from structured input to SQL generation with no assumptions or guesswork. This is an analytical tool and consumes MCP tokens.
Input / Output
| Input | Pre-defined analytical framework with structured query parameters |
| Output | Analytical insights with formatted results |
Processing Method
- Bypasses NER interpretation layer
- Uses exact parameters specified in the framework
- No assumptions or guesswork
- Direct path from structured input to SQL generation
Use Cases
- LLM agents with sufficient context to build precise frameworks
- Programmatic access with known parameters
- Batch processing of analytical requests
- API integrations requiring precise control over query structure
When to Use (Preferred)
✅ Best for:
- When the LLM has enough context to construct exact entity IDs, insight IDs, filters, and time periods
- Precise control over analytical parameters is required
- Automated systems can build structured queries
- You know exactly which entities, insights, and filters to apply
Advantages over Text-to-Insight
| Benefit | Description |
|---|---|
| No interpretation errors | Eliminates NER misinterpretation |
| Faster processing | Skips NER layer entirely |
| More reliable results | Eliminates assumptions |
| Deterministic output | Same framework yields same results |
Preferred Method
When you have sufficient context to build a structured framework, Framework-to-Insight is always the preferred approach for its precision and reliability.