LibreDesk assistant trial (D-142): analyst text tools server, snippets, procedure
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
ee3875fe75
commit
b988b6de9a
5 files changed
+330
-1
No files matched your search
@@ -0,0 +1,74 @@
|
||||
"""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
|
||||
Reference in new issue
Block a user