Passer au contenu

    EXEMPLE : une entreprise fictive. Pas un client d'Adwaizer.

    Version française de l'exemple de rapport en anglais. Même contenu, mêmes chiffres et mêmes conditions que la version anglaise ; en cas d'écart, la version anglaise fait foi.

    Agent de réponse documentaire : rapport de remise pour Ottermoss Gear Rentals (exemple)

    Préparé par : Adwaizer AI Consulting Inc. · Mandat : Agent de réponse documentaire (Document Answer Agent) · Version du rapport : exemple, octobre 2026

    Ce qu'est cette page. Voici le rapport de remise que le client conserve à la fin de la réalisation de l'Agent de réponse documentaire. Ottermoss Gear Rentals, ses employés, son centre d'aide, chaque passage cité ci-dessous et chaque résultat sont inventés pour montrer la forme et le niveau de détail ; rien de tout cela n'existe, et toute ressemblance avec une entreprise réelle est une coïncidence. Dans une vraie réalisation, chaque ligne renvoie aux propres documents du client, à son dépôt et à son exécution des tests.

    Comment lire les chiffres. Chaque chiffre de ce rapport est illustratif : inventé pour cet exemple, pas mesuré. Ils sont marqués (illustratif) là où ils apparaissent. Les seuils de réussite (recall@5 d'au moins 0.85, 10 questions avec citations, 3 refus) sont le test d'acceptation de l'offre, pas des résultats. Un vrai rapport montre l'exécution du client lui-même, et ses chiffres peuvent être plus élevés ou plus bas.


    1. Ce qui a été réalisé

    Ottermoss Gear Rentals est une boutique fictive de location d'équipement de plein air (tentes, canots, équipement d'hiver) avec une équipe au comptoir et une page de réservation en ligne. Les clients posent les mêmes questions par courriel et au comptoir ; le personnel cherche les réponses dans le centre d'aide de la boutique. Ottermoss a demandé un assistant qui répond uniquement à partir du centre d'aide et qui montre d'où vient chaque réponse.

    ÉlémentCe qui a été livré
    Documents couvertsUn format : les articles du centre d'aide exportés en HTML, (illustratif) 212 articles découpés en 1,486 passages. Chaque passage a un identifiant stable (par exemple hc-rentals-014.p3) et un lien vers son article
    Non cités4 articles de la liste « à ne pas citer » du client (rémunération du personnel, conditions des fournisseurs) (nombre illustratif), exclus à l'intégration et énumérés dans la note de remise
    Qui l'utiliseLe personnel du comptoir, avec Claude Desktop et le serveur MCP (search, get_section, verify_citations) ; l'équipe de la page de réservation de la boutique, avec l'API REST (/v1/search, /v1/sections/{id}, /v1/research)
    Comment une réponse fonctionneLa recherche renvoie les meilleurs passages ; la réponse cite les identifiants des passages et les reprend mot pour mot ; le vérificateur contrôle chaque citation par rapport au passage avant que la réponse ne soit affichée ; les questions que le centre d'aide ne couvre pas reçoivent un refus
    Où il se trouveDans le propre dépôt du client et dans le propre compte d'API de modèle du client. Nos copies des documents ont été supprimées à la remise (liste de contrôle de remise, point 7)

    2. Test d'acceptation

    Le jour de la remise, le client a exécuté les quatre contrôles de l'offre avec le guide d'exploitation. Les quatre ont réussi (illustratif).

    #Contrôle (seuil de réussite de l'offre)Résultat (illustratif)Réussi
    1Évaluation de la recherche sur le jeu de référence : recall@5 d'au moins 0.850.90 sur 30 questions de référence (27 sur 30 trouvées dans les 5 premiers)Oui
    210 questions de référence : chaque affirmation montre une référence et une citation, et est marquée vérifiée ou visiblement « non vérifiée »10 réponses, 23 affirmations : 22 vérifiées, 1 affichée comme « non vérifiée », 0 masquéeOui
    33 questions hors des documents : chacune refusée, aucune référence inventée3 sur 3 refusées, 0 référenceOui
    4Chaque réponse indique les jetons, les USD et les secondes13 réponses sur 13Oui

    Le jeu de référence. Chaque question de référence tient sur une ligne : la question telle qu'un client la poserait, et l'identifiant du passage qu'une personne désignerait. Ottermoss en a fourni 30 (illustratif) ; nous les avons rédigées au jour 1 et le client les a corrigées.

    Dix des questions de référence (résultats illustratifs) :

    QuestionPassage attenduRang obtenu
    Puis-je prendre un canot le soir avant le début de ma location?hc-rentals-014.p31
    Que se passe-t-il si je rapporte une tente en retard?hc-returns-002.p11
    Louez-vous des raquettes pour enfants?hc-winter-007.p22
    Un gilet de sauvetage est-il inclus avec un kayak?hc-water-003.p11
    Quel est le dépôt pour dommages sur un canot?hc-deposits-001.p21
    Puis-je changer les dates de ma réservation en ligne?hc-booking-009.p13
    Dois-je nettoyer le réchaud avant de le rapporter?hc-returns-005.p41
    Quelqu'un d'autre peut-il prendre ma réservation?hc-rentals-021.p12
    Les animaux sont-ils permis dans les tentes louées?hc-camping-011.p21
    Que faire si une fermeture éclair brise en sentier?hc-repairs-004.p1pas dans les 5 premiers (l'un des 3 échecs)

    Les échecs, et ce qui a été corrigé. Au jour 7, la première exécution a obtenu (illustratif) 0.77. Deux corrections l'ont portée à 0.90 : (1) le titre de l'article a été ajouté au texte de recherche de chaque passage, pour que les questions sur les « fermetures éclair » atteignent l'article sur les réparations ; (2) deux réponses de FAQ que l'exportation avait fusionnées en un seul passage ont été séparées. Les 3 échecs restants (illustratif) sont des questions formulées très différemment de tous les articles ; ils sont énumérés dans le rapport d'évaluation pour qu'Ottermoss puisse ajouter une phrase à son centre d'aide si elle le souhaite.


    3. Exemples de réponses

    Trois réponses telles que le personnel les voit, et un refus. Les passages sources sont inventés pour cet exemple (traduits de l'anglais).

    Réponse 1. Question : « Puis-je prendre un canot le soir avant le début de ma location? »

    Oui, moyennant des frais. La prise de l'équipement la veille au soir est offerte pour les canots et les kayaks lorsque la boutique en a en stock.

    • Affirmation : il est possible de prendre un canot la veille au soir. Référence hc-rentals-014.p3, citation : « Les canots et les kayaks peuvent être pris après 17 h la veille du début de votre location, selon la disponibilité. » Vérifiée.
    • Affirmation : des frais s'appliquent. Référence hc-rentals-014.p4, citation : « La prise anticipée est facturée comme une demi-journée. » Vérifiée.

    Jetons 2,940 · USD 0.011 · 3.8 s (illustratif)

    Réponse 2. Question : « Que se passe-t-il si je rapporte une tente en retard? »

    Un retour en retard est facturé par jour, et la boutique conserve le dépôt jusqu'au retour de l'équipement.

    • Affirmation : les retours en retard sont facturés par jour. Référence hc-returns-002.p1, citation : « L'équipement rapporté après l'heure de fermeture à la date prévue est facturé une journée de plus pour chaque jour de retard. » Vérifiée.
    • Affirmation : le dépôt est conservé. Référence hc-deposits-001.p4, citation : « Nous libérons votre dépôt une fois que tous les articles sont rapportés et vérifiés. » Vérifiée.

    Jetons 3,105 · USD 0.012 · 4.1 s (illustratif)

    Réponse 3, avec une affirmation affichée comme non vérifiée. Question : « Louez-vous des raquettes pour enfants? »

    Oui. Les raquettes pour enfants sont louées en deux tailles.

    • Affirmation : des raquettes pour enfants sont offertes. Référence hc-winter-007.p2, citation : « Des raquettes jeunesse sont offertes pour les enfants à partir d'environ 20 kg. » Vérifiée.
    • Affirmation : il y a deux tailles. Référence hc-winter-007.p2, citation : « Les raquettes jeunesse sont offertes en deux tailles. » Non vérifiée : cette phrase ne se trouve pas dans le passage, qui n'indique aucun nombre de tailles. Le tour de correction du modèle ne l'a pas réglé, donc l'affirmation est affichée marquée « non vérifiée » plutôt que masquée.

    Jetons 3,420 · USD 0.013 · 6.2 s, tour de correction compris (illustratif)

    C'est le vérificateur qui fonctionne comme prévu : le lecteur voit quelle partie vérifier. Après cette exécution, Ottermoss a décidé s'il fallait ajouter les tailles à son centre d'aide ; l'agent lui-même ne comble jamais le manque.

    Un refus. Question : « Quel sentier près du lac est le plus sûr pour les débutants? »

    Je ne peux pas répondre à cette question à partir du centre d'aide d'Ottermoss : aucun de ses articles ne traite du choix ou de la sécurité des sentiers. Veuillez vous adresser à un membre du personnel.

    Aucune référence. Jetons 1,210 · USD 0.004 · 2.0 s (illustratif)

    La règle de refus : quand aucun passage n'appuie une réponse, l'agent le dit et ne cite rien ; il n'invente jamais de référence et ne répond jamais à partir de connaissances générales.


    4. Coût par réponse et limites

    Coût par réponse. Chaque réponse indique les jetons, les USD et les secondes, comme à la section 3. Lors de l'exécution d'acceptation (illustratif) : 13 réponses, médiane de 3,000 jetons, USD 0.011 et 3.9 secondes par réponse, et la plus coûteuse a été de USD 0.013 (la réponse avec un tour de correction). Le montant en USD est calculé à partir de la grille de prix par jeton du modèle, qui se trouve dans le dépôt et que le client met à jour quand le fournisseur change ses prix. Le coût du modèle est payé dans le propre compte d'API d'Ottermoss. La recherche et le vérificateur ne font aucun appel au modèle et ne coûtent rien par question.

    Limites, telles que l'offre et la trousse les énoncent.

    • L'agent cite les documents d'Ottermoss. Il ne juge pas s'ils sont exacts ou à jour ; un article périmé donne une réponse périmée, avec sa citation.
    • Un format de document (l'exportation HTML du centre d'aide). Les PDF, les pages numérisées qui demandent une reconnaissance optique de caractères (OCR) et l'écriture manuscrite ne sont pas lus ; un autre format fait l'objet d'un devis distinct.
    • Les passages de la liste « à ne pas citer » sont exclus à l'intégration ; ajouter des éléments à cette liste demande de relancer l'intégration (guide d'exploitation, section 3).
    • Aucune promesse d'exactitude au-delà du test d'acceptation. « Vérifiée » signifie que chaque citation est le texte mot pour mot du passage cité, pas que la réponse est juste.
    • Ce n'est pas un avis juridique, médical, financier ou professionnel d'autre nature.
    • L'hébergement, la surveillance et les coûts d'exploitation après la remise ne sont pas inclus.

    5. Liste de contrôle de remise

    #ÉlémentÉtat (illustratif)
    1Code source dans le dépôt d'Ottermoss, avec l'adaptateur d'intégration, l'API, le vérificateur et le serveur MCPFait
    2Les tests réussissent avec le modèle simulé ; gitleaks propre à chaque envoiFait
    3Jeu de référence (30 questions, illustratif) et rapport d'évaluation : score, échecs, correctionsFait
    4Rapport de coût par réponse et la grille de prix qu'il utiliseFait
    5Guide d'exploitation d'une page, y compris claude mcp add pour le serveur MCP et la façon de relancer l'intégrationFait
    6Liste de contrôle d'acceptation (les quatre contrôles de la section 2), exécutée et signée par la personne-ressource désignée du clientFait
    7Nos copies des documents supprimées ; la clé d'API est restée dans le propre compte d'Ottermoss du début à la finFait
    8Appel de présentation de 45 minutesFait
    9Note de remise énumérant tout ce qui se trouve dans le dépôt, la liste « à ne pas citer » et les 3 échecs de l'évaluationFait

    Si un contrôle avait échoué, la période de correction de l'offre s'applique : correction dans un délai de 5 jours ouvrables, sans frais.


    Exemple de rapport. Ottermoss Gear Rentals est fictive ; toute ressemblance avec une entreprise réelle est une coïncidence. Adwaizer AI Consulting Inc. ne promet aucun résultat d'exactitude ni d'économies au-delà du test d'acceptation ; chaque résultat ci-dessus est illustratif.