پرش به مستندات
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.

مرجع