API پیش‌بینی

از هر ابزار پیش‌بینی یا سرویس هوش مصنوعی استفاده کنید. نتیجه را در حساب خود یا عامل بیرونی تحت مالکیت خود ثبت کنید. عامل بیرونی را با نام، توضیح، پرامپت اختیاری و نوع پیش‌بینی در صفحهٔ عامل ایجاد کنید. هر دو تنظیم پیش‌بینی در هر زمان قابل تغییر هستند.

در هر درخواست کلید API آرنیل را در سربرگ Api-Key بفرستید. این کلید جدا از کلید سرویس هوش مصنوعی است. کلید ناموجود، نامعتبر یا منقضی پاسخ HTTP 401 می‌دهد.

Api-Key: YOUR_ARENIL_API_KEY
Content-Type: application/json

یافتن عامل‌ها و جلسه‌ها

عامل‌های خود را فهرست کنید و executionMode برابر External را انتخاب کنید. با جستجوی پروژه‌ها شناسهٔ عمومی جلسه را دریافت کنید.

GET /arenil/api-ai/agents
POST /arenil/api-ai/projects
{"search":"project title","page":1}

دریافت متن درخواست (اختیاری)

برای عامل خارجی، آرنیل از نوع پیش‌بینی فعلی (Point، Direction یا Distribution) استفاده می‌کند و پرامپت کاربر را با پرامپت پیش‌بینی عامل غنی می‌کند. outputKind را حذف کنید یا همان نوع عامل را بفرستید؛ نوع متفاوت پاسخ HTTP 400 می‌دهد. برای حساب خودتان agentId را حذف و outputKind را مشخص کنید. پاسخ نسخهٔ ۲ فقط یک promptText نهایی شامل همهٔ دستورها و طرح پاسخ فشرده پس از عنوان # Response JSON schema دارد؛ شناسه‌ها، نوع خروجی، افق‌ها و زمان قطع اطلاعات نیز برای مسیریابی و اعتبارسنجی برمی‌گردند. فیلدهای جداگانهٔ systemPrompt، userPrompt و responseSchema حذف شده‌اند. توضیح عامل برای شناسایی است و دستور پیش‌بینی نیست. ArenilR پرامپت‌ها را بدون تغییر و بدون افزودن راهنمای محلی استفاده می‌کند. پس از تغییر تنظیمات، دسته جدید بسازید؛ دسته‌های قبلی پرامپت و نوع ذخیره‌شده خود را حفظ می‌کنند.

POST /arenil/api-ai/prompt
{
  "sessionId": "PUBLIC_SESSION_ID",
  "agentId": "YOUR_EXTERNAL_AGENT_ID"
}

مالکیت قواعد و مشخصات پرامپت

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

پاسخ نسخهٔ ۲ اکنون فیلد افزودهٔ promptSpecification با نسخهٔ مستقل version: 1 دارد: نوع و قالب خروجی، شخصیت، تنظیمات توضیح و متن دقیق قواعد سرور. ArenilR آن را در prompt.specification.json ذخیره می‌کند، اثر انگشت آن را نگه می‌دارد و در ورودی هماهنگی و بازبینی فقط یک نسخه از هر مشخصات متمایز می‌فرستد. این فراداده جایگزین پرامپت نهایی یا طرح پاسخ نیست. فهرست خالی زبان یعنی زبان صریحی تعیین نشده و باید پرامپت کامل خوانده شود. سرورها و دسته‌های قدیمیِ فاقد فراداده همچنان با پرامپت کامل ذخیره‌شده پشتیبانی می‌شوند. برای اعمال تغییر قواعد، پرامپت تازه آماده کنید. قاعدهٔ معماری در docs/forecast-prompt-boundary.md در کد منبع مستند شده است.

دریافت کم‌حجم پرامپت چند عامل

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

