Personnalisation

Réutilisez un seul agent pour chaque appelant. Renseignez des détails comme un nom ou un statut de compte au moment où l'appel démarre, pour que chaque conversation soit personnelle.

Variables dynamiques

Les variables dynamiques sont des espaces à remplir dans le prompt et la phrase d'accueil de votre agent. Vous écrivez un marqueur comme {{customer_name}} dans system_prompt ou first_message, et Aethex y insère une vraie valeur au moment où un appel démarre.Un seul agent peut ainsi accueillir chaque appelant par son nom. Définissez des valeurs par défaut sur l'agent, puis remplacez-les appel par appel en passant dynamic_variables — sur POST /calls/trigger pour un appel téléphonique, ou sur POST /conversation/connect pour une session navigateur. Dans les deux cas les valeurs ne valent que pour cet appel, et rien n'est enregistré sur l'agent.Les deux chemins diffèrent lorsqu'un marqueur n'a ni valeur par défaut ni valeur fournie. Un appel téléphonique est refusé immédiatement avec une erreur claire, pour qu'un contact n'entende jamais un accueil à moitié rempli. Une session navigateur laisse le marqueur tel quel : une session sans clé — un agent public atteint sans clé d'API, ou un jeton d'appel — ne peut fournir aucune valeur, la refuser ne lui laisserait donc aucune issue. Ces sessions ignorent de même les valeurs qu'elles envoient et utilisent les valeurs par défaut de l'agent.

Remarque

Deux raccourcis. Aethex remplit pour vous les marqueurs system__ comme system__caller_id au moment de l'appel, vous n'avez donc pas à les définir — sur une session navigateur il n'y a pas de ligne téléphonique, donc system__caller_id et system__called_number arrivent vides. Utilisez le préfixe secret__ pour les valeurs qui ne doivent aller que dans les en-têtes de requête d'un outil, comme un jeton d'API : elles sont transmises à vos outils mais jamais montrées au modèle ni enregistrées dans les journaux.

Définir et envoyer des variables

bash

# 1. Configure placeholders and their default values on the agent.
curl -X PATCH https://api.aethexai.com/api/v1/agents/$AGENT_ID \
  -H "X-API-Key: $AETHEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "system_prompt": "You are a support agent for {{company_name}}. The customer name is {{customer_name}}.",
    "dynamic_variables": {
      "company_name": "Acme Corp",
      "customer_name": "Alice"
    }
  }'

# 2. Override the defaults per call (and fill any placeholder that has no default).
curl -X POST https://api.aethexai.com/api/v1/calls/trigger \
  -H "X-API-Key: $AETHEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "'$AGENT_ID'",
    "to_number": "+14155551234",
    "from_number": "+18885551234",
    "dynamic_variables": {
      "company_name": "Globex Bank",
      "customer_name": "Jordan"
    }
  }'

Récupérez les détails depuis votre CRM

C'est ainsi qu'un appel donne l'impression que vous connaissez déjà l'appelant. Avant l'appel, recherchez la personne dans votre CRM et transmettez ce que vous trouvez dans dynamic_variables : son nom, son offre, sa dernière commande, ce qui compte pour vous. L'agent ouvre alors avec ces détails plutôt qu'avec un accueil générique.Besoin d'une information qui change pendant la conversation, comme le solde du jour ou l'état d'une commande ? Donnez à l'agent un outil qui interroge votre CRM en direct, et il peut récupérer la réponse en plein appel. Voir Outils.

Métadonnées

Le champ metadata est un endroit pour garder vos propres notes sur un agent, sous forme de simples paires clé-valeur. Le modèle ne le voit jamais et il ne change rien au déroulé des appels. Utilisez-le pour étiqueter les agents comme vous le souhaitez, par exemple par équipe, gamme de produits ou version de prompt, afin de les filtrer dans vos propres tableaux de bord.Il est renvoyé exactement tel que vous l'avez enregistré à chaque lecture de l'agent.

Maintenant que votre agent est configuré, associez-le à un numéro de téléphone ou déclenchez des appels par programmation. Consultez Numéros de téléphone ou la référence API.

Variables dynamiques

Récupérez les détails depuis votre CRM

Métadonnées

Suivant