Service IA¶
Vue d'ensemble¶
Le Service IA expose des endpoints REST compatibles OpenAI pour les fonctions IA intégrées au SQL. Il sert de pont entre les fonctions natives akko_ai_*() de la couche Query et la stack LLM souveraine locale.
Architecture¶
Endpoints¶
| Endpoint | Méthode | Description |
|---|---|---|
/v1/analyze_sentiment |
GET/POST | Analyse de sentiment |
/v1/classify |
GET/POST | Classification de texte |
/v1/summarize |
GET/POST | Résumé de texte |
/v1/translate |
GET/POST | Traduction |
/v1/extract_entities |
GET/POST | Reconnaissance d'entités nommées |
/v1/redact_pii |
GET/POST | Masquage des données personnelles (RGPD) |
/v1/classify_sensitivity |
GET/POST | Classification de sensibilité des données |
/v1/detect_language |
GET/POST | Détection de langue |
/v1/extract_keywords |
GET/POST | Extraction de mots-clés |
/v1/embed |
GET | Embedding vectoriel (768 dimensions) |
/v1/trino-audit |
POST | Récepteur d'audit des requêtes Moteur de requête (Trino) |
/v1/storage-audit |
POST | Récepteur d'audit des accès object storage |
/health |
GET | Vérification de santé |
/metrics |
GET | Métriques Couche Métriques (Prometheus) |
Configuration¶
| Variable | Défaut | Description |
|---|---|---|
LLM_URL |
http://akko-akko-litellm:4000 |
URL du backend LLM |
AKKO_AI_SERVICE_TOKEN |
(vide) | Jeton du compte de service |
OLLAMA_HOST |
http://akko-akko-ollama:11434 |
URL directe d'Runtime LLM local (Ollama) |
Image personnalisée¶
akko-ai-service:2026.03 -- FastAPI + endpoints d'audit (docker/ai-service/Dockerfile)
Licence¶
Apache 2.0