Emulate: شبیهساز API هوش مصنوعی برای تست و CI
خلاصهٔ کاملتر
طبق مستندات Emulate، سرویس AI این ابزار یه شبیهساز برای APIهای OpenAI Responses، Chat Completions و Anthropic Messages هست که برای CI و sandboxهای آفلاین ساخته شده. نکته اصلی اینه که این سرویس مدل زبانی نیست. همه جوابها، یعنی متن، خروجی ساختاریافته، tool call، reasoning، refusal، خطا و حتی زمانبندی stream، با قانونها و پیشفرضهای deterministic (یعنی بدون هیچ تصادفی) ساخته میشن. پس هر بار که تست رو اجرا کنی همون نتیجه رو میگیری.
استفادهش سادهست: سرویس رو با npx emulate start --service ai --port 4014 بالا میاری و کلاینت OpenAI رو به وصل میکنی. هر کلید API و هر اسم مدلی قبوله و کلیدها نه چک میشن، نه ذخیره. SDK انتروپیک خودش /v1/messages رو اضافه میکنه، برای همین باید فقط آدرس اصلی رو بهش بدی:
const client = new OpenAI({ apiKey: "test", baseURL: "http://localhost:4014/v1" });
const anthropic = new Anthropic({ apiKey: "test", baseURL: "http://localhost:4014" });فرمت درخواست از آخر مسیر تشخیص داده میشه، پس هر پیشوندی مثل /v1 یا /api/v1 کار میکنه. route مربوط به Messages دقیقاً فرمت انتروپیک رو حرف میزنه: system یه فیلد بالادستیه، max_tokens اجباریه و stream همون رویدادهای message_start تا message_stop رو میفرسته. ابزارهای سمت سرور مثل web search یا code execution خطای 400 برمیگردونن و خطاها هم تو همون قالب و نوعهای خطای انتروپیک میان.
قلب ماجرا قانونها (rules) هستن که از بلوک ai تو فایل seed یا از PUT /_ai/rules میان. قانونها به ترتیب چک میشن و اولین قانونی که مچ بشه جواب میده. شرطها میتونن روی اسم مدل، فرمت، stream بودن، متن پیام کاربر (textContains)، ابزار تعریفشده یا داشتن tool result باشن. مثلاً با دو قانون میشه یه حلقه دومرحلهای ساخت: اول یه tool call به get_weather و بعد از رسیدن نتیجه، یه جواب متنی.
هر قانون میتونه times داشته باشه، یعنی چند بار اجازه جواب دادن داره، و این شمارش حتی با خطا و retryهای SDK هم کم میشه. با finish میشه حالتهایی مثل length یا content_filter رو تست کرد، با fault یه stream رو وسط راه قطع کرد و با timing زمان اولین توکن و فاصله بین chunkها رو تنظیم کرد. یعنی سناریوهای سختی مثل قطعی شبکه رو هم بدون مدل واقعی تست میکنی.
محدودیتهای درخواست هم شبیه API واقعی رعایت میشن. stop sequenceها متن رو سر اولین مچ میبُرن و سقف توکن با تخمین هر چهار کاراکتر یه توکن حساب میشه. اگه جواب از سقف بیشتر باشه بریده میشه و با length تموم میشه، و tool callی که جا نشه کلاً حذف میشه، نه نصفه.
نکات کلیدی:
- Emulate APIهای OpenAI Responses، Chat Completions و Anthropic Messages رو بدون مدل واقعی شبیهسازی میکنه.
- همه جوابها deterministic هستن و از قانونهای تعریفشده تو seed یا PUT /_ai/rules میان.
- هر کلید API و اسم مدلی قبوله و کلیدها هیچوقت چک یا ذخیره نمیشن.
- با times، finish، fault و timing میشه خطا، قطعی stream و تأخیر رو تست کرد.
- ابزارهای سمت سرور انتروپیک مثل web search روی این شبیهساز خطای 400 میدن.




