aller au contenu principal
Parcourir la documentation

Syncanix avec Django

Rendez un projet Django prêt pour les agents : ce que lit la découverte, comment la lancer et comment mettre en service la surface de chat et le serveur MCP.

Les routes Django vivent dans des modules urls.py assemblés avec include(). La découverte suit les include et leurs préfixes, et comprend en plus les conventions de Django REST Framework.

Ce que lit la découverte

La découverte est statique : elle lit votre code source, pas votre trafic. Elle compose les chemins de requête complets à travers les fichiers, si bien que les préfixes montés font partie de chaque route extraite :

# 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/
]
Routes représentatives que l’extracteur compose — chemins complets, préfixes inclus.

L’extracteur lit les motifs path(), re_path() et l’ancien url(), suit les préfixes d’include() entre modules et comprend DRF : le CRUD des ViewSets enregistrés dans des routeurs et l’inférence des verbes des vues génériques (une ListCreateAPIView produit GET et POST).

Lancez la découverte

Depuis la racine du dépôt, lancez la commande init. Elle détecte le framework automatiquement, demande votre consentement avant tout enrichissement par LLM et écrit un catalogue déterministe :

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

Relisez le catalogue

Le catalogue dans .syncanix/catalog.json liste chaque capacité trouvée par la découverte : méthode, chemin et la description enrichie que verront vos utilisateurs. Relisez-le comme du code avant de l’envoyer : c’est le contrat qu’exposent votre surface de chat et votre serveur MCP.

Mettez la surface en service

Une fois le catalogue envoyé, intégrez le widget pour le chat dans votre application et connectez le serveur MCP par tenant pour Claude, ChatGPT et Cursor. Chaque action d’écriture reste soumise aux permissions, confirmée et auditée.

Étapes suivantes