Agents

Nom d'affichage de l'agent.

Prompt système du LLM qui définit la persona et le comportement de l'agent.

Voix à utiliser pour la synthèse vocale. Doit être un ID de voix valide depuis GET /voices.

Message de bienvenue que l'agent dit lorsqu'un appel se connecte. Si omis, l'agent attend que l'utilisateur parle en premier.

Langue pour la reconnaissance et la synthèse vocale (ex. english, french). Par défaut : english.

Remplacement du style dialectal (ex. formal, local). Spécifique au fournisseur.

Paires clé-valeur arbitraires stockées avec l'agent.

ID du modèle LLM — un nom public du catalogue GET /api/v1/models (par exemple claude-sonnet-4-6, gpt-4o ou aethex-default). Omettez-le ou envoyez une chaîne vide pour utiliser le modèle par défaut de la plateforme. Les réponses renvoient toujours le nom public du catalogue ; le routage interne du fournisseur n'est jamais exposé.

Température d'échantillonnage (0.0–2.0). Les valeurs basses produisent des réponses plus déterministes. Ignorée pour les modèles de raisonnement d'OpenAI (la série o et la famille gpt-5), qui n'acceptent pas de température.

Nombre maximum de tokens par réponse LLM, un entier de 1 à 8192. Omettez ou envoyez null pour le défaut de la plateforme (configurable via AETHEX_LLM_MAX_COMPLETION_TOKENS, 512 sauf si le déploiement le remplace).

Fenêtre de contexte LLM maximale pour cet agent (1024–262144 tokens). Null utilise le défaut de la plateforme.

Pénalité de fréquence LLM entre -2.0 et 2.0. Omettre ou envoyer null revient à la valeur par défaut de la plateforme Aethex (0.4), et non à une valeur par défaut native du fournisseur.

Pénalité de présence LLM entre -2.0 et 2.0. Omettre ou envoyer null revient à la valeur par défaut de la plateforme Aethex (0.9), et non à une valeur par défaut native du fournisseur.

Durée maximale stricte de l'appel en secondes (30–3 600). L'appel se termine automatiquement quand cette limite est atteinte.

Termine l'appel si l'utilisateur reste silencieux pendant ce nombre de secondes. Null désactive.

Raccroche quand l'appelant entame son Nième tour de parole, où N vaut cette valeur (1–1000) ; ce tour n'est pas traité. Null hérite du défaut de la plateforme (aucune limite).

Supprime les tours anciens quand la conversation s’allonge. Null hérite du défaut ; la plateforme ignore false sur les modèles qu’elle héberge elle-même.

Nombre de tours qui déclenche la troncature (1–200) — pas le nombre de tours conservés. Null hérite du défaut de la plateforme.

Les SMS que cet agent peut envoyer, par identifiant. Omis ou [] : tous les messages actifs. Au-delà d'environ 8 choix, l'agent distingue moins bien — un conseil, pas une limite.

Combien de fois un appel peut envoyer le même message (1–30). Null hérite du défaut, 2. Le plafond de l'appel borne toujours le total.

Permet à l'appelant d'interrompre l'agent en cours de réponse (par défaut : true).

Durée, en secondes, pendant laquelle l'appelant doit continuer à parler par-dessus l'agent avant que celui-ci s'arrête pour l'écouter, de 0 à 3. Un son plus court, comme une toux ou un bref « mm-hmm », n'interrompt plus l'agent, qui n'y répond pas. Quand l'agent se tait, toute parole ouvre aussitôt le tour de l'appelant. Null applique la valeur par défaut de la plateforme, 0,6 ; 0 arrête l'agent dès la première parole entendue. Une modification s'applique à partir du prochain appel de l'agent.

Avec quelle insistance l'agent prend la parole : patient, normal, ou eager. Null utilise le défaut de la plateforme.

Si l'agent peut terminer l'appel lui-même (par défaut : true).

Phrases que l'appelant peut dire pour mettre fin à l'appel. Lorsque l'agent en entend une, il dit un bref au revoir et raccroche.

