# بهترین روش‌ها (/docs/best-practices) ## مرور کلی [#مرور-کلی] کیفیت پاسخ‌های موچت به چهار عامل بستگی دارد که در اختیار شماست: دستورالعمل‌هایی که به آن می‌دهید، منابع داده‌ای که با آن‌ها آموزش می‌بیند، مدلی که انتخاب می‌کنید و نحوهٔ اصلاح پاسخ‌ها پس از انتشار. در این صفحه هرکدام را به‌ترتیب بررسی می‌کنیم. این موارد را به‌ترتیب بررسی کنید. بیشتر مشکلات کیفیت به دستورالعمل‌ها و منابع داده مربوط می‌شوند؛ پس پیش از تغییر مدل، آن‌ها را اصلاح کنید. ## دستورالعمل‌های موچت را دقیق‌تر کنید [#دستورالعملهای-موچت-را-دقیقتر-کنید] دستورالعمل‌ها رفتار و پاسخ‌های موچت را شکل می‌دهند. با آن‌ها شخصیت و لحن موچت را تعیین کنید و مشخص کنید به چه نوع پرسش‌هایی می‌تواند پاسخ دهد. دستورالعمل‌های روشن و دقیق، رفتار موچت را با اهداف شما و تجربهٔ کاربر هماهنگ نگه می‌دارند. از منوی موچت وارد **آزمایشگاه** شوید و بخش **دستورالعمل‌ها (پرامپت)** را ویرایش کنید. برای شروع می‌توانید از چنین متنی استفاده کنید:

```text شما دستیار پشتیبانی [نام کسب‌وکار] هستید. به زبان کاربر، روشن و دوستانه پاسخ دهید. برای اطلاعات محصولات، خدمات و قوانین از منابع پایگاه دانش استفاده کنید. اگر سؤال مبهم است، سؤال تکمیلی بپرسید. اگر اطلاعات کافی ندارید، این موضوع را بگویید و از حدس‌زدن خودداری کنید. ```

اگر می‌خواهید موچت فقط بر اساس اطلاعات کسب‌وکارتان پاسخ دهد، این موضوع را صریح بنویسید؛ مثلاً: *«فقط بر اساس اطلاعات موجود در پایگاه دانش پاسخ بده و اطلاعات ناموجود را حدس نزن.»* می‌توانید نمونهٔ زیر را متناسب با کسب‌وکارتان تغییر دهید و استفاده کنید:

```text ### نقش شما دستیار پشتیبانی [نام کسب‌وکار] در زمینهٔ [حوزهٔ فعالیت] هستید. به سؤال‌های مربوط به محصولات، خدمات و قوانین این کسب‌وکار پاسخ دهید. ### لحن و شخصیت دوستانه، محترمانه و روشن بنویسید. پاسخ را به زبان کاربر و متناسب با سؤال او ارائه کنید. ### محدودهٔ پاسخ‌گویی ۱. برای قیمت، ویژگی محصول، زمان ارسال و قوانین فقط از پایگاه دانش استفاده کنید. ۲. اگر پاسخ در منابع نیست، بگویید اطلاعات کافی ندارید و از ساختن پاسخ خودداری کنید. ۳. اگر سؤال مبهم است، پیش از پاسخ‌دادن یک سؤال تکمیلی بپرسید. ۴. اگر موضوع خارج از حوزهٔ کسب‌وکار است، گفتگو را محترمانه به موضوعات مرتبط برگردانید. ```

