Préréglages

​

Démarrage rapide

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
	  -d '{
	    "model": "@release-summary",
	    "input": "Generate a release summary for the last 24 hours."
	  }'

import Phaseo from "@phaseo/sdk";

const client = new Phaseo({ apiKey: process.env.PHASEO_API_KEY! });

const response = await client.generateResponse({
	  model: "@release-summary",
	  input: "Generate a release summary for the last 24 hours.",
});

from phaseo import Phaseo

client = Phaseo(api_key="YOUR_API_KEY")

response = client.generate_response({
	    "model": "@release-summary",
	    "input": "Generate a release summary for the last 24 hours.",
})

​

Contenu d’un préréglage

• Un prompt système ajouté au début de chaque requête.
• Des modèles ou familles de modèles autorisés.
• Des listes de fournisseurs autorisés ou ignorés pour les préférences de routage.
• Des paramètres par défaut (temperature, top_p, max_tokens et paramètres similaires).
• Des valeurs de raisonnement par défaut facultatives pour les modèles pris en charge.

• Les préréglages privés ou d’espace de travail utilisent @{slug} et se résolvent dans l’espace de travail de la clé d’API.
• Les préréglages publics utilisent @{username}/{slug} et sont accessibles depuis n’importe quel espace de travail. Exemple : @octavia/release-summary.

​

Versions et forks du marketplace

• Séquentiel : v1, v2, v3.
• Versionnage sémantique : libellés SemVer explicites, par exemple 1.2.0, 2.0.0-beta.1 ou 1.4.2+build.7.
• Par date : YYYY.MM.DD, avec un suffixe numérique lorsque plusieurs versions sont publiées le même jour, par exemple 2026.08.02.2.

​

Fusion des préréglages

• Les paramètres par défaut remplissent uniquement les champs absents du corps de la requête. Ils ne remplacent pas les valeurs déjà fournies par l’appelant.
• Si la requête contient déjà un message système, le prompt du préréglage est ajouté avant celui-ci. Avec un champ system au format Anthropic, le prompt est ajouté à ce champ.
• Les listes de fournisseurs autorisés et ignorés sont appliquées avant la sélection. Elles réduisent donc le pool de repli au lieu de servir d’étiquette décorative.
• Les requêtes utilisant un modèle hors de la liste d’autorisation du préréglage sont rejetées rapidement plutôt que redirigées silencieusement.

​

Fonctionnalités publiques actuelles

• injection du prompt système
• listes d’autorisation de modèles
• contraintes de routage avec listes de fournisseurs autorisés ou ignorés
• valeurs par défaut de décodage et de génération
• valeurs par défaut de raisonnement

​

Gérer les préréglages

​

Quand utiliser des préréglages

• Uniformiser les prompts système entre plusieurs services.
• Limiter le routage à des fournisseurs approuvés pour répondre aux exigences de conformité.
• Garder les paramètres par défaut cohérents entre les environnements.
• Fournir aux projets de migration un emplacement pérenne pour les valeurs par défaut des prompts, du routage et des paramètres, tout en limitant les changements du code applicatif.

​

Guides associés

• Recueillir des commentaires sur les préréglages
• Routage et solutions de repli
• Paramètres d’inférence
• Matrice de parité des fonctionnalités