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

Syncanix עם Laravel

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

קובצי הנתיבים של Laravel נראים שטוחים, אבל קידומת ה‏‎/api מוחלת במקום אחר — ב‑route service provider או בתצורת ה‑bootstrap. הגילוי מרכיב אותה מרחבי בסיס הקוד.

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

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

// routes/api.php (the /api prefix comes from the route service provider)
Route::get('/orders/{order}', [OrderController::class, 'show']);
Route::post('/orders/{order}/refund', [OrderController::class, 'refund']);
// → GET /api/orders/{order} · POST /api/orders/{order}/refund
נתיבים מייצגים שהמחלץ מרכיב — נתיבים מלאים, כולל קידומות.

המחלץ קורא הכרזות ::Route ורישומי resource, מרכיב את קידומת הקבוצה מה‑RouteServiceProvider (או apiPrefix של withRouting ב‑Laravel 11) בין קבצים, וממסך הערות כך שנתיבים בהערה לעולם לא יחולצו.

הרצת הגילוי

משורש המאגר, הריצו את פקודת 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. כל פעולת כתיבה נשארת מוגבלת בהרשאות, מאושרת ומתועדת.

השלבים הבאים