Engineering choicesDécisions d’architecture(in French)4 min read
0012 · Fisher : Anthropic seul, des chiffres sourcés
Fisher, l’assistant de l’ERP, appelle les modèles d’Anthropic par la passerelle de Vercel. Ses gestes sont dans un registre, ses chiffres sont vérifiés et ses écritures sont confirmées.
Not translated yet
Statut : acceptée, amendée le 26 octobre 2026 (périmètre levé) · Décidée : 23 au 25 octobre 2026 · Sources : 8977dfebc9 et sa note docs/tanstack-ai-analyse.md (git show 8977dfebc9:docs/tanstack-ai-analyse.md), apps/erp/shared/server/ai/gateway.ts, AGENTS.md (décision du 26 octobre 2026)
Contexte
Fisher lit les papiers (bons de livraison, accusés de réception, factures étrangères), rédige des textes et répond aux questions sur le manuel et sur les données de l’ERP (Fisher). Les documents qu’il manipule portent les coordonnées des clients et des fournisseurs. L’intégration est partie d’une analyse de TanStack AI que j’ai demandée le 23 octobre.
Contraintes
- Un chiffre faux coûte cher. Une quantité, un prix ou une date doivent venir de l’ERP, pas du modèle.
- Les données ne doivent pas servir à entraîner un modèle, ni partir chez un sous-traitant que la page Confidentialité du site ne nomme pas.
- Le 26 octobre 2026, j’ai décidé de rester sans plan Pro chez Vercel, donc sans non-conservation (ZDR).
- La dépense mensuelle reste plafonnée.
Alternatives
- L’API d’Anthropic en direct. Il faudrait garder une clé partout, et on n’aurait ni le coût par appel ni un modèle de repli.
- Laisser la passerelle choisir le fournisseur, puisque Bedrock et Vertex servent les mêmes modèles. Ça a été écarté (voir les raisons).
- Le SDK IA de Vercel à la place de TanStack AI. Il a été étudié : « Les deux feraient l’affaire ; la décision importante est l’architecture ».
- Un outil d’IA qui écrit en base. Il a d’abord été écarté (« aucun outil d’IA n’écrit en base »), puis accepté derrière une confirmation de la personne.
Décision
Le SDK (TanStack AI) s’importe dans le socle apps/erp/shared/server/ai, le hook du chat (use-manual-chat.ts) et les deux scripts d’évaluation. Il appelle les modèles d’Anthropic par la passerelle IA de Vercel, avec only: ["anthropic"] et disallowPromptTraining. La non-conservation est derrière AI_ZERO_DATA_RETENTION. Et sur Vercel, il passe par un jeton OIDC.
Un geste n’existe que dans le registre FISHER_GESTURES, et une lecture que dans FISHER_TOOLS (apps/erp/shared/server/ai/gestures.ts). C’est de là qu’on tire les modèles, les outils, la garde des durées et les libellés de la mesure.
Dans la réponse, chaque chiffre qui n’a pas de source est signalé (apps/erp/shared/server/ai/stream.ts). Une écriture passe par une confirmation. Et la dépense est plafonnée (isBudgetExhausted). Depuis le 26 octobre, il n’y a plus de limite de périmètre. Il reste seulement ces garanties.
Raisons
Confirmées
- On se limite à Anthropic : « un devis ou un BL qui porte l’adresse d’un client n’a pas à partir chez AWS ou Google sans que le client le sache » (
gateway.ts). - Avec la passerelle, il n’y a aucune clé à poser sur Vercel, grâce au jeton OIDC. Elle donne le coût réel de chaque appel, elle accepte
zeroDataRetentionetdisallowPromptTraining, et on y change de modèle en une ligne (note du 23 octobre). - TanStack AI va avec TanStack Form et Zod. Il refuse à la compilation un PDF envoyé à un modèle qui ne le lit pas, et il se simule dans Vitest. Le risque que la note nomme, c’est une 1.0 toute récente (note du 23 octobre).
- J’ai levé le périmètre le 26 octobre 2026 : « plus aucune décision ne tranche ni ne limite Fisher », et ce qui reste n’est « pas des limites mais des garanties ».
Hypothèses
- Le registre, plutôt que des appels éparpillés, sert à garder les modèles, les outils et la mesure au même endroit. C’est ce qu’il fait, et l’
AGENTS.mdl’impose pour tout nouveau geste, sans dire pourquoi.
Compromis
- Le contenu des documents part chez Anthropic, qui le garde jusqu’à 30 jours.
- Le contrôle des chiffres signale, mais il n’empêche rien. La personne doit relire.
- Le registre, les lectures décrites pour le chat et le manuel, ce sont des textes de plus à garder à jour avec le code.
- Les évaluations appellent le vrai modèle et se lancent à la main (
pnpm ai:eval).
Conséquences
- Un nouveau geste ou une nouvelle lecture s’inscrit dans
FISHER_GESTURESouFISHER_TOOLS. - La mesure (
/coulisses/fisher) informe sur les appels, les propositions gardées, le coût et le temps gagné. Elle ne retire rien. - Si le budget est épuisé, ou si le modèle et son repli sont indisponibles, les formulaires repassent en saisie à la main.
Risques résiduels
- Le contrôle des chiffres est lexical. Il rattrape un chiffre grossièrement inventé. Il ne rattrape pas un chiffre juste attaché à la mauvaise pièce (Un assistant qui n’apporte pas les faits).
- Un document déposé peut contenir des consignes. Le modèle lit un bon de livraison ou une facture comme du texte. Une phrase écrite pour le détourner arrive donc dans la conversation. Toute écriture passe par une confirmation, et les lectures se font sous les droits de la personne. Aujourd’hui, ça veut dire tous les droits (ADR 0011).
- Il n’y a qu’un fournisseur de modèles, et c’est un choix. Si Anthropic est en panne, Fisher s’arrête, et les formulaires repassent en saisie à la main.
- TanStack AI est jeune. La note du 23 octobre nommait déjà ce risque : une 1.0 toute récente.
Quand la revoir
- La non-conservation se demandera avec
AI_ZERO_DATA_RETENTION=1le jour où l’offre le permettra. Il faudra aussi mettre à jour la page Confidentialité du site. - Si TanStack AI changeait d’API à chaque version, ou n’avançait plus, on changerait de SDK. Seuls le socle serveur (
apps/erp/shared/server/ai), le hook du chat (use-manual-chat.ts) et les scripts d’évaluation (ai-eval.mts,ai-eval-chat.mts) l’importent. - Les droits par geste reviendront avec les rôles (ADR 0011).