Créer un agent ============== Deux façons de créer un agent : de zéro, ou en clonant un agent existant. La première part du formulaire de création ; le clonage se fait depuis l'éditeur d'agent. Les deux produisent un agent Active sans version live, prêt à être configuré, hors du circuit d'appels jusqu'à Save puis Make live. ![Création d'un nouveau workflow d'agent : nom et description](/docs/agents-create-dark.gif) Créer de zéro ------------- 1. Naviguez vers **Tableau de bord → Agents** 2. Cliquez sur **Nouveau workflow d'agent** (en haut à droite) 3. Remplissez : - **Nom de l'agent**, identifiant interne visible uniquement par votre équipe (ex : `Customer Support FR`, `Outbound Sales EN`) - **Description**, note interne optionnelle sur la finalité de cet agent - **Compte**, le compte auquel appartient cet agent. Obligatoire — chaque agent appartient à exactement un compte. Assignable à un seul compte ; ne peut pas être modifié après la création. 4. Cliquez sur **Créer et configurer** en bas du formulaire, l'agent est créé (`ACTIVE`, aucune version live pour l'instant) et vous êtes dirigé directement vers l'éditeur de flux ### Flux initial L'agent démarre avec un seul **nœud Welcome** et aucune arête. Aucune logique de flux n'est câblée, le nœud Welcome est là comme point de départ. Vous construisez le flux à partir de là en ajoutant des nœuds et en les connectant. Un nouvel agent démarre avec un seul **nœud Welcome** (`id: "start"`, libellé : "Main Agent") et aucune arête. Toute la logique de flux doit être câblée manuellement depuis ce canevas vide. L'agent démarre avec ces valeurs par défaut définies automatiquement : `system_prompt` = "You are a professional phone assistant.", `temperature` = 0.7, `stt_language` = "fr". Vous devriez modifier toutes ces valeurs avant la mise en production. Cloner un agent existant ------------------------ Pour baser un nouvel agent sur une configuration existante, ouvrez l'éditeur de l'agent et utilisez l'action **Clone**. Le clone est créé `ACTIVE` sans version live, il ne peut pas recevoir de vrais appels tant que vous n'avez pas effectué Save et Make live, avec : - Tous les paramètres copiés (fournisseurs, comportement, messages, prompt système) - Le flux complet copié (tous les nœuds, arêtes et configurations de nœuds) - L'historique des versions **non** copié, le clone repart de zéro - **Aucun numéro de téléphone assigné**, assignez un nouveau numéro avant d'activer le clone Le clonage est le moyen le plus rapide de créer des variantes linguistiques d'un même agent (ex : FR → EN → ES) ou de mettre en place des tests A/B entre deux conceptions de flux. Rédiger le prompt système ------------------------- Le prompt système est la configuration la plus impactante que vous allez définir, il gouverne l'intégralité du comportement du LLM pendant toute la durée de chaque appel. ``` Vous êtes [nom], un(e) [rôle] pour [entreprise]. Votre objectif est de [objectif principal]. Règles : - Gardez toutes les réponses en moins de 2 phrases. C'est un appel téléphonique. - Ne discutez jamais de [sujets interdits]. - Répondez toujours en [langue]. - Si vous ne pouvez pas aider, dites : "[phrase de repli]" et arrêtez-vous. - N'utilisez pas de listes, de puces ou de mise en forme. Parole naturelle uniquement. Contexte disponible dès le début de l'appel : - {{customer_name}} : le nom de l'appelant - {{account_id}} : son numéro de compte ``` Règles clés pour les agents vocaux : - **Réponses courtes**, 1 à 2 phrases maximum par tour - **Pas de mise en forme**, les astérisques, tirets et crochets sont lus littéralement par le TTS - **Repli explicite**, indiquez toujours au LLM quoi dire quand il ne peut pas aider - **Verrouillage de langue**, si l'agent ne doit pas changer de langue, dites-le explicitement Voir [Configuration → Prompt système](https://www.manivox.ai/docs/agents/configuration#system-prompt) pour plus de conseils. Configuration minimale pour la mise en production ------------------------------------------------- Avant la mise en ligne, vérifiez que ces quatre éléments sont configurés : \#ParamètreOù 1**Langue STT**, correspondant à la langue de l'appelant (ex : `fr`, `en`)Initialisation → Agent → Langue 2**Fournisseur + modèle LLM**, valeurs par défaut héritées de la plateforme ; à modifier uniquement si nécessaireInitialisation → Modèle de langage 3**Voix TTS**, une voix adaptée à la personnalité de l'agent est recommandée ; si aucune n'est sélectionnée, la plateforme tente d'en résoudre une automatiquement depuis la bibliothèque de voix de votre organisation, et avertit si aucune n'est disponibleInitialisation → Synthèse vocale → Voix 4**Prompt système**, rédigé, relu, testé dans le simulateurWorkflow d'agent → cliquez sur l'engrenage du nœud Start → Général → Prompt système 5**Flux**, au moins un chemin complet du nœud Welcome vers un nœud Hangup ou TransferOnglet Workflow d'agent Sauvegarder et passer en live ----------------------------- Un agent sans version live n'accepte pas d'appels. Passer en live se fait en deux étapes : 1. Ouvrez l'éditeur d'agent → onglet **Workflow d'agent** 2. Cliquez sur **Save** (en haut à droite), une modale s'ouvre avec un nom de version prérempli (`v1`, modifiable) ; validez pour créer la version enregistrée 3. Cliquez sur **Make live** (icône fusée), cela promeut la version que vous venez de créer vers la version live qu'entendent les vrais appelants 4. Pour retirer l'agent du service ultérieurement, utilisez **Archive**, dans l'en-tête de l'éditeur ou via le commutateur de ligne dans **Tableau de bord → Agents**, et désarchivez-le pour le remettre en service. Un numéro de téléphone doit être assigné à l'agent *avant* qu'il puisse recevoir des appels entrants. Activer l'agent sans numéro est valide, vous pouvez assigner des numéros plus tard, mais l'agent ne recevra aucun appel tant qu'au moins un numéro n'est pas assigné. Assigner un numéro de téléphone ------------------------------- Pour les appels entrants : 1. Naviguez vers **Tableau de bord → Comptes** et cliquez sur le compte propriétaire de cet agent 2. Ouvrez l'onglet **Numéros** 3. Trouvez un numéro disponible et assignez cet agent depuis la liste déroulante 4. Confirmez, le numéro s'affiche désormais comme assigné à cet agent Un numéro de téléphone ne peut être assigné qu'à un seul agent à la fois. Pour les appels sortants initiés via l'API, le paramètre `from_number` spécifie l'identifiant de l'appelant, il n'a pas besoin d'être pré-assigné à l'agent. Utilisez un numéro appartenant à votre organisation : les opérateurs rejettent ou signalent les appels dont l'identifiant d'appelant ne peut pas vous être attribué. Tester avec le simulateur ------------------------- Avant d'assigner un numéro de téléphone et de prendre de vrais appels, utilisez le simulateur navigateur intégré pour tester le flux de bout en bout, en utilisant l'API Web Audio (AudioWorklet) pour la capture du microphone et un WebSocket pour le transport (le microphone de votre navigateur). Le simulateur exécute votre *état actuel de l'éditeur*, sauvegardé ou non, ce qui vous permet d'itérer sans mettre en ligne. 1. Ouvrez l'onglet **Workflow d'agent** 2. Cliquez sur **In-browser test call** (en haut à droite du canevas), votre navigateur demande l'accès au microphone 3. Parlez en tant qu'appelant, l'agent répond avec un vrai audio TTS dans votre navigateur 4. Regardez le flux surligner le nœud actif en temps réel 5. Terminez la session, examinez la transcription dans **Tableau de bord → Voir les appels** Le simulateur utilise le même pipeline STT/LLM/TTS que les appels de production, donc la latence, la voix et le comportement de routage sont représentatifs. Les variables collectées pendant la simulation sont visibles dans le visualiseur de transcription. Étapes suivantes ---------------- GuideContenu [Configuration](https://www.manivox.ai/docs/agents/configuration)STT/LLM/TTS, paramètres de silence, variables d'initialisation, Save vs Make live [Éditeur de flux](https://www.manivox.ai/docs/agents/flow-editor)Navigation sur le canevas, ajout de nœuds, connexion des handles [Types de nœuds](https://www.manivox.ai/docs/agents/nodes)Référence pour les 5 types de nœuds [Versions](https://www.manivox.ai/docs/agents/versions)Historique des versions, mise en ligne, retour arrière [Numéros](https://www.manivox.ai/docs/phone-numbers/index)Assigner un numéro à l'agent Cloner vers un autre compte --------------------------- Lorsque vous clonez un agent, vous pouvez choisir un **compte de destination différent**. Les paramètres et le flux de l'agent sont copiés, mais **pas ses connecteurs Composio** — les connexions appartiennent au compte dans lequel elles ont été créées, de sorte que le compte de destination ne dispose d'aucun des connecteurs de la source. Après un clonage vers un autre compte, ré-associez les connecteurs dont l'agent a besoin dans le compte de destination.