API ات رو برای ایجنتها آماده کن
هوش مصنوعیخلاصهٔ کاملتر
نویسنده با یه ادعای صریح شروع میکنه: API قبلاً یه فیچر بود، حالا خودش محصوله. شرکت بعدی که میخواد با تو یکپارچه بشه، برنامهنویس نمیفرسته که مستنداتت رو بخونه؛ یه ایجنت میفرسته که هم یکپارچهسازی رو میسازه هم توی production اجراش میکنه. فرقش اینجاست که ایجنت تحقیق نمیکنه، فقط صدا میزنه و واکنش نشون میده. پس هر چیزی که لازم داره باید توی خود پاسخ برسه دستش.
مهمترین توصیهاش دربارهٔ خطاهاست. یه خطای invalid_parameter: date_range حتی برای آدم هم بهزور سرنخ میده. به گفتهٔ نویسنده، بدنهٔ خطا باید خود راه حل رو داشته باشه: قدم بعدی به زبان ساده، آدرس مستندات مربوطه و لینک لاگ همون درخواست. یه نکتهٔ ریز ولی مهم هم میگه، ایجنتها لینکهایی که پارامتر ترکینگ دارن رو دنبال نمیکنن و بیشتر سراغ لینکی میرن که وسط متن با یه دلیل روشن اومده.
سه پیشنهاد بعدی دربارهٔ ابزارهاست. اول یه ابزار agent_send_feedback بذار تا خود ایجنتها بگن کجا گیر کردن و مشکل رو دستهبندی کنن. دوم لاگ درخواستهای production رو در دسترسشون بذار، چون بیشتر مشکلها فقط با دادهٔ واقعی خودشون رو نشون میدن. سوم تعداد ابزار MCP رو کم نگه دار: به گفتهٔ نویسنده انتخاب ابزار بعد از حدود ۳۰ تا ۵۰ ابزار افت میکنه، پس بهتره فقط یه لیست کوتاه از پرکاربردها رو ابزار کنی و بقیه پشت Tool Search بمونه.
سه تای آخر دربارهٔ شروع کاره. ثبتنام باید برنامهنویسیشده باشه، وگرنه کل مسیر سر ساختن اکانت میشکنه و باز یه آدم باید بره تو سایت ثبتنام کنه. نویسنده به استاندارد نوظهور auth.md اشاره میکنه که با فرستادن یه توکن به ایمیل کاربر، به ایجنت اعتبارنامهٔ محدود میده تا بتونه خودش ادامه بده.
CLI هم بهتره دو مسیر داشته باشه، چون ایجنت با تعامل TTY کار نمیکنه. برای تشخیصش میشه سراغ متغیر محیطی مثل CLAUDECODE=1 رفت یا process.stdout.isTTY رو چک کرد، و تو حالت ایجنت خروجی رو پرحرفتر کرد. حرف آخر نویسنده اینه که داشتن endpointهای مخصوص ایجنت اشکالی نداره، مهم اینه که ایجنت بتونه هر کاری که تو محصولت هست انجام بده.
نکات کلیدی:
- بدنهٔ خطا باید قدم بعدی، آدرس مستندات و لینک لاگ همون درخواست رو داشته باشه
- ایجنتها لینکهای دارای پارامتر ترکینگ رو دنبال نمیکنن
- انتخاب ابزار MCP بعد از حدود ۳۰ تا ۵۰ ابزار افت میکنه، پس لیست کوتاه بساز و بقیه رو پشت Tool Search بذار
- ابزار agent_send_feedback راه سادهایه برای فهمیدن اینکه ایجنتها کجا گیر میکنن
- استاندارد auth.md با توکن ایمیلی به ایجنت اعتبارنامهٔ محدود میده
- برای CLI دو مسیر بساز و حالت ایجنت رو با CLAUDECODE=1 یا process.stdout.isTTY تشخیص بده
