API گفتگو

مرور کلیکپی پیوند عنوان

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

ایجاد کلید APIکپی پیوند عنوان

ارسال پیامکپی پیوند عنوان

درخواست POST /v2/chat را با هدر Authorization: Bearer بفرستید. این نمونه منتظر پاسخ نهایی JSON می‌ماند:

curl --request POST 'https://api.mu.chat/v2/chat' \
  --header "Authorization: Bearer $MUCHAT_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"query":"سلام","stream":false}'

متن پاسخ در data.message.parts قرار دارد. هر بخش متنی، type برابر text دارد و متن آن در text است. اطلاعات مکالمه و نتیجهٔ پاسخ‌گویی را در data.metadata بخوانید:

ادامهٔ گفتگو و تلاش مجددکپی پیوند عنوان

برای پیام بعدی، conversation_id پاسخ قبلی را همراه query تازه در بدنه بفرستید. پیش از ارسال پیام بعدی، منتظر پایان درخواست قبلی بمانید؛ گفتگو با پاسخ در حال تولید، پیام هم‌زمان دیگری نمی‌پذیرد.

• برای هر پیام منطقی می‌توانید یک external_message_id یکتا تعیین کنید. اگر همان درخواست را دوباره می‌فرستید، همان شناسه و بدنه را نگه دارید تا پیام تکراری ساخته نشود.
• استفاده از همان شناسه با متن یا بدنهٔ متفاوت، خطای تعارض می‌دهد. برای پیام تازه، شناسهٔ تازه بسازید.
• بدون conversation_id، پیام را به‌عنوان شروع گفتگو در نظر بگیرید. برای ادامهٔ مکالمه، شناسهٔ برگشتی را ذخیره کنید.
• اگر message خالی است یا نتیجه suppressed است، متن ساختگی به کاربر نشان ندهید؛ وضعیت توقف هوش مصنوعی و ارجاع را بررسی کنید.

رفع مشکلکپی پیوند عنوان

برای آزمون، ابتدا یک پیام بفرستید، سپس با شناسهٔ برگشتی پیام دوم را ادامه دهید و ثبت همان گفتگو را در اینباکس بررسی کنید. حذف اتصال API، کلید آن را از دسترس درخواست‌های بعدی خارج می‌کند.

قدم‌های بعدیکپی پیوند عنوان