Leçon 2 sur 2 · 7 minutes

Utiliser un préréglage

Enregistrez un modèle, un prompt et des règles de routage sous un seul nom, et appelez-le depuis n’importe quelle application.

Un préréglage stocke le modèle, le prompt système, les paramètres et les règles de fournisseur d’une tâche sous un nom comme @support-triage. Les appelants envoient ce nom comme model, avec seulement l’entrée. Phaseo complète le reste avant de choisir un fournisseur. Créez des préréglages dans Paramètres -> Préréglages, ou avec POST /v1/presets et une clé de gestion.

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "@support-triage",
    "input": "Customer says the invoice total is wrong."
  }'

Il n’y a pas de champ preset séparé. Désignez une version avec @support-triage@v3, ou suivez un label avec @support-triage@production : vous pourrez revenir en arrière en déplaçant le label.

Quand la requête et le préréglage définissent tous deux une valeur, ces règles tranchent :

  • Les paramètres comblent les vides. Les valeurs par défaut d’un préréglage ne s’appliquent qu’aux champs que la requête omet. Une valeur dans la requête l’emporte toujours.
  • Les prompts système s’empilent. Le prompt du préréglage passe en premier, puis celui de la requête.
  • Les paramètres de fournisseur de la requête l’emportent. provider.order ou provider.max_price dans la requête remplace la valeur du préréglage pour ce champ.
  • Les listes d’autorisation restreignent, sans jamais élargir. Un modèle hors des modèles autorisés par le préréglage échoue avec validation_error ; il n’est pas redirigé.

Vérifiez votre compréhension

Votre préréglage fixe temperature à 0.2. Une requête envoie "model": "@support-triage" avec "temperature": 0.8. Quelle valeur est utilisée ?

Mettez-le en pratique

Trois services appellent le même modèle d’assistance avec des prompts et des règles de fournisseur copiés-collés. Une modification de prompt a été déployée sur un service mais pas sur les autres, et les réponses diffèrent maintenant. Comment éviter que cela se reproduise ?

Afficher la réponse

Regroupez le modèle, le prompt système et les règles de fournisseur partagés dans un seul préréglage, et faites envoyer "model": "@support-triage@production" par chaque service. Publiez les modifications sous forme de nouvelles versions et déplacez le label production pour les déployer, ou remettez-le en place pour revenir en arrière.

À retenir

Placez les paramètres partagés dans un préréglage, appelez-le par son nom dans model, et laissez les valeurs de la requête remplacer les valeurs par défaut du préréglage quand il le faut.

Liens utiles

La progression est enregistrée dans ce navigateur.

Dernière vérification le 17 novembre 2026