Mood-Based Movie Recommendation Agent
A conversational AI agent exploring emotional intent mapping and intent-based retrieval within a calm discovery interface.

Overview
Choosing what to watch shouldn't feel like a chore. Mood-Based Movie Recommendation Agent is a conversational AI system that understands emotional context through natural dialogue, surfacing thoughtful, personalized recommendations based on how you feel right now.
In an ecosystem built on calm interaction, this project serves as a primary example of how AI can simplify complex discovery processes by focusing on human emotional intent rather than cold algorithmic history.
Problem & Motivation
Traditional recommendation systems rely heavily on viewing history and explicit ratings. However, what you want to watch on a rainy Sunday afternoon is fundamentally different from what you'd enjoy on a high-energy Friday night.
Most entertainment platforms suffer from "Discovery Overload"—presenting endless grids of content that require significant cognitive effort to navigate. There is a fundamental mismatch between the rigid genre filters of today's algorithms and the fluid emotional intent of the viewer.
System Architecture
The system is built as a conversational bridge between raw human emotion and structured film metadata.
The architecture prioritizes the separation of interaction and recommendation logic. The conversational interface (Next.js) handles the nuance of natural language, while the underlying reasoning layer (LLM) performs the emotional-to-semantic mapping required to query movie databases effectively.
The pipeline follows a structured path: Mood Extraction → Emotional-to-Genre Mapping → Intelligent Filtering → Ranked Presentation. By modularizing these steps, we can refine the agent's "emotional intelligence" without disrupting the data retrieval systems.
Workflow & Process
Our iteration cycle focused heavily on conversational refinement and UX testing:
- Interaction Prototyping: Testing various system prompts to find a tone that felt "calm" rather than "robotic."
- Mapping Validation: Manually testing the mapping between complex emotional states (e.g., "bittersweet and reflective") and cinematic genres.
- UX Simplification: Iteratively removing interface elements to ensure the focus remained entirely on the conversation and the final recommendations.
Technical Decisions
We made a deliberate choice to prioritize conversational simplicity over a dense feature set.
The Power of Constraint
The agent is intentionally constrained to recommend only 3–5 carefully selected films. This reduces decision fatigue and reinforces the "curated quality" philosophy of the ecosystem, ensuring the user feels supported rather than overwhelmed.
We treated the system prompt not just as a technical instruction, but as the core product definition. The way the agent asks follow-up questions and presents results is as critical as the underlying model's movie knowledge.
Tradeoffs & Rationale
We sacrificed the ability to provide "exhaustive" lists for conversational clarity. While some users might want to see 50 options, we believe a calm experience is better served by a few highly accurate suggestions that respect the user's attention.
By choosing a specialized conversational flow, we limited the agent's ability to handle general-purpose queries. This was a strategic choice to ensure the system remained optimized for its primary purpose: emotional movie discovery.
Operational Constraints
Human input is often vague or contradictory. The system must gracefully handle "ambiguous emotional states" by asking clarifying questions without becoming intrusive or annoying.
As the depth of the conversation increases, so does the token cost and latency. We manage this through careful state management and concise prompt engineering to ensure the experience remains responsive and cost-effective.
Iteration & Evolution
The interaction model evolved through several simplifications:
- From Filters to Dialogue: Initially featured genre checkboxes, which were eventually removed in favor of a 100% natural language interface.
- Tone Maturation: Transitioned from a "search assistant" persona to a more "cinematic curator" persona, aligning with the ecosystem's calm luxury aesthetic.
Lessons & Reflections
This project provided a deep masterclass in AI-assisted product thinking:
- Interaction design is the bottleneck: The best model in the world fails if the interface feels noisy or demanding.
- Systems simplicity is a feature: Reducing the user's cognitive load is the ultimate goal of an intelligent discovery system.
- AI must be empathetic: Understanding why a user feels a certain way is the key to providing a truly personalized recommendation.
Research Foundation
Retrieval Foundations
The core reasoning engine of this agent was prototyped and validated through foundational Lab research:
- Semantic Search Playground: Our exploration of vector embeddings and intent-based retrieval provided the primary semantic framework for the Movie Agent's discovery workflow.
Future Direction
The future of the Mood Movie Agent involves deeper personalization and ecosystem integration:
- Contextual Awareness: Integrating local data (like time of day or weather) to further refine the "mood" without requiring explicit user input.
- Ecosystem Integration: Linking the agent into the Lab to experiment with new emotional-mapping algorithms and shared semantic data providers.
Semantic Search Playground
An interactive system for exploring vector embeddings and semantic similarity across different text inputs.