وضعیت عملیاتی
سلامت سرویس، پوشش دانش و عملکرد هفت روز اخیر
همگام‌سازی دانش
وضعیت فایل فعال در Vector Store
عملکرد هفت روز اخیر
مصرف و کیفیت اجرای مدل
مصرف OpenAI
هزینه و مصرف واقعی سازمان از Usage و Costs API
روند هزینه روزانه
—
مصرف به تفکیک مدل
| مدل | درخواست | ورودی | خروجی | Cache |
|---|
اقلام هزینه
| عنوان | هزینه | سهم |
|---|
بانک پرسش و پاسخ
افزودن، ویرایش و مدیریت محتوای قابل جست‌وجو
| سؤال | دسته‌بندی | وضعیت | آخرین تغییر |
|---|
سؤال‌های بی‌پاسخ
پاسخ را به‌صورت پیش‌نویس آماده کنید، رد کنید یا به FAQ اصلی منتقل کنید.
دستورالعمل‌های مدل
تغییرات از درخواست بعدی اعمال می‌شوند و پیش از ذخیره اعتبارسنجی خواهند شد.
support.md
پشتیبانی اصلی
فایل قبلی به‌طور خودکار پشتیبان‌گیری می‌شود.
open-case.md
پرونده باز
credential یا محتوای نامعتبر ذخیره نخواهد شد.
مدل، اتصال و Agent
پیکربندی OpenAI و کنترل حافظه و رفتار Agent
اتصال OpenAI
کلید و مدل پیش از ذخیره با درخواست واقعی بررسی می‌شوند.
اتصال OpenAI
کلید و مدل پیش از ذخیره با درخواست واقعی بررسی می‌شوند.
تنظیمات گزارش مالی
مبنای محاسبه مانده حساب OpenAI
تنظیمات گزارش مالی
مبنای محاسبه مانده حساب OpenAI
تنظیمات اصلی Agent
حافظه مکالمه، نگهداری History و File Search؛ مناسب استفاده روزمره
تنظیمات اصلی Agent
حافظه مکالمه، نگهداری History و File Search؛ مناسب استفاده روزمره
محیط تست واقعی
اجرای مستقیم همان مسیر واقعی پاسخ‌گویی با متن، تصویر و Platform انتخابی
اجرای آزمایشی Agent
متن یا تصویر را با همان مدل، Instruction و File Search اجرا کنید.
پلتفرم‌های متصل
مدیریت دسترسی مصرف‌کننده‌های API بدون نمایش یا نگهداری کلید خام
| نام | شناسه | وضعیت | کلید API | آخرین تغییر |
|---|
یک درخواست ساده، یک پاسخ قابل پیش‌بینی
هر پلتفرم با کلید اختصاصی خود پیام کاربر را ارسال می‌کند؛ مدیریت مکالمه، حافظه Agent و ارتباط با OpenAI کاملاً داخل مرکز کنترل باقی می‌ماند.
https://support-ai.ozvinoo.xyz
اولین پیام را ارسال کنید
نمونه زبان موردنظر را انتخاب و مقدار کلید و شناسه کاربر را جایگزین کنید.
/v1/messages
curl --request POST \
--url https://support-ai.ozvinoo.xyz/v1/messages \
--header 'Authorization: Bearer <PLATFORM_KEY>' \
--header 'Idempotency-Key: msg-2026-0001' \
--form 'user_id=user-123' \
--form 'message=سلام، چطور می‌توانم سفارشم را پیگیری کنم؟'const form = new FormData();
form.append("user_id", "user-123");
form.append("message", "سلام، چطور می‌توانم سفارشم را پیگیری کنم؟");
const response = await fetch(
"https://support-ai.ozvinoo.xyz/v1/messages",
{
method: "POST",
headers: {
Authorization: "Bearer <PLATFORM_KEY>",
"Idempotency-Key": "msg-2026-0001",
},
body: form,
},
);
const result = await response.json();import httpx
response = httpx.post(
"https://support-ai.ozvinoo.xyz/v1/messages",
headers={
"Authorization": "Bearer <PLATFORM_KEY>",
"Idempotency-Key": "msg-2026-0001",
},
files={
"user_id": (None, "user-123"),
"message": (None, "سلام، چطور می‌توانم سفارشم را پیگیری کنم؟"),
},
timeout=300,
)
result = response.json()ساختار درخواست
بدنه باید با multipart/form-data ارسال شود.
Headers
Authorization
اجباری
کلید اختصاصی Platform با قالب Bearer <PLATFORM_KEY>
Idempotency-Key
پیشنهادی
شناسه یکتای درخواست، بین ۱ تا ۲۵۵ کاراکتر؛ برای retry امن استفاده شود.
Form fields
user_id
string
اجباری
شناسه پایدار کاربر در پلتفرم شما؛ حداکثر ۲۵۵ کاراکتر.
message
string
اختیاری
متن پیام کاربر؛ حداکثر ۲۰٬۰۰۰ کاراکتر.
image
binary
اختیاری
یک فایل JPEG، PNG یا WebP تا سقف ۵ مگابایت.
message یا image
باید ارسال شود. فایل تصویر در سرور ذخیره نمی‌شود.
Platform + user_id شناسایی می‌شود.
ارسال پیام بعدی با همان user_id زنجیره قبلی را با
previous_response_id داخلی ادامه می‌دهد؛ این شناسه
نباید توسط Platform ارسال یا نگهداری شود.
پاسخ موفق
درخواست موفق با HTTP 200 و یک payload کوچک و پایدار برمی‌گردد.
{
"reply": "برای پیگیری سفارش وارد بخش سفارش‌های من شوید.",
"action": "answer",
"request_id": "50de57f3-9c55-4f2f-a2c9-4f415c013e45"
}reply- متن نهایی برای نمایش به کاربر
action-
answer،acknowledgeیاescalate request_id- شناسه رهگیری برای پشتیبانی و مانیتورینگ
escalation_question-
فقط برای
action=escalate؛ شرح مستقل موضوعی که باید برای پشتیبانی انسانی ارسال شود
answer پاسخ معمولی است؛
acknowledge تأیید غیرواقعیاتی بدون ارجاع جدید است؛ و
escalate یعنی کاربر ارجاع انسانی را تأیید کرده است.
در حالت آخر، پاسخ می‌تواند فیلد اختیاری
escalation_question را نیز داشته باشد.
{
"reply": "درخواستت برای بررسی پشتیبانی ثبت شد.",
"action": "escalate",
"request_id": "651dff5d-4be5-43ef-a88b-3bf8f50d2431",
"escalation_question": "آیا Google Voice برای Apple ID قابل استفاده است؟"
}ارسال دوباره، بدون اجرای دوباره
برای هر پیام یک Idempotency-Key یکتا بسازید و هنگام
retry همان مقدار را تکرار کنید.
پیام پردازش و نتیجه با همان کلید برای همان Platform ثبت می‌شود.
نتیجه قبلی بدون هزینه اجرای مجدد OpenAI بازگردانده می‌شود.
استفاده مجدد از کلید برای پیام دیگر، خطای HTTP 409 می‌دهد.
شروع پیام بعدی بدون حافظه زنجیره قبلی
برای یک کاربر مشخص، اتصال به آخرین
previous_response_id را قطع کنید.
/v1/conversations/reset
درخواست
Authorization
اجباری
همان Platform key با قالب
Bearer <PLATFORM_KEY>؛ نشست ادمین جایگزین آن نیست.
user_id
اجباری
دقیقاً همان شناسه‌ای که در /v1/messages استفاده
شده است؛ حداکثر ۲۵۵ کاراکتر.
curl --request POST \
--url https://support-ai.ozvinoo.xyz/v1/conversations/reset \
--header 'Authorization: Bearer <PLATFORM_KEY>' \
--header 'Content-Type: application/json' \
--data '{"user_id":"user-123"}'{
"ok": true,
"conversation_found": true
}user_id در Platformهای دیگر دست‌نخورده می‌ماند.
مقدار conversation_found=false یعنی هنوز مکالمه‌ای برای
این شناسه ثبت نشده است.
خطاهای قابل مدیریت
تمام خطاهای API شامل کد ماشین‌خوان و شناسه رهگیری هستند.
{
"error": {
"code": "rate_limit_exceeded",
"message": "The platform request limit has been exceeded."
},
"request_id": "e2a9d96c-4ea4-48ca-8bc5-0b4bd4ed55ad"
}کلید وجود ندارد یا معتبر نیست.
Platform غیرفعال شده است.
کلید برای محتوای دیگری مصرف شده است.
حجم تصویر بیشتر از ۵ مگابایت است.
بدنه multipart نیست یا تصویر معتبر نیست.
فرمت یا محتوای واقعی تصویر پشتیبانی نمی‌شود.
یکی از فیلدهای ورودی معتبر نیست.
تا زمان Retry-After صبر کنید.
اجرای مدل با خطای موقت مواجه شده است.
سرویس AI موقتاً در دسترس نیست.
تاریخچه مکالمات
پیام‌ها و خلاصه اجرای مدل بدون payload حساس
| کاربر | پیام‌ها | آخرین فعالیت |
|---|
مانیتورینگ و رویدادها
فعالیت مدیر، تاریخچه همگام‌سازی و فایل‌های Vector Store
اجراهای اخیر Sync
فایل‌های Vector Store
گزارش فعالیت
| نوع | عملیات | هدف | اجراکننده | جزئیات | زمان |
|---|
مدیریت مدیران
ساخت حساب و تعیین بخش‌های قابل دسترسی برای هر مدیر
| نام کاربری | Level | دسترسی‌ها | وضعیت | آخرین ورود |
|---|