OpenAI
Cette page a été traduite automatiquement. Afficher l’article original en anglais.

Gestion des projets dans la plateforme API

Mise à jour : 7 days ago

Les projets visent à donner aux clients la capacité d’organiser leur travail. Les organisations peuvent gérer l’accès et les limites, provisionner des comptes de service (au moyen de l’interface utilisateur) et faire le suivi de l’utilisation dans une portée limitée au sein d’un projet (p. ex., modèles, capacités, fils de discussion, assistants, ajustement fin, stockage, etc.). L’activité d’utilisation peut être ventilée par projet, et les utilisateurs peuvent consulter la facturation et définir des budgets par projet.

Les propriétaires de l’organisation peuvent voir tous leurs projets actifs et archivés sur la page Projets. En savoir plus sur les rôles d’utilisateur et les autorisations dans la plateforme d’API.

Image

Qui peut créer un projet?

Seuls les propriétaires de l’organisation peuvent créer un projet. Veuillez consulter les rôles et les autorisations pour en savoir plus.

Pour passer d’une organisation à l’autre, survolez le nom de votre organisation en haut à gauche de la page et sélectionnez l’organisation dans la liste :

Projects page with the organization switcher open, listing Personal and Staging organizations

Pour les organisations qui disposent d’un plan de facturation consolidée, les sous-organisations sont identifiées séparément. Les projets ne peuvent pas être créés dans les sous-organisations.

Image

Comment fonctionnent les projets?

Chaque organisation comprend un « projet par défaut » qui ne peut pas être supprimé. Vous pouvez configurer les limites de débit, les autorisations de modèles virtuels et les budgets de dépenses (depuis novembre 2024). Il hérite de la configuration complète de l’organisation; vous ne pouvez donc pas y ajouter directement des membres ou des comptes de service.

Comment créer un projet?

Commencez par survoler le nom du projet dans le coin gauche de la page et sélectionnez Create project.

API platform project menu with Create project highlighted under Default project

Fournissez un nom, une description et un site Web pour votre projet, puis sélectionnez Create.

Create a new project dialog in the API platform with fields for project name, use case, and business website

Comment ajouter des utilisateurs à un projet?

Les membres nouvellement ajoutés à l’organisation ne sont pas automatiquement ajoutés au « projet par défaut ». Les nouveaux membres peuvent être invités au projet soit lorsqu’ils sont invités à l’organisation (en cochant la case « Inviter au projet par défaut »), soit après avoir accepté l’invitation à l’organisation.

Les utilisateurs invités au moyen de l’API d’administration suivent les règles décrites par l’endpoint /organization/invites.

Si vous rencontrez une erreur lors de l’invitation d’utilisateurs à un projet au moyen de l’interface utilisateur ou de l’API d’administration, vérifiez d’abord que le projet cible existe et n’est pas archivé avant de renvoyer l’invitation.

Les propriétaires de l’organisation sont automatiquement ajoutés comme propriétaires aux nouveaux projets créés au sein d’une organisation.

Quels sont les différents rôles d’utilisateur dans les organisations et les projets, et quelles autorisations comportent-ils?

Alors que les organisations ont des rôles de « propriétaire » et de « lecteur », les projets ont des rôles de « propriétaire » et de « membre ». Les membres de projet sont analogues aux lecteurs d’organisation. Veuillez consulter le tableau ci-dessous pour obtenir une description plus détaillée des autorisations associées à chaque rôle d’utilisateur.

RôlePortéeDescription
PropriétaireOrganisationPeut créer et consulter tous les projets, tous les utilisateurs et toutes les clés d’API. A la capacité de surveiller tous les projets de l’organisation avec la

