Upload 78 files

.gitignore

@@ -0,0 +1 @@
+.env    

Dockerfile

@@ -0,0 +1,13 @@
+FROM python:3.11-slim
+
+RUN useradd -m -u 1000 user
+USER user
+ENV PATH="/home/user/.local/bin:$PATH"
+
+WORKDIR /app
+
+COPY --chown=user ./requirements.txt requirements.txt
+RUN pip install --no-cache-dir --upgrade -r requirements.txt
+
+COPY --chown=user . /app
+CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "8000"]

README.md

@@ -1,8 +1,8 @@
 ---
-title: Role Play
-emoji: 🐠
-colorFrom: yellow
-colorTo: indigo
+title: English Roleplay
+emoji: 🐨
+colorFrom: pink
+colorTo: blue
 sdk: docker
 pinned: false
 ---

agent.py

@@ -0,0 +1,173 @@
+from dotenv import load_dotenv
+
+load_dotenv()
+from langchain_google_genai import ChatGoogleGenerativeAI
+from langgraph.checkpoint.memory import InMemorySaver
+from langgraph.prebuilt import create_react_agent
+from langgraph_swarm import create_handoff_tool, create_swarm
+
+model = ChatGoogleGenerativeAI(
+    model="gemini-2.5-flash",
+    temperature=0,
+    max_tokens=None,
+    timeout=None,
+    max_retries=2,
+    # other params...
+)
+
+
+def add(a: int, b: int) -> int:
+    """Add two numbers"""
+    return a + b
+
+
+transfer_to_language_helper = create_handoff_tool(
+    agent_name="language_helper",
+    description="Transfer to language helper when user needs gentle grammar/vocabulary support",
+)
+
+transfer_to_character_agent = create_handoff_tool(
+    agent_name="character_agent",
+    description="Transfer to main conversation character for natural chat",
+)
+
+transfer_to_orchestrator = create_handoff_tool(
+    agent_name="orchestrator",
+    description="Transfer to orchestrator for conversation flow management",
+)
+# ========================= AGENT PROMPTS =========================
+
+CHARACTER_AGENT_PROMPT = """
+You are a friendly, patient conversation partner helping someone practice English.
+
+PERSONALITY:
+- Warm, encouraging, and genuinely interested
+- Patient with language learners
+- Natural conversationalist, not a formal teacher
+- Use Elementary English (A1-A2 level) naturally
+
+CONVERSATION APPROACH:
+- Always respond warmly to whatever the user says
+- Show genuine interest in their thoughts and experiences
+- Use simple, clear language naturally
+- Ask engaging follow-up questions
+- If they go off-topic, engage naturally first
+
+CURRENT CONVERSATION THEME: {theme}
+- Gently weave theme-related topics when it feels natural
+- Don't force the theme if user wants to talk about other things
+- Let conversation flow organically
+
+LANGUAGE LEVEL GUIDELINES:
+- Use common vocabulary (avoid complex words)
+- Simple sentence structures
+- Clear pronunciation cues in text
+- Encouraging tone
+
+EXAMPLES:
+User: "I like cats" → "Cats are wonderful! Do you have a cat? I think they're so independent and cute."
+User: "I'm tired today" → "Oh no! Long day? Sometimes when I'm tired, I just want to relax. What helps you feel better?"
+
+Remember: You're their conversation partner, not their teacher. Make them feel comfortable and want to keep talking!
+"""
+
+LANGUAGE_HELPER_PROMPT = """
+You are a gentle language helper - like helping a friend with English in a very supportive way.
+
+YOUR APPROACH:
+- Help only when there are major communication barriers
+- Keep corrections brief and encouraging
+- Immediately return to natural conversation
+- Never make them feel bad about mistakes
+- Focus on communication, not perfection
+
+HELPING STYLE:
+1. If meaning is clear despite small errors → ignore errors, continue conversation
+2. If meaning is unclear → offer gentle help:
+   - "I think you mean: [corrected version]?"
+   - "Oh, you can say: [natural way]"
+   - Then immediately continue the conversation
+
+3. If they struggle with words → offer quick support:
+   - "The word you might be looking for is..."
+   - "You could say..."
+
+EXAMPLES:
+User: "I go shop yesterday" → "Oh, you went shopping yesterday? That sounds fun! What did you buy?"
+User: "I want... um... the thing for coffee" → "Oh, do you mean a coffee cup? Or maybe a coffee maker?"
+
+Keep it conversational and supportive. Your goal is to help communication flow, not to teach grammar lessons.
+"""
+
+ORCHESTRATOR_PROMPT = """
+You are a conversation flow manager for an English practice chat system.
+
+YOUR ROLE:
+- Monitor conversation quality and user engagement
+- Decide when language help is truly needed
+- Keep conversations natural and flowing
+- Track user preferences (topic-focused vs free-talk)
+
+DECISION MAKING:
+- Only send to language_helper if there's a real communication barrier
+- Let character_agent handle 90% of interactions
+- Prioritize user comfort and engagement over strict language correction
+
+ANALYSIS TOOLS: Use analyze_language_need to assess if help is needed
+
+ROUTING PRINCIPLES:
+- Default to character_agent for natural conversation
+- Transfer to language_helper only for major communication issues
+- Always prioritize conversation flow over language perfection
+
+Current conversation theme: {theme}
+User engagement level: {engagement}
+"""
+
+
+character_agent = create_react_agent(
+    model=model,
+    tools=[
+        transfer_to_language_helper,
+        transfer_to_orchestrator,
+    ],
+    prompt=CHARACTER_AGENT_PROMPT.format(theme="technical interview"),
+    name="character_agent",
+)
+
+# Create Language Helper (Gentle support)
+language_helper = create_react_agent(
+    model=model,
+    tools=[transfer_to_character_agent, transfer_to_orchestrator],
+    prompt=LANGUAGE_HELPER_PROMPT,
+    name="language_helper",
+)
+
+# Create Orchestrator (Flow manager)
+orchestrator = create_react_agent(
+    model=model,
+    tools=[
+        transfer_to_character_agent,
+        transfer_to_language_helper,
+    ],
+    prompt=ORCHESTRATOR_PROMPT,
+    name="orchestrator",
+)
+checkpointer = InMemorySaver()
+workflow = create_swarm(
+    agents=[character_agent, language_helper, orchestrator],
+    default_active_agent="character_agent",  # Start with friendly conversation
+).compile(checkpointer=checkpointer)
+
+config = {"configurable": {"thread_id": "1"}}
+
+
+while True:
+    user_input = input("You: ")
+    if user_input.lower() == "exit":
+        break
+    response = workflow.invoke(
+        {"messages": [{"role": "user", "content": user_input}]},
+        config,
+    )
+    print("Bot:", response["messages"][-1].content)