Quand terminer les appels : auto_detect (intention LLM + phrases) ou phrases_only (par défaut : auto_detect). phrases_only est indicatif — il oriente l'agent vers une fin sur vos end_call_phrases, mais le modèle peut tout de même terminer sur une conclusion claire de la conversation.

Détecte quand l'appel est tombé sur messagerie vocale (par défaut : false).

Message à laisser quand la messagerie vocale est détectée. Nécessite voicemail_detection_enabled=true.

Que faire sur messagerie : leave_message ou hangup (par défaut : leave_message).

Joue un message d'attente au début des appels entrants avant que l'agent ne prenne la ligne (par défaut : false).

Texte d'accueil du lobby, jusqu'à 120 caractères.

Audio de fond du lobby : none, ambient, ou instrumental (par défaut : ambient).

Attente maximale du lobby en secondes (0–60, par défaut : 45).

Si l'audio de l'appel doit être enregistré (par défaut : true).

Si la transcription de la conversation doit être stockée (par défaut : true).

Lorsque cette option est active, n'importe qui peut démarrer un appel avec cet agent depuis un navigateur ou une application en utilisant uniquement son id, sans clé API ni proxy. Désactivé par défaut. Les appels publics vous sont facturés normalement, et des limites de la plateforme protègent contre les abus. Utilisez allowed_origins pour restreindre les sites web autorisés à l'intégrer.

Liste facultative de noms d'hôtes de sites web autorisés à intégrer un agent public dans un navigateur, par exemple example.com ou app.example.com. Laissez vide pour autoriser toute origine. S'applique uniquement aux navigateurs, car les applications natives et les serveurs n'envoient pas d'origine. Sans effet si public_access n'est pas activé.

Bloque les réponses hors sujet (par défaut : true).

Bloque le contenu non sécuritaire (par défaut : false).

Règles personnalisées en langage naturel : liste d'objets { name, prompt, is_enabled }.

Avec quelle rigueur l'agent suit son prompt système : strict, medium, ou loose (par défaut : strict).

Indique si l'agent accepte la saisie au clavier téléphonique (DTMF) pendant les appels, pour qu'un appelant puisse taper une référence ou un numéro de carte plutôt que de le dire. Activé par défaut. Sans effet sur les agents navigateur, qui n'ont pas de clavier.

Secondes de silence utilisateur avant que l'agent ne relance la conversation (1.0–600.0). 15 secondes par défaut si non défini.