page Projets
. Peut définir des budgets d’organisation et des budgets de projet. Peut accorder des autorisations permettant de consulter les renseignements d’utilisation d’autres membres de l’organisation. Peut archiver des projets.
LecteurOrganisationPeut effectuer de l’inférence, utiliser des ressources et créer des clés dans ses projets. Peut être ajouté à des projets.
Ne peut pas créer de projets ni gérer des utilisateurs.
PropriétaireProjetPeut ajouter d’autres utilisateurs au projet et renommer le projet, en plus de toutes les capacités d’un membre. Peut définir des budgets de projet. Peut archiver le projet.
MembreProjetPeut effectuer de l’inférence, utiliser des ressources et créer des clés au niveau du projet.

Si je ne suis pas propriétaire dans l’organisation, à quoi ai-je accès?

Les utilisateurs qui ne sont pas propriétaires dans l’organisation ne peuvent voir que les projets dont ils sont membres. Seul le propriétaire de l’organisation peut voir tous les projets, membres et clés d’API au niveau du projet, et accéder à la page Projets.

  • Seuls les membres d’un projet (et les propriétaires de l’organisation) peuvent voir les modèles ajustés finement qui ont été créés dans ce projet, les fils de discussion de tous les assistants créés ou tous les fichiers ajoutés.

  • Les membres d’un projet peuvent voir qui sont tous les autres membres de ce projet et leurs rôles (c.-à-d. propriétaire ou membre).

Comment mettre à jour le rôle d’un utilisateur dans un projet ou retirer un utilisateur d’un projet?

Seul le propriétaire d’un projet peut mettre à jour le rôle d’un utilisateur dans le projet ou retirer un utilisateur d’un projet. Veuillez consulter les rôles et les autorisations pour en savoir plus.

Pour mettre à jour un utilisateur dans un projet, accédez à vos paramètres de l’organisation, sélectionnez le projet, puis cliquez sur Membres. Vous pouvez définir le rôle de chaque membre comme Membre ou Propriétaire. Vous pouvez aussi sélectionner Supprimer pour retirer l’utilisateur du projet.

Qu’est-ce qu’un compte de service et en quoi diffère-t-il d’un compte utilisateur ordinaire?

Un compte de service agit comme un pseudo-utilisateur conçu pour l’accès système, distinct des comptes d’utilisateurs individuels. Seuls les propriétaires de l’organisation et du projet peuvent créer des comptes de service.

Les comptes de service sont limités aux projets uniquement.

Ajouter un membre à un projet

Si vous cliquez sur le bouton + Add member, vous verrez une liste des utilisateurs de votre organisation ayant le rôle Reader. Si vous voulez ajouter un utilisateur qui ne fait pas actuellement partie de votre organisation, vous devrez d’abord l’ajouter à l’organisation (vous pouvez laisser la case « Ajouter au projet par défaut » décochée si vous ne voulez pas donner à ces utilisateurs un accès plus large). Cette liste n’inclura pas les comptes de service. À cette étape, vous pouvez choisir si leur rôle est Owner ou Member :

Project members with Add team members dialog assigning a user the Member role

Lorsque vous ajoutez un membre de l’équipe, vous devez lui attribuer le rôle Membre ou Propriétaire. Les membres du projet peuvent faire des requêtes d’API qui lisent ou modifient des données, tandis que les propriétaires du projet peuvent aussi modifier les paramètres et les budgets du projet, ainsi que gérer les membres du projet. Veuillez consulter les rôles et les autorisations pour en savoir plus.

Comment créer un compte de service pour un projet

Accédez d’abord au projet pour lequel vous voulez créer un compte de service en le choisissant dans la liste déroulante de la barre de navigation :

API platform project switcher open with options to create a project or manage projects

Ensuite, allez dans vos paramètres de l’organisation -> Projet -> Membres -> cliquez sur + Service account :

Les comptes de service créés au niveau du projet sont propres au projet et ne peuvent pas être utilisés à l’extérieur du projet dans lequel ils sont créés.

Project Members page with Create a service account dialog after selecting the Service account option

Nommer le compte de service

