Skip to main content
Un projet représente le comportement stable que sollicite votre application. Il comprend un projet Weights & Biases, des datasets, des modèles fine-tunés, des évaluations, des analyses et une ou plusieurs versions d’acheminement. Cette page explique comment s’articulent les projets, leurs noms et les versions, afin que vous puissiez modifier l’acheminement d’un projet sans perturber le trafic que votre application envoie déjà.
Les chemins de l’API de gestion commencent par /projects/{alias}, où alias est l’alias du projet. Voir Conventions de l’API.

​
Sélection du projet

Une application sélectionne un projet au moyen de l’en-tête OpenAI-Project: <entity>/<project>. <project> correspond au nom du projet Weights & Biases dans lequel sont stockées les traces du projet. Les SDK d’OpenAI envoient cet en-tête à partir de l’option client project ou de la variable d’environnement OPENAI_PROJECT_ID. Dans Studio, la valeur à copier s’affiche dans l’en-tête du projet ainsi que sur la page des paramètres du projet.
Avec l’en-tête, model sélectionne uniquement le modèle. Si model vaut "router", est vide ou est omis, l’acheminement pondéré de la version s’applique. Une valeur provider/model remplace le modèle au sein du projet. Pour plus de détails, voir Acheminement des modèles. L’alias du projet, par exemple ticket-classifier, identifie le projet dans les URL de Studio et les chemins de l’API de gestion. Il est unique au sein d’une entity Weights & Biases et ne peut plus être modifié une fois le projet créé. Il peut différer du nom du projet Weights & Biases ; copiez donc la valeur OpenAI-Project depuis Studio plutôt que de la reconstituer à partir de l’alias. Une requête qui ne précise pas de version cible toujours la version 1. La version 1 est une valeur par défaut fixe, et non la dernière version. Pour cibler une version ultérieure, épinglez-la explicitement avec les métadonnées forge.project_version :
Une version inexistante renvoie 404.

​
Quand créer une version

Créez une nouvelle version lorsque vous souhaitez tester une autre combinaison de modèles ou d’autres paramètres de fournisseur sans affecter le trafic actuel de l’application. Chaque version dispose de sa propre configuration d’acheminement, indépendante des autres.
La création d’une version ne redirige pas le trafic. Un appelant n’y accède qu’une fois qu’il envoie le nouveau numéro de version dans forge.project_version.

​
Ce que les versions ne copient pas

Une version n’est pas une copie du projet. Les datasets, les modèles fine-tunés et les évaluations restent des ressources rattachées au projet. Les requêtes de dataset permettent de choisir la version du projet dont le trafic doit être utilisé. Pour valider une nouvelle version avant qu’elle ne reçoive le moindre trafic de production, procédez comme suit :
  1. Maintenez la production sur la version 1 en omettant forge.project_version.
  2. Créez une nouvelle version avec l’acheminement proposé.
  3. Envoyez le trafic interne ou canari avec forge.project_version défini sur la nouvelle version.
  4. Examinez les analyses et les évaluations.
  5. Ne définissez forge.project_version dans l’application que lorsque la nouvelle version est prête.
Le trafic de votre application utilise alors l’acheminement de la nouvelle version.
Cette requête crée la version suivante avec son propre acheminement. La réponse contient le numéro de version attribué.
Pour consulter l’opération complète, voir Créer une version de projet.
Dernière modification le 27 octobre 2026