Rechercher dans la documentation

Rechercher dans la documentation

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émentCe que c'estOutil
QuestionCe qui reste à trancheropen_question
PreuveCe qui appuie une réponse : citation, valeur retenue, observationsave_finding
OptionUne manière de trancher la question, nommée dès son ouverturelistée dans open_question
DécisionCe que l'ingénieur a confirmé, et pourquoirecord_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 :

TypeCe que c'estChamps attendus
referenceCe que la norme ditnormCode, sectionPath, page
hypothesisLa valeur retenue par l'ingénieur, et pourquoivalue, detail, confidence
observationCe 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 norme
  • judgement : choisie par l'ingénieur entre plusieurs valeurs possibles
  • to_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.

namestringrequired

Le nom sous lequel vous parlez du projet, par exemple « Villa Morges — toiture ». C'est ce nom que vous emploierez pour le reprendre.

referencestring

Le 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.

dossierIdstringrequired

Renvoyé par open_dossier ou list_dossiers.

titlestringrequired

La question en une ligne, formulée comme une question.

bodystring

Ce qui est en jeu et pourquoi ce n'est pas tranché, en deux ou trois phrases. Pas une liste de sous-questions.

optionsarray

Les 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.

dossierIdstringrequired

Le dossier.

attachmentsarray

id, 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.

attachmentIdstringrequired

Depuis list_attachments ou search_in_dossier.

fromnumberdefault: 1

Première page.

tonumberdefault: dernière

Dernière page.

maxCharsnumberdefault: 12000

Caractères par appel (500 à 40000). Quand truncated vaut true, rappeler avec from à nextPage.

markdownstring

Les 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.

dossierIdstringrequired

Le dossier.

keywordstringrequired

Termes de recherche dans la langue des documents.

limitnumberdefault: 10

Nombre maximal de correspondances (1 à 30).

hitsarray

attachmentId, 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.

templatesarray

id, 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.

dossierIdstringrequired

Le dossier.

templateIdstringrequired

Depuis list_templates.

resultobject

questionsOpened, 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.

dossierIdstringrequired

Renvoyé par open_dossier ou list_dossiers.

questionIdstring

La 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.

kindstringrequired

reference, hypothesis ou observation. Voir le tableau plus haut.

titlestringrequired

Le fait en une ligne, comme un ingénieur l'écrirait dans un rapport.

detailstring

Le raisonnement : pourquoi cette valeur, ce sur quoi elle repose, ce qui la contredit.

valuestring

La valeur retenue avec son unité, par exemple 30° ou 1,25 kN/m².

confidencestring

established, judgement ou to_confirm.

normCodestring

Norme d'origine, par exemple SIA 267.

sectionPathstring

Chemin de section exact, par exemple 9.5.2.1.

pagenumber

Page dans la norme, pour que vous puissiez le vérifier dans votre PDF.

normEditionstring

L'é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.

questionIdstringrequired

Renvoyée par open_question ou load_dossier.

retainedOptionstring

L'option retenue, par son nom, quand la question en listait. Une option non listée jusque-là est créée à la volée.

titlestringrequired

La décision en une ligne.

detailstring

Le raisonnement.

valuestring

La valeur retenue avec son unité, quand la décision en porte une.

confidencestring

established, judgement ou to_confirm.

normCodestring

Norme d'origine.

sectionPathstring

Chemin de section exact.

pagenumber

Page dans la norme.

normEditionstring

L'é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à.

namestring

Le 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.

questionIdstringrequired

Renvoyée par open_question ou load_dossier.

resolvedboolean

true par défaut. Passez false pour rouvrir une question.


Limites

Pour borner un agent qui boucle, sans que cela ne se facture :

LimiteValeur
Dossiers par organisation200
Questions par dossier200
Options par question10
Entrées par dossier500
Commentaires par dossier500

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.