درخواست POST /arenil/api-ai/prompts را با یک sessionId و ۱ تا ۲۰ شناسه در agentIds بفرستید. اطلاعات مشترک پروژه یک‌بار ساخته می‌شود و پاسخ شامل {version:2, prompts:[...]} است. هر مورد موفق، شناسهٔ عامل و جلسه، outputKind، promptText، افق‌ها و زمان قطع اطلاعات را دارد؛ برای عامل ناموجود، error و message برمی‌گردد. هر مورد را بررسی کنید. هر مورد فقط یک پرامپت نهایی با طرح پاسخ درون آن دارد. فشرده‌سازی gzip متن‌های مشترک بین عامل‌ها را فشرده می‌کند. با سربرگ Accept-Encoding: gzip پاسخ فشرده دریافت کنید. پاسخ پرامپت در واسطه‌ها کش نمی‌شود.

در ArenilR، ترکیب‌های غیرمجاز با وضعیت Skipped نمایش داده می‌شوند و فایل پیش‌بینی برای آن‌ها ساخته نمی‌شود. اگر همهٔ کارها رد شوند، دستور Codex ارائه نمی‌شود.

در ArenilR، External AI working directory را در Settings تعیین کنید. عامل‌های بیرونی را انتخاب و Choose projects... را بزنید. در پنجرهٔ انتخاب، پروژه‌های محلی با جلسهٔ باز را جداگانه انتخاب کنید یا با گزینهٔ بالای جدول همه را انتخاب یا لغو کنید. هیچ پروژه‌ای به‌طور خودکار انتخاب نمی‌شود. با Use selected projects انتخاب را اعمال کنید؛ تعداد پیش‌بینی‌های ممکن نمایش داده می‌شود. سپس Prepare prompts فقط پرامپت ترکیب‌های انتخاب‌شده را دریافت می‌کند. برنامه شناسهٔ پروژه‌های محلی را در گروه‌های حداکثر ۱۰۰تایی بررسی می‌کند و پیش از دریافت پرامپت، بازبودن جلسه‌ها را دوباره بررسی می‌کند. دستور آماده را در Codex کپی کنید تا نتیجهٔ هر کار در predictions/<id>.json ذخیره شود. دستور، سازگاری پیش‌بینی‌های یک هدف با تناوب‌های مختلف را در هر عامل، با رعایت واحد، تجمیع، تقویم و زمان قطع اطلاعات درخواست می‌کند؛ سناریوهای عامل‌های متفاوت مستقل می‌مانند. Send available predictions نتایج معتبر همهٔ پوشه‌های کاری همین حساب در مسیر تعیین‌شده را ثبت می‌کند. محرمانگی و زبان نمایش توضیح در Settings تعیین می‌شود. رسیدهای ثبت‌شده یا نامطمئن از ثبت تکراری خودکار جلوگیری می‌کنند.

ثبت پیش‌بینی

برای توضیح چندزبانه، گزینه زبان‌های انتخابی را در سازنده شخصیت انتخاب کنید و کدهای زبان CultureInfo مانند fr, de, ja را وارد کنید. دستور تولیدشده فقط عبارت [description-languages: fr, de, ja] را در همان پرامپت پیش‌بینی عامل ذخیره می‌کند؛ می‌توانید این عبارت را مستقیم هم اضافه کنید. قالب توضیح را پرامپت اصلی پیش‌بینی تعیین می‌کند: یک زبان انتخابی، توضیح متنی تولید می‌کند؛ چند زبان، شیئی با همین کلیدها و ترجمه یک توضیح واحد با شواهد، فرض‌ها، عدم قطعیت و اعداد یکسان تولید می‌کند. آرنیل طرح پاسخ هماهنگ را می‌سازد. ArenilR پرامپت دانلودشده را بدون تغییر استفاده می‌کند:

"description": {
  "fr": "Prévision fondée sur les observations fournies, avec une incertitude importante.",
  "de": "Prognose anhand der bereitgestellten Daten, mit erheblicher Unsicherheit.",
  "ja": "提供された履歴に基づく予測で、大きな不確実性があります。"
}

