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

# Prompt système ou générateur de Flow

> Deux façons de définir le comportement d'un assistant — et quand utiliser laquelle

Un assistant peut être piloté de deux façons : un **prompt système** unique, ou un **flux** visuel. Les deux s'appuient sur le même moteur vocal ; la différence tient à la structure que vous imposez à la conversation.

## Ce qui compose un assistant

Chaque assistant combine les mêmes éléments, quelle que soit la façon dont vous configurez son comportement :

| Élément            | Ce qu'il contrôle                                                                                                                                                                                |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Comportement**   | Un prompt système ou un flux — voir ci-dessous                                                                                                                                                   |
| **Mode moteur**    | [Pipeline, realtime ou half-cascade](/fr/assistants/engine-modes) — comment il écoute et parle                                                                                                   |
| **Modèle et voix** | Le [modèle de langage, la reconnaissance vocale et la voix](/fr/assistants/models-and-voices) qu'il utilise                                                                                      |
| **Outils**         | Les [actions intégrées](/fr/assistants/built-in-tools) comme les transferts, les SMS ou la fin d'appel, plus les [Agent Tools](/fr/assistants/agent-tools) que vous créez ou installez vous-même |
| **Canaux**         | Où il est joignable — numéros de téléphone, [WhatsApp](/fr/channels/whatsapp), [widget web](/fr/web-widget), et plus                                                                             |

Une fois configuré, assignez l'assistant à un numéro de téléphone pour les appels entrants, ou à une [campagne](/fr/campaigns/overview) pour les appels sortants.

## Prompt système unique

La configuration la plus simple : un prompt décrit le rôle, les connaissances et les règles de l'assistant ; un **first message** définit l'accueil. Le LLM gère ensuite librement toute la conversation, dans le cadre de ces instructions.

**Idéal pour :**

* Les assistants FAQ et d'accueil (« répondre aux questions, prendre les messages »)
* Les assistants dont la mission ne se découpe pas en phases distinctes
* Le prototypage rapide — un prompt se réécrit en quelques secondes

**Configuration :**

* **Agent type** — choisissez **Single prompt** ou **Conversational flow** lors de la création de l'assistant, ou plus tard sous **Settings → General**.
* **System prompt** — rôle, ton, règles et informations. Utilisez **Choose template** sur le canevas (mode Prompt) ou lors de la création de l'assistant. Appliquer un modèle copie son contenu dans le prompt (et, le cas échéant, dans le premier message) ; aucun lien actif n'est conservé avec le modèle. Voir [Rédaction de prompts](/fr/assistants/prompt-writing) pour savoir comment structurer et resserrer le prompt lui-même.
* **First message** — la phrase d'ouverture, prononcée dès que l'appel est connecté.
* **Greeting mode** — `agent speaks first` (cas typique d'un appel entrant) ou `user speaks first` (l'assistant attend ; utile en sortant, quand l'appelé décroche par un « Allô ? »).
* **Allow interruption** — permet éventuellement aux appelants d'interrompre le message d'accueil d'ouverture. Ce réglage est distinct des réglages d'interruption au niveau de la conversation.
* **Audio greeting** — importez ou enregistrez éventuellement un fichier audio (mp3/wav/ogg/m4a, ≤ 5 Mo) diffusé au début de l'appel à la place de la voix synthétisée. Le texte du premier message reste disponible pour les canaux texte et la messagerie vocale. Gérez-le depuis la carte d'accueil ou via `POST`/`DELETE /api/v1/assistants/{id}/greeting-audio`.
* **Assistant picture** — importez éventuellement une image PNG/JPEG/WebP (≤ 1 Mo) affichée dans le produit à la place de l'orbe par défaut. Survolez l'avatar dans l'en-tête de l'assistant pour l'importer ou le remplacer, ou utilisez `POST`/`DELETE /api/v1/assistants/{id}/avatar`.

<Tip>
  Gardez le premier message court — 5 à 10 secondes suffisent largement. Comme il est prononcé exactement tel qu'il est écrit, écrivez les chiffres et la ponctuation de façon à ce qu'ils sonnent comme prévu (des points de suspension ajoutent une pause naturelle). Si vous utilisez un message d'accueil audio enregistré, faites-le enregistrer par un professionnel et clonez la même voix pour le reste de l'appel, afin que la transition entre l'enregistrement et la voix synthétisée paraisse fluide.
</Tip>

## Modèles de cas d'usage

La galerie de création d'assistant propose à la fois des modèles de prompt et des plans de flux complets. Les plans de flux affichent le résultat attendu, les surfaces compatibles et toute configuration à terminer après la création. En appliquer un copie son prompt, son message d'accueil, son graphe et ses variables dans le nouvel assistant ; la copie reste modifiable et n'est pas affectée par les mises à jour du modèle du catalogue. Voir [Partir d'un modèle de cas d'usage](/fr/flow-builder/overview#partir-dun-modèle-de-cas-dusage) pour en savoir plus.

Le libellé **Avatar-ready** décrit l'expérience web prévue, pas un nœud de flux particulier. Configurez le widget web et l'avatar virtuel après la création. L'image de l'assistant n'est que le portrait statique affiché dans le produit ; elle est distincte de l'avatar parlant utilisé pendant une session web.

## Générateur de flux

Le [générateur de Flow](/fr/flow-builder/overview) transforme l'appel en graphe : plusieurs agents spécialisés, des branches conditionnelles, des outils HTTP, des étapes de collecte de données, des transferts et des fins d'appel explicites. Le moteur fait passer la conversation de nœud en nœud.

Dans l'éditeur, basculez sur **Flow** (ou créez directement l'assistant avec Conversational flow). Le **prompt système de base** se modifie sous Settings → General → **Advanced prompt** (il apparaît réduit sur le canevas). Les instructions des nœuds agent sont **ajoutées** à cette base — elles ne la remplacent pas.

