Procédures | ElevenLabs Documentation

Présentation

Une procédure contient des instructions pour une tâche spécifique. Chaque procédure comporte un déclencheur qui décrit quand elle s’applique et un contenu qui indique quoi faire. Lorsqu’une conversation correspond au déclencheur, l’agent charge la procédure.

Utilisez des procédures lorsque votre agent doit traiter de nombreuses tâches distinctes. Par exemple, un agent de support client peut utiliser une procédure pour chaque type de demande : remboursements, vérification d’identité, récupération de compte ou résolution de problèmes de connexion.

Onglet Procédures dans le
Dashboard de l'agent

Types de procédures

Il existe deux types de procédures :

Les procédures en langage naturel sont rédigées sous forme d’instructions en langage naturel que l’agent interprète et adapte à la situation.
Les procédures structurées sont une liste ordonnée d’étapes typées que l’agent exécute de la même manière à chaque fois.

Vous pouvez utiliser les deux types pour un même agent. L’agent sélectionne la procédure pertinente selon son déclencheur, quel que soit son type.

Les procédures peuvent s’appeler entre elles. Une procédure en langage naturel appelle une autre procédure à l’aide d’une référence intégrée, et une procédure structurée appelle une autre procédure structurée à l’aide d’une étape Sous-procédure. Une approche courante consiste à conserver le traitement ouvert dans une procédure en langage naturel et à confier les parties qui doivent toujours s’exécuter de la même façon à une procédure structurée.

Un agent peut avoir des procédures, un workflow, ou les deux. Lorsque les deux sont présents, chaque procédure est disponible depuis chaque point du workflow ; une procédure ne peut pas être limitée à des nœuds spécifiques du workflow. La plupart des agents reposent sur l’une ou l’autre approche, mais elles peuvent être combinées.

Quand utiliser des procédures

Chaque agent dispose d’un prompt système. Les procédures et les workflows permettent d’ajouter une structure, et un agent peut utiliser les deux. Choisissez un point de départ selon le degré de variation possible dans la conversation.

Exigence	Utiliser	Pourquoi
Agent de preuve de concept simple	Prompt système uniquement	La solution la plus rapide à configurer et à itérer, mais un prompt unique devient difficile à gérer à mesure que le périmètre de l’agent s’étend.
Tâche pour laquelle l’agent peut adapter la formulation et l’ordre	Procédure en langage naturel	Conserve toute la conversation dans le contexte d’un même LLM ; l’agent peut donc adapter la formulation et l’ordre, et gérer les changements de direction inattendus. Utilise davantage la fenêtre de contexte.
Tâche dont les étapes doivent toujours s’exécuter de la même manière	Procédure structurée	Chaque étape s’exécute dans l’ordre défini, de la même façon à chaque fois, et vous la rédigez sous la forme d’une courte liste d’étapes.
Contrôle total sur des branchements complexes et des cas limites	Workflow	S’exécute sous la forme d’un graphe de sous-agents que vous concevez et reliez vous-même, avec un contrôle total sur les branchements et le modèle utilisé à chaque étape.

Les procédures en langage naturel constituent le choix par défaut. Elles sont les plus rapides à rédiger, se lisent comme un document afin que les équipes non techniques puissent en assurer la gestion, et permettent à l’agent de s’adapter lorsqu’une conversation sort du cadre prévu. Privilégiez une procédure structurée lorsque le coût d’une étape ignorée ou exécutée dans le mauvais ordre est élevé, par exemple pour l’authentification, une escalade ou une transaction financière. Utilisez un workflow lorsque vous avez besoin d’une logique de routage ou d’un contrôle du modèle à chaque étape qu’aucun type de procédure ne propose.

Gérer les procédures

Le Dashboard est la méthode recommandée pour créer des procédures. Utilisez la CLI ou l’API pour gérer les procédures par programmation ou les intégrer à vos outils de déploiement.

Créer depuis le Dashboard

Gérer via la CLI

Gérer via l'API

Ouvrez votre agent dans le Dashboard, puis sélectionnez Procédures. Utilisez + pour créer une procédure en langage naturel ou structurée. Vous pouvez regrouper les procédures dans des dossiers depuis le même menu. Consultez les pages Procédures en langage naturel et Procédures structurées pour obtenir des conseils de rédaction.

Limites

Le contenu d’une procédure est limité à 50 000 caractères.
L’agent conserve dans son contexte les cinq procédures démarrées le plus récemment. Lorsque davantage de procédures ont été démarrées dans une même conversation, le contenu, les outils intégrés et les documents de base de connaissances des procédures en langage naturel les plus anciennes disparaissent du prompt. Gardez des procédures ciblées et utilisez des sous-procédures afin que peu d’entre elles soient actives simultanément.
Vous ne pouvez pas modifier le type d’une procédure après sa création. Pour passer d’une procédure en langage naturel à une procédure structurée, ou inversement, créez une nouvelle procédure et mettez à jour toutes les références qui y renvoient.
Les procédures appartiennent à un seul agent. Elles ne peuvent pas être partagées entre plusieurs agents ni stockées comme ressources au niveau du Workspace.
La duplication d’un agent copie ses procédures au lieu de les partager. Les copies reçoivent de nouveaux ID de procédure ; les références dans l’agent dupliqué doivent donc utiliser ces nouveaux ID.
Les procédures ne peuvent pas être limitées à des nœuds spécifiques du workflow. Lorsqu’un agent dispose des deux, chaque procédure est disponible depuis chaque nœud.
Les procédures structurées ne peuvent pas référencer de documents de base de connaissances.