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.orderouprovider.max_pricedans 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éponseMasquer 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
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
Dernière vérification le 17 novembre 2026