How-To Guides

ساخت چت‌بات هوش مصنوعی با قابلیت صوتی: یکپارچه‌سازی Whisper و TTS با LangChain

رابط‌های متنی در حال حاضر در منظره برنامه‌های هوش مصنوعی غالب هستند، اما آینده تعامل انسان و کامپیوتر در مکالمات صوتی طبیعی و روان نهفته است. با ترکیب Whisper از OpenAI برای تبدیل دقیق گفتار به متن (STT)، LangChain برای هماهنگ‌سازی منطق مدل‌های زبانی بزرگ (LLM) و یک موتور تبدیل متن به گفتار (TTS)، می‌توانیم چت‌بات‌هایی بسازیم که واقعاً زنده به نظر برسند. این راهنما شما را در معماری و پیاده‌سازی چنین سیستمی همراهی می‌کند، با تمرکز بر بهینه‌سازی تأخیر (Latency) و یکپارچه‌سازی قابل اعتماد.

درک معماری

قبل از ورود به کد، درک جریان داده بسیار حیاتی است. یک ربات با قابلیت صوتی معمولاً از یک خط لوله چهار مرحله‌ای پیروی می‌کند:

  1. دریافت صدا: ضبط ورودی کاربر از یک میکروفون یا فایل صوتی.
  2. نسخه‌برداری (Transcription): تبدیل بایت‌های خام صوتی به متن با استفاده از Whisper.
  3. استدلال (Reasoning): پردازش متن از طریق LangChain برای تولید پاسخی آگاه از بافت (Context-aware).
  4. ترکیب (Synthesis): تبدیل متن تولید شده به صدا با استفاده از یک سرویس TTS.

چالش اصلی در اینجا تأخیر (Latency) است. کاربران انتظار پاسخ‌های بلادرنگ را دارند. بنابراین، قابلیت‌های پخش زنده (Streaming) در هر دو Whisper و ارائه‌دهنده LLM ضروری هستند. علاوه بر این، مدیریت خطا برای ورودی‌های ساکت یا صداهای غیرگفتاری باید محکم باشد تا از حلقه‌های بی‌نهایت جلوگیری شود.

راه‌اندازی محیط

مطمئن شوید که Python 3.9+ نصب شده است. کتابخانه‌های مورد نیاز را از طریق pip نصب کنید:


pip install openai-whisper langchain langchain-openai gtts soundfile

نکته: اگرچه gtts (Google Text-to-Speech) در اینجا برای سادگی و استفاده رایگان استفاده شده است، اما برنامه‌های تولیدی ممکن است برای وفاداری بالاتر، از OpenAI TTS یا Azure Speech Services ترجیح دهند.

پیاده‌سازی: خط لوله اصلی

در زیر یک نمونه فشرده برای نشان دادن یکپارچه‌سازی آورده شده است. در یک محیط تولیدی، این مراحل را در یک چارچوب ناهمگام مانند FastAPI پیچیده می‌کنید تا کاربران متعدد را به صورت همزمان مدیریت کنید.


import whisper
from langchain_openai import ChatOpenAI
from langchain_core.messages import HumanMessage, SystemMessage
import gtts
import io

# بارگذاری مدل Whisper یک بار برای کارایی
model = whisper.load_model("base")

# راه‌اندازی LLM در LangChain
llm = ChatOpenAI(model="gpt-4o-mini", temperature=0.7)

def transcribe_audio(audio_file_path: str) -> str:
    """
    از Whisper برای تبدیل فایل صوتی به متن استفاده می‌کند.
    """
    result = model.transcribe(audio_file_path)
    return result['text'].strip()

def generate_response(user_input: str, chat_history: list) -> str:
    """
    متن نسخه‌برداری شده و تاریخچه را به LLM ارسال می‌کند.
    """
    system_prompt = "You are a helpful voice assistant. Keep your responses concise and conversational."
    
    messages = [
        SystemMessage(content=system_prompt),
        *chat_history,
        HumanMessage(content=user_input)
    ]
    
    response = llm.invoke(messages)
    return response.content

def synthesize_speech(text: str, output_file_path: str) -> None:
    """
    متن را به MP3 با استفاده از gTTS تبدیل می‌کند.
    """
    tts = gtts.TTS(text=text, lang='en')
    tts.save(output_file_path)

