{"api_format":{"request":{"question":"your question","session_id":"optional - will be generated if not provided"},"response":{"api_version":"2.0","engagement":{"clarifying_questions":[],"conversation_guidance":{},"follow_up_suggestions":[]},"intelligence":{"conversation_state":{},"user_analysis":{}},"request":{"processed_at":"timestamp","question":"user question"},"response":{"answer":"AI response","confidence_indicators":{},"model_used":"openai/gpt-oss-120b"},"session":{"conversation_number":"1-N","session_id":"unique_session_id","user_status":"new|returning"},"success":true}},"clarity_examples":{"clear_questions":["What are Yash's main technical skills?","How did Yash implement the DocuTalk project?","Are you hiring for an AI engineer role?"],"note":"Unclear questions will receive clarifying questions to better understand your needs","unclear_questions":["About Yash","Tell me about him","His work"]},"conversation_memory":{"description":"AI maintains context across multiple exchanges within a session","example":"If you first ask about projects, then about AI experience, the AI will connect these topics and reference your previous interest in projects when discussing AI implementations","features":{"context_building":"References previous conversations naturally","duplicate_avoidance":"Avoids repeating previously covered information","progression_awareness":"Tracks how your interests and questions evolve","topic_tracking":"Remembers what topics have been discussed (projects, AI/ML, experience, etc.)"}},"description":"Ask me anything about Yash's AI expertise, projects, and experience!","developer":"Yash Gori - AI Engineer","endpoints":{"GET /admin/conversations":"View all visitor conversations (admin only)","GET /admin/profiles":"View user profiles and analytics (admin only)","GET /profile":"Get Yash's complete profile information","GET /session/{session_id}/history":"Get detailed conversation history (optional ?limit=N)","GET /session/{session_id}/state":"Get complete session state and conversation context","POST /ask":"Ask questions about Yash (send JSON with 'question' field, optional 'session_id')"},"engagement_features":{"conversation_continuity":"AI remembers your previous questions and builds on your interests","follow_up_suggestions":{"description":"Each response includes 3-4 intelligent follow-up suggestions","examples":{"recruiter":["What role level are you considering?","What's your hiring timeline?"],"student":["What skills do you want to develop next?","Would learning resources be helpful?"],"technical":["Want to dive deeper into the architecture?","Are you working on similar projects?"]}},"personalized_suggestions":"Follow-ups adapt based on your detected type and sophistication level"},"rich_content_integration":{"content_types":{"architecture":"System design, data flow, scalability details","implementation":"Development highlights, challenges solved, technical approaches","links":"GitHub repositories, live demos, documentation","performance":"Metrics, accuracy rates, response times, scalability numbers"},"description":"AI automatically detects project-specific questions and provides enhanced technical details","example_enhanced_response":{"enhanced_content":{"architecture":"Microservices architecture with Flutter frontend, Flask API backend, and FAISS vector database","implementation":["Custom document preprocessing pipeline","Optimized FAISS index configuration"],"links":{"demo":"https://docutalk-demo.streamlit.app","github":"https://github.com/yashgori/docutalk"},"performance":"95% accuracy on 100+ page documents, sub-second query response times"},"question":"How did you implement DocuTalk?"},"features":{"comprehensive_data":"Includes GitHub repos, demo links, technical specifications, challenges solved, and implementation highlights","contextual_details":"Provides relevant technical information based on question type (architecture, implementation, performance, links)","project_detection":"Automatically identifies when specific projects (DocuTalk, Inhance, Finance Advisor, etc.) are mentioned"}},"sample_questions":["What makes Yash special as an AI developer?","Tell me about his experience with RAG systems","How did he achieve 94% accuracy in customer churn prediction?","What's his experience with different LLM platforms?","Can you explain his DocuTalk project?","What business impact has he created?","What's his current role and responsibilities?"],"smart_suggestions":{"categories":{"depth_exploration":"Deeper dives based on user sophistication level","immediate_follow_ups":"Direct follow-up questions based on current topic","meta_suggestions":"High-level conversation guidance and next steps","topic_transitions":"Natural transitions to related topics"},"description":"AI analyzes conversation flow patterns to provide intelligent next-step suggestions","example":"After asking about DocuTalk project, you might get immediate follow-ups about FAISS integration, topic transitions to other AI projects, or depth exploration about system architecture","flow_analysis":{"depth_trend":"broad|balanced|deep - topic coverage pattern","engagement_pattern":"new|moderate|high - level of user engagement","progression":"exploring|deepening|focused - how user interest is evolving"}},"status":"\ud83d\ude80 Yash Gori's AI Portfolio API is Live!"}