chatbox2 / USAGE_GUIDE.md
anaspro
update
55612d9

A newer version of the Gradio SDK is available: 6.1.0

Upgrade

Qwen3-14B Chatbot - Quick Usage Guide

๐ŸŽฏ Three Ways to Control Thinking Mode

1. Hard Switch: Enable Thinking Mode Checkbox

Located in the sidebar, this is the main control:

  • โœ… Checked (ON): Thinking mode is available

    • Model can show reasoning process
    • Supports /think and /no_think soft switches
    • Best for: Math, coding, complex reasoning
    • Parameters: Temp=0.6, TopP=0.95, TopK=20
  • โŒ Unchecked (OFF): Thinking mode is disabled

    • No thinking process shown
    • Faster responses
    • Soft switches are ignored
    • Best for: General chat, quick questions
    • Parameters: Temp=0.7, TopP=0.8, TopK=20

2. Soft Switch: /think Tag

Force thinking for a specific message (only works when checkbox is ON):

User: How many r's are in "strawberry"? /think

Result:

๐Ÿค” Thinking Process:
Let me count each letter carefully:
s-t-r-a-w-b-e-r-r-y
The r's appear at positions 3, 8, and 9.

๐Ÿ’ฌ Response:
There are 3 r's in the word "strawberry".

3. Soft Switch: /no_think Tag

Skip thinking for a specific message (only works when checkbox is ON):

User: What is 2+2? /no_think

Result:

๐Ÿ’ฌ Response:
2+2 equals 4.

๐Ÿ“Š Comparison Table

Feature Checkbox ON + /think Checkbox ON + /no_think Checkbox ON (default) Checkbox OFF
Shows thinking โœ… Yes โŒ No โœ… Yes โŒ No
<think> tags โœ… With content โš ๏ธ Empty โœ… With content โŒ None
Speed ๐Ÿข Slower ๐Ÿš€ Faster ๐Ÿข Slower ๐Ÿš€ Fastest
Best for Complex problems Quick answers Reasoning tasks General chat

๐Ÿ’ก Real-World Examples

Example 1: Math Problem (Use Thinking)

User: Solve: If x^2 + 5x + 6 = 0, what are the values of x? /think

Bot:
๐Ÿค” Thinking Process:
This is a quadratic equation. I can solve it by factoring:
x^2 + 5x + 6 = 0
(x + 2)(x + 3) = 0
So x + 2 = 0 or x + 3 = 0
Therefore x = -2 or x = -3

๐Ÿ’ฌ Response:
The values of x are -2 and -3.

Example 2: Quick Fact (Skip Thinking)

User: What is the capital of Iraq? /no_think

Bot:
๐Ÿ’ฌ Response:
The capital of Iraq is Baghdad (ุจุบุฏุงุฏ).

Example 3: Multi-Turn Conversation

User: How many r's in "strawberry"? /think
Bot: ๐Ÿค” [shows counting process] ๐Ÿ’ฌ There are 3 r's.

User: What about "blueberry"? /no_think
Bot: ๐Ÿ’ฌ There are 2 r's in "blueberry".

User: Are you sure? /think
Bot: ๐Ÿค” [recounts carefully] ๐Ÿ’ฌ Yes, confirmed: 2 r's in "blueberry".

๐ŸŽ“ Best Practices

โœ… DO Use Thinking Mode For:

  • ๐Ÿงฎ Math equations and calculations
  • ๐Ÿ’ป Code generation and debugging
  • ๐Ÿงฉ Logic puzzles and riddles
  • ๐Ÿ“Š Data analysis questions
  • ๐Ÿ” Complex reasoning tasks
  • ๐Ÿ“ Step-by-step explanations

โŒ DON'T Use Thinking Mode For:

  • ๐Ÿ’ฌ Simple greetings
  • โ“ Basic factual questions
  • ๐ŸŽจ Creative writing
  • ๐Ÿ—ฃ๏ธ Casual conversation
  • โšก When you need quick responses

โš™๏ธ Settings Explained

System Prompt

Customizes the AI's personality and language style.

Default (Iraqi Arabic):

ุงู†ุช ู…ูˆุฏูŠู„ ุนุฑุงู‚ูŠ ุฐูƒูŠ ู…ู† ุจุบุฏุงุฏ. ุชุชุญุฏุซ ุจุงู„ู„ู‡ุฌุฉ ุงู„ุนุฑุงู‚ูŠุฉ ูู‚ุท...

English Alternative:

You are a helpful AI assistant. Provide clear, detailed answers.

Max New Tokens

Controls response length (100 - 32,768 tokens).

  • 512: Short answers
  • 2,048: Standard (default)
  • 8,192: Long explanations
  • 32,768: Maximum (for very complex problems)

๐Ÿ› Troubleshooting

Issue: Soft switches not working

Solution: Make sure "Enable Thinking Mode" checkbox is ON

Issue: Empty thinking blocks

Cause: You used /no_think or the model decided not to think Solution: This is normal behavior; use /think to force thinking

Issue: Responses too slow

Solution:

  1. Disable thinking mode checkbox, OR
  2. Use /no_think for specific messages, OR
  3. Reduce Max New Tokens

Issue: Not enough detail in responses

Solution:

  1. Enable thinking mode checkbox
  2. Use /think tag
  3. Increase Max New Tokens
  4. Adjust system prompt for more detailed responses

๐Ÿš€ Quick Start Checklist

  1. โœ… Open the chatbot interface
  2. โœ… Check if "Enable Thinking Mode" is ON (for complex tasks) or OFF (for chat)
  3. โœ… Adjust "Max New Tokens" based on expected response length
  4. โœ… (Optional) Customize System Prompt
  5. โœ… Type your message
  6. โœ… (Optional) Add /think or /no_think at the end
  7. โœ… Press Enter and wait for response

๐Ÿ“š Additional Resources


๐Ÿ’ฌ Need Help?

If you encounter issues or have questions:

  1. Check the CHANGES.md file for detailed technical information
  2. Review the examples above
  3. Experiment with different settings
  4. Read the official Qwen3 documentation

Happy chatting! ๐ŸŽ‰