تخطَّ إلى المستندات
API

تجربة تصنيف على البريد الأخير

ما كان سيلتقطه تصنيف يطبّقه الذكاء الاصطناعي في أحدث بريد في البريد الوارد، دون وضع أي تصنيف.

POST/labels/{id}/test

ينفّذ الاستدعاء الحقيقي على مساحة عملك.

POST /labels/{id}/test

ما كان سيلتقطه تصنيف يطبّقه الذكاء الاصطناعي في أحدث بريد في البريد الوارد، دون وضع أي تصنيف.

مثال

يتطلب labels:write وthreads:read. أرسل aiInstructions لتجربة صياغة لم تحفظها بعد، أو {} لتجربة ما يحمله التصنيف.

curl
curl -X POST "$OE/labels/USER_INVOICES/test" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "aiInstructions": "invoices and receipts" }'
الاستجابة
{  "object": "label_test",  "labelId": "USER_INVOICES",  "examined": 20,  "matched": [    {      "threadId": "thr_7c1e4a90",      "subject": "Your September invoice",      "sender": "[email protected]",      "receivedOn": "Wed, 23 Sep 2026 10:02:44 +0000"    }  ]}

يقرأ أحدث 20 محادثة في البريد الوارد، ويذكر examined عدد ما قرأه. والرسالة التي وصلت مشفّرة تُتخطى، والمفتاح المقيّد بعناوين معيّنة لا يقرأ إلا المحادثات المسلَّمة إليها.

كل تجربة تستهلك إجراء ذكاء اصطناعي واحدًا من إجراءات المستدعي، وهو ما لا يفعله وضع التصنيفات على البريد الواصل أبدًا. وإذا لم يبقَ منها شيء اليوم فالنتيجة 429 ai_quota_exceeded، وبلا تعليمات في الطلب ولا على التصنيف 422 invalid_parameter، وفي تثبيت بلا نموذج ذكاء اصطناعي 409 ai_not_configured.

المرجع