# devisoc ia construire arborescence

### Introduction

La fonctionnalité **Recherche de prestations par description libre** vous permet de décrire en langage naturel les besoins d'un projet et d'obtenir automatiquement une sélection de prestations issues de vos bibliothèques. Les prestations retenues sont intégrées directement dans votre affaire, avec **recréation automatique de leur arborescence complète** (lot > chapitre > prestation).

Cette fonctionnalité s'adresse à tous les utilisateurs DeviSOC impliqués dans la rédaction de CCTP : économistes de la construction, maîtres d'œuvre, bureaux d'études. Elle ne nécessite aucune connaissance de la structure interne des bibliothèques.

***

### À quoi ça sert ?

Constituer un CCTP nécessite traditionnellement de naviguer manuellement dans des bibliothèques volumineuses (BatiChiffrage, BatiCCTP, Clauses-Construction) en connaissant leur arborescence. Ce processus est chronophage et source d'oublis sur les projets complexes.

Avec cette fonctionnalité, vous décrivez votre besoin en quelques mots — l'IA identifie les prestations correspondantes et vous propose une sélection à intégrer en quelques clics.

***

### Comment lancer une recherche ?

{% stepper %}
{% step %}

### Ouvrir la boîte de dialogue

Dans DeviSOC, cliquez sur le bouton **"Rechercher des prestations"** dans le ruban principal (menu Intelligence artificielle). Une boîte de dialogue dédiée s'ouvre.
{% endstep %}

{% step %}

### Décrire votre besoin

Saisissez en langage naturel un ou plusieurs besoins de prestation dans le champ texte libre. Une seule saisie peut couvrir plusieurs ouvrages distincts.

**Exemples de descriptions valides :**

```
Isolation thermique par l'extérieur sur murs béton
Doublage placo BA13, faux-plafond dalles 60x60 et revêtement de sol carrelage grès cérame
Menuiseries extérieures aluminium double vitrage et garde-corps terrasse inox
```

{% endstep %}

{% step %}

### Paramétrer la recherche

Avant de lancer, vous pouvez ajuster deux paramètres :

* **Sources de recherche** : cochez ou décochez les bibliothèques à interroger (BatiChiffrage, BatiCCTP, Clauses-Construction, bibliothèque personnalisée). Par défaut, toutes les bibliothèques actives sont sélectionnées.
* **Nombre de propositions par prestation** : définissez le nombre maximum de prestations candidates à afficher par ouvrage (ex. : 3, 5, 10).

Cliquez ensuite sur **"Lancer la recherche"**.
{% endstep %}

{% step %}

### Valider les ouvrages extraits

L'IA décompose automatiquement votre description en **ouvrages distincts**. Par exemple, la description *"Doublage placo BA13, faux-plafond dalles 60x60 et revêtement de sol carrelage grès cérame"* génère trois ouvrages :

1. Doublage de cloison — plaque de plâtre BA13
2. Faux-plafond — dalles 60x60
3. Revêtement de sol — carrelage grès cérame

Vérifiez la liste des ouvrages extraits et confirmez avant de lancer la recherche dans les bibliothèques.
{% endstep %}

{% step %}

### Sélectionner les prestations candidates

La boîte de dialogue de résultats s'ouvre, organisée en pages (une page par ouvrage). Pour chaque ouvrage, vous voyez la liste des prestations candidates avec :

* L'intitulé complet et le code de la prestation
* Le descriptif (dépliable pour afficher le contenu complet)
* L'unité et le prix unitaire de référence
* La bibliothèque source et l'arborescence d'origine
* Le **niveau de confiance** (pourcentage de pertinence)

Cochez zéro, une ou plusieurs prestations par ouvrage selon vos besoins. Naviguez entre les ouvrages via les boutons Précédent / Suivant. Votre sélection est conservée pendant toute la navigation.
{% endstep %}

{% step %}

### Intégrer dans l'affaire

Cliquez sur **"Appliquer les prestations sélectionnées"**. DeviSOC recrée automatiquement l'arborescence complète (lot > chapitre > prestation) avec toutes les données associées (code, titre, descriptif, unité, prix). Si un élément est déjà présent dans l'affaire, il est mis à jour — aucune duplication n'est introduite.