**Idéal pour :**

* Les appels à phases distinctes (qualifier → collecter les données → réserver → confirmer)
* La capture fiable de données (noms, e-mails, numéros de téléphone, avec validation intégrée)
* Les appels qui doivent bifurquer (« client existant ? » → parcours différents)
* Les transferts soumis à des règles (transfert accompagné vers les ventes uniquement après qualification)

## Lequel choisir ?

| Situation                                    | Recommandation                                                                                                                              |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| « Répondre à des questions sur X »           | Prompt système                                                                                                                              |
| « Toujours collecter un numéro de rappel »   | Flow (un nœud `collect` le valide)                                                                                                          |
| « Orienter support ou ventes »               | Flow (un nœud `condition` gère la bifurcation)                                                                                              |
| « Appeler une API en cours de conversation » | Les deux — les flows offrent des nœuds `tool` ; les assistants en prompt seul peuvent utiliser les [outils MCP](/fr/api/tools-and-webhooks) |
| Premier prototype                            | Prompt système, puis passage à un flow le moment venu                                                                                       |

<Note>
  Les nœuds `agent` d'un flux peuvent laisser les instructions vides — le prompt système de l'assistant (Advanced prompt) sert alors de base. Quand un nœud agent a son propre texte, celui-ci est **ajouté** au prompt système, pas substitué. Partez d'un prompt et ajoutez une structure de flux sans dupliquer toute la persona.
</Note>

## Paramètres communs aux deux modes

### Comportement de réponse par canal

L'assistant adapte automatiquement la longueur, le ton et la mise en forme au canal de diffusion : les appels restent naturels et concis, le chat en direct reste lisible, les canaux collaboratifs sont orientés vers l'action et les e-mails restent structurés. Aucune configuration n'est nécessaire.

Pour affiner un canal, ouvrez **Settings → Channels**, choisissez le canal, développez **Advanced**, puis passez d'**Automatic** à **Manual**. Les instructions manuelles complètent le profil automatique ; elles ne remplacent jamais les règles de sécurité, de langue, d'utilisation des outils ou de diffusion. Le widget web et WhatsApp exposent séparément leurs modes voix et texte. Si Manual reste vide, Automatic reste actif.

Quel que soit le mode, chaque assistant dispose de : un mode moteur ([pipeline / realtime / half-cascade](/fr/assistants/engine-modes)), du choix du modèle et de la voix, d'une [base de connaissances](/fr/assistants/knowledge-base), des [réglages de qualité de conversation](/fr/assistants/conversation-quality), des options d'enregistrement et de consentement, d'une durée d'appel maximale, d'un délai d'inactivité, de tags facultatifs et d'une URL de webhook pour les résultats d'appel.

**iOS / Android Call Screen Handling** (Settings → Conversation, ou le nœud Pre-Call dans le générateur de Flow) permet à l'assistant de répondre aux services de filtrage (« Qui est à l'appareil ? ») avec un nom, une société et un motif, puis d'attendre une personne avant de délivrer le message d'accueil habituel.

## Historique des versions

Chaque enregistrement prend un instantané de la configuration précédente de l'assistant. Ouvrez l'icône **History** dans l'en-tête de l'éditeur pour voir la liste complète, la plus récente en premier.

* **Renommer une version** — lui donner un libellé court et mémorable plutôt que le « Version N » par défaut.
* **Ouvrir une version** — lire un résumé en langage clair de son contenu : prompt, modèles, voix, outils, canaux, et plus.
* **Restaurer une version** — la configuration actuelle est d'abord sauvegardée sous forme d'instantané, donc la restauration elle-même peut être annulée.

Les mêmes actions sont disponibles en REST et en MCP :

| REST                                                        | Outil MCP                   | Portée             |
| ----------------------------------------------------------- | --------------------------- | ------------------ |
| `GET /api/v1/assistants/{id}/versions`                      | `list_assistant_versions`   | `assistants:read`  |
| `GET /api/v1/assistants/{id}/versions/{versionId}`          | `get_assistant_version`     | `assistants:read`  |
| `PATCH /api/v1/assistants/{id}/versions/{versionId}`        | `rename_assistant_version`  | `assistants:write` |
| `POST /api/v1/assistants/{id}/versions/{versionId}/restore` | `restore_assistant_version` | `assistants:write` |
| `DELETE /api/v1/assistants/{id}/versions/{versionId}`       | `delete_assistant_version`  | `assistants:write` |

## Lien de démo public

Activez **Public demo link** dans l'éditeur d'assistant pour obtenir une URL partageable que n'importe qui peut ouvrir pour parler immédiatement à l'assistant — sans connexion requise. Les appels passés via ce lien sont facturés sur le solde de crédits de votre espace de travail exactement comme des appels de test, donc surveillez l'usage si vous le partagez largement.

Désactiver la bascule interrompt le fonctionnement du lien. La réactiver restaure exactement le même lien plutôt que d'en émettre un nouveau, donc un lien déjà partagé continue de fonctionner après une désactivation/réactivation.

<Note>
  Le lien de démo public fonctionne sur le domaine en marque blanche de votre espace de travail lorsque celui-ci est configuré. Il n'existe pas d'équivalent REST ou MCP — la bascule du tableau de bord est le seul moyen de l'activer ou de le désactiver.
</Note>