# جریان اجرای اصلی
if __name__ == "__main__":
    # شبیه‌سازی ورودی صوتی (در واقعیت، این از یک جریان میکروفون می‌آید)
    audio_path = "user_input.wav"
    
    # 1. نسخه‌برداری
    print("Processing audio...")
    text_input = transcribe_audio(audio_path)
    print(f"User said: {text_input}")

    if not text_input:
        print("No speech detected.")
        exit()

    # 2. تولید پاسخ
    print("Thinking...")
    chat_history = [] # در یک اپلیکیشن واقعی، این ذخیره‌سازی می‌شود
    bot_response = generate_response(text_input, chat_history)
    print(f"Bot says: {bot_response}")

    # 3. ترکیب
    print("Generating audio...")
    output_path = "bot_response.mp3"
    synthesize_speech(bot_response, output_path)
    print(f"Audio saved to {output_path}")

بهینه‌سازی‌ها برای تولید

برای اینکه این سیستم برای تعامل بلادرنگ قابل اجرا باشد، این تکنیک‌های پیشرفته را در نظر بگیرید:

۱. پخش زنده Whisper (Streaming Whisper)

Whisper استاندارد کل فایل صوتی را پردازش می‌کند. برای مکالمات زنده، شما به پردازش تکه‌ای (Chunked processing) نیاز دارید. کتابخانه‌هایی مانند whisper-streaming یا استفاده از جریان‌های صوتی WebRTC به شما امکان می‌دهند صدا را در حال صحبت نسخه‌برداری کنید که به طور قابل توجهی زمان تا اولین توکن (TTFT) را کاهش می‌دهد.

۲. کش و مدیریت بافت (Context)

LLM‌ها گران هستند. یک پایگاه داده برداری را از طریق LangChain پیاده‌سازی کنید تا فقط بافت‌های مرتبط را در صورت نیاز بازیابی کند، به جای ارسال کل تاریخچه چت در هر بار. از Redis برای حافظه جلسه کوتاه‌مدت استفاده کنید تا تیرهای اخیر سریع باقی بمانند.

۳. بهینه‌سازی فرمت صوتی

همیشه ورودی صوتی خود را به 16kHz تک‌کاناله (Mono) نرمال کنید قبل از ارسال آن به Whisper. این فرمت استاندارد زمان پیش‌پردازش را به حداقل می‌رساند و دقت نسخه‌برداری یکسان را در میکروفون‌های مختلف تضمین می‌کند.

مدیریت موارد حاشیه‌ای (Edge Cases)

رابط‌های صوتی با چالش‌های منحصربه‌فردی در مقایسه با متن مواجه هستند:

  • سر و صدای پس‌زمینه: Whisper محکم است، اما محیط‌های بسیار پر سر و صدا می‌توانند باعث توهم (Hallucinations) شوند. یک تشخیص‌دهنده فعالیت صدا (VAD) مانند Silero VAD را پیاده‌سازی کنید تا دوره‌های ساکت را قبل از نسخه‌برداری فیلتر کند.
  • مدیریت قطع شدن (Interruption Handling): اگر کاربر در حالی که ربات در حال پخش TTS است صحبت کند، به یک مکانیزم بارج-این (Barge-in) نیاز دارید. این نیاز به پایش بلادرنگ صدا دارد که می‌تواند پخش TTS را فوراً متوقف کند.
  • اصلاح خطا: اگر اطمینان نسخه‌برداری پایین باشد، LLM باید برای شفاف‌سازی بپرسد به جای حدس زدن. می‌توانید امتیاز اطمینان از Whisper را به بافت پرامپت (Prompt) منتقل کنید.

نتیجه‌گیری

یکپارچه‌سازی Whisper، LangChain و TTS یک پایه قدرتمند برای برنامه‌های هوش مصنوعی اولویت‌دار صوتی ایجاد می‌کند. اگرچه خط لوله پایه ساده است، اما تفاوت بین یک دمو و یک سیستم آماده تولید در مدیریت تأخیر، مدیریت خطای محکم و بهینه‌سازی بافت نهفته است. در حالی که مدل‌های گفتاری در دقت و سرعت ادامه می‌دهند، آستانه ورود برای توسعه رابط‌های صوتی طبیعی از هر زمان کمتر است. با رویکرد ماژولار توصیف شده در بالا شروع کنید، به طور کامل با نمونه‌های صوتی مختلف آزمایش کنید و بر متریک‌های تأخیر خود تکرار کنید. نسل بعدی دستیارهای هوش مصنوعی فقط گوش نخواهند داد—they will understand, respond, and feel human.

Share: