@support-triage. Les appelants envoient ce nom comme model, avec seulement l’entrée ; le Gateway complète le reste avant de choisir un fournisseur.
Activez ou désactivez les champs de la requête pour voir quelle valeur l’emporte :
Les règles sont les suivantes :
- Les paramètres comblent les manques. Les paramètres par défaut d’un préréglage ne s’appliquent qu’aux champs absents de la requête. Une valeur présente dans la requête l’emporte toujours.
- Les prompts système s’empilent. Le prompt du préréglage vient en premier. Si la requête a son propre prompt système ou ses propres
instructions, ils suivent après une ligne vide. - Les réglages de fournisseur de la requête l’emportent. Des champs tels que
provider.orderouprovider.max_pricedans la requête remplacent la valeur du préréglage pour ce champ. - Les listes d’autorisation restreignent, sans jamais élargir. Les listes de fournisseurs autorisés et ignorés du préréglage sont appliquées avant la sélection du fournisseur ; elles limitent donc aussi les fournisseurs utilisables en secours. Un modèle hors des modèles autorisés du préréglage échoue avec une
validation_errordont le mot-clé de détail estpreset_model_not_allowed; il n’est pas réacheminé.
Créer et utiliser un préréglage
1
Créer le préréglage
Ouvrez Tableau de bord -> Paramètres -> Préréglages et créez un préréglage avec un slug tel que
support-triage. N’ajoutez que les valeurs par défaut que tous les appelants doivent partager.Pour le créer depuis un script, appelez POST /v1/presets avec une clé de gestion.2
L’appeler par son nom
3
Vérifier ce qui a été appliqué
Ouvrez la requête dans Gateway -> Utilisation pour voir quelles valeurs par défaut du préréglage ont été appliquées et quel fournisseur l’a servie.
Ce qu’un préréglage peut contenir
Gardez la logique propre à chaque appelant dans votre application, et utilisez des préréglages distincts lorsque des workflows ont besoin de prompts, de routage ou de mise en cache différents.
Nommer un préréglage
Envoyez un préréglage via le champmodel, ou via prompt.id lorsqu’il a un modèle de prompt. Il n’existe pas de champ preset distinct.
Publier un préréglage public nécessite un profil public activé et un nom d’utilisateur. Les noms d’utilisateur sont uniques dans tout Phaseo ; les slugs n’ont besoin d’être uniques que pour un même éditeur. Les slugs sont mis en minuscules et peuvent contenir des lettres, des chiffres,
-, _, . et :.
Versionner et revenir en arrière
Enregistrer modifie un brouillon privé. Publier une nouvelle version transforme le brouillon en une version numérotée immuable et conserve toutes les précédentes. Choisissez l’apparence des libellés de version :
Faites pointer un libellé nommé tel que
production vers une version, et ramenez-le vers une version antérieure pour revenir en arrière. Consultez Versions et libellés.
Depuis un script, publiez avec POST /v1/presets/{id}/versions et déplacez les étiquettes avec PUT /v1/presets/{id}/labels/{label}, avec une clé de gestion. Une connexion via la CLI ou une app qui utilise Se connecter avec Phaseo peut lire les préréglages, mais pas les modifier.