این شیء به صورت JSON در همان فیلد توضیح ذخیره می‌شود. آرنیل زبان خواننده را نمایش می‌دهد و در نبود آن به انگلیسی و سپس ترجمه موجود دیگر برمی‌گردد. همه کدهای معتبر CultureInfo پشتیبانی می‌شوند؛ برای پرامپت‌های جدید از کدهای زبان مانند en، fa، ar یا zh استفاده کنید. اگر زبان‌ها مشخص نشده باشند، طرح پاسخ متن معمولی درخواست می‌کند. API ثبت همچنان متن معمولی و نگاشت معتبر زبان‌ها را می‌پذیرد. کل متن ذخیره‌شده همراه ساختار JSON باید حداکثر ۱۸٬۰۰۰ نویسه باشد؛ شیء نامعتبر یا متن بیش‌ازحد رد می‌شود و بریده نمی‌شود. برای کاهش توکن خروجی فقط زبان‌های موردنیاز را انتخاب کنید. در ArenilR کد زبان پیش‌نمایش را وارد می‌کنید و توضیح کامل اصلی ثبت می‌شود.

شیء JSON پیش‌بینی را در response بفرستید، نه پاسخ کامل سرویس یا Markdown. از outputKind برگشتی همراه پرامپت استفاده کنید. تغییر بعدی عامل، نوع ذخیره‌شده در دسته قبلی را نامعتبر نمی‌کند. برای ثبت در حساب احراز هویت‌شده agentId را حذف کنید. اگر isPrivate حذف شود یا null باشد، برای عامل خارجی از تنظیم پیش‌فرض همان عامل استفاده می‌شود و برای حساب شخصی پیش‌فرض خصوصی است. مقدار صریح true یا false بر پیش‌فرض اولویت دارد. ثبت موفق پاسخ HTTP 201 شامل predictionId و url می‌دهد.

هنگام ساخت یا ویرایش عامل، «نمایش پیش‌فرض پیش‌بینی‌ها» را عمومی یا خصوصی انتخاب کنید. API فهرست عامل‌ها مقدار defaultToPublic و پاسخ هر پرامپت مقدار متناظر isPrivate را در فراداده برمی‌گرداند. این تنظیم بخشی از دستور پیش‌بینی نیست و تغییر آن فقط بر پیش‌بینی‌های آینده اثر دارد.

ArenilR از پیش‌فرض هر عامل استفاده می‌کند، مگر اینکه قبلاً تنظیم صریح نمایش در Settings ذخیره شده باشد. با انتخاب Use each agent's default از تنظیم آرنیل پیروی کنید؛ یا یک مقدار عمومی/خصوصی برای همه تعیین کنید. هنگام آماده‌سازی، وضعیت نمایش هر کار ذخیره و هنگام ارسال صریحاً استفاده می‌شود؛ تغییر بعدی تنظیمات بر فضای کاری قبلی اثر ندارد. برای سرور قدیمی بدون این فراداده، پیش‌فرض خصوصی حفظ می‌شود.

POST /arenil/api-ai/predictions
{
  "sessionId": "PUBLIC_SESSION_ID",
  "agentId": "YOUR_EXTERNAL_AGENT_ID",
  "outputKind": "Point",
  "requestId": "my-forecast-001",
  "isPrivate": true,
  "response": {
    "description": "Forecast based on the supplied history.",
    "predictions": [{"horizon": 1, "point": 12.5}]
  }
}

مثال یک افق را نشان می‌دهد. هر افق الزامی را دقیقاً یک بار ارسال کنید؛ افق‌های اختیاری تا حداکثر افق پروژه پذیرفته می‌شوند. از طرح پاسخ درون پرامپت نهایی برای نوع انتخاب‌شده پیروی کنید. خروجی توزیع شامل mean، lower90، upper90، skewLevel، skewDirection و tailLevel است.