Que vous créiez le compte de service au niveau de l’organisation ou un compte unique à un projet, lorsque vous créez un compte de service, vous pouvez créer un ID de compte de service unique composé de lettres, de chiffres et de traits d’union pour l’identifier facilement.

Enregistrer la clé d’API du compte de service

Après avoir sélectionné le bouton Créer, une clé d’API est immédiatement créée pour le compte de service et la clé secrète s’affiche. Enregistrez cette clé secrète dans un endroit sûr et sécurisé. Pour des raisons de sécurité, vous ne pourrez pas la consulter de nouveau dans votre compte OpenAI. Si vous perdez cette clé secrète, vous devrez en générer une nouvelle.

Members page with Save your key modal after creating a service account

Les autorisations de la clé d’API du compte de service sont définies par défaut pour lire et écrire toutes les ressources d’API du projet. Ces autorisations peuvent être mises à jour dans les paramètres Clés d’API de votre projet.

Les comptes de service sont répertoriés avec les membres du projet sur la page des paramètres des membres de votre projet. Veuillez consulter cette page pour en savoir plus sur la mise à jour ou la suppression de l’accès d’un compte de service dans la page des paramètres des membres de votre projet.

Tous les comptes de service des projets et des organisations seront affichés avec vos utilisateurs humains sur la page des membres au niveau de l’organisation.

Les comptes de service sont gérés comme des comptes ordinaires. Dans le menu Organisation -> Membres, vous pouvez Supprimer un compte de service ou mettre à jour son rôle :

OpenAI API Members settings with a service account role menu open for Reader or Owner

Comment gérer les clés d’API dans les projets de mon organisation?

Vous pouvez créer et gérer des clés d’API pour chaque projet sur la page des paramètres de ce projet. Dans vos paramètres de l’organisation, sélectionnez le projet, puis cliquez sur Clés d’API.

Pour créer une nouvelle clé secrète, sélectionnez + Create new secret key. Vous pouvez aussi sélectionner l’icône Modifier à côté d’une clé secrète pour modifier ses autorisations.

API keys page for a project with the Create new secret key button highlighted

Vous pouvez définir les autorisations de chacune de vos clés d’API lorsque vous créez une nouvelle clé secrète ou en modifiant une clé existante.

Trois niveaux d’autorisations sont disponibles : Toutes, Restreintes et Lecture seule.

  • Toutes — Des autorisations complètes sont définies pour la clé secrète. Il s’agit du paramètre par défaut.

  • Restreintes — Permet à l’utilisateur de définir les autorisations Aucune, Lecture et Écriture pour chaque endpoint.

    • Par exemple, vous créez une clé d’API qui n’a précisément pas l’autorisation de lire ni d’écrire dans l’endpoint /v1/assistants :

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Lecture seule — Des autorisations de lecture sont définies pour tous les endpoints.

Comment l’accès est-il géré pour les utilisateurs appartenant à plusieurs projets ou organisations?

Les utilisateurs peuvent être membres d’autant de projets que nécessaire. Dans un projet, les utilisateurs peuvent générer une clé API personnelle dont la portée est limitée à l’accès à ce projet et à ses ressources.

Comment définir et gérer les limites de débit pour les projets de mon organisation?

Seul le propriétaire d’une organisation peut définir et gérer les limites de débit au niveau des projets. Veuillez consulter les rôles et les autorisations pour en savoir plus.

Dans vos paramètres de l’organisation, cliquez sur le projet à mettre à jour, puis sélectionnez Limites dans la section Projet de la liste de navigation. Vous pouvez mettre à jour votre utilisation du modèle sur cette page.

L’utilisation du modèle vous permet de configurer les modèles que le projet peut utiliser, et des limites de débit peuvent être définies pour chaque modèle au besoin.

Comment définir et gérer les budgets des projets de mon organisation?

