• View
• Edit
• History
• Print

API IA — Endpoints et configuration

API IA

Architecture

Plugin Moodle (PHP curl)
    |
    v
ai-proxy (container Docker, port 9200)
    |
    v (Tailscale VPN)
    |
PGX socat proxy (port 8200)
    |
    v
vLLM (port 8101, localhost only)

L'endpoint est configuré dans l'admin Moodle (Admin > Plugins > AI Grader). Le proxy IA interne route les requêtes vers le serveur GPU via Tailscale.

Format (OpenAI Chat Completions)

POST /v1/chat/completions
Content-Type: application/json
Authorization: Bearer <clé API>

{"model": "<nom du modèle>", "messages": [...], "temperature": 0.3, "max_tokens": 2000, "stream": false}

Paramètres par plugin

Streaming (Tutor IA)

SSE via CURLOPT_WRITEFUNCTION. Filtrage temps réel des tags think (DeepSeek R1). Désactivation buffers PHP (ob_end_clean, zlib.output_compression=0, X-Accel-Buffering: no).

Fallback

Tutor IA : Si endpoint principal échoue (HTTP 500+ ou curl error), tente l'endpoint de secours (local_tutor_ia/api_endpoint_fallback).

Configuration centralisée

AI Grader (Admin Plugins Dream-U AI Grader) : api_endpoint, model_name, api_key. Page test : /local/dreamu_ai/test_api.php. QCM Generator : hérite de AI Grader, peut surcharger. Tutor IA : hérite de AI Grader, endpoint secours en propre.