Outils de dossier
Les 7 outils qui gardent trace de ce qui a été décidé sur un projet.
Une conversation disparaît, un projet dure des mois. Ces treize outils permettent à votre agent d'écrire ce qui a été retenu dans un dossier que vous rouvrez, annotez et exportez depuis stratta.ch/dossiers.
Vous ne les appelez pas à la main. Votre agent le fait pendant qu'il travaille, en suivant la
politique décrite dans get_methodology.
Ces outils sont ouverts à tout membre de l'organisation, contrairement aux outils d'ingestion réservés aux propriétaires et administrateurs. Un dossier est votre travail, pas le corpus partagé du bureau.
Ce qu'un dossier contient
Un dossier est un ensemble de questions à trancher, par exemple « Le pieu P38 peut-il être conservé ? » ou « Quel φ'k retenir pour le remblai ? ». C'est la question, et non l'entrée isolée, qui est l'unité de travail : c'est elle qu'on assigne, qu'on relit et qu'on clôt.
| Élément | Ce que c'est | Outil |
|---|---|---|
| Question | Ce qui reste à trancher | open_question |
| Preuve | Ce qui appuie une réponse : citation, valeur retenue, observation | save_finding |
| Option | Une manière de trancher la question, nommée dès son ouverture | listée dans open_question |
| Décision | Ce que l'ingénieur a confirmé, et pourquoi | record_decision |
Une preuve peut être enregistrée avant même de savoir à quelle question elle sert : elle reste alors « à classer », et vous la rattachez ensuite depuis l'application. Trois types de preuve, et la distinction n'est pas décorative :
| Type | Ce que c'est | Champs attendus |
|---|---|---|
reference | Ce que la norme dit | normCode, sectionPath, page |
hypothesis | La valeur retenue par l'ingénieur, et pourquoi | value, detail, confidence |
observation | Ce que le terrain a montré | detail avec la date |
En calcul de structure, une valeur retenue est le résultat d'une formule et se recalcule. En
géotechnique, c'est un jugement posé entre trois sondages qui ne disent pas la même chose, et
la seule chose relisible six mois plus tard est le raisonnement. D'où le champ confidence :
established: calculée, ou lue directement dans la normejudgement: choisie par l'ingénieur entre plusieurs valeurs possiblesto_confirm: provisoire, demande un essai ou une vérification
Confondre les trois est la faute professionnelle que ce champ existe pour éviter.
list_dossiers
Liste les dossiers de votre organisation, le plus récemment modifié en tête. Chaque ligne porte le nombre d'entrées et surtout le nombre de questions ouvertes : c'est ce qui désigne le dossier à reprendre.
Aucun paramètre.
open_dossier
Ouvre le dossier d'un projet, en le créant s'il n'existe pas encore.
namestringrequiredLe nom sous lequel vous parlez du projet, par exemple « Villa Morges — toiture ». C'est ce nom que vous emploierez pour le reprendre.
referencestringLe numéro de projet de votre bureau, s'il y en a un.
Idempotent sur le nom. Appeler l'outil deux fois avec le même nom renvoie le même dossier plutôt que d'en créer un second qui couperait l'historique du projet en deux.
Renvoie { dossierId, created }.
open_question
Ouvre une question à trancher dans un dossier, avant de rassembler des preuves pour elle. Une
question est l'unité de travail : « Le pieu P38 peut-il être conservé ? », « Quel φ'k retenir pour
le remblai ? ». Les preuves enregistrées avec save_finding et l'éventuelle décision de
record_decision s'y rattachent.
Une seule question par chose à trancher : une question dont le corps liste huit sous-questions ne peut être ni assignée, ni répondue, ni close une à une. Ouvrez huit questions.
dossierIdstringrequiredRenvoyé par open_dossier ou list_dossiers.
titlestringrequiredLa question en une ligne, formulée comme une question.
bodystringCe qui est en jeu et pourquoi ce n'est pas tranché, en deux ou trois phrases. Pas une liste de sous-questions.
optionsarrayLes manières de trancher la question, quand la norme ou vous en mettez plusieurs sur la table : « abandonner le pieu », « le récupérer par reprise en sous-œuvre et essais d'intégrité », « redistribuer sur P37/P39 ». Un nom court par option, dix au maximum.
Idempotent sur le titre. Rouvrir la même formulation renvoie la question déjà ouverte, avec ses preuves.
Renvoie { questionId, created }.
list_attachments
Liste les pièces d'un dossier (rapports, forages, procès-verbaux, fiches techniques) avec l'état de leur extraction. Un agent les lit avant de répondre sur un projet.
dossierIdstringrequiredLe dossier.
attachmentsarrayid, name, mimeType, bytes, pageCount, status (pending, ready,
failed), note, addedAt.
read_attachment
Lit le texte d'une pièce sous forme de document Markdown, page par page, par fenêtres.
attachmentIdstringrequiredDepuis list_attachments ou search_in_dossier.
fromnumberdefault: 1Première page.
tonumberdefault: dernièreDernière page.
maxCharsnumberdefault: 12000Caractères par appel (500 à 40000). Quand truncated vaut true, rappeler
avec from à nextPage.
markdownstringLes pages lues, chacune sous un titre ## p. N. Un scan sans couche de texte
le dit.
search_in_dossier
Recherche plein texte dans les pièces d'un dossier, accents et casse ignorés.
dossierIdstringrequiredLe dossier.
keywordstringrequiredTermes de recherche dans la langue des documents.
limitnumberdefault: 10Nombre maximal de correspondances (1 à 30).
hitsarrayattachmentId, name, page, snippet.
Sur le serveur local seulement, add_attachment téléverse un fichier depuis
la machine de l'utilisateur (PDF, DOCX, XLSX, PNG, JPEG, TXT, MD, CSV, 25 Mo
au plus, 20 par dossier). Le connecteur distant n'a pas de disque : déposez la
pièce depuis la page du dossier.
list_templates
Liste les gabarits de dossier de l'organisation : des listes de questions par type d'ouvrage, avec les clauses sur lesquelles chacune repose. Aucun paramètre.
templatesarrayid, name, description, questions, citations.
apply_template
Ouvre les questions d'un gabarit dans un dossier, avec leurs options, et dépose sous chacune une
entrée reference pour chaque clause qui se résout dans le corpus. Une clause que
l'organisation ne peut pas lire est écrite dans le corps de la question comme à établir.
Appliquer deux fois n'ouvre rien deux fois.
dossierIdstringrequiredLe dossier.
templateIdstringrequiredDepuis list_templates.
resultobjectquestionsOpened, referencesFiled, unresolved[] (question, normCode,
sectionPath).
save_finding
Enregistre une preuve dans un dossier. Votre agent l'appelle au fil du travail, pas en lot à la fin : une preuve consignée au moment où elle est trouvée garde le raisonnement qui l'a produite.
dossierIdstringrequiredRenvoyé par open_dossier ou list_dossiers.
questionIdstringLa question que cette preuve sert, renvoyée par open_question ou
load_dossier. Omis uniquement quand vous ne savez pas encore laquelle : la
preuve est enregistrée « à classer », et vous la rattachez plus tard depuis
l'application.
kindstringrequiredreference, hypothesis ou observation. Voir le tableau plus haut.
titlestringrequiredLe fait en une ligne, comme un ingénieur l'écrirait dans un rapport.
detailstringLe raisonnement : pourquoi cette valeur, ce sur quoi elle repose, ce qui la contredit.
valuestringLa valeur retenue avec son unité, par exemple 30° ou 1,25 kN/m².
confidencestringestablished, judgement ou to_confirm.
normCodestringNorme d'origine, par exemple SIA 267.
sectionPathstringChemin de section exact, par exemple 9.5.2.1.
pagenumberPage dans la norme, pour que vous puissiez le vérifier dans votre PDF.
normEditionstringL'édition citée, par exemple « 2013 » ou « 2020 + rect. 2022 », quand
list_norms la donne.
record_decision
Tranche une question avec une décision confirmée par l'ingénieur : ce qui a été décidé, pourquoi, et l'article sur lequel cela repose. La question sort des points ouverts et garde ses preuves ; la décision devient l'entrée qu'un relecteur lit en premier.
Votre agent ne l'appelle qu'une fois que vous avez confirmé la décision, jamais sur son seul raisonnement.
questionIdstringrequiredRenvoyée par open_question ou load_dossier.
retainedOptionstringL'option retenue, par son nom, quand la question en listait. Une option non listée jusque-là est créée à la volée.
titlestringrequiredLa décision en une ligne.
detailstringLe raisonnement.
valuestringLa valeur retenue avec son unité, quand la décision en porte une.
confidencestringestablished, judgement ou to_confirm.
normCodestringNorme d'origine.
sectionPathstringChemin de section exact.
pagenumberPage dans la norme.
normEditionstringL'édition citée.
Renvoie { entryId }.
load_dossier
Recharge tout ce qu'un dossier contient : ses questions avec leurs preuves, leurs options et leur décision, puis les preuves qui ne sont pas encore rattachées à une question, puis les commentaires. Les questions ouvertes viennent en premier : lisez-les avant tout le reste et dites à l'utilisateur ce qui est encore ouvert.
Dites simplement « reprends le dossier Villa Morges » : votre agent appelle cet outil avant de répondre quoi que ce soit sur le projet, et repart de ce qui a été décidé au lieu de le redécider.
dossierIdstringÀ privilégier quand l'agent l'a déjà.
namestringLe nom du projet, quand vous le nommez plutôt que de donner un identifiant. Correspondance exacte.
L'un des deux est nécessaire.
resolve_question
Clôt une question qui a cessé d'importer sans décision : la variante a été abandonnée, le
client a retiré la demande, la question est devenue sans objet. La question reste dans le dossier,
marquée close, avec ses preuves. Pour trancher une question avec une réponse, appelez
record_decision.
questionIdstringrequiredRenvoyée par open_question ou load_dossier.
resolvedbooleantrue par défaut. Passez false pour rouvrir une question.
Limites
Pour borner un agent qui boucle, sans que cela ne se facture :
| Limite | Valeur |
|---|---|
| Dossiers par organisation | 200 |
| Questions par dossier | 200 |
| Options par question | 10 |
| Entrées par dossier | 500 |
| Commentaires par dossier | 500 |
Un dossier visé n'accepte plus d'entrée ni de modification. Les commentaires, eux, restent ouverts : la clôture d'un dossier n'est pas la fin de la conversation à son sujet.
Ce que Stratta ne fait pas
Le dossier documente le raisonnement de l'ingénieur, il ne le remplace pas. Stratta ne conclut jamais à la conformité d'un ouvrage, et un agent ne doit écrire aucune hypothèse que vous n'avez pas validée.