> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bookivox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Le canevas du builder

> L'éditeur de workflow : barre d'outils, canevas, ajout de nœuds, et le dialogue d'édition des nœuds avec ses trois onglets.

Le **canevas** est l'éditeur où vous construisez concrètement un agent
(`/workflow/[identifiant]`). C'est là que vivent les nœuds et les liens entre
eux.

## La barre d'outils

Sur le bord gauche de l'éditeur, une barre verticale regroupe les actions
principales :

| Action | Rôle |
| - | - |
| **Ajouter un nœud** | Ouvre le panneau de nœuds disponibles |
| **Paramètres** | Ouvre les [réglages de l'agent](https://docs.bookivox.com/workflow/agent-settings.md) |
| **Versions** | Consulte les versions brouillon / publiée / archivée |
| **Tester** | Lance un test (chat texte ou appel web) |
| **Appel test** | Démarre un appel de test en direct |
| **Exécutions** | Ouvre l'historique des appels de cet agent |
| **Plus** | Dupliquer, exporter, copier la définition |

> [!NOTE]
>
> Enregistrez vos modifications avec **Cmd+S** (macOS) ou **Ctrl+S**
> (Windows/Linux). Le statut de l'agent (brouillon / publié) s'affiche dans la
> barre d'outils.

## Ajouter un nœud

L'action **Ajouter un nœud** ouvre un panneau latéral où les nœuds sont
classés par catégorie :

| Catégorie | Contenu |
| - | - |
| **Déclencheurs** | Comment l'appel démarre (départ d'appel, déclencheur API) |
| **Nœuds d'appel** | Étapes de la conversation (étape agent, fin d'appel) |
| **Nœuds globaux** | Comportements transverses (nœud global) |
| **Intégrations** | Actions externes (webhook, QA) |

Cliquez sur un nœud pour l'ajouter au canevas, puis **reliez** les nœuds entre
eux en tirant un lien d'une poignée de sortie vers une poignée d'entrée.

> [!TIP]
>
> La liste des types de nœuds est fournie **dynamiquement** par Bookivox. Lorsque
> de nouveaux nœuds sont publiés côté plateforme, ils apparaissent ici sans mise à
> jour de votre part.

## Éditer un nœud

Un clic sur un nœud ouvre le **dialogue d'édition**, organisé en trois
onglets :

**Général**

Les propriétés propres au nœud : nom, prompt, voix, modèle, transitions.
Voir [Onglet Général](https://docs.bookivox.com/workflow/node-general.md).

**Outils**

Les **outils** que l'agent peut appeler depuis ce nœud (appels HTTP,
transfert, fin d'appel). Voir [Onglet Outils](https://docs.bookivox.com/workflow/node-tools.md).

**Connaissance**

Les **documents** de la base de connaissance mis à disposition du nœud.
Voir [Onglet Connaissance](https://docs.bookivox.com/workflow/node-knowledge.md).

Les champs de l'onglet **Général** sont affichés **dynamiquement** selon le
type de nœud : chaque propriété est rendue par le widget adapté (zone de texte
avec mentions, sélecteur d'outils, sélecteur de documents, choix d'un
enregistrement, choix d'un identifiant…). Vous ne voyez donc que les champs
pertinents pour le nœud sélectionné.

## Le panneau de test

Sur le bord droit, un **panneau de test** permet d'éprouver l'agent sans
téléphonie :

* un onglet **Audio** (appel web via le micro) ;
* un onglet **Texte** (chat écrit, idéal pour itérer sur un prompt).

Voir [Tester et publier](https://docs.bookivox.com/workflow/testing-and-versions.md).

> **[Types de nœuds](https://docs.bookivox.com/workflow/nodes/start-call.md)**
>
> Le rôle de chaque nœud.

> **[Réglages de l'agent](https://docs.bookivox.com/workflow/agent-settings.md)**
>
> Paramètres globaux du workflow.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.