Nombre maximal de relances avant que l'agent n'envoie un au revoir et raccroche (>= 0). Utilisez 0 pour des relances illimitées (l'agent ne raccroche jamais pour silence seul).

Secondes avant que l'agent ne joue une phrase d'attente pendant qu'il attend le LLM (1.0–300.0). Null désactive.

Texte d'attente prononcé quand le soft timeout se déclenche.

Si true, le message de soft timeout est généré par le LLM au lieu d'utiliser soft_timeout_message tel quel (par défaut : false).

Nombre minimal de phrases par réponse (>= 0). 2 par défaut si non défini.

Nombre maximal de phrases par réponse (>= 0). Doit être >= response_min_sentences. 3 par défaut si non défini.

Nombre de morceaux de base de connaissances à récupérer par tour (1–20). Null utilise le défaut de la plateforme : 6, choisi pour améliorer le rappel quand une politique est répartie sur des fragments adjacents tandis que le pipeline vocal limite toujours l'injection locale au contexte réellement servi.

Score minimal de similarité vectorielle ou par mot-clé pour les morceaux récupérés (0.0–1.0). Null utilise le défaut de la plateforme : 0.1 ; utilisez 0.0 pour désactiver le seuil.

Numéro E.164 vers lequel transférer l'appel quand l'agent déclenche un transfert.

Jusqu'à cinq numéros au format E.164, appelés dans l'ordre : un transfert accompagné passe au suivant lorsqu'une ligne ne répond pas ou est indisponible. Lorsqu'il est renseigné, il prime sur transfer_phone_number ; envoyez [] pour revenir au comportement à un seul numéro.

Ce que fait l'agent une fois que la personne vers qui il transfère décroche. warm (par défaut) : il la briefe en privé, puis quitte l'appel. conference : il la briefe, puis reste en ligne sans parler — la suite de l'appel est enregistrée et transcrite, les propos de cette personne sous forme de tours human_agent, dans la limite de recording_enabled et transcription_enabled de l'agent. Le mode conférence exige que l'appel reste sur la passerelle SIP d'Aethex : appels SIP uniquement, avec un trunk sortant par lequel le transfert peut appeler. Sur les appels Twilio et Teams, l'agent transfère en mode warm.

Le trunk SIP par lequel cet agent émet ses appels. Il doit faire partie de vos trunks sortants actifs ; omettez-le pour utiliser celui de l'espace de travail par défaut, et envoyez "" pour effacer un choix existant. Un trunk lié au numéro concerné reste prioritaire sur ce réglage.

Le numéro depuis lequel partent les messages texte de cet agent, sous forme d'identifiant de numéro. Il doit être l'un de vos numéros actifs portant sms_sender : 404 s'il n'est pas le vôtre, 422 s'il n'envoie pas. Omis (ou envoyé à ""), l'agent utilise le numéro qui porte sms_sender_default, ce que font tous les agents tant que vous n'en désignez pas. Vérifié à chaque appel : un numéro rendu plus tard revient au numéro par défaut au lieu d'envoyer depuis une ligne que vous n'avez plus.

Valeurs par défaut pour les placeholders {{variable}} interpolés dans le prompt système au début de l'appel.

URL HTTPS (port 443) qui reçoit un rapport call.ended signé à la fin de chaque appel, avec le statut de l'appel et la transcription. L'enregistrement est livré séparément via un événement recording.ready une fois que l'audio a fini d'être téléversé. Signé avec le secret webhook de votre tenant via l'en-tête X-Aethex-Signature.

UUID de l'agent à dupliquer.

UUID de l'agent.

Nom de l'outil utilisé dans l'appel de fonction LLM (snake_case, sans espaces).

Description lisible par l'humain de ce que fait l'outil. Le LLM l'utilise pour décider quand l'appeler.

Type d'outil — function pour les callbacks HTTP. Par défaut : function.

Objet JSON Schema décrivant les paramètres de l'outil.

Alias pour parameters_schema.

URL HTTPS (port 443) que la plateforme appelle quand l'agent invoque cet outil. Doit être un nom d'hôte publiquement résolvable ou une adresse IP publique (pas de localhost, pas d'IP privée/interne, pas d'identifiants intégrés, pas de fragment d'URL) ; validé à la création — les requêtes vers des hôtes non résolvables, non publics ou hors port 443 sont rejetées.

En-têtes HTTP supplémentaires à envoyer avec la requête de l'outil (ex. {"Authorization": "Bearer token"}).

Méthode HTTP utilisée pour dispatcher l'outil. POST (défaut) : les arguments LLM et les identifiants contextuels sont dans le corps JSON. GET : les arguments sont dans la chaîne de requête URL et les identifiants contextuels sont envoyés en en-têtes ; aucun corps n'est envoyé. Seuls POST et GET sont acceptés. Note sur les types (GET uniquement) : les scalaires sont convertis en chaîne directement — "true" (chaîne) et true (booléen) arrivent tous deux comme flag=true, impossibles à distinguer côté serveur. null arrive comme la chaîne littérale "null".

UUID de l'agent.

Fichier de document à télécharger (PDF, DOCX, TXT, MD).

Contenu en texte brut à ajouter comme document virtuel à la place d'un fichier.

Nom de fichier à attribuer au document texte virtuel.

UUID de l'agent.

Jeton de téléchargement signé retourné par POST /uploads/presign. Chaîne opaque, 8 à 8192 caractères.

Indication de langue pour l'extraction de texte.

Remplacement du nom de fichier du document.

UUID de l'agent.

UUID du document à retraiter.

UUID de l'agent.

Requête en texte libre à exécuter contre la base de connaissances.

Nombre de fragments à retourner. Omettez-le pour utiliser le rag_top_k de l'agent ou le défaut de la plateforme : 6.

Score minimal de pertinence. Omettez-le pour utiliser le rag_min_score de l'agent ou le défaut de la plateforme : 0.1.