‏ایجنت کدنویس بدون گراف، حدس می‌زنه

Talia Kohan تو بلاگ Postman می‌گه یک اتفاق مشترک داره تو سازمان‌های مهندسی می‌افته: همه دارن یک گراف دانش می‌سازن، فقط اسمش فرق می‌کنه. یکی بهش می‌گه service catalog، یکی API registry، یکی نقشهٔ مالکیت یا گراف وابستگی. زیر همهٔ این اسم‌ها یک شکل واحده: مجموعه‌ای از موجودیت‌های تایپ‌دار و رابطه‌های تایپ‌دار بینشون.

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

اولین واکنش خیلی از تیم‌ها بزرگ‌تر کردن context window بود و مقاله می‌گه این جواب نداده. مطالعهٔ context rot شرکت Chroma روی ۱۸ مدل frontier نشون داده کیفیت همه‌شون خیلی قبل از پر شدن پنجره افت می‌کنه، و کار «lost in the middle» استنفورد افت ۳۰ درصدی یا بیشترِ دقت رو برای اطلاعاتی که وسط پرامپت طولانی می‌شینن گزارش کرده. پرامپت بلندتر با retrieval بهتر یکی نیست.

پیشنهاد جایگزین اینه که گراف رو بیرون از مدل بسازی و ایجنت ازش کوئری بگیره. هر واقعیت یک جملهٔ سه‌تکه‌ست (سوژه، رابطه، مفعول) درست مثل RDF: سرویس X فلان اندپوینت رو ارائه می‌ده، اون اندپوینت مال تیم Z هست، اون تیم فلان auth scheme رو استفاده می‌کنه. یک موجودیت اندپوینت تو این گراف چیزی شبیه اینه:

{
  "id": "svc.payments.charges",
  "type": "service.endpoint",
  "method": "POST",
  "path": "/v2/charges",
  "owner_team": "team.payments-core",
  "deprecates": "svc.payments.charges.v1"
}

با همین یک رکورد، ایجنت می‌تونه به سؤال‌هایی جواب بده که یک grep ساده نمی‌تونه: از قبل اندپوینتی برای این کار هست؟ کی باید تغییر رو تأیید کنه؟ اگه شکل پاسخ عوض بشه چی می‌شکنه؟ نویسنده می‌گه بخش زیادی از این گراف رو از قبل دارین، چون خود اسپک OpenAPI مجموعه‌ای از موجودیت و رابطهٔ تایپ‌داره. Postman همین رو با Private API Network، API Governance و MCP Server در اختیار ایجنت می‌ذاره تا به‌جای grep زدن، گراف رو کوئری کنه.

نکات کلیدی:

• مطالعهٔ context rot شرکت Chroma روی ۱۸ مدل frontier: افت کیفیت خیلی قبل از پر شدن context window.
• کار «lost in the middle» استنفورد: افت ۳۰٪ یا بیشتر دقت برای اطلاعاتی که وسط پرامپت طولانی قرار می‌گیرن.
• GraphRAG مایکروسافت و CodexGraph (NAACL 2025) هر دو نشون می‌دن پیمایش گراف از retrieval تنها بهتر جواب می‌ده.
• MCP پروتکل بازیه که همین گراف رو به شکل ابزار قابل کوئری جلوی ایجنت می‌ذاره.
• گراف سریع بیات می‌شه؛ آپدیتش رو به همون فرآیند ریویو کد وصل کن، نه به یک پاکسازی فصلی.
• گوگل هم Agentic Resource Discovery رو منتشر کرده؛ همین الگوی «گراف قابلیت‌ها رو منتشر کن» در مقیاس اینترنت.