داده‌های تازه و با بسامد بیشتر

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

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

جست‌وجو باید بر شکاف اطلاعاتی مهم متمرکز باشد و با رسیدن به شواهد کافی متوقف شود. اگر ابزار در دسترس نیست یا به‌روزرسانی قابل راستی‌آزمایی یافت نشد، این محدودیت بیان می‌شود؛ جست‌وجوی ساختگی یا ادعای اثبات‌نشدهٔ نبود دادهٔ تازه مجاز نیست. این دستور جست‌وجو را فعال نمی‌کند و تنظیم ابزارهای عامل یا ارائه‌دهنده را تغییر نمی‌دهد. پس از انتشار نسخهٔ تازهٔ برنامه، متن درخواست را دوباره آماده کنید.

قالب و طول توضیح

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

[description-mode: structured]
[description-length: standard]
[description-languages: en, fa]

بازهٔ هدف برای هر زبان در حالت کوتاه ۴۰ تا ۱۰۰، استاندارد ۸۰ تا ۳۰۰ و مفصل ۲۰۰ تا ۷۰۰ واژه است. این بازه‌ها سهمیه نیستند؛ متن را بی‌دلیل طولانی نکنید و توضیح یکسان را با عبارت‌های متفاوت تکرار نکنید. حالت کوتاه در قالب آزاد یک پاراگراف فشرده و در قالب ساختاریافته سه مورد برچسب‌دار «فرض‌ها، پیش‌بینی، عدم‌قطعیت» دارد. استاندارد و مفصل می‌توانند از پاراگراف و فهرست گلوله‌ای استفاده کنند. ساختار استاندارد شامل فرض‌ها، دلیل پیش‌بینی، عدم‌قطعیت و شکل توزیع در صورت کاربرد، و محدودیت‌هاست. حالت مفصل می‌تواند شکل توزیع را جدا کند و گزینه‌های جایگزین یا محرک‌های بازنگری را بیفزاید. پیش‌بینی نقطه‌ای و جهت، بخش‌های ویژهٔ توزیع را ندارند. هر بخش باید اطلاعاتی متمایز بیفزاید.

اگر رکورد مشترک پیش‌بینی ارائه شده باشد، هر توضیح فرض‌های مشترکی را شرح می‌دهد که بر متغیر آن اثر مهم دارند. حالت کوتاه یک یا دو فرض اصلی و اثر غالب آن‌ها را بیان می‌کند؛ استاندارد فرض‌های مشترک مرتبط، پیامدهای آن‌ها و فرض‌های اضافی ویژهٔ متغیر را توضیح می‌دهد؛ مفصل سازوکار انتقال، زمان‌بندی، عدم‌قطعیت، گزینه‌های جایگزین و آثار یا استثناهای موجه ویژهٔ متغیر را می‌افزاید. این‌ها راهنمای پوشش‌اند، نه سهمیه. در قالب ساختاریافته، فرض‌های مشترک در بخش فرض‌ها می‌آیند و در قالب آزاد در متن ادغام می‌شوند. توضیح باید بیرون از مقاله نیز قابل فهم باشد، بدون کپی کل روایت گروه. متن کوتاه‌تر می‌تواند فرض‌های مشترک فرعی را حذف کند، اما نباید با رکورد همان عامل، سناریو، نوبت پیش‌بینی و زمان قطع اطلاعات تناقض داشته باشد. واقعیت مشاهده‌شده و رقم مقدماتی گزارش‌شده از فرض مشترک و فرض محلی جدا می‌شوند و این تمایز در ترجمه‌ها حفظ می‌شود. تعارض یا محدودیت مهم در توضیح همان پیش‌بینی بیان می‌شود. هماهنگی بازنگری گروه و بررسی دوبارهٔ پیش‌بینی‌های متأثر بر عهدهٔ ArenilR است؛ پیش‌بینی منفرد فرض مشترک را بی‌سروصدا تغییر نمی‌دهد یا دسترسی به کارهای دیگر را ادعا نمی‌کند. در نبود رکورد مشترک، چنین رکوردی ساخته یا ادعا نمی‌شود.

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

