zum Hauptinhalt springen
Dokumentation durchsuchen

Syncanix mit Django

Machen Sie ein Django-Projekt agent-ready: was die Discovery liest, wie Sie sie ausführen und wie Sie Chat-Oberfläche und MCP-Server ausliefern.

Django-Routen leben in urls.py-Modulen, die mit include() zusammengesetzt werden. Die Discovery folgt den Includes und ihren Präfixen und versteht zusätzlich die Konventionen des Django REST Framework.

Was die Discovery liest

Die Discovery arbeitet statisch — sie liest Ihren Quellcode, nicht Ihren Traffic. Sie setzt vollständige Request-Pfade über Dateigrenzen hinweg zusammen, sodass gemountete Präfixe Teil jeder extrahierten Route sind:

# 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/
]
Repräsentative Routen, die der Extraktor zusammensetzt — vollständige Pfade, Präfixe inklusive.

Der Extraktor liest path()-, re_path()- und Legacy-url()-Muster, folgt include()-Präfixen über Module hinweg und versteht DRF — router-registrierte ViewSet-CRUD-Routen und die Verb-Inferenz generischer Views (eine ListCreateAPIView ergibt GET und POST).

Discovery ausführen

Führen Sie im Wurzelverzeichnis des Repositories den init-Befehl aus. Er erkennt das Framework automatisch, holt vor jeder LLM-Anreicherung Ihre Zustimmung ein und schreibt einen deterministischen Katalog:

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

Katalog prüfen

Der Katalog unter .syncanix/catalog.json listet jede gefundene Capability auf — Methode, Pfad und die angereicherte Beschreibung, die Ihre Nutzer sehen. Prüfen Sie ihn wie Code, bevor Sie ihn hochladen: Er ist der Vertrag, den Ihre Chat-Oberfläche und Ihr MCP-Server offenlegen.

Oberfläche ausliefern

Sobald der Katalog hochgeladen ist, betten Sie das Widget für den In-App-Chat ein und verbinden den MCP-Server pro Tenant für Claude, ChatGPT und Cursor. Jede Schreibaktion bleibt berechtigungsgeprüft, bestätigt und auditiert.

Nächste Schritte