Seuls les propriétaires d’une organisation et les propriétaires d’un projet peuvent définir et gérer les budgets de projet. Veuillez consulter les rôles et les autorisations pour en savoir plus. Pour modifier les limites au niveau de l’organisation, dans vos paramètres de l’organisation, cliquez sur Limites, puis faites défiler jusqu’à Limites d’utilisation.

Project Limits page with organization budget controls, usage alerts, and model rate limits table

Pour définir les limites de votre projet, dans vos paramètres de l’organisation, cliquez sur le projet à mettre à jour, puis sélectionnez Limites. Vous pouvez mettre à jour votre budget mensuel, votre seuil de notification et votre utilisation du modèle.

Définir un budget mensuel vous permet d’établir des seuils de dépenses souples pour votre projet. Lorsque l’utilisation dépasse cette limite au cours d’un mois civil donné (UTC), les requêtes d’API continueront d’être traitées sans interruption. Cette fonctionnalité est conçue pour vous aider à surveiller l’utilisation au moyen d’alertes budgétaires, mais elle n’impose pas de plafond strict aux dépenses. Lorsqu’un budget de projet est créé, une alerte est créée par défaut au seuil de 100 %. Des budgets supplémentaires à différents seuils peuvent être définis en cliquant sur Ajouter une alerte.

Veuillez noter que les propriétaires de l’organisation et les propriétaires du projet recevront toujours ces messages, et que cela ne peut pas être personnalisé.

Project Limits page with Add budget alert dialog set to notify at 90% budget usage

Comment supprimer ou archiver un projet?

Les projets peuvent être archivés soit à partir de la nouvelle page de liste des projets, soit dans les paramètres d’un projet individuel. Une fois qu’un projet est archivé, il ne peut pas être restauré. Lorsque vous procédez à l’archivage, vous serez invité à saisir le nom du projet pour continuer.

Vous pouvez voir la liste de tous les projets archivés dans l’onglet « Archivés » de la même page de liste des projets.

API platform Projects page with the Archived tab selected to view archived projects

Il n’est pas possible de supprimer des projets; nous conservons un historique de tous les projets afin d’assurer la continuité du suivi de l’utilisation et de la facturation.

Y a-t-il une limite au nombre de projets que je peux avoir dans mon organisation?

Les organisations peuvent créer jusqu’à 2 000 projets par défaut.

Les ressources peuvent-elles être partagées entre les projets?

Les ressources de projet (comme les fichiers, les assistants, le stockage ou les fils) sont limitées au projet et ne sont pas accessibles aux membres non administrateurs à l’extérieur du projet. De plus, les ressources ne peuvent pas être déplacées entre les projets.

La seule exception est que les ajustements fins dans le « projet par défaut » peuvent être accessibles à partir d’autres projets.

Quel est le quota de stockage de fichiers par projet?

OpenAI prend actuellement en charge un quota de stockage de 100 Go de fichiers par projet.

Si ce quota est dépassé, vous verrez l’erreur suivante :

Vous avez dépassé votre quota de stockage de fichiers. Les organisations sont limitées à 100 Go de fichiers. Veuillez réduire la taille des fichiers ou contacter le soutien.

Nous vous recommandons de supprimer les fichiers inutilisés stockés dans votre compte. À titre de référence, vous pouvez consulter et lister les fichiers avec l’API.

Je suis propriétaire de projet; pourquoi ne puis-je pas voir le tableau de bord d’utilisation de mon projet?

La visibilité du tableau de bord d’utilisation d’un projet n’est pas liée au rôle d’un utilisateur dans un projet. Elle est plutôt déterminée par votre rôle au sein de l’organisation et par les paramètres à l’adresse https://platform.openai.com/settings/organization/data-controls/visibility

Project setting for Usage dashboard visibility with Visible to organization owners selected

Si vous ne pouvez pas voir un tableau de bord d’utilisation, ce paramètre est probablement défini à « Visible par les propriétaires de l’organisation ».

Cet article vous a-t-il été utile?