mirror of
https://github.com/JMP-MS/ASPIC.git
synced 2026-10-27 14:57:09 +00:00
350 lines
16 KiB
PHP
350 lines
16 KiB
PHP
<?php
|
|
/**
|
|
* ASPIC — contact_ia_interprete.php
|
|
*
|
|
* Outil de mise au point interne (4 septembre 2026, demande explicite de
|
|
* Jean-Marc) : PAS un endpoint destiné aux futurs utilisateurs à ce stade.
|
|
* Prolonge la banque de dictées de dictees_test.php/micro_test.js — jusqu'ici
|
|
* la dictée était seulement enregistrée brute, sans aucune interprétation
|
|
* (voir réflexions stratégiques, section 12 : "constituer d'abord un corpus
|
|
* réel avant de concevoir les règles"). Avec ce fichier, on franchit l'étape
|
|
* suivante pour un seul périmètre volontairement restreint — la création
|
|
* d'un contact — en s'appuyant sur un LLM à sortie structurée plutôt que sur
|
|
* des règles écrites à la main (rejetées pour ce problème dans les
|
|
* réflexions stratégiques : trop de variabilité dans les formulations
|
|
* réelles pour un empilement de règles/regex).
|
|
*
|
|
* Reçoit un texte dicté libre (POST, corps JSON {"texte": "..."}) et renvoie
|
|
* les champs de ASP_Contacts qu'un modèle OpenAI (function calling / sortie
|
|
* structurée JSON) a pu en extraire — laissés à null quand rien de fiable
|
|
* n'a été trouvé, jamais devinés. Ce fichier NE CRÉE JAMAIS de contact
|
|
* lui-même : c'est le rôle de contacts.php (déjà en production), appelé
|
|
* séparément par le front-end une fois que Jean-Marc a vérifié/complété les
|
|
* champs à l'écran — voir contact_ia_test.html/.js.
|
|
*
|
|
* Choix d'architecture :
|
|
* - Un seul appel LLM par interprétation, pas de session/état conservé ici.
|
|
* - Les listes de référence (ASP_Statuts, ASP_Professions) sont relues à
|
|
* chaque appel et injectées dans le prompt — jamais recopiées en dur dans
|
|
* ce fichier, même principe que AGN_Variantes/AGN_Defaut pour les agents
|
|
* vocaux (piloté en base, pas figé dans le code).
|
|
* - CNT_Statut doit être un STA_Code réellement existant (ou null) : imposé
|
|
* par une énumération dans le schéma JSON transmis au modèle, jamais une
|
|
* valeur inventée.
|
|
* - CNT_CodeProfession (clé vers ASP_Professions, liste OUVERTE contrairement
|
|
* à ASP_Statuts — voir professions.php) ne peut pas être imposé par
|
|
* énumération de la même façon : le modèle renvoie soit l'identifiant
|
|
* d'une profession existante si elle correspond clairement, soit un
|
|
* libellé de profession nouvelle en toutes lettres si aucune ne
|
|
* correspond — c'est au front-end de créer cette profession (POST
|
|
* professions.php, déjà utilisé ailleurs pour "+ Nouvelle profession…")
|
|
* avant de créer le contact, jamais à ce fichier.
|
|
* - Tout ce qui est dit et ne correspond à aucun champ structuré n'est pas
|
|
* perdu : renvoyé dans CNT_Notes (résumé concis, pas nécessairement mot
|
|
* pour mot) — cohérent avec la règle déjà en place ailleurs dans le
|
|
* projet ("aucun essai raté supprimé", rien n'est jeté).
|
|
*
|
|
* Clé d'API : lue via getenv('OPENAI_API_KEY'), jamais en dur dans le code —
|
|
* même convention que DB_USER/DB_PASS dans db.php (variable d'environnement
|
|
* posée côté docker-compose sur le VPS, ajoutée par Jean-Marc le 4 septembre
|
|
* 2026). Si absente, l'endpoint répond 500 avec un message explicite plutôt
|
|
* que d'échouer silencieusement.
|
|
*
|
|
* ⚠️ Point non vérifié en conditions réelles : cette session n'a pas la main
|
|
* pour exécuter un vrai appel à l'API OpenAI (pas de clé disponible ici,
|
|
* jamais transmise — voir échange avec Jean-Marc). L'appel ci-dessous suit
|
|
* la documentation OpenAI (endpoint Chat Completions, response_format en
|
|
* json_schema strict) au 4 septembre 2026, mais mérite un premier essai réel
|
|
* pour confirmer que la forme de la requête/réponse n'a pas divergé entre
|
|
* temps. Si le premier essai échoue, le message d'erreur renvoyé par
|
|
* OpenAI est transmis tel quel au front-end (voir gérerErreurOpenAI) pour
|
|
* pouvoir corriger vite sans deviner.
|
|
*
|
|
* Modèle utilisé : constante OPENAI_MODEL ci-dessous, volontairement isolée
|
|
* pour pouvoir monter en gamme (gpt-5.6-terra, plus capable mais plus cher —
|
|
* voir comparatif tarifaire du 4 septembre) sans toucher au reste du fichier
|
|
* si la qualité d'extraction sur gpt-5.6-luna se révèle insuffisante à
|
|
* l'usage.
|
|
*
|
|
* ⚠️ Session utilisateur : accès réservé aux utilisateurs identifiés
|
|
* (`$_SESSION['USR_Code']`, ouverte par aspic.php), même principe que les
|
|
* autres endpoints (dictees_test.php, todolist.php...).
|
|
*/
|
|
|
|
session_start();
|
|
header('Content-Type: application/json; charset=utf-8');
|
|
require __DIR__ . '/db.php';
|
|
require __DIR__ . '/moteur_prompts.php';
|
|
|
|
if (empty($_SESSION['USR_Code'])) {
|
|
http_response_code(401);
|
|
echo json_encode(['error' => 'Non identifié — veuillez vous connecter.']);
|
|
exit;
|
|
}
|
|
|
|
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
|
|
http_response_code(405);
|
|
echo json_encode(['error' => 'Méthode non autorisée']);
|
|
exit;
|
|
}
|
|
|
|
const OPENAI_MODEL = 'gpt-5.6-luna';
|
|
const OPENAI_CHAT_URL = 'https://api.openai.com/v1/chat/completions';
|
|
|
|
$data = json_decode(file_get_contents('php://input'), true) ?? [];
|
|
$texte = trim((string) ($data['texte'] ?? ''));
|
|
|
|
if ($texte === '') {
|
|
http_response_code(400);
|
|
echo json_encode(['error' => 'Rien à interpréter']);
|
|
exit;
|
|
}
|
|
|
|
// trim() : un espace ou un retour à la ligne resté collé à la valeur en la
|
|
// collant dans docker-compose/.env (très facile en copiant-collant depuis le
|
|
// navigateur) suffit à faire échouer l'authentification côté OpenAI avec un
|
|
// message d'erreur qui ne le laisse pas deviner (la clé "a l'air" correcte).
|
|
$apiKey = trim((string) getenv('OPENAI_API_KEY'));
|
|
if (!$apiKey) {
|
|
http_response_code(500);
|
|
echo json_encode(['error' => "Clé OPENAI_API_KEY absente côté serveur — à ajouter dans l'environnement du conteneur avant de pouvoir tester."]);
|
|
exit;
|
|
}
|
|
|
|
try {
|
|
$pdo = getDbConnection();
|
|
} catch (PDOException $e) {
|
|
http_response_code(500);
|
|
echo json_encode(['error' => 'Connexion base de données impossible']);
|
|
exit;
|
|
}
|
|
|
|
// -------- Listes de référence, relues à chaque appel (voir en-tête) --------
|
|
try {
|
|
$statuts = $pdo->query('SELECT STA_Code, STA_Libellé FROM ASP_Statuts ORDER BY STA_Incr ASC')->fetchAll();
|
|
$professions = $pdo->query('SELECT PRF_Incr, PRF_Libelle FROM ASP_Professions ORDER BY PRF_Libelle ASC')->fetchAll();
|
|
// Ajout du 4 septembre 2026 (soir), demande de Jean-Marc : deux champs de
|
|
// plus à interpréter, "à qui s'adresse la dictée" et "quelles actions
|
|
// sont demandées" — en réutilisant deux tables déjà existantes plutôt
|
|
// qu'en inventer de nouvelles : ASP_Agents (déjà lue par agents.php pour
|
|
// le vrai pilotage vocal, mêmes AGN_Variantes tolérées ici) et
|
|
// ASP_Actions (déjà utilisée par realisations.php pour journaliser une
|
|
// action faite sur un contact — même liste de référence, réutilisée ici
|
|
// en amont, comme intention plutôt que comme réalisation déjà faite).
|
|
// Pas de AGN_Defaut ici : Jean-Marc a précisé (4 septembre 2026, soir)
|
|
// que le choix de l'assistant par défaut quand personne n'est nommément
|
|
// cité n'est PAS la responsabilité de ce fichier — c'est le traitement
|
|
// déclenché par n8n, en aval, qui s'en charge au moment de transformer
|
|
// une proposition validée (ASP_PropositionsContact) en post-it réel. Ce
|
|
// fichier reste volontairement passif : il ne renvoie que ce qui a été
|
|
// réellement dit (assistant_id reste null si personne n'est cité), sans
|
|
// jamais anticiper une décision qui appartient à l'étage suivant.
|
|
// AGN_Nom renommée AGN_Prenom en base (7 septembre 2026, nuit).
|
|
$agents = $pdo->query('SELECT AGN_Incr, AGN_Prenom, AGN_Fonction, AGN_Variantes FROM ASP_Agents ORDER BY AGN_Incr ASC')->fetchAll();
|
|
$actionsDisponibles = $pdo->query('SELECT ACT_Code, ACT_Libelle FROM ASP_Actions ORDER BY ACT_Libelle ASC')->fetchAll();
|
|
} catch (PDOException $e) {
|
|
http_response_code(500);
|
|
echo json_encode(['error' => 'Erreur base de données : ' . $e->getMessage()]);
|
|
exit;
|
|
}
|
|
|
|
$codesStatutsValides = array_column($statuts, 'STA_Code');
|
|
$idsAgentsValides = array_map('intval', array_column($agents, 'AGN_Incr'));
|
|
$codesActionsValides = array_column($actionsDisponibles, 'ACT_Code');
|
|
|
|
// -------- Schéma JSON strict transmis au modèle --------
|
|
// additionalProperties:false + tous les champs listés dans "required" (y
|
|
// compris ceux qui peuvent être null) : forme imposée par le mode "strict"
|
|
// d'OpenAI pour garantir que la réponse colle exactement au schéma, jamais
|
|
// un champ en plus ou en moins.
|
|
$schemaChamps = [
|
|
'CNT_Nom' => ['type' => ['string', 'null']],
|
|
'CNT_Prenom' => ['type' => ['string', 'null']],
|
|
'CNT_Statut' => ['type' => ['string', 'null'], 'enum' => array_merge($codesStatutsValides, [null])],
|
|
'CNT_Société' => ['type' => ['string', 'null']],
|
|
'CNT_Service' => ['type' => ['string', 'null']],
|
|
'CNT_Fonction' => ['type' => ['string', 'null']],
|
|
'CNT_AdrLig1' => ['type' => ['string', 'null']],
|
|
'CNT_AdrLig2' => ['type' => ['string', 'null']],
|
|
'CNT_AdrLig3' => ['type' => ['string', 'null']],
|
|
'CNT_AdrCP' => ['type' => ['string', 'null']],
|
|
'CNT_AdrVille' => ['type' => ['string', 'null']],
|
|
'CNT_SIRET' => ['type' => ['string', 'null']],
|
|
'CNT_Tel' => ['type' => ['string', 'null']],
|
|
'CNT_Portable' => ['type' => ['string', 'null']],
|
|
'CNT_Mail' => ['type' => ['string', 'null']],
|
|
'CNT_Notes' => ['type' => ['string', 'null']],
|
|
];
|
|
|
|
$schema = [
|
|
'type' => 'object',
|
|
'properties' => [
|
|
'champs' => [
|
|
'type' => 'object',
|
|
'properties' => $schemaChamps,
|
|
'required' => array_keys($schemaChamps),
|
|
'additionalProperties' => false,
|
|
],
|
|
'profession_existante_id' => [
|
|
'type' => ['integer', 'null'],
|
|
'description' => "PRF_Incr d'une profession de la liste fournie, UNIQUEMENT si elle correspond clairement à ce qui a été dicté.",
|
|
],
|
|
'profession_nouvelle_libelle' => [
|
|
'type' => ['string', 'null'],
|
|
'description' => "Libellé d'une profession dictée qui ne correspond à AUCUNE profession existante de la liste fournie. Toujours null si profession_existante_id est renseigné.",
|
|
],
|
|
'assistant_id' => [
|
|
'type' => ['integer', 'null'],
|
|
'enum' => array_merge($idsAgentsValides, [null]),
|
|
'description' => "AGN_Incr de l'assistant nommément désigné par la dictée (ex. \"Matilda, ajoute...\"), UNIQUEMENT s'il est clairement nommé. null si aucun assistant n'est nommé — ne jamais supposer un assistant par défaut.",
|
|
],
|
|
'actions' => [
|
|
'type' => 'array',
|
|
'description' => "Chaque action demandée explicitement dans la dictée (ex. créer/ajouter le contact, envoyer une documentation, envoyer une proposition tarifaire...). Tableau vide si aucune action explicite n'est demandée. La création/l'ajout du contact lui-même, quand elle est demandée, est toujours le premier élément du tableau (libellé fixe \"Ajouter le contact\" en action_nouvelle_libelle si aucun code existant ne correspond) — voir les instructions détaillées plus bas.",
|
|
'items' => [
|
|
'type' => 'object',
|
|
'properties' => [
|
|
'action_existante_code' => [
|
|
'type' => ['string', 'null'],
|
|
'enum' => array_merge($codesActionsValides, [null]),
|
|
],
|
|
'action_nouvelle_libelle' => ['type' => ['string', 'null']],
|
|
],
|
|
'required' => ['action_existante_code', 'action_nouvelle_libelle'],
|
|
'additionalProperties' => false,
|
|
],
|
|
],
|
|
],
|
|
'required' => ['champs', 'profession_existante_id', 'profession_nouvelle_libelle', 'assistant_id', 'actions'],
|
|
'additionalProperties' => false,
|
|
];
|
|
|
|
// -------- Prompt --------
|
|
$listeStatuts = $statuts
|
|
? implode(', ', array_map(fn($s) => $s['STA_Code'] . ' (' . $s['STA_Libellé'] . ')', $statuts))
|
|
: '(aucun statut configuré)';
|
|
$listeProfessions = $professions
|
|
? implode(', ', array_map(fn($p) => $p['PRF_Incr'] . ' = ' . $p['PRF_Libelle'], $professions))
|
|
: '(aucune profession existante)';
|
|
$listeAgents = $agents
|
|
? implode(', ', array_map(
|
|
fn($a) => $a['AGN_Incr'] . ' = ' . $a['AGN_Prenom'] .
|
|
($a['AGN_Variantes'] ? ' (variantes tolérées : ' . $a['AGN_Variantes'] . ')' : ''),
|
|
$agents
|
|
))
|
|
: '(aucun assistant configuré)';
|
|
$listeActions = $actionsDisponibles
|
|
? implode(', ', array_map(fn($a) => $a['ACT_Code'] . ' = ' . $a['ACT_Libelle'], $actionsDisponibles))
|
|
: '(aucune action de référence configurée)';
|
|
|
|
// Texte sorti du code le 11 septembre 2026 — voir moteur_prompts.php pour le
|
|
// texte par défaut/la table ASP_Prompts, bo_prompts.html pour l'édition.
|
|
try {
|
|
$promptSysteme = chargerPromptSysteme($pdo, 'CONTACT_IA_INTERPRETE', [
|
|
'{{LISTE_STATUTS}}' => $listeStatuts,
|
|
'{{LISTE_PROFESSIONS}}' => $listeProfessions,
|
|
'{{LISTE_AGENTS}}' => $listeAgents,
|
|
'{{LISTE_ACTIONS}}' => $listeActions,
|
|
]);
|
|
} catch (Throwable $e) {
|
|
http_response_code(500);
|
|
echo json_encode(['error' => 'Prompt système indisponible : ' . $e->getMessage()]);
|
|
exit;
|
|
}
|
|
|
|
// -------- Appel OpenAI --------
|
|
$corpsRequete = [
|
|
'model' => OPENAI_MODEL,
|
|
'messages' => [
|
|
['role' => 'system', 'content' => $promptSysteme],
|
|
['role' => 'user', 'content' => $texte],
|
|
],
|
|
'response_format' => [
|
|
'type' => 'json_schema',
|
|
'json_schema' => [
|
|
'name' => 'extraction_contact',
|
|
'strict' => true,
|
|
'schema' => $schema,
|
|
],
|
|
],
|
|
// Ni temperature ni max_completion_tokens fixés volontairement : la
|
|
// famille de modèles gpt-5.6 a changé plusieurs fois la prise en charge
|
|
// de ces paramètres selon la variante — mieux vaut s'en tenir aux
|
|
// valeurs par défaut tant que le premier essai réel n'a pas confirmé ce
|
|
// qui est accepté, plutôt que de risquer une requête rejetée pour un
|
|
// paramètre mal supporté.
|
|
];
|
|
|
|
$ch = curl_init(OPENAI_CHAT_URL);
|
|
curl_setopt_array($ch, [
|
|
CURLOPT_RETURNTRANSFER => true,
|
|
CURLOPT_POST => true,
|
|
CURLOPT_POSTFIELDS => json_encode($corpsRequete),
|
|
CURLOPT_HTTPHEADER => [
|
|
'Content-Type: application/json',
|
|
'Authorization: Bearer ' . $apiKey,
|
|
],
|
|
CURLOPT_TIMEOUT => 30,
|
|
CURLOPT_CONNECTTIMEOUT => 10,
|
|
]);
|
|
$reponseBrute = curl_exec($ch);
|
|
$erreurCurl = curl_error($ch);
|
|
$codeHttp = curl_getinfo($ch, CURLINFO_HTTP_CODE);
|
|
curl_close($ch);
|
|
|
|
if ($reponseBrute === false) {
|
|
http_response_code(502);
|
|
echo json_encode(['error' => "Appel à l'API OpenAI impossible : " . $erreurCurl]);
|
|
exit;
|
|
}
|
|
|
|
$reponseDecodee = json_decode($reponseBrute, true);
|
|
|
|
if ($codeHttp !== 200) {
|
|
http_response_code(502);
|
|
echo json_encode([
|
|
'error' => "L'API OpenAI a renvoyé une erreur (HTTP $codeHttp) : " .
|
|
($reponseDecodee['error']['message'] ?? $reponseBrute),
|
|
]);
|
|
exit;
|
|
}
|
|
|
|
$contenuJson = $reponseDecodee['choices'][0]['message']['content'] ?? null;
|
|
if (!$contenuJson) {
|
|
http_response_code(502);
|
|
echo json_encode(['error' => "Réponse OpenAI inattendue (pas de contenu) : " . $reponseBrute]);
|
|
exit;
|
|
}
|
|
|
|
$extraction = json_decode($contenuJson, true);
|
|
if ($extraction === null) {
|
|
http_response_code(502);
|
|
echo json_encode(['error' => "Le contenu renvoyé par OpenAI n'est pas un JSON valide : " . $contenuJson]);
|
|
exit;
|
|
}
|
|
|
|
// Garde-fous défensifs : le mode strict d'OpenAI est censé garantir des
|
|
// valeurs valides (CNT_Statut, assistant_id, codes d'action), mais on ne
|
|
// fait jamais confiance aveuglément à un service externe pour la suite
|
|
// (voir contacts.php, même principe déjà appliqué à CNT_Statut).
|
|
if (!empty($extraction['champs']['CNT_Statut']) && !in_array($extraction['champs']['CNT_Statut'], $codesStatutsValides, true)) {
|
|
$extraction['champs']['CNT_Statut'] = null;
|
|
}
|
|
if (!empty($extraction['assistant_id']) && !in_array((int) $extraction['assistant_id'], $idsAgentsValides, true)) {
|
|
$extraction['assistant_id'] = null;
|
|
}
|
|
foreach ($extraction['actions'] ?? [] as &$action) {
|
|
if (!empty($action['action_existante_code']) && !in_array($action['action_existante_code'], $codesActionsValides, true)) {
|
|
$action['action_existante_code'] = null;
|
|
}
|
|
}
|
|
unset($action);
|
|
|
|
echo json_encode([
|
|
'extraction' => $extraction,
|
|
'statuts' => $statuts,
|
|
'professions' => $professions,
|
|
'agents' => $agents,
|
|
'actionsDisponibles' => $actionsDisponibles,
|
|
]);
|