Pièce en vigueur · accessible
citée
policy-pack-q3.pdf
v.6 · effet au 01/09/2026 · rôle juridique-fr
API
Intégrateur Anthropic Claude API : documents citables, outils et garde-fous
Un contexte long ne rend pas un dossier fiable par lui-même. Une pièce obsolète peut être parfaitement citée, une source exacte peut être interdite à l’utilisateur et un appel d’outil bien formé peut rester hors mandat. Dawap relie documents, versions, droits, Messages API, budget de contexte, mode de sortie, outils et verdict humain pour que Claude travaille sur un dossier que vos équipes peuvent réellement contester et reprendre.
APIs, données et infrastructures que nos projets savent connecter
Du besoin métier au run mesurable
01
Contrat
versionné
02
Sécurité
explicite
03
Reprise
testée
04
Supervision
actionnable
Réponse courte
Intégrer Claude API, c’est construire un dossier de preuve avant de construire un assistant.
La Messages API traite des messages structurés et peut retourner des blocs de texte ou d’appel d’outil. Anthropic permet aussi de joindre des documents citables, de compter les tokens avant l’envoi et de contraindre certaines sorties par schéma. Dawap choisit le bon mode par parcours, filtre les sources, valide les outils côté serveur et relie chaque réponse à une version, un droit et un verdict métier. Aucun projet public Dawap n’est présenté comme une intégration Anthropic déjà livrée.
- Tracer la pièce et sa validité métier, pas seulement l’extrait cité.
- Choisir entre citations et JSON strict lorsqu’un même appel ne peut pas porter les deux.
- Intercepter tool_use, contrôler l’action puis renvoyer tool_result sans ouvrir le SI au modèle.
Atelier de preuve documentaire
Avant la réponse, voir exactement ce qui entre dans le dossier Claude.
Cette maquette suit un dossier témoin : trois pièces, deux contrats de sortie et un outil de lecture. Elle rend visibles les exclusions que l’interface conversationnelle laisse habituellement hors champ.
01
revue requise
Enveloppe documentaire
dossier-218 · révision contractuelle
Pièce remplacée
exclue
policy-pack-q2.pdf
v.5 · remplacée par v.6 · même clause détectée
Pièce hors périmètre du rôle
masquée
board-exception-07.txt
direction uniquement · contenu non transmis au modèle
Corpus transmis
1 pièce sur 3
Une citation localise l’extrait. Le registre documentaire continue de décider quelle version fait foi et qui peut la lire.
03
choix explicite
Contrat de réponse
Un parcours choisit sa preuve. Il ne promet pas deux formats incompatibles.
ALecture et justification
Réponse citée
Le lecteur remonte au passage et ouvre la pièce en vigueur. Le format reste destiné à expliquer et à contester.
retenue pour ce dossierou
BTraitement applicatif
JSON strict
Le serveur reçoit une structure conforme au schéma, puis valide références et règles métier avant toute utilisation.
testé dans un appel séparé
04
lecture seule
Boucle d’outil côté application
Claude propose la consultation. Le serveur conserve le mandat.
- 01Claudetool_use · get_contract_status
Arguments structurés, aucun effet direct.
- 02MiddlewareSchéma, rôle et dossier vérifiés
Allowlist et accès relus côté serveur.
- 03Système sourceÉtat courant consulté
Aucune écriture ouverte pendant le premier lot.
- 04Applicationtool_result renvoyé à la boucle
Résultat borné, erreur ou refus explicite.
request IDreq_…91f
stop reasontool_use
tokenscomptés puis rapprochés
cachepréfixe stable suivi
verdictmétier · à revoir
Périmètre Anthropic
Quatre chantiers pour intégrer Claude sans diluer les responsabilités
La marque, le RAG, les documents et les outils sont cadrés ensemble autour du dossier Anthropic. L’architecture transverse IA/data/search et le choix du cas d’usage métier gardent chacun un périmètre distinct.
01intégrateur Claude API
Relier Messages API au système d’information
Rôles, messages, modèles, erreurs, usage, outils, observabilité, reprise et responsabilités.
02intégration Anthropic API
Construire le contrat fournisseur et son run
Authentification, versions, requêtes, request IDs, limites, backoff, coûts et procédures de support.
03RAG Claude
Composer un contexte documentaire autorisé
Ingestion, versions, ACL, retrieval, documents citables, fraîcheur, cache et règle d’abstention.
04Claude tool use
Brancher des outils sans déléguer l’autorisation
Schémas, tool_use, validation serveur, tool_result, idempotence, confirmation et effet métier.
La source citée n’est pas encore la décision
Trois dossiers peuvent sembler propres tout en restant impropres à la production.
Claude peut restituer une pièce, respecter un schéma ou proposer un outil. Le service devient défendable seulement lorsque la validité métier, les droits et l’effet réel sont contrôlés hors du modèle.
01
Version
La bonne phrase vient de la mauvaise pièce
La citation mène bien à l’extrait, mais l’annexe a été remplacée ou son statut ne lui permet plus de faire foi pour ce dossier.
02
Contrat
La requête exige deux formats incompatibles
Le parcours attend à la fois des citations intercalées et un JSON strict. L’architecture doit choisir le mode de preuve utile au lieu de masquer un conflit de contrat.
03
Mandat
L’outil respecte son schéma mais dépasse le rôle
Les arguments sont valides ; l’appelant ne peut pourtant ni consulter le compte visé, ni déclencher l’action proposée, ni autoriser son rejeu.
Architecture Anthropic Claude API
Six contrats transforment le contexte en dossier exploitable
La Messages API porte l’échange. Autour d’elle, le service doit décider quelles pièces entrent, quel format sort, quels outils peuvent être proposés et quelle trace suffit pour contester le résultat.
Le message garde son rôle et son objectif
Le système, l’utilisateur, le cas d’usage et la décision attendue sont séparés. L’historique utile est reconstruit explicitement ; il ne devient pas une mémoire implicite incontrôlée.
Le document transporte sa preuve métier
PDF, texte ou contenu préparé garde titre, version, statut, droits, date et propriétaire. La citation localise un passage ; votre référentiel décide encore si cette pièce fait foi.
Le budget de contexte est composé avant l’appel
Le comptage de tokens, la priorité des blocs, les exclusions et le cache des préfixes stables sont définis par scénario. Plus de contexte n’est jamais assimilé à plus de vérité.
Le mode de sortie répond au besoin de preuve
Une réponse citée explique les sources au lecteur. Un JSON strict sécurise la forme pour un traitement. Comme ces deux mécanismes ne se combinent pas dans le même appel, le parcours choisit et teste son contrat.
Tool use reste une boucle applicative
Claude renvoie un bloc tool_use ; votre application valide le nom et les arguments, exécute ou refuse, puis retourne tool_result. Le modèle ne reçoit jamais le droit d’exécuter seul votre code métier.
Le run rapproche technique et décision
Request ID, stop_reason, usage, cache, latence, erreurs, pièces, outil et verdict sont corrélés. Le support sait distinguer refus, contexte incomplet, quota, timeout et effet métier inconnu.
Méthode
Faire contester le dossier Anthropic avant de chercher à étendre le contexte
Le pilote part d’une décision connue et de trois pièces volontairement difficiles. Une personne différente de l’équipe de développement doit retrouver la sélection, ouvrir les citations, expliquer le mode de sortie, refuser l’outil hors mandat et reprendre un timeout. L’élargissement du corpus, les outils d’écriture et l’autonomie restent fermés tant que cette contestation ne peut pas être menée depuis la trace.
Fermer l’enveloppe documentaire
Chaque pièce garde identifiant, version, statut, propriétaire, niveau d’accès et date de validité.
Composer le contexte utile
Le pipeline compte, ordonne, exclut et met en cache les blocs stables sans confondre longueur et pertinence.
Choisir le contrat de réponse
Réponse citée pour expliquer une décision ou sortie JSON stricte pour alimenter un traitement : le choix est écrit.
Gouverner la boucle d’outil
Claude propose ; le middleware contrôle identité, état courant, idempotence et effet avant d’exécuter.
Premier lot Claude
Rejouer un dossier de trois pièces et un outil de lecture, sans aucune mutation.
On choisit une décision déjà tranchée, une pièce en vigueur, une ancienne version et une pièce inaccessible au rôle témoin. Le pilote doit sélectionner le bon corpus, produire soit une réponse citée soit une sortie structurée, proposer un outil de consultation autorisé, puis laisser une autre personne reconstituer le verdict. L’écriture reste fermée jusqu’à ce que la reprise soit démontrée.
Entrée : 3 pièces versionnées
Sortie : 1 preuve contestable
Suite : pilote réversible
Sorties concrètes
Matrice rôle × pièce × version × statut × droit × décision attendue × propriétaire de validation.
Deux contrats de sortie testés séparément : réponse avec citations ou JSON strict validé par le domaine.
Outil de lecture à schéma étroit, allowlist, contrôle serveur, timeout, stop_reason et résultat retourné à la boucle.
Trace minimale : correlation ID, request ID, modèle, tokens, cache, pièces retenues, outil proposé et verdict humain.
Scénarios de recette, non résultats client
Trois contre-tests propres à Anthropic avant d’étendre le pilote
Ces scénarios décrivent les preuves à produire dans votre environnement. Ils ne sont pas présentés comme des résultats déjà obtenus sur un projet client Dawap.
Claude cite exactement une clause qui ne fait plus foi
Le texte cité est correct et facile à retrouver. Une annexe plus récente remplace pourtant cette clause pour le compte analysé ; le moteur a privilégié la proximité sémantique plutôt que le statut documentaire.
- Entrée
- Dossier, identité, ACL, document ID, version, statut, dates d’effet, relation de remplacement, chunk, passage cité, réponse et pièce attendue.
- Sortie
- Enveloppe documentaire, filtrage par validité, graphe de versions, corpus contradictoire, règle d’abstention et écran permettant d’ouvrir la pièce source.
- Décision
- Bloquer la réponse si la validité de la pièce n’est pas résolue ; une citation exacte ne rend pas un document opposable.
Le même appel demande une réponse sourcée et un schéma strict incompatible
Le parcours veut afficher les passages justificatifs tout en envoyant directement un objet JSON garanti au workflow. La combinaison est refusée par l’API ; contourner l’erreur en supprimant les citations ferait disparaître la preuve attendue.
- Entrée
- Objectif utilisateur, mode de sortie demandé, configuration des documents, schéma, statut HTTP, type d’erreur, request ID et traitement de repli.
- Sortie
- Décision d’architecture par parcours, deux appels séparés si nécessaire, contrat de passage entre eux, validation serveur et test qui attend explicitement le refus incompatible.
- Décision
- Choisir la preuve prioritaire au lieu de fabriquer un faux hybride ; aucune donnée n’entre dans le workflow tant que le contrat de sortie reste ambigu.
Après un timeout, la boucle repropose un outil dont l’effet est inconnu
Claude émet un tool_use valide. Le middleware lance l’opération, perd la réponse puis reçoit une nouvelle proposition identique ; sans clé métier ni lecture de l’état courant, le rejeu peut dupliquer l’effet.
- Entrée
- Tool use ID, nom et version du schéma, arguments, rôle, autorisation, request ID, timeout, clé d’idempotence, état source, tool_result et stop_reason.
- Sortie
- Allowlist, validation des arguments, clé d’effet métier, lecture avant écriture, état indéterminé, réconciliation, confirmation et procédure de reprise.
- Décision
- Ne jamais rejouer sur le seul tool_use ; suspendre la boucle jusqu’à ce que l’état métier puisse être prouvé.
Frontières documentaires et IA
Relier Claude au bon corpus sans confondre fournisseur, RAG, sécurité et gestion documentaire
Anthropic porte le traitement et les outils ; chaque page voisine garde une responsabilité distincte sur l’architecture transverse, le cas d’usage, les accès ou la couche de connaissance.
Pour Branchassist, passer du SSO historique à Keycloak ne devait pas transférer aveuglément les autorisations. Dawap a séparé la connexion externe des droits internes : échange du code, contrôle de l’utilisateur actif, rôles Symfony, accès par ressource, révocation des jetons et trace des connexions. Une migration IAM ancrée dans l’application métier.
Entre le 22 mai et le 5 août 2026, Dawap construit la première fondation de son CMS : arbre de 83 nœuds, 249 versions françaises, anglaises et espagnoles, SEO localisé, API transactionnelle et back-office protégé. Chaque contenu conserve une identité stable tandis que son chemin et ses décisions de publication s’adaptent à la langue.
L’API Anthropic Claude permet d’utiliser contexte et outils, mais l’application doit contrôler les données transmises et les actions réellement exécutables. Pour éviter une conclusion trop rapide, mieux vaut définir garde-fous, validation et suivi des appels, afin de construire un assistant utile sans confondre une proposition du modèle avec une décision métier autorisée.
Un data contract API n’est pas un schéma décoratif. Il fixe la source de vérité, les statuts métiers, les règles de compatibilité et les écarts tolérés entre ERP, CRM, e-commerce et support. Ce guide aide à éviter les dérives silencieuses, à décider vite et à préserver un run lisible quand les flux évoluent sans bruit.
Questions d’achat
Questions fréquentes avant une intégration Anthropic Claude API
Réponses sur Messages API, documents citables, contexte, sorties structurées, tool use, coûts, sécurité et passage en production.
01Que renvoie la Messages API dans une application métier ?
Elle génère un message composé de blocs de contenu, par exemple du texte ou un appel d’outil. Votre application construit explicitement les tours utiles et interprète aussi le stop_reason, l’usage et les erreurs avant de poursuivre le workflow.
02Claude peut-il citer des documents internes ?
Oui. Des documents PDF, texte ou contenu préparé peuvent être fournis avec les citations activées. Le pipeline doit encore filtrer les droits, résoudre les versions et permettre au lecteur d’ouvrir la pièce qui fait réellement foi.
03Peut-on demander des citations et un JSON strict dans le même appel ?
Non dans la configuration actuelle : les citations et les sorties structurées strictes sont incompatibles dans une même requête. Il faut choisir le contrat adapté au parcours ou séparer les étapes avec une validation explicite entre les deux.
04Comment sécuriser un outil proposé par Claude ?
Les outils métier sont exécutés par votre application. Elle contrôle le nom, le schéma, les arguments, le rôle, l’état courant et l’idempotence, puis renvoie un tool_result. Une action sensible reste soumise à confirmation ou validation humaine.
05Comment maîtriser contexte, latence et coût ?
On compte les tokens avant les scénarios critiques, priorise les blocs, exclut les pièces inutiles, met en cache les préfixes réellement stables et suit tokens lus, écrits, latence et qualité par parcours. Le comptage reste une estimation à rapprocher de l’usage réel.
06Quel premier lot Claude recommandez-vous ?
Un dossier déjà tranché avec une pièce valide, une version obsolète, une source interdite et un outil de lecture. On teste citations et sortie structurée séparément, puis un timeout de tool use, avant toute mutation réelle.
API IA, data & search
Votre intégration Claude sait-elle expliquer quelle pièce elle a écartée ?
Dawap peut construire un dossier témoin, résoudre ses versions et ses droits, choisir le bon mode de réponse, borner les outils et préparer la trace qui rend le service Anthropic exploitable.
Cadrer mon dossier Claude