aethexDocs
Tableau de bord

Garde-fous

Les guardrails sont des paramètres de sécurité qui gardent votre agent dans le sujet et professionnel pendant un appel. Ils vivent sur l'agent : vous les définissez une fois et ils s'appliquent à chaque appel que cet agent gère. Il y en a trois : un guardrail de recentrage, un guardrail de contenu, et le respect du script.

Comment fonctionnent les garde-fous

Chaque guardrail ajoute une règle aux instructions que votre agent suit pendant un appel. Quand un appelant fait quelque chose que couvre un guardrail, comme s'éloigner du sujet ou devenir agressif, l'agent ramène la conversation ou donne une réponse calme et neutre au lieu d'y céder. Vous activez ou désactivez chaque guardrail avec un paramètre sur l'agent, sans toucher à votre prompt.

RecentrageACTIVÉactivé par défautContenuDÉSACTIVÉdésactivé par défautRespect du scriptstrictmediumlooseTrois paramètres indépendants, chacun avec une valeur par défaut sensée.

Garde-fou de focus

Le guardrail de recentrage empêche les appelants de détourner l'agent de sa mission. Si quelqu'un pose une question sans rapport avec le rôle de l'agent, l'agent ramène poliment la conversation. Celui-ci est activé par défaut. Pour le désactiver, mettez focus_guardrail_enabled: false sur l'agent.

Remarque
Ce qui compte comme « dans le sujet » vient de votre system prompt. Plus vous y décrivez clairement le rôle de l'agent, mieux le guardrail de recentrage distingue une vraie demande hors sujet d'une demande valide.

Garde-fou de contenu

Le guardrail de contenu bloque les propos nuisibles, harcelants ou abusifs, de l'appelant comme de l'agent. Quand il se déclenche, l'agent répond calmement et de façon neutre au lieu de s'engager, et si l'appelant persiste, l'agent peut mettre fin à l'appel. Ce guardrail est désactivé par défaut. Activez-le avec content_guardrail_enabled: true sur l'agent.

Adhérence au script

Le respect du script contrôle à quel point l'agent suit un déroulé d'appel étape par étape que vous écrivez dans son system prompt. Réglez script_adherence sur l'un de ces trois niveaux :- `strict` (par défaut) : l'agent suit le script mot pour mot.
- `medium` : l'agent garde le plan mais peut reformuler à sa manière.
- `loose` : l'agent traite le script comme un guide approximatif.

Activer les garde-fous

Cette requête active les deux guardrails et règle le respect du script sur medium sur un agent déjà créé. Remplacez $AGENT_ID par l'id de votre agent.

Activer les guardrails sur un agent existant
bash
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 '{
    "focus_guardrail_enabled": true,
    "content_guardrail_enabled": true,
    "script_adherence": "medium"
  }'

Suivant

Les guardrails fonctionnent mieux avec un system prompt clair. Consultez la page concept Agents pour des conseils de rédaction.