Files

75 lines
3.9 KiB
Python

"""Les outils texte de l'analyste, ouverts à l'assistant LibreDesk pour l'essai « LibreDesk seul face au duo » (D-142).
API/.venv/bin/python app/serveur/outils_libredesk.py → http://127.0.0.1:8771/outils/<nom>, à joindre par un tunnel
Un serveur à part de la web app : la web app (mails, PDF des clients) reste fermée au dehors. Chaque appel porte
l'en-tête X-Api-Key = LIBREDESK_TOOL_KEY (API/.env) ; le corps JSON, les arguments de l'outil (schémas de OUTILS_ANALYSTE).
Seuls les outils qui rendent du texte : l'assistant ne voit pas d'image. Une erreur d'outil revient en 200 {"erreur": …},
pour que le modèle corrige son appel au lieu de passer la main.
"""
import hmac
import os
import sys
import tempfile
from pathlib import Path
import uvicorn
from fastapi import FastAPI, Request
from fastapi.responses import JSONResponse
APP = Path(__file__).resolve().parents[1]
sys.path.insert(0, str(APP.parent / "API" / "support"))
from outils import AVEC_SORTIE, LECTURE, OUTILS_ANALYSTE, Boite, ErreurOutil, plafonner # noqa: E402
from seance import donnees_par_defaut # noqa: E402 (charge API/.env)
PORT = int(os.environ.get("AIMSIGHT_TOOLS_PORT", 8771))
CLE = os.environ.get("LIBREDESK_TOOL_KEY", "")
OUVERTS = {"detecteurs", "stabilite", "lire_document", "outil_de_lecture"}
TEXTE = LECTURE - AVEC_SORTIE # les outils de lecture qui n'écrivent pas de PNG
CAP = 8000 # caractères : LibreDesk tronque les réponses longues, autant couper nous-mêmes, et le dire
dossier = Path(tempfile.mkdtemp(prefix="outils-libredesk-")) # le cwd des outils de lecture
# ponytail: la station vient des arguments du modèle, pas de X-Libredesk-Contact-Email ; à lier au contact avant tout client réel
boite = Boite(lambda: dossier, lambda: None, donnees_par_defaut(), lambda m: "", lambda s, t: dossier)
app = FastAPI(docs_url=None, redoc_url=None, openapi_url=None)
@app.post("/outils/{nom}")
async def outil(nom: str, request: Request):
if not CLE or not hmac.compare_digest(request.headers.get("x-api-key", ""), CLE):
return JSONResponse({"erreur": "unauthorized"}, 401)
if nom not in OUVERTS:
return JSONResponse({"erreur": f"outil inconnu : {nom}"}, 404)
try:
e = await request.json()
if nom == "outil_de_lecture" and e.get("nom") not in TEXTE:
raise ErreurOutil(f"outil de lecture permis ici : {', '.join(sorted(TEXTE))}")
if nom == "stabilite":
e.setdefault("hors", [])
if nom == "lire_document":
e.setdefault("section", "")
return {"resultat": plafonner(boite.executer_analyste(nom, e), CAP)}
except (ErreurOutil, KeyError, ValueError, TypeError) as x:
return {"erreur": f"{type(x).__name__}: {x}"}
def config() -> list[dict]:
"""Les outils à créer dans LibreDesk (Admin → AI → Tools) : nom, description, paramètres."""
ici = {"lire_document": "Lit un document du savoir de l'analyste, entier (section vide) ou une section par son titre. "
"Documents : " + ", ".join(sorted(p.name for p in (APP.parent / "API" / "knowledge" / "analyste").iterdir())) + ".",
"outil_de_lecture": "Lance un outil de lecture (mode d'emploi : lire_document lire-les-donnees.md) : nom parmi "
+ ", ".join(sorted(TEXTE)) + ". arguments : la ligne de commande après le nom du script, "
"data/<STATION> pour le dossier (--help pour l'usage)."}
return [{"name": o["name"], "description": ici.get(o["name"], o["description"]), "parameters": o["input_schema"]}
for o in OUTILS_ANALYSTE if o["name"] in OUVERTS]
if __name__ == "__main__":
if "--config" in sys.argv:
import json
print(json.dumps(config(), ensure_ascii=False, indent=1))
sys.exit()
if not CLE:
sys.exit("LIBREDESK_TOOL_KEY manque dans API/.env")
uvicorn.run(app, host=os.environ.get("AIMSIGHT_TOOLS_HOST", "127.0.0.1"), port=PORT) # 0.0.0.0 : le réseau