تغییرات را در گفتگوی آزمایشی بررسی کنید. وقتی از نتیجه راضی بودید، **ذخیره تغییرات نهایی** را بزنید و تأیید کنید تا تنظیمات برای موچت ذخیره شوند. برای آشنایی با این بخش، [راهنمای آزمایش و تنظیم پاسخ‌ها](/build-your-first-ai-agent#fine-tune-settings) را ببینید. ## خوانایی منابع داده را بهتر کنید [#خوانایی-منابع-داده-را-بهتر-کنید] کیفیت پاسخ‌های موچت تا حد زیادی به کیفیت منابع داده‌ای بستگی دارد که در اختیارش می‌گذارید. موچت برای پاسخ‌گویی به جزئیات کسب‌وکارتان به متن روشن و خوانا نیاز دارد؛ بنابراین محتوای صفحه‌های وب و فایل‌ها را پیش از افزودن بررسی کنید. استخراج محتوا از بعضی وب‌سایت‌ها آسان نیست. اگر موچت در پاسخ‌دادن به پرسش‌های مربوط به وب‌سایتتان مشکل دارد، محتوای منبع را بررسی کنید. در صورت نیاز، اطلاعات را با گزینهٔ **متن** وارد کنید یا فایل خوانایی با یکی از فرمت‌های پشتیبانی‌شده، مانند TXT، Markdown یا DOCX، بارگذاری کنید. برای آموزش از فایل، متن باید قابل استخراج باشد. اگر اطلاعات مهم فقط داخل تصویر یا اسکن هستند، متن آن‌ها را جداگانه به پایگاه دانش اضافه کنید. محصول: Widget123؛ رنگ‌ها مشخص نیست، احتمالاً قرمز یا آبی. جزئیات تخفیف نامشخص است. وزن: حدود ۱ کیلوگرم یا ۱٫۵ کیلوگرم؟ ارسال: زمان تحویل معلوم نیست، شاید سریع باشد یا با تأخیر برسد. دسترسی: ارسال جهانی تأیید نشده است. بسته‌بندی: مشخص نیست در جعبه ارائه می‌شود یا خیر. مونتاژ: اطلاعات روشن نیست. موجودی محدود است؟ تأیید نشده. محصول: Widget123\ رنگ‌ها: قرمز، آبی\ تخفیف: ۵۰٪\ وزن: ۱٫۵ کیلوگرم\ ارسال: تحویل در حدود ۱ تا ۲ هفته (بسته به موقعیت مکانی)\ دسترسی: ارسال به سراسر جهان\ بسته‌بندی: در جعبه‌ای با اندازهٔ استاندارد ارائه می‌شود\ مونتاژ: به مقداری مونتاژ نیاز دارد\ همین حالا سفارش دهید: موجودی محدود است، فرصت را از دست ندهید! این محصول یک چیز است. رنگش مشخص نیست و اندازه‌اش معلوم نیست. شاید مفید باشد، اما معلوم نیست. موجودی آن نامشخص است و زمان ارسال ذکر نشده. شاید تخفیف داشته باشد، اما مشخص نشده. راهنمای مونتاژ؟ نامعلوم. زود بخرید؟ مشخص نیست موجودی چه زمانی تمام می‌شود. Widget123 محصولی با کیفیت عالی است که در دو رنگ قرمز و آبی عرضه می‌شود.\ با تخفیف ۵۰٪، خرید آن بسیار مقرون‌به‌صرفه است.\ این محصول ۱٫۵ کیلوگرم وزن دارد و به سراسر جهان ارسال می‌شود.\ بسته به موقعیت مکانی، می‌توانید انتظار داشته باشید سفارش در ۱ تا ۲ هفته تحویل داده شود.\ محصول در جعبه‌ای با اندازهٔ استاندارد ارائه می‌شود و تنها به کمی مونتاژ نیاز دارد.\ زود اقدام کنید؛ موجودی محدود است! ## تصاویر پیشنهادی اضافه کنید [#تصاویر-پیشنهادی-اضافه-کنید] برای نمایش تصویر در پاسخ موچت، از آن بخواهید لینک مستقیم تصویر را در قالب Markdown ارسال کند. آدرس تصویر باید عمومی باشد و بدون نیاز به ورود در مرورگر باز شود. برای نمایش تصویر مرتبط با درخواست کاربر، می‌توانید دستوری مانند نمونهٔ زیر اضافه کنید. آدرس نمونه را با لینک واقعی تصویرتان جایگزین کنید:

```text وقتی کاربر تصویر محصول یا راهنما را می‌خواهد، از لینک معتبر موجود در منابع استفاده کن و تصویر را با این قالب در پاسخ نمایش بده: ![توضیح تصویر](https://example.com/product.jpg) ```

پس از افزودن دستور و لینک تصویر، نتیجه را در آزمایشگاه بررسی کنید: ## مدل هوش مصنوعی مناسب را انتخاب کنید [#مدل-هوش-مصنوعی-مناسب-را-انتخاب-کنید] انتخاب مدل مناسب روی کیفیت و سرعت پاسخ‌ها تأثیر دارد. مدل را متناسب با کاربردتان انتخاب کنید: پاسخ‌گویی به سؤال‌های پرتکرار، توضیح یک موضوع پیچیده و دنبال‌کردن دستورالعمل‌های چندبخشی، نیازهای یکسانی ندارند. در **آزمایشگاه**، از فهرست **مدل هوش مصنوعی** یکی از مدل‌های در دسترس حساب خود را انتخاب کنید. کیفیت پاسخ، سرعت و میزان مصرف اعتبار را در کنار هم بسنجید و با رشد نیازهای کسب‌وکارتان این انتخاب را دوباره بررسی کنید. ### مدل‌ها را با سؤال‌های یکسان مقایسه کنید [#مدلها-را-با-سؤالهای-یکسان-مقایسه-کنید] چند سؤال واقعی مشتریان را با یک مدل آزمایش کنید. سپس مدل را تغییر دهید، **شروع دوبارهٔ تست** را بزنید و همان سؤال‌ها را دوباره بپرسید. این موارد را مقایسه کنید: - کیفیت و دقت پاسخ - زمان و سرعت پاسخ‌گویی - لحن و شخصیت - نحوهٔ پاسخ‌دادن به سؤال‌های خارج از اطلاعات منابع هنگام مقایسهٔ مدل‌ها، منابع، دستورالعمل‌ها و دقت هوش مصنوعی را ثابت نگه دارید. پس از انتخاب مدل مناسب، **ذخیره تغییرات نهایی** را بزنید و تأیید کنید. ## پاسخ‌ها را با بهبود پاسخ و پرسش‌وپاسخ اصلاح کنید [#پاسخها-را-با-بهبود-پاسخ-و-پرسشوپاسخ-اصلاح-کنید] با دو روش می‌توانید پاسخ درست را به پایگاه دانش اضافه کنید تا موچت در پاسخ‌های بعدی از آن استفاده کند. برای **افزودن پرسش‌وپاسخ**، وارد **پایگاه دانش** شوید، یک پایگاه را باز کنید و **اضافه کردن پایگاه داده ← پرسش‌ و پاسخ** را انتخاب کنید. سؤال و پاسخ دقیق آن را بنویسید و **اضافه کردن** را بزنید. این اطلاعات به‌عنوان منبع در اختیار موچت قرار می‌گیرد تا برای پاسخ به پرسش‌های مرتبط از آن استفاده کند. برای **بهبود پاسخ**، وارد **صندوق ورودی** (پیام‌های دریافتی) موچت شوید و گفتگو را باز کنید. زیر پاسخ موچت، **بهبود پاسخ** را بزنید. سؤال را بررسی کنید، پاسخ درست را کامل بنویسید و **ذخیره** را بزنید.

مشاهدهٔ ویدیوی بهبود پاسخ {/* */} اصلاح به‌صورت منبع پرسش‌وپاسخ در پایگاه دانش ذخیره می‌شود و متن پیام قبلی گفتگو تغییر نمی‌کند. پس از تکمیل پردازش منبع، همان سؤال و چند شکل مشابه آن را در آزمایشگاه امتحان کنید. نمایش گزینهٔ **بهبود پاسخ** به امکانات پلن و دسترسی مدیریت صندوق ورودی و پایگاه دانش بستگی دارد. ## قدم‌های بعدی [#قدمهای-بعدی] نقش، لحن و محدودهٔ پاسخ‌گویی موچت را روشن کنید. محتوایی را که موچت از آن یاد می‌گیرد اضافه و مرتب کنید و آموزش دهید. پاسخ مدل‌های در دسترس را با سؤال‌های یکسان بررسی کنید. گفتگوهای مشتریان را دنبال کنید و با اصلاح پاسخ‌ها، کیفیت را بهتر کنید. # ساخت اولین موچت (/docs/build-your-first-ai-agent) ## مرور کلی [#مرور-کلی] تنها در چند دقیقه، یک موچت فعال خواهید داشت که به پرسش‌های مربوط به کسب‌وکارتان پاسخ می‌دهد و با بازدیدکنندگان وب‌سایت گفتگو می‌کند. این مراحل را طی می‌کنیم: موچت را بسازید و وب‌سایت، فایل یا اطلاعات موردنیازش را به پایگاه دانش اضافه کنید. در آزمایشگاه سؤال بپرسید و لحن و کیفیت پاسخ‌ها را تنظیم کنید. کد ویجت را در سایت قرار دهید تا بازدیدکنندگان بتوانند گفتگو را شروع کنند. **زمان تقریبی:** حدود ۵ دقیقه از شروع تا انتشار. ## پیش از شروع [#پیش-از-شروع] برای دنبال‌کردن این راهنما به یک حساب فعال موچت نیاز دارید. اگر هنوز حساب ندارید، [**ثبت‌نام کنید**](https://app.mu.chat/auth/signin). ## مرحلهٔ ۱: ساخت و آموزش موچت [#مرحلهٔ-۱-ساخت-و-آموزش-موچت] ### به داشبورد خود بروید [#به-داشبورد-خود-بروید] در داشبورد روی **ساخت موچت جدید** کلیک کنید. آدرس وب‌سایتتان را وارد کنید و **ادامه** را بزنید تا اطلاعات اولیهٔ کسب‌وکار، لوگو و رنگ برند از سایت دریافت شود. اگر سایت ندارید، **من وب‌سایتی ندارم** را انتخاب کنید؛ اطلاعات را در مرحلهٔ بعد خودتان وارد می‌کنید. صفحهٔ ساخت موچت با فیلد آدرس وب‌سایت و گزینهٔ من وب‌سایتی ندارم

صفحهٔ ساخت موچت با فیلد آدرس وب‌سایت و گزینهٔ من وب‌سایتی ندارم

### تنظیمات اولیه را بررسی کنید [#تنظیمات-اولیه-را-بررسی-کنید] سه صفحهٔ زیر را به‌ترتیب می‌بینید. اطلاعات پیشنهادی را بررسی کنید و در صورت نیاز تغییر دهید. عنوان، توضیحات، رنگ، آواتار و آیکون ویجت را در **نمای موچت** تنظیم کنید. نتیجه را در پیش‌نمایش ببینید و **بنظر خوبه** را بزنید. تنظیم عنوان، توضیحات و رنگ موچت در کنار پیش‌نمایش ویجت

تنظیم عنوان، توضیحات و رنگ موچت در کنار پیش‌نمایش ویجت

لحن، نام بات، صنعت، مخاطب هدف و اطلاعات کسب‌وکارتان را تکمیل کنید. سپس **ذخیره** را بزنید. فرم اطلاعات کسب‌وکار شامل لحن، نام بات، صنعت و مخاطب هدف

در **تنظیمات پرامپت** بنویسید موچت چه نقشی دارد و چطور پاسخ می‌دهد. برای نمونه: > شما دستیار پشتیبانی کسب‌وکار ما هستید. روشن و دوستانه پاسخ دهید. برای اطلاعات محصولات، ارسال و مرجوعی از پایگاه دانش استفاده کنید. اگر اطلاعات کافی ندارید، این موضوع را بگویید و از حدس‌زدن خودداری کنید. **انتشار** را بزنید و در پیام خوش‌آمدگویی، **ادامه دادن** را انتخاب کنید تا وارد پایگاه دانش شوید. ویرایشگر دستورالعمل‌های موچت و دکمهٔ انتشار برای تکمیل ساخت

ویرایشگر دستورالعمل‌های موچت و دکمهٔ انتشار برای تکمیل ساخت

### داده‌های آموزشی خود را انتخاب کنید [#دادههای-آموزشی-خود-را-انتخاب-کنید] موچت برای یادگیری به اطلاعات نیاز دارد. از منوی **پایگاه دانش**، یک پایگاه را باز کنید و **اضافه کردن پایگاه داده** را بزنید. می‌توانید موچت را با منابع دادهٔ مختلف آموزش دهید: فهرست منابع پایگاه دانش و دکمهٔ اضافه کردن پایگاه داده

فهرست منابع پایگاه دانش و دکمهٔ اضافه کردن پایگاه داده

**اسناد خود را بارگذاری کنید** موچت را با اسناد خود آموزش دهید. **فایل** را انتخاب کنید، سند را بارگذاری کنید و **اضافه کردن** را بزنید. فرمت‌های DOCX، MD، TXT، CSV و JSON پشتیبانی می‌شوند. **مناسب برای:** اسناد کسب‌وکار، راهنماها، پرسش‌های متداول و اطلاعات محصول. فرم افزودن فایل به پایگاه دانش با محل بارگذاری، فرمت‌های مجاز و دکمهٔ اضافه کردن

فرم افزودن فایل به پایگاه دانش با محل بارگذاری، فرمت‌های مجاز و دکمهٔ اضافه کردن

**ورود مستقیم متن** محتوای خود را مستقیماً وارد کنید. برای اطلاعاتی که فایل یا صفحهٔ جداگانه ندارند، گزینهٔ **متن** را انتخاب کنید، نام و محتوا را بنویسید و **آموزش متن** را بزنید. **مناسب برای:** ساعات پاسخ‌گویی، معرفی خدمات و اطلاعات آموزشی سفارشی. فرم منبع متنی با نام ساعات پاسخ‌گویی و متن واردشده در ویرایشگر

فرم منبع متنی با نام ساعات پاسخ‌گویی و متن واردشده در ویرایشگر

**اطلاعات وب‌سایت را دریافت کنید** موچت صفحه‌های وب‌سایتتان را پیدا می‌کند تا محتوای موردنیاز را برای آموزش انتخاب کنید. **مناسب برای:** وب‌سایت، مرکز راهنما، صفحه‌های محصول یا نقشهٔ سایت. نوع لینک را روی **وب‌سایت**، **لینک تکی** یا **سایت مپ** بگذارید و آدرس را وارد کنید. با زدن **بعدی**، صفحه‌های پیدا‌شده را بررسی و انتخاب کنید؛ سپس در مرحلهٔ **بررسی**، **همگام‌سازی وب‌سایت** را بزنید. فرم همگام‌سازی وب‌سایت با انتخاب نوع لینک، آدرس سایت و دکمهٔ بعدی

فرم همگام‌سازی وب‌سایت با انتخاب نوع لینک، آدرس سایت و دکمهٔ بعدی

**پرسش‌وپاسخ‌های خودتان را اضافه کنید** سؤال‌های پرتکرار را همراه با پاسخ موردنظرتان ثبت کنید. در **اضافه کردن دستی**، سؤال و جواب را بنویسید و **اضافه کردن** را بزنید. **مناسب برای:** شرایط مرجوعی، روش ارسال و سؤال‌های مشخص مشتریان. برای افزودن چندین پرسش‌وپاسخ، از تب **آپلود فایل** استفاده کنید. فایل CSV باید ستون‌های `question` و `answer` داشته باشد. فرم افزودن پرسش‌وپاسخ با سؤال زمان ارسال و پاسخ واردشده و تب آپلود فایل

فرم افزودن پرسش‌وپاسخ با سؤال زمان ارسال و پاسخ واردشده و تب آپلود فایل

**محتوای وردپرس را متصل کنید** محصولات ووکامرس، صفحه‌ها یا نوشته‌های وردپرس را به پایگاه دانش اضافه کنید. آدرس سایت را وارد کنید، **بعدی** را بزنید و نوع محتوای موردنظر را انتخاب کنید. در پایان، **همگام‌سازی وردپرس** را بزنید. **مناسب برای:** فروشگاه‌های ووکامرسی و سایت‌های وردپرسی. افزونهٔ موچت باید در سایت وردپرسی شما نصب و فعال باشد. برای محصولات، می‌توانید فقط کالاهای موجود یا همهٔ محصولات را انتخاب کنید. فرم اتصال وردپرس با آدرس سایت و مراحل اتصال، محتوا، موجودی و بررسی

فرم اتصال وردپرس با آدرس سایت و مراحل اتصال، محتوا، موجودی و بررسی

**اطلاعات سرویس خود را اضافه کنید** از API سامانهٔ خود به‌عنوان منبع آموزشی استفاده کنید. آدرس دریافت اطلاعات و روش احراز هویت را مشخص کنید، سپس **بررسی لینک‌ها** را بزنید تا اتصال بررسی و منبع اضافه شود. **مناسب برای:** اطلاعات سامانه‌های اختصاصی و فهرست محصولات، با کمک تیم فنی. فرم افزودن منبع API با آدرس سرویس و گزینه‌های بدون احراز هویت، API Key و Bearer Token

فرم افزودن منبع API با آدرس سرویس و گزینه‌های بدون احراز هویت، API Key و Bearer Token

پردازش هر منبع پس از افزودن آن شروع می‌شود. وقتی وضعیت **آموزش تکمیل شده** را دیدید، موچت آمادهٔ آزمایش پاسخ‌ها بر اساس آن منبع است. زمان آماده‌شدن به نوع و حجم اطلاعات بستگی دارد. **محدودیت ذخیره‌سازی:** ظرفیت پایگاه دانش در هر پلن متفاوت است. اگر به سقف مجاز رسیدید، میزان استفاده و محدودیت‌های پلن خود را در داشبورد بررسی کنید. ## مرحلهٔ ۲: آزمایش و بهینه‌سازی موچت [#مرحلهٔ-۲-آزمایش-و-بهینهسازی-موچت] ### وارد آزمایشگاه شوید [#وارد-آزمایشگاه-شوید] پس از آماده‌شدن منابع، از منوی موچت وارد **آزمایشگاه** شوید. سؤال‌هایی شبیه سؤال‌های مشتریان بپرسید و پاسخ‌ها را با اطلاعات کسب‌وکارتان مقایسه کنید. در همین صفحه می‌توانید مدل، دستورالعمل‌ها و دقت هوش مصنوعی را تغییر دهید و نتیجه را آزمایش کنید. آزمایشگاه موچت با تنظیمات مدل و دستورالعمل‌ها در کنار گفتگوی آزمایشی

آزمایشگاه موچت با تنظیمات مدل و دستورالعمل‌ها در کنار گفتگوی آزمایشی

### تنظیمات پاسخ‌گویی را بهتر کنید [#تنظیمات-پاسخگویی-را-بهتر-کنید] **پاسخ‌ها را با مدل‌های مختلف آزمایش کنید** از بین مدل‌های در دسترس، یک مدل انتخاب کنید. پرسش‌های یکسان را با مدل‌های مختلف آزمایش کنید و این موارد را مقایسه کنید: - **کیفیت و دقت پاسخ** - **زمان و سرعت پاسخ‌گویی** - **لحن و شخصیت** - **مدیریت سؤال‌های خارج از اطلاعات منابع** بر اساس این مقایسه، مدلی را انتخاب کنید که با کاربرد موردنظر و لحن برندتان بیشترین هماهنگی را دارد. هر بار یک تنظیم را تغییر دهید و همان سؤال‌ها را دوباره بپرسید. با **شروع دوبارهٔ تست** می‌توانید یک گفتگوی آزمایشی تازه شروع کنید. مشخص کنید موچت چگونه رفتار کند و به کاربران پاسخ دهد. این دستورالعمل‌ها شخصیت، لحن و شیوهٔ مدیریت گفتگو را شکل می‌دهند. **چگونه دستورالعمل‌های مؤثر بنویسیم:** - لحن موچت را مشخص کنید؛ مثلاً حرفه‌ای، دوستانه یا خودمانی. - نقش موچت را مشخص کنید؛ مثلاً جمع‌آوری اطلاعات مشتریان، پشتیبانی یا فروش. - موضوعاتی را که موچت می‌تواند دربارهٔ آن‌ها صحبت کند یا باید از آن‌ها دوری کند، به‌روشنی مشخص کنید. - لحن و شخصیت برندتان را تعریف کنید. - واژه‌های مشخصی را که موچت باید به کار ببرد اضافه کنید. - زبان‌های پاسخ‌گویی را مشخص کنید؛ مثلاً پاسخ‌دادن به زبان کاربر. - هر دستورالعمل دیگری را که می‌خواهید موچت بداند اضافه کنید. مشخص کنید وقتی پاسخ در منابع نیست، موچت چه کند؛ برای مثال، کمبود اطلاعات را بگوید و از حدس‌زدن خودداری کند. این تنظیم میزان تنوع پاسخ‌ها را کنترل می‌کند: - **کم (۰٫۱ تا ۰٫۳):** پاسخ‌های باثبات‌تر و کم‌تنوع‌تر - **متوسط (۰٫۴ تا ۰٫۷):** تنوع متعادل در بیان - **زیاد (۰٫۸ تا ۱):** پاسخ‌های متنوع‌تر و خلاقانه‌تر مقدار پایین‌تر، به‌تنهایی درستی اطلاعات را تضمین نمی‌کند؛ پاسخ‌ها را با منابع خود بسنجید. وقتی از نتیجه راضی بودید، **ذخیره تغییرات نهایی** را بزنید و تأیید کنید. با این کار، تنظیماتی که در آزمایشگاه بررسی کرده‌اید برای موچت ذخیره می‌شوند. ## مرحلهٔ ۳: انتشار در وب‌سایت [#مرحلهٔ-۳-انتشار-در-وبسایت] ### بخش انتشار موچت را باز کنید [#بخش-انتشار-موچت-را-باز-کنید] وقتی از پاسخ‌های موچت راضی بودید، زمان انتشار آن است. از منوی **انتشار موچت**، در کارت **ویجت چت** روی **مدیریت** بزنید. **وضعیت کانال:** برای پاسخ‌گویی به بازدیدکنندگان سایت، کانال ویجت باید فعال باشد. وضعیت آن را پیش از نصب بررسی کنید. ### روش انتشار خود را انتخاب کنید [#روش-انتشار-خود-را-انتخاب-کنید] موچت را می‌توانید به‌صورت حباب شناور یا در یک بخش ثابت از صفحه نمایش دهید. در بالای پیش‌نمایش، **انتشار** را بزنید و **ویجت وب‌سایت** یا **آی‌فریم وب‌سایت** را انتخاب کنید.

منوی انتشار موچت با دو گزینهٔ ویجت وب‌سایت و آی‌فریم وب‌سایت

کد نصب را از پنجرهٔ بازشده کپی کنید. تب‌های **HTML**، **React.js** و **Next.js**، نمونه‌کد مناسب هر روش را در اختیارتان می‌گذارند. پنجرهٔ کد نصب ویجت با تب‌های HTML و React.js و Next.js و دکمهٔ کپی

پنجرهٔ کد نصب ویجت با تب‌های HTML و React.js و Next.js و دکمهٔ کپی

1. به [داشبورد موچت](https://app.mu.chat/dashboard) خود بروید 2. به **تنظیمات فضای کاری** ← **کلیدهای API** بروید 3. روی **ایجاد کلید API** کلیک کنید و کلید تولیدشده را کپی کنید کلید API خود را در محلی امن نگه دارید و هرگز آن را در کد سمت کاربر افشا نکنید. یافتن شناسه ایجنت در تنظیمات موچت

1. ایجنت هوش مصنوعی خود را در داشبورد انتخاب کنید 2. به **تنظیمات** ← **عمومی** بروید 3. **شناسهٔ ایجنت** را از کارت **جزئیات ایجنت** کپی کنید اتصال خود را با یک درخواست گفتگوی ساده آزمایش کنید: ```bash theme={null} curl -X POST 'https://api.mu.chat/api/v2/agents/YOUR_AGENT_ID/chat' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "message": "Hello! How can you help me?", "stream": false }' ``` **پاسخ مورد انتظار:** ```json theme={null} { "data": { "id": "msg_abc123", "role": "assistant", "parts": [ { "type": "text", "text": "Hello! I'm here to help answer your questions and assist with any information you need. What can I help you with today?" } ], "metadata": { "userMessageId": "msg_xyz789", "conversationId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d", "userId": null, "finishReason": "stop", "usage": { "credits": 2 } } } } ``` مقدار پیش‌فرض `stream` در API نسخهٔ ۲ برابر با `true` است. آن را روی `false` تنظیم کنید تا پیام کامل را در قالب یک پاسخ JSON دریافت کنید. موچت تاریخچهٔ گفتگو را ذخیره می‌کند؛ بنابراین نیازی به ارسال دوبارهٔ پیام‌های قبلی ندارید. برای ارسال پیام بعدی، `conversationId` پاسخ قبلی را ارسال کنید: ```bash theme={null} curl -X POST 'https://api.mu.chat/api/v2/agents/YOUR_AGENT_ID/chat' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "message": "Tell me more about your pricing.", "conversationId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d", "stream": false }' ``` برای مرتبط کردن یک گفتگوی جدید با یکی از کاربران خود، `userId` را همراه با اولین پیام ارسال کنید. برای جزئیات، [گفتگوهای کاربر](/api-reference/v2/user-conversations) را ببینید. ### دریافت جریانی در API گفتگو [#دریافت-جریانی-در-api-گفتگو] [API گفتگو](/api-reference/v2/agents/chat-with-an-agent) با استفاده از رویدادهای ارسالی سرور، پاسخ‌ها را به‌صورت جریانی و بی‌درنگ ارسال می‌کند. هر رویداد یک خط `data:` شامل شیء JSON با فیلد `type` است و جریان با `data: [DONE]` پایان می‌یابد. برای ساخت پاسخ کامل، محتوای رویدادهای `text-delta` را به هم بچسبانید و برای ادامهٔ گفتگو، `conversationId` را از رویداد `finish` بخوانید. ```javascript Node.js theme={null} // streamer.js (Node.js 18+) const apiKey = '' const agentId = '' const apiUrl = `https://api.mu.chat/api/v2/agents/${agentId}/chat` async function readAgentReply() { const response = await fetch(apiUrl, { method: 'POST', headers: { Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ message: '', stream: true, // conversationId: '', // omit to start a new conversation }), }) if (!response.ok) { const { error } = await response.json() throw new Error(`${error.code}: ${error.message}`) } const reader = response.body.getReader() const decoder = new TextDecoder() let buffer = '' let conversationId while (true) { const { done, value } = await reader.read() if (done) break buffer += decoder.decode(value, { stream: true }) const lines = buffer.split('\n') buffer = lines.pop() // keep any incomplete line for the next chunk for (const line of lines) { if (!line.startsWith('data: ')) continue const data = line.slice('data: '.length) if (data === '[DONE]') continue const event = JSON.parse(data) switch (event.type) { case 'text-delta': process.stdout.write(event.delta) break case 'finish': conversationId = event.messageMetadata.conversationId break case 'error': console.error('\nStream error:', event.errorText) break } } } console.log('\nConversation ID:', conversationId) } readAgentReply().catch((error) => console.log('Error:', error.message)) ``` ```python Python theme={null} ## streamer.py import json import requests api_key = '' agent_id = '' api_url = f'https://api.mu.chat/api/v2/agents/{agent_id}/chat' def read_agent_reply(): try: headers = { 'Authorization': f'Bearer {api_key}', 'Content-Type': 'application/json' } data = { 'message': '', 'stream': True, # 'conversationId': '', # omit to start a new conversation } response = requests.post(api_url, json=data, headers=headers, stream=True) response.raise_for_status() conversation_id = None for line in response.iter_lines(decode_unicode=True): if not line or not line.startswith('data: '): continue payload = line[len('data: '):] if payload == '[DONE]': continue event = json.loads(payload) if event['type'] == 'text-delta': print(event['delta'], end='', flush=True) elif event['type'] == 'finish': conversation_id = event['messageMetadata']['conversationId'] elif event['type'] == 'error': print(f"\nStream error: {event['errorText']}") print(f'\nConversation ID: {conversation_id}') except requests.exceptions.RequestException as error: print('Error:', error) read_agent_reply() ``` برای فهرست کامل رویدادهای جریان، از جمله رویدادهای اکشن سمت کاربر (فراخوانی ابزار)، [راهنمای دریافت جریانی](/api-reference/v2/streaming) را ببینید. ## مدیریت خطا [#مدیریت-خطا] API نسخهٔ ۲ خطاهای ساختاریافته را همراه با `code` قابل‌خواندن برای ماشین برمی‌گرداند: ```json theme={null} { "error": { "code": "RATE_LIMIT_TOO_MANY_REQUESTS", "message": "Too many requests, please try again later" } } ``` هر پاسخ شامل هدر `x-request-id` است؛ هنگام تماس با پشتیبانی آن را ارائه کنید. برای همهٔ کدهای خطا، [مدیریت خطا](/api-reference/v2/error-handling) و برای محدودیت‌ها و راهنمای تلاش مجدد، [محدودیت نرخ درخواست](/api-reference/v2/authentication#rate-limiting) را ببینید. ## بهترین روش‌ها برای عملکرد بهتر [#بهترین-روشها-برای-عملکرد-بهتر] **راهکارهای بهینه‌سازی:** - برای اینکه کاربران پاسخگویی را سریع‌تر احساس کنند، پاسخ‌های گفتگو را به‌صورت جریانی دریافت کنید - برای پیام‌های بعدی، به‌جای شروع گفتگوی جدید از همان `conversationId` استفاده کنید - در موارد مناسب، پاسخ‌های ایجنت هوش مصنوعی را در حافظهٔ نهان ذخیره کنید - هنگام دریافت پاسخ `429`، هدر `Retry-After` را رعایت کنید - هنگام فهرست کردن گفتگوها، پیام‌ها یا منابع از [صفحه‌بندی](/api-reference/v2/pagination) مبتنی بر مکان‌نما استفاده کنید ## 🚀 آن را به‌صورت زنده امتحان کنید! [#-آن-را-بهصورت-زنده-امتحان-کنید] آماده‌اید امکانات را در عمل ببینید؟ وارد محیط آزمایش تعاملی ما شوید؛ می‌توانید هر نقطهٔ پایانی API را آزمایش کنید، پاسخ‌های واقعی را بررسی کنید و اتصال خود را به‌صورت بی‌درنگ بسازید. آزمایش فوری APIها • بدون نیاز به راه‌اندازی • پاسخ‌های بی‌درنگ • کپی کردن قطعه‌کدهای قابل‌اجرا ### نقاط پایانی کلیدی API [#نقاط-پایانی-کلیدی-api] پیام ارسال کنید و پاسخ‌های هوش مصنوعی را با پشتیبانی از دریافت جریانی دریافت کنید ایجنت‌های هوش مصنوعی را از طریق کد ایجاد، به‌روزرسانی و پیکربندی کنید به تاریخچه چت و پیام‌های گفتگو دسترسی داشته باشید منابع آموزشی را برای ایجنت‌های هوش مصنوعی خود اضافه و مدیریت کنید مرجع کامل API نسخهٔ ۲ را ببینید: احراز هویت، دریافت جریانی، اکشن‌های سمت کاربر، صفحه‌بندی و موارد دیگر # مرور کلی ویژهٔ توسعه‌دهندگان (/docs/developer-guide) ## روش اتصال را انتخاب کنید [#روش-اتصال-را-انتخاب-کنید] ایجنت هوش مصنوعی خود را به‌صورت حباب گفتگو یا سنتر استیج در وب‌سایت جاسازی کنید. با REST API، رابط‌های گفتگوی سفارشی و اتصال‌های سرور به سرور بسازید. با [SDK اندروید](/android-sdk) (آلفا) یا [SDK آی‌اواس](/ios-sdk) (بتا)، ایجنت‌های هوش مصنوعی را به برنامه‌های بومی موبایل اضافه کنید. ایجنت‌های هوش مصنوعی، منابع، گفتگوها و موارد دیگر را از ترمینال یا CI خود مدیریت کنید. ## با قابلیت‌های ویژهٔ توسعه‌دهندگان آشنا شوید [#با-قابلیتهای-ویژهٔ-توسعهدهندگان-آشنا-شوید] اعلان‌های رویدادهای گفتگو را به‌صورت بی‌درنگ دریافت کنید. کلاینت‌های MCP مانند Claude و Cursor را به فضای کاری خود متصل کنید. رابط‌های کاربری غنی و تعاملی را در گفتگوها نمایش دهید. ## الگوهای رایج اتصال [#الگوهای-رایج-اتصال] - [اسکریپت جاسازی](/developer-guide/website-integration/chat-bubble) در صفحه‌های محصول - [تأیید هویت](/developer-guide/website-integration/identity-verification) برای مشتریانی که وارد حساب شده‌اند - [اکشن‌های سفارشی](/developer-guide/website-integration/client-side-custom-actions) برای جستجوی سفارش‌ها و رسیدگی به مرجوعی‌ها - [اسکریپت جاسازی](/developer-guide/website-integration/chat-bubble) به‌عنوان ابزارک راهنمای متناسب با موقعیت کاربر - [شنونده‌های رویداد](/developer-guide/website-integration/chatbot-event-listeners) برای پایش تعامل‌های کاربر - [اکشن‌های سفارشی](/developer-guide/website-integration/client-side-custom-actions) برای راهنماهای آموزشی و مدیریت حساب - [اتصال با API](/developer-guide/api-integration) برای داشبورد داخلی - [تأیید هویت](/developer-guide/website-integration/identity-verification) برای کارکنان - [داده‌های تحلیلی](/user-guides/chatbot/analytics) برای شناخت نحوهٔ استفاده