--- title: Anatomie d'un agent description: >- Chaque partie d'un agent, son emplacement dans le workspace, et les parties qui varient selon la modalité de l'agent et le type de prompt. --- Un agent est un objet unique doté d'une structure fixe : une identité, une langue et une voix ou un modèle, un prompt, des outils, des variables, des résultats, un pipeline vocal et des paramètres de confidentialité. Cette page associe chaque partie à la section de l'**agent workspace** (espace de travail de l'agent) où vous la configurez. :::note[Quand lire cette page] Lisez-la une fois, avant les pages plus détaillées. Chacune des autres pages de **Build** (construction) traite l'une des parties nommées ici. ::: ## Le workspace Ouvrez un agent depuis **AI Agents** (agents IA) et il s'ouvre à l'adresse `/agents/edit/`. L'en-tête porte le nom de l'agent, sa version (`v0.3`), **Agent info** (informations sur l'agent), **More actions** (autres actions) sur un agent à prompt unique, **Share agent** (partager l'agent), **Save** (enregistrer) et **Publish** (publier). La barre latérale répertorie les sections en quatre groupes. | Groupe | Sections | Remarques | |---|---|---| | **Build** | **Settings** (paramètres), **Advanced** (avancé), **Flow**, **Tools** (outils), **Outcomes** (résultats), **Memory** (mémoire) | **Flow** n'apparaît que pour les agents de type flow | | **Testing** (test) | **Chat**, **Call** (appel), **Evaluation** (évaluation) | **Call** n'apparaît que pour les agents vocaux, **Chat** que pour les agents textuels | | **Improve** (amélioration) | **Recommendations** (recommandations), **Change Requests** (demandes de modification) | Prochaines étapes suggérées, et modifications du prompt rédigées à partir des retours | | **Release** (mise en production) | **Publish**, **Widget**, **Deployments** (déploiements), **Versions** | **Publish** contient la checklist de lancement ; **Deployments** n'apparaît que pour les agents textuels | ![La barre latérale du workspace d'un agent vocal avec un prompt unique.](/media/build/agent-workspace-sidebar.webp) **Agent info** ouvre une fiche d'audit : **Created by** (créé par), **Updated by** (modifié par), **Updated at** (modifié le) et l'**Agent ID** (identifiant de l'agent). **Share agent** ouvre une seule boîte de dialogue pour le lien public et le code d'intégration, tous deux soumis à l'interrupteur **Agent Visibility** (visibilité de l'agent) ; voir [Lien de partage](/fr/deploy/widget-and-embed/share-link). **More actions** contient **Migrate to Flow Agent** (migrer vers un agent de type flow), qui convertit le prompt, les outils, les résultats et les bases de connaissances en un flow sur un nouvel agent portant le nom de l'original suivi de `(Flow)`. L'original n'est pas modifié, ses campaigns et ses numéros continuent donc de fonctionner ; voir [Choisir un type de prompt](/fr/build/choosing-a-prompt-type). ## Les parties ### General La fiche située en haut de **Settings**. Elle affiche les puces **Modality** (modalité) et **Prompt type** (type de prompt), qui sont fixées à la création, ainsi que les champs modifiables : **Name** (nom), **Description**, **Language** (langue), et, pour les agents vocaux, la voix et **Background audio** (fond sonore). Les agents textuels disposent d'une fiche **Model** (modèle) à la place d'une voix. ![La fiche General d'un agent vocal.](/media/build/general-card.webp) - Modality : [Choisir une modalité](/fr/build/choosing-a-modality) - Prompt type : [Choisir un type de prompt](/fr/build/choosing-a-prompt-type) - Language : [Langues](/fr/build/voice-and-audio/languages) - Voix : [Choisir une voix](/fr/build/voice-and-audio/choosing-a-voice) - Model : [Configuration du LLM](/fr/build/llm-configuration) ### Prompt Les agents à prompt unique disposent d'une fiche **Prompt** comportant trois champs : **Agent Identity** (identité de l'agent), **Tasks** (tâches) et **Guardrails** (garde-fous). Trois boutons figurent au-dessus : **Variables**, **Manage tools** (gérer les outils) et **Generate With AI** (générer avec l'IA). Les agents de type flow n'ont pas de fiche Prompt ; leurs instructions résident dans des nœuds sous **Flow**. - Rédaction : [Guide de prompting](/fr/build/prompting/prompting-guide) - Ébauche : [Generate with AI](/fr/build/prompting/generate-with-ai) - Espaces réservés : [Variables dynamiques](/fr/build/dynamic-variables) - Actions : [Présentation des outils](/fr/build/tools/overview) ### Conversation Les agents vocaux, à prompt unique ou de type flow, disposent d'une fiche **Conversation** avec **Who talks first** (qui parle en premier) et **First message** (premier message). Ce n'est pas le cas des agents textuels ; la personne écrit toujours en premier. Voir [Premier message et conversation](/fr/build/prompting/first-message-and-conversation). ### Advanced Pour les agents vocaux, **Advanced** regroupe le pipeline vocal en cinq fiches : **Voice activity** (activité vocale), **Turn detection** (détection des tours de parole), **Noise reduction** (réduction du bruit), **AMD** (détection de répondeur) et **Reminders** (rappels), suivies de **Privacy** (confidentialité). Pour les agents textuels, **Advanced** se limite à la fiche **Privacy**. - [Détection d'activité vocale](/fr/build/speech-pipeline/voice-activity-detection) - [Détection des tours de parole](/fr/build/speech-pipeline/turn-detection) - [Suppression du bruit](/fr/build/voice-and-audio/noise-suppression) - [Détection de répondeur](/fr/build/speech-pipeline/answering-machine-detection) - [Silence, rappels et durée d'appel](/fr/build/speech-pipeline/silence-reminders-and-call-duration) - [Conservation des données](/fr/build/privacy/data-retention), [Masquage des données personnelles](/fr/build/privacy/pii-redaction), [Destination de stockage](/fr/build/privacy/storage-destination), [Mémoire](/fr/build/memory) ### Tools Les actions que l'agent peut effectuer en plus de parler : mettre fin à l'appel ou le transférer, appeler vos API, réserver une réunion, passer le relais à un autre agent. **Add tool** (ajouter un outil) en ajoute un, et chaque outil configuré est répertorié avec sa description, que le modèle lit pour décider quand l'utiliser. Voir [Présentation des outils](/fr/build/tools/overview). ### Outcomes Les champs structurés que l'agent renseigne après chaque conversation, chacun doté d'un nom de variable, d'une description et, en option, de valeurs fixes. Voir [Résultats](/fr/build/outcomes). ### Memory Ce dont l'agent se souvient à propos de chaque contact. Sélectionnez un contact pour le consulter, et effacez tout ce qui doit l'être. L'interrupteur qui active la mémoire se trouve dans **Advanced**. Voir [Mémoire](/fr/build/memory). ## Improve **Recommendations** classe les prochaines étapes pour l'agent selon leur impact attendu et est réévalué après chaque révision. **Change Requests** contient les modifications du prompt rédigées par l'IA à partir des retours négatifs (pouce vers le bas), à examiner puis accepter en tant que nouvelle révision. Voir [Recommandations](/fr/test-and-improve/recommendations) et [Demandes de modification](/fr/test-and-improve/change-requests). ## Enregistrement et versions La modification d'un champ, quel qu'il soit, active **Save** et affiche une barre indiquant **You have unsaved changes** (vous avez des modifications non enregistrées) avec un décompte, **Undo Changes** (annuler les modifications) et **View Changes** (afficher les modifications). L'enregistrement crée une nouvelle révision ; le compteur de l'en-tête passe de `v0.2` à `v0.3`. Chaque version est conservée sous **Versions**, avec un diff et une possibilité de restauration. Voir [Versions](/fr/test-and-improve/versions). ## Ce qui change selon le type d'agent | Partie | Vocal, prompt unique | Vocal, flow | Textuel | |---|---|---|---| | Voix et Background audio | Oui | Oui | Non | | Sélecteur de modèle | Non | Non | Oui | | Fiche Prompt | Oui | Non, des nœuds à la place | Oui | | Fiche Conversation | Oui | Oui | Non | | Fiches du pipeline vocal | Oui | Oui | Non | | Fiche Privacy | Oui | Oui | Oui | | Test d'appel | Oui | Oui | Non | | Test de chat | Non | Non | Oui | | Deployments | Non | Non | Oui | ## Pour aller plus loin - [Concepts clés](/fr/get-started/core-concepts) - [Choisir une modalité](/fr/build/choosing-a-modality) - [Choisir un type de prompt](/fr/build/choosing-a-prompt-type) - [Tester dans le navigateur](/fr/test-and-improve/testing-in-the-browser) - [Versions](/fr/test-and-improve/versions)