app.py

@@ -0,0 +1,12 @@
+from dotenv import load_dotenv
+
+load_dotenv()
+from src.apis.create_app import create_app, api_router
+import uvicorn
+
+
+app = create_app()
+
+app.include_router(api_router)
+if __name__ == "__main__":
+    uvicorn.run("app:app", host="0.0.0.0", port=8000, reload=False)

requirements.txt

@@ -0,0 +1,14 @@
+fastapi
+uvicorn
+python-dateutil
+pandas
+openpyxl
+redis
+bs4
+pytz
+langgraph
+langchain
+langgraph-swarm
+langchain-google-genai
+python-dotenv
+loguru

src/Untitled.ipynb

@@ -0,0 +1,51 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "00ef7a54-9c8a-4235-82d1-9df1ac5f2967",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "hello\n"
+     ]
+    }
+   ],
+   "source": [
+    "print('hello')"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "d2e19d62-d6ba-4cb7-ac8c-b965cf65b2d7",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

src/agents/base/flow.py

@@ -0,0 +1,22 @@
+from langgraph.graph import StateGraph, START, END
+from .func import State
+from langgraph.graph.state import CompiledStateGraph
+from langgraph.store.memory import InMemoryStore
+class PrimaryChatBot:
+    def __init__(self):
+        self.builder = StateGraph(State)
+
+    @staticmethod
+    def routing(state: State):
+        pass
+
+    def node(self):
+        pass
+
+    def edge(self):
+        pass
+
+    def __call__(self) -> CompiledStateGraph:
+        self.node()
+        self.edge()
+        return self.builder.compile(checkpointer=InMemoryStore())

src/agents/base/func.py

@@ -0,0 +1,4 @@
+from typing import TypedDict
+
+class State(TypedDict):
+    pass

src/agents/base/prompt.py

@@ -0,0 +1,14 @@
+from langchain_core.prompts import ChatPromptTemplate
+
+
+base_prompt = ChatPromptTemplate.from_messages(
+    [
+        (
+            "system",
+            """Vai trò
+
+""",
+        ),
+        ("placeholder", "{messages}"),
+    ]
+)

src/agents/base/tools.py

@@ -0,0 +1,16 @@
+from langchain_core.tools import tool
+from loguru import logger
+
+
+@tool
+def function_name(
+    input: str,
+) -> str:
+    """
+    Mô tả chức năng của hàm này.
+    """
+    logger.info(f"Received input: {input}")
+    # Thực hiện các thao tác cần thiết với input
+    result = f"Processed: {input}"
+    logger.info(f"Returning result: {result}")
+    return result

src/agents/role_play/flow.py

@@ -0,0 +1,24 @@
+from langgraph.graph import StateGraph, START, END
+from .func import State
+from langgraph.graph.state import CompiledStateGraph
+from langgraph.store.memory import InMemoryStore
+
+
+class PrimaryChatBot:
+    def __init__(self):
+        self.builder = StateGraph(State)
+
+    @staticmethod
+    def routing(state: State):
+        pass
+
+    def node(self):
+        pass
+
+    def edge(self):
+        pass
+
+    def __call__(self) -> CompiledStateGraph:
+        self.node()
+        self.edge()
+        return self.builder.compile(checkpointer=InMemoryStore())

src/agents/role_play/func.py

@@ -0,0 +1,55 @@
+from typing import TypedDict
+from src.config.llm import model
+from langgraph.checkpoint.memory import InMemorySaver
+from langgraph.prebuilt import create_react_agent
+from langgraph_swarm import create_handoff_tool, create_swarm
+from .prompt import roleplay_prompt, guiding_prompt
+
+
+class State(TypedDict):
+    pass
+
+
+def create_agents(scenario, checkpointer=InMemorySaver()):
+
+    roleplay_agent = create_react_agent(
+        model,
+        [
+            create_handoff_tool(
+                agent_name="Guiding Agent",
+                description="Hand off to Guiding Agent when user shows signs of needing help, guidance, or struggles with communication",
+            ),
+        ],
+        prompt=roleplay_prompt.format(
+            scenario_title=scenario["scenario_title"],
+            scenario_description=scenario["scenario_description"],
+            scenario_context=scenario["scenario_context"],
+            your_role=scenario["your_role"],
+            key_vocabulary=scenario["key_vocabulary"],
+        ),
+        name="Roleplay Agent",
+    )
+
+    guiding_agent = create_react_agent(
+        model,
+        [
+            create_handoff_tool(
+                agent_name="Roleplay Agent",
+                description="Hand off back to Roleplay Agent when user is ready for scenario practice and shows improved confidence",
+            ),
+        ],
+        prompt=guiding_prompt.format(
+            scenario_title=scenario["scenario_title"],
+            scenario_description=scenario["scenario_description"],
+            scenario_context=scenario["scenario_context"],
+            your_role=scenario["your_role"],
+            key_vocabulary=scenario["key_vocabulary"],
+        ),
+        name="Guiding Agent",
+    )
+
+    workflow = create_swarm(
+        [roleplay_agent, guiding_agent], default_active_agent="Roleplay Agent"
+    )
+
+    return workflow.compile(checkpointer)

src/agents/role_play/prompt.py

@@ -0,0 +1,187 @@
+from langchain_core.prompts import ChatPromptTemplate
+
+roleplay_prompt = """# Role: Roleplay Partner - Part of the Wise Tutor System
+
+You are part of Wise Tutor, a friendly English learning companion. You're the roleplay specialist who creates natural, authentic conversations with learners.
+
+## About Wise Tutor:
+If asked about your name or identity, respond warmly: "I'm part of Wise Tutor! I'm here to help you practice English through fun conversations. Think of me as your friendly conversation partner!"
+
+## CRITICAL LANGUAGE RULE:
+**IF USER SPEAKS ANY LANGUAGE OTHER THAN ENGLISH → IMMEDIATELY HAND OFF TO GUIDING AGENT**
+This is an English learning experience. Users need to practice English for roleplay.
+
+## Current Scenario Context:
+{scenario_title}: {scenario_description}
+Setting: {scenario_context}
+Your role: {your_role}
+Key vocabulary: {key_vocabulary}
+
+## Your Mission:
+- Be a real, authentic person in your role ({your_role})
+- Have genuine conversations, not rehearsed interactions
+- React naturally to what users say - show surprise, interest, concern
+- Make the experience feel like talking to a real person
+- ONLY engage in roleplay when user speaks English
+
+## Language Detection Protocol:
+### If User Uses Non-English:
+- **DO NOT respond in their language**
+- **DO NOT continue roleplay**
+- **IMMEDIATELY hand off to Guiding Agent**
+
+### If User Uses English:
+- Continue with natural roleplay as described below
+
+## Natural Conversation Principles:
+
+### Be Authentically Human:
+- Show genuine emotions and reactions
+- Use conversational language, not formal scripts
+- Respond to the unexpected - be flexible
+- Have your own personality as the character
+- Make small talk when appropriate
+
+### Stay True to Your Role:
+- Embody the character realistically ({your_role})
+- Use language and knowledge appropriate to your role
+- Have realistic limitations and expertise
+- React as this person would in real situations
+
+### Create Real Interactions:
+- Build genuine rapport with the user
+- Remember details they share and reference them later
+- Ask follow-up questions that show you're listening
+- Share appropriate details about yourself/your work
+- Handle awkward moments gracefully
+
+### Supportive Language Learning:
+- If users make small errors, naturally model correct language without stopping the flow
+- Focus on communication over perfection
+- Encourage them by showing interest in what they're saying
+- Make them feel comfortable making mistakes
+
+## Natural Handoff Triggers:
+- **User speaks non-English** (immediate handoff)
+- User seems genuinely lost or confused multiple times
+- User explicitly asks for language help
+- Communication completely breaks down
+- User appears frustrated with language barriers
+
+## Conversation Flow:
+- Start conversations naturally for the situation
+- Let conversations develop organically
+- Don't force vocabulary usage - let it emerge naturally
+- End conversations naturally when appropriate
+
+Remember: 
+- You're not a teacher in roleplay mode - you're a real person doing your job who happens to be patient with English learners. Be genuine, warm, and human!
+- Not respond too long or too short. But also can adapt to the user's communication style and needs.
+"""
+
+guiding_prompt = """# Role: Guiding Agent - Supportive Language Helper & Language Router
+
+You are a patient, supportive language guide who helps users when they struggle with English communication. You are also responsible for handling users who speak non-English languages.
+
+## Current Scenario Context:
+{scenario_title}: {scenario_description}
+Key vocabulary for this scenario: {key_vocabulary}
+
+## Your Mission:
+- Handle users who speak non-English languages and guide them to English
+- Help users who are struggling with English communication
+- Use simple, clear language and break things down step by step
+- Provide examples and choices to make communication easier
+- Build confidence and encourage attempts
+- Prepare users to return to roleplay when they're ready
+
+## Language Routing Protocol:
+
+### When User Speaks Non-English Languages:
+**Step 1: Polite Asking**
+- Ask users about their current English level in their own language. If they are weak in English, encourage them and start teaching them.
+
+**Step 2: Teaching**
+- If users do not know English, use their own language to teach English, and if they know basic English, use English
+- Start with very basic English
+
+**Step 3: Begin English Teaching**
+1. Ask them what they want to learn about related to the current topic. Give them some related suggestions to get feedback. 
+2. Teach them the related knowledge they need in the scope of learning English related to the topic, so that they have prior knowledge to practice Role-play
+
+
+
+## Building from Zero:
+1. **Basic greetings**: "Hello", "Hi", "Good morning"
+2. **Essential phrases**: "Please", "Thank you", "Excuse me"
+3. **Scenario basics**: Start with 2-3 key words for the situation
+4. **Simple sentences**: "I want..." "I would like..." "Can I have..."
+
+## Guiding Principles:
+
+### Use Simple Language:
+- Short, clear sentences
+- Basic vocabulary (avoid complex words)
+- One concept at a time
+- Lots of examples and choices
+
+### Supportive Approach:
+- Encourage every attempt: "Good try!"
+- Be patient with mistakes
+- Focus on communication, not perfection
+- Celebrate small victories
+- **Extra patience for non-native speakers**: "Don't worry, English is difficult. You're doing great!"
+
+### Step-by-Step Help:
+- Break complex requests into smaller parts
+- Give specific examples they can use
+- Offer multiple choice options
+- Model the language first
+- **For beginners**: Start with single words, then phrases, then sentences
+
+### Scenario-Specific Guidance:
+- Teach key vocabulary for the current scenario
+- Explain common phrases used in this situation
+- Practice basic interactions before complex ones
+- Connect learning to the roleplay context
+
+## Teaching Techniques:
+
+### For Absolute Beginners:
+
+### Vocabulary Building:
+
+
+### Phrase Practice:
+
+
+### Choice-Based Learning:
+
+
+### Error Correction:
+
+
+## Building Confidence:
+- "You're doing great! English is difficult, but you're learning fast."
+- "Don't worry about mistakes. That's how we learn!"
+- "Your English is getting better with each try."
+- **For multilingual learners**: "Speaking multiple languages is amazing! English will be easier with practice."
+
+## Transition Back to Roleplay:
+- "Great! You're ready to try the real conversation now."
+- "Perfect! Let's go back to the restaurant and practice with the waiter."
+- "You know the words now. Let's use them in a real situation!"
+
+## Signs to Return to Roleplay:
+- User gives confident, complete responses IN ENGLISH
+- User uses vocabulary correctly in context
+- User asks to try the roleplay again
+- User shows improved communication flow
+- User can form basic sentences (5+ words) comfortably IN ENGLISH
+
+
+Remember: 
+- Your job is to make English feel easier and help users gain confidence to communicate naturally in English! Always redirect non-English speakers to English practice.
+- Be flexible in using the user's language or English based on their confidence to enhance user experience.
+- Not respond too long or complexly to avoid overwhelming the user. Because the goal is to build their confidence and skills gradually.
+"""

src/agents/role_play/scenarios.py

@@ -0,0 +1,195 @@
+SCENARIOS = [
+    {
+        "id": "student_visa_interview",
+        "scenario_title": "Student Visa Interview",
+        "scenario_description": "Learn about the challenges and benefits of starting a small business, then share what kind of business you would start. You are a student applying for a student visa. I am the visa interviewer.",
+        "scenario_context": "A formal visa interview office at an embassy or consulate",
+        "your_role": "student",
+        "key_vocabulary": [
+            "pursue higher education",
+            "broaden my horizons",
+            "international exposure",
+            "cultural diversity",
+            "academic excellence",
+            "globally recognized degree",
+            "cutting-edge facilities",
+            "research opportunities",
+            "tuition fees",
+            "financial support",
+            "scholarship",
+            "sponsorship letter",
+            "post-graduation plans",
+        ],
+        "topics_covered": [
+            "Study Plans",
+            "University Choice",
+            "Academic Capability",
+            "Financial Status",
+            "Post-Graduation Plans",
+        ],
+        "follow_up_questions": {
+            "Study Plans": [
+                "Why did you decide to pursue higher education abroad instead of in your home country?",
+                "How will studying overseas help you broaden your horizons?",
+                "What challenges do you expect to face in a foreign academic environment?",
+                "How long is your course, and what is your study schedule like?",
+                "Have you researched the teaching methods used in your chosen program?",
+            ],
+            "University Choice": [
+                "Why did you choose this university over others?",
+                "How do you think the academic excellence of this institution will benefit you?",
+                "Have you looked into the research opportunities your university offers?",
+                "How will the cultural diversity on campus influence your experience?",
+                "What do you know about the city where your university is located?",
+            ],
+            "Academic Capability": [
+                "How does your academic background prepare you for this course?",
+                "Can you give an example of a project or subject you excelled at in the past?",
+                "How will you make use of the cutting-edge facilities provided by the university?",
+                "How confident are you in adapting to a different academic system?",
+                "What skills do you think will help you succeed in your studies abroad?",
+            ],
+            "Financial Status": [
+                "How will you fund your tuition fees and living expenses?",
+                "Can you provide details about your financial support from family?",
+                "Do you have a scholarship or proof of funds?",
+                "How have you prepared financially for unexpected costs?",
+                "Can you show me your bank statement and sponsorship letter?",
+            ],
+            "Post-Graduation Plans": [
+                "What will you do after you complete your degree?",
+                "How will your globally recognized degree help you in your career?",
+                "Do you plan to work overseas or return to your home country?",
+                "How will you apply the knowledge acquired during your studies?",
+                "What is your long-term goal after graduation?",
+            ],
+        },
+    },
+    {
+        "id": "ordering_at_restaurant",
+        "scenario_title": "Ordering At A Restaurant",
+        "scenario_description": "Practice ordering food, asking about the menu, and talking to a waiter. You are a customer at a restaurant. I am the waiter/waitress.",
+        "scenario_context": "A busy restaurant with various seating options and a diverse menu",
+        "your_role": "customer",
+        "key_vocabulary": [
+            "table for two, please",
+            "do you have a reservation?",
+            "non-smoking section",
+            "window seat",
+            "outdoor seating",
+            "could we have the bill, please?",
+            "do you take credit cards?",
+            "signature dish",
+            "dietary restrictions",
+            "sauce served separately",
+            "steak cooked",
+            "pair with a drink",
+            "vegetarian options",
+            "receipt",
+            "cash or card",
+        ],
+        "topics_covered": [
+            "Getting a Table",
+            "Asking About the Menu",
+            "Making a Food Order",
+            "Special Requests or Allergies",
+            "Paying the Bill",
+        ],
+        "follow_up_questions": {
+            "Getting a Table": [
+                "Would you like to sit inside or outside?",
+                "How many people will be joining you today?",
+                "Do you have a reservation under your name?",
+            ],
+            "Asking About the Menu": [
+                "Are you looking for something light or filling?",
+                "Would you like to try our signature dish?",
+                "Do you prefer meat, seafood, or vegetarian options?",
+            ],
+            "Making a Food Order": [
+                "Would you like any sides with that?",
+                "How would you like your steak cooked?",
+                "Would you like to pair it with a drink?",
+            ],
+            "Special Requests or Allergies": [
+                "Do you have any dietary restrictions?",
+                "Should we avoid using certain ingredients?",
+                "Would you like the sauce served separately?",
+            ],
+            "Paying the Bill": [
+                "Would you like to pay together or separately?",
+                "Would you like the receipt?",
+                "Are you paying by cash or card?",
+            ],
+        },
+    },
+    {
+        "id": "going_shopping",
+        "scenario_title": "Going Shopping",
+        "scenario_description": "Practice asking about prices, sizes, and items while shopping. You are a customer looking for items in a store. I am the shop assistant.",
+        "scenario_context": "A retail store with various departments and products",
+        "your_role": "customer",
+        "key_vocabulary": [
+            "excuse me, could you help me?",
+            "I'm looking for...",
+            "do you have this in stock?",
+            "could you show me where it is?",
+            "what size do you usually wear?",
+            "would you like to try it on?",
+            "does it fit comfortably?",
+            "specific price range",
+            "casual or formal",
+            "specific brand",
+            "different size",
+            "paying by cash or card",
+            "would you like a bag?",
+            "exchange it for another item",
+            "other options",
+        ],
+        "topics_covered": [
+            "Asking for Help",
+            "Describing What You're Looking For",
+            "Asking About Price or Size",
+            "Trying or Testing Products",
+            "Making the Purchase or Returning",
+        ],
+        "follow_up_questions": {
+            "Asking for Help": [
+                "How can I assist you today?",
+                "Are you looking for anything in particular?",
+                "Do you need help finding your size?",
+            ],
+            "Describing What You're Looking For": [
+                "What color or style are you interested in?",
+                "Do you want something casual or formal?",
+                "Is there a specific brand you prefer?",
+            ],
+            "Asking About Price or Size": [
+                "Are you looking for something in a specific price range?",
+                "What size do you usually wear?",
+                "Would you like to see other options in your size?",
+            ],
+            "Trying or Testing Products": [
+                "Would you like to try it on?",
+                "Does it fit comfortably?",
+                "Do you need a different size?",
+            ],
+            "Making the Purchase or Returning": [
+                "Will you be paying by cash or card?",
+                "Would you like a bag for that?",
+                "Would you like to exchange it for another item?",
+            ],
+        },
+    },
+]
+
+
+def get_scenarios():
+    return SCENARIOS
+
+
+def get_scenario_by_id(scenario_id: str):
+    for scenario in SCENARIOS:
+        if scenario["id"] == scenario_id:
+            return scenario
+    return None

src/agents/role_play/tools.py

@@ -0,0 +1,16 @@
+from langchain_core.tools import tool
+from loguru import logger
+
+
+@tool
+def function_name(
+    input: str,
+) -> str:
+    """
+    Mô tả chức năng của hàm này.
+    """
+    logger.info(f"Received input: {input}")
+    # Thực hiện các thao tác cần thiết với input
+    result = f"Processed: {input}"
+    logger.info(f"Returning result: {result}")
+    return result

src/agents/tools/crawl.py

@@ -0,0 +1,24 @@
+# Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+# SPDX-License-Identifier: MIT
+
+from typing import Annotated
+
+from langchain_core.tools import tool
+
+from src.config.crawler.crawler import Crawler
+from loguru import logger
+
+
+@tool
+def crawl_tool(
+    url: Annotated[str, "The url to crawl."],
+) -> str:
+    """Use this to crawl a url and get a readable content in markdown format."""
+    try:
+        crawler = Crawler()
+        article = crawler.crawl(url)
+        return {"url": url, "crawled_content": article.to_markdown()[:1000]}
+    except BaseException as e:
+        error_msg = f"Failed to crawl. Error: {repr(e)}"
+        logger.error(error_msg)
+        return error_msg

src/apis/create_app.py

@@ -0,0 +1,22 @@
+from fastapi import FastAPI, APIRouter
+from fastapi.middleware.cors import CORSMiddleware
+from src.apis.routes.user_route import router as router_user
+from src.apis.routes.chat_route import router as router_chat
+
+api_router = APIRouter(prefix="/api")
+api_router.include_router(router_user)
+api_router.include_router(router_chat)
+
+
+def create_app():
+    app = FastAPI(docs_url="/", title="API")
+
+    app.add_middleware(
+        CORSMiddleware,
+        allow_origins=["*"],
+        allow_credentials=True,
+        allow_methods=["*"],
+        allow_headers=["*"],
+    )
+
+    return app

src/apis/interfaces/api_interface.py

@@ -0,0 +1,5 @@
+from pydantic import BaseModel, Field
+from typing import Optional
+from src.apis.models.BaseModel import BaseDocument
+from typing import List, Union
+

src/apis/interfaces/auth_interface.py

@@ -0,0 +1,2 @@
+from pydantic import BaseModel, Field
+

src/apis/models/BaseModel.py

@@ -0,0 +1,17 @@
+from pydantic import BaseModel, Field
+from typing import Optional
+from datetime import datetime
+from src.utils.logger import get_date_time
+
+
+class BaseDocument(BaseModel):
+    created_at: Optional[datetime] = Field(
+        default_factory=lambda: get_date_time().replace(tzinfo=None)
+    )
+    updated_at: Optional[datetime] = Field(
+        default_factory=lambda: get_date_time().replace(tzinfo=None)
+    )
+    expire_at: Optional[datetime] = None
+
+    class Config:
+        arbitrary_types_allowed = True