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

Syncanix עם Django

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

נתיבי Django חיים במודולי urls.py שנתפרים יחד עם include()‎. הגילוי עוקב אחרי ה‑include והקידומות שלהם, ומעבר לכך מבין את המוסכמות של Django REST Framework.

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

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

# project/urls.py
urlpatterns = [path("api/", include("orders.urls"))]

# orders/urls.py
urlpatterns = [
    path("orders/<int:pk>/", views.OrderDetail.as_view()),    # → GET /api/orders/<pk>/
    path("orders/<int:pk>/refund/", views.refund),            # → POST /api/orders/<pk>/refund/
]
נתיבים מייצגים שהמחלץ מרכיב — נתיבים מלאים, כולל קידומות.

המחלץ קורא תבניות path()‎, ‏re_path()‎ ו‑url()‎ הישנה, עוקב אחרי קידומות include()‎ בין מודולים ומבין DRF — פעולות CRUD של ViewSet רשומים בראוטרים והסקת פעלים מ‑generic views‏ (ListCreateAPIView מניבה GET ו‑POST).

הרצת הגילוי

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

השלבים הבאים