Un **récapitulatif post-intégration** liste les prestations ajoutées ou mises à jour.
{% endstep %}
{% endstepper %}

***

### Le Volet IA — historique de session

Chaque recherche lancée est consignée dans le **Volet IA** (panneau latéral rétractable) sous forme de bulles de conversation horodatées. Depuis ce volet, vous pouvez :

* Rouvrir la boîte de résultats d'une recherche passée via le bouton **"Revoir"**
* Reprendre une sélection non finalisée
* Enchaîner plusieurs recherches dans la même session pour enrichir progressivement le CCTP

***

### Bonnes pratiques

* **Soyez précis mais naturel** : *"isolation thermique par l'extérieur sur murs béton"* donne de meilleurs résultats que *"ITE"*.
* **Regroupez des ouvrages liés** dans une même description pour gagner du temps, et séparez-les si les résultats sont insatisfaisants.
* **Consultez le niveau de confiance** : un score élevé (> 80 %) indique une correspondance fiable ; un score faible invite à vérifier la pertinence avant sélection.
* **Utilisez "Modifier la recherche"** si les résultats ne correspondent pas — vous pouvez reformuler sans perdre la session.

***

### Limites actuelles

* Seules les bibliothèques pour lesquelles votre organisation dispose d'une **licence active** sont interrogées. Si aucune bibliothèque n'est disponible, la recherche ne peut pas être lancée.
* En V1, le contexte du projet (localisation, type de marché, phase…) n'est pas transmis automatiquement au serveur — seule votre description est analysée.
* En cas de timeout ou d'erreur serveur, un message s'affiche avec une option de réessai.
* La fermeture de la boîte de dialogue sans validation ne perd pas les résultats : le bouton **"Revoir"** dans le Volet IA permet d'y revenir.

***

### Foire aux questions

<details>

<summary>L'IA peut-elle intégrer des prestations sans que je valide ?</summary>

Non. Aucune prestation n'est ajoutée à votre affaire sans que vous ayez cliqué sur "Appliquer les prestations sélectionnées". Vous restez décisionnaire à chaque étape.

</details>

<details>

<summary>Puis-je rechercher des prestations depuis ma bibliothèque personnalisée ?</summary>

Oui. Votre bibliothèque personnalisée (fichiers DVS importés) est toujours disponible, indépendamment des licences sur les bibliothèques de référence.

</details>

<details>

<summary>Que se passe-t-il si une prestation est déjà présente dans mon affaire ?</summary>

Elle est **mise à jour** avec les données de la bibliothèque source. Aucune duplication n'est créée.

</details>

<details>

<summary>Puis-je faire plusieurs recherches à la suite dans la même session ?</summary>

Oui. Chaque recherche est historisée dans le Volet IA. Vous pouvez enchaîner des recherches successives pour composer votre CCTP progressivement.

</details>

<details>

<summary>Le niveau de confiance est faible sur certaines prestations — que faire ?</summary>

Vérifiez le descriptif complet de la prestation avant de la sélectionner. Un faible score peut indiquer que le libellé est spécifique ou formulé différemment des standards bibliothèques.

</details>

***

### Glossaire

| Terme                    | Définition                                                                                                                |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| **Ouvrage**              | Unité de recherche extraite de votre description, correspondant à un besoin de prestation distinct                        |
| **Prestation candidate** | Prestation issue d'une bibliothèque métier proposée par l'IA en réponse à la recherche                                    |
| **Niveau de confiance**  | Pourcentage reflétant la pertinence sémantique d'une prestation candidate par rapport à l'ouvrage recherché               |
| **Arborescence**         | Structure hiérarchique lot > chapitre > prestation recréée automatiquement dans l'affaire                                 |
| **Volet IA**             | Panneau latéral rétractable conservant l'historique des recherches de la session                                          |
| **RAG**                  | Technique d'IA combinant base de données vectorielle et modèle de langage pour des résultats basés sur vos données métier |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.socinformatique.fr/devisoc/devisoc-ia-construire-arborescence.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