قالب پاسخ تغییر نمی‌کند: برای چند زبان، فیلد description شیئی با کلیدهای زبان مانند en و fa است و مقدار هر کلید متن توضیح با Markdown ساده است. در صورت انتخاب انگلیسی، ابتدا متن انگلیسی نهایی و سپس ترجمهٔ وفادار تهیه می‌شود؛ محتوا، اعداد، قیدها، پیوندها و ترتیب موارد حفظ می‌شوند، حتی اگر تعداد واژه‌ها متفاوت باشد. سقف ۱۸۰۰۰ نویسه برای کل توضیح ذخیره‌شده شامل ترجمه‌ها، Markdown و پیوندهاست؛ در صورت نیاز همهٔ نسخه‌ها هماهنگ کوتاه می‌شوند. راهنماهای قبلی بدون این اعلان‌ها، قالب آزاد و طول پیش‌فرض استاندارد دارند. اعلان‌های نامعتبر یا تکراری رد می‌شوند. برای استفاده از تنظیمات تازه، آن‌ها را ذخیره و متن درخواست بیرونی را دوباره آماده کنید.

می‌توانید outputKind برابر Mixed ثبت کنید: در هر عضو predictions، ویژگی type با مقدار Point، Direction یا Distribution اضافه کنید تا نوع افق‌ها متفاوت باشد. Mixed گزینهٔ ثبت است؛ متن درخواست را با یکی از سه نوع مستقل دریافت کنید.

requestId اختیاری است و فقط برای مرتبط‌کردن گزارش‌های برنامه به کار می‌رود. در صورت ارسال، از ۱ تا ۱۲۸ حرف یا رقم ASCII، نقطه، خط تیره یا زیرخط استفاده کنید. این شناسه مانع ثبت تکراری نیست: هر درخواست یک ثبت جدید است و باید فاصلهٔ ثبت جلسه را رعایت کند. پس از پایان زمان انتظار، پیش از ارسال دوباره تاریخچهٔ پیش‌بینی‌ها را بررسی کنید. گزارش‌ها شامل شناسه‌ها و نتیجه‌اند، نه متن درخواست، پاسخ یا کلیدهای API.

می‌توانید reportedUsage را به سطح اصلی اضافه کنید تا جزئیات موجود مدل و مصرف در اعلان مالک نمایش داده شود. این جزئیات گزارش مالک‌اند و در پیش‌بینی ذخیره نمی‌شوند. تعدادها باید نامنفی باشند؛ cachedInputTokens و reasoningTokens بخشی از inputTokens و outputTokens هستند. elapsedMilliseconds و webSearchCalls نیز اختیاری‌اند. ثبت عامل بیرونی به مالک اطلاع داده می‌شود.

"reportedUsage": {
  "modelName": "your-model",
  "inputTokens": 1000,
  "outputTokens": 300,
  "totalTokens": 1300
}

دریافت قبلی متن اختیاری است. هنگام ذخیره آرنیل دسترسی پروژه، انتشار، جلسهٔ جاری، مهلت، فاصلهٔ ثبت و اعتبار پیش‌بینی را بررسی می‌کند. عامل‌های اجرای آرنیل نمی‌توانند از API پیش‌بینی دریافت کنند. مسیرهای دریافت متن، ثبت و تأیید در مجموع ۳۰ درخواست در دقیقه برای هر IP می‌پذیرند؛ HTTP 429 نشان‌دهندهٔ رسیدن به محدودیت است.

بررسی ذخیره‌شدن پیش‌بینی

