דלג לתוכן הראשי
עיון בתיעוד

Syncanix עם Rails

הפכו API של Rails למוכן לסוכנים: מה הגילוי קורא, איך מריצים אותו ואיך משחררים את ממשק הצ׳אט ושרת ה‑MCP.

נתיבי Rails מוכרזים ב‑config/routes.rb עם מאקרו של משאבים וקינון. הגילוי פורש את ההכרזות האלה לזוגות הקונקרטיים של פועל ונתיב שה‑API שלכם מגיש.

מה הגילוי קורא

הגילוי סטטי — הוא קורא את קוד המקור שלכם, לא את התעבורה. הוא מרכיב נתיבי בקשה מלאים בין קבצים, כך שקידומות שעוגנו הן חלק מכל נתיב שחולץ:

# config/routes.rb
namespace :api do
  resources :orders, only: [:index, :show] do
    member { post :refund }   # → POST /api/orders/:id/refund
  end
end
נתיבים מייצגים שהמחלץ מרכיב — נתיבים מלאים, כולל קידומות.

המחלץ פורש בלוקים של namespace ו‑scope (בצורת מחרוזת וסימבול), resources מקוננים, נתיבי member ו‑collection, ומכבד מסנני only:‎/except:‎ — אפילו נתיבי האימות של devise_for נפרשים.

הרצת הגילוי

משורש המאגר, הריצו את פקודת init. היא מזהה את הפריימוורק אוטומטית, מבקשת את הסכמתכם לפני כל העשרה באמצעות LLM, וכותבת קטלוג דטרמיניסטי:

$ npx syncanix init
✓ detected framework
✓ scanned routes
✓ wrote .syncanix/catalog.json
→ review your capabilities in the dashboard

סקירת הקטלוג

הקטלוג ב‏‎.syncanix/catalog.json מפרט כל יכולת שהגילוי מצא — מתודה, נתיב והתיאור המועשר שהמשתמשים שלכם יראו. סקרו אותו כמו קוד לפני ההעלאה: זהו החוזה שממשק הצ׳אט ושרת ה‑MCP שלכם חושפים.

שחרור הממשק

לאחר העלאת הקטלוג, הטמיעו את הווידג׳ט לצ׳אט בתוך האפליקציה וחברו את שרת ה‑MCP הפר‑טננטי ל‑Claude, ‏ChatGPT ו‑Cursor. כל פעולת כתיבה נשארת מוגבלת בהרשאות, מאושרת ומתועדת.

השלבים הבאים