The problem
An operational question rarely lives in one table or one document. Finding a useful answer may require checking an asset, reviewing telemetry and events, consulting analysis history, and deciding whether the evidence is sufficient. A conversational interface is only useful if those steps remain bounded and inspectable.
What I architected
WaveAI turns a question into a scoped investigation on LangGraph and MCP: resolve the desired outcome, assess evidence gaps, select a typed tool, validate and authorize, then reassess. That loop operates within explicit step and token budgets rather than treating endless tool use as progress.
- Resolve the desired outcome
- Assess evidence gaps
- Select a typed tool
- Validate and authorize
- Reassess with the new evidence
While evidence gaps remain and budget is left, the loop returns to step 2.
Answer with its limits
- complete
- partial
- clarification
- blocked
The tool surface covers assets, telemetry, events, workflows, analysis history, data pipelines, documents, and charts. Retrieval uses semantic chunking, hybrid search, and re-ranking. It provides bounded evidence access—not arbitrary database queries or code execution.
Authority is part of the architecture
The application supplies authorized records. The agent coordinates investigation. The user owns every consequential change:
- Preview the proposed change.
- Obtain explicit user confirmation.
- Revalidate authorization and the proposed operation.
- Execute the supported change.
- Persist a durable receipt.
These are deliberate boundaries between reasoning, permission, and execution. A model’s suggestion is not authorization.
Honest completion
Every run ends in one of four evidence-guided states. An exhausted budget must never be reported as success.
complete- The evidence answers the question within budget.
partial- A supported finding with its limits stated.
clarification- The question is ambiguous, so the agent asks instead of guessing.
blocked- Access or evidence is missing, and the run says what it needs.
How we know it works
Golden datasets come from real investigations. LLM-as-judge scoring, grounding and hallucination checks, and prompt regression tests run on every change, alongside prompt-injection defenses. Full run tracing and replay with Langfuse and Arize show what was asked, which tools ran, what evidence supported an answer, and what changed—so an investigation stays reviewable after the conversation ends.
Connected to operational priorities
WaveAI is also the investigation layer behind Smart Summary & Priority Tracker. A “Tell Me More” action supplies the site, period, and evidence already in context. The agent explains the ranking engine’s own criteria and continues into telemetry, event history, and root-cause investigation.
Explore fleet prioritization →
My contribution
I owned the agentic architecture, authority separation, typed tool surface, completion semantics, and the evaluation and observability layer as part of leading Narrativewave’s AI strategy, and I lead the team of five AI engineers and data scientists who build it. WaveAI cut site investigations from about an hour of manual cross-referencing to a few minutes, and weekly active users doubled within a quarter.
Architecture illustration and résumé-backed description; no client data, private code, or product screenshots are disclosed.