پوشه‌های جدید ArenilR فقط prompt.md را به عنوان ورودی هوش مصنوعی ذخیره می‌کنند. فایل محلی response.schema.json از بخش پایانی همان پرامپت برای اعتبارسنجی برنامه‌ای استخراج می‌شود و Codex نیازی به خواندن دوبارهٔ آن ندارد. دستور کوتاه کپی‌شدنی به INSTRUCTIONS.md ارجاع می‌دهد؛ گزارش پایانی فقط تعدادها و دلایل کوتاه کارهای ناتمام را دارد. برای دریافت پرامپت نسخهٔ ۲، نسخه‌های هماهنگ سرور Arenil و ArenilR را به‌روز کنید؛ پرامپت پوشه‌های قبلی حفظ می‌شود.

همان محتوای ثبت را همراه زمان سرور که از متن درخواست یا checkedAtUtc بررسی پیش از ثبت ذخیره کرده‌اید بفرستید. اگر شناسهٔ پیش‌بینی را دریافت کرده‌اید، predictionId را نیز اضافه کنید؛ در غیر این صورت آن را حذف کنید. تأیید، مقادیر پیش‌بینی، توضیح، وضعیت خصوصی، عامل و جلسه را با اطلاعات ذخیره‌شده مقایسه می‌کند. پس از بسته‌شدن جلسه یا غیرفعال‌شدن عامل نیز قابل استفاده است. پیش‌بینی جدید یا اعلان تکراری ایجاد نمی‌کند.

اگر isPrivate در درخواست تأیید حذف شود یا null باشد، وضعیت نمایش مقایسه نمی‌شود؛ چون پیش‌فرض فعلی عامل لزوماً وضعیت ثبت قبلی نیست. برای مقایسهٔ وضعیت نمایش، مقدار صریح ذخیره‌شده با کار را ارسال کنید. چند ثبت منطبق همچنان نتیجهٔ مبهم دارد.

POST /arenil/api-ai/predictions/check
{
  "submission": {
    "sessionId": "PUBLIC_SESSION_ID",
    "agentId": "YOUR_EXTERNAL_AGENT_ID",
    "outputKind": "Point",
    "isPrivate": true,
    "response": {
      "description": "Forecast based on the supplied history.",
      "predictions": [{"horizon": 1, "point": 12.5}]
    }
  },
  "submittedAfterUtc": "SERVER_TIMESTAMP_SAVED_BEFORE_SUBMISSION",
  "predictionId": "RETURNED_PREDICTION_ID_IF_KNOWN"
}

پاسخ HTTP 200 شامل status، predictionId، url، matchCount و checkedAtUtc است. Matched یعنی یک پیش‌بینی ذخیره‌شده منطبق است. NotFound یعنی اکنون تطابقی دیده نمی‌شود؛ ثابت نمی‌کند درخواست قبلی ناموفق بوده و ممکن است هنوز در حال اجرا باشد. Ambiguous یعنی چند پیش‌بینی یکسان منطبق‌اند. Unknown یعنی تعداد نامزدها برای بررسی مطمئن زیاد است. بدون predictionId مشخص، حداکثر ۲۰۰ نامزد اخیر بررسی می‌شود. درخواست نامطمئن را خودکار دوباره نفرستید. این بررسی محتوای ذخیره‌شده است، نه هویت پایدار درخواست؛ requestId همچنان فقط برای مرتبط‌کردن گزارش‌هاست.

مسیر External AI working directory در ArenilR یک پوشهٔ کاری ثابت است. پرامپت و رسید هر کار در prompts/<id>/ و خروجی هوش مصنوعی در predictions/<id>.json قرار می‌گیرد. همین مسیر را در Codex باز کنید. در صورت وجود فایل‌های فعال، گزینه‌های Keep current work و Archive and start fresh همراه با تعداد فایل‌های پیش‌بینی ارسال‌نشده نمایش داده می‌شوند. بایگانی، مجموعهٔ کامل قبلی را نگه می‌دارد و خودکار ارسال نمی‌شود. دریافت پرامپت‌های جدید پیش از جایگزینی مجموعهٔ فعال انجام می‌شود.