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

Gestion des projets dans la plateforme API

Mise à jour : 9 days ago

Les projets visent à permettre aux clients d’organiser leur travail. Les organisations peuvent gérer l’accès et les limites, créer des comptes de service (au moyen de l’interface utilisateur) et suivre l’utilisation dans une portée restreinte au sein d’un projet (p. ex., modèles, capacités, fils, assistants, réglage fin, stockage, etc.). L’activité d’utilisation peut être ventilée par projet, et les utilisateurs peuvent consulter la facturation et définir des limites de dépenses pour chaque projet.

Les propriétaires d’une organisation peuvent consulter tous leurs projets actifs et archivés sur la page Projets. En savoir plus sur les rôles et autorisations des utilisateurs dans la Plateforme 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 limites de dépenses (en date de novembre 2024). Il hérite de toute la configuration de l’organisation; vous ne pouvez donc pas y ajouter directement des membres ni des comptes de service.

Comment créer un projet?

Placez d’abord le pointeur sur le nom du projet dans le coin gauche de la page, puis sélectionnez Créer un projet.

API platform project menu with Create project highlighted under Default project

Indiquez un nom, une description et un site Web pour votre projet, puis sélectionnez Créer.

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 nouveaux membres de l’organisation ne sont pas automatiquement ajoutés au « Projet par défaut ». Les nouveaux membres peuvent être invités au projet lorsqu’ils sont invités à rejoindre l’organisation (en cochant la case « Inviter au projet par défaut ») ou après avoir accepté l’invitation à rejoindre l’organisation.

Les utilisateurs invités au moyen de l’API d’administration sont assujettis aux règles du point de terminaison /organization/invites.

Si une erreur survient lorsque vous invitez des utilisateurs à rejoindre un projet dans l’interface utilisateur ou au moyen 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 de celle-ci.

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 d’un projet sont comparables aux lecteurs d’une 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. Peut effectuer le suivi de tous les projets de l’organisation à partir de la

page Projets
. Peut définir les limites de dépenses de l’organisation et des projets. Peut accorder des autorisations permettant de consulter les renseignements sur l’utilisation d’autres personnes de l’organisation. Peut archiver des projets.
LecteurOrganisationPeut effectuer des inférences, 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 les utilisateurs.
PropriétaireProjetPeut ajouter d’autres utilisateurs au projet et renommer le projet, en plus de disposer de toutes les capacités d’un membre. Peut définir les limites de dépenses du projet. Peut archiver le projet.
MembreProjetPeut effectuer des inférences, utiliser des ressources et créer des clés au niveau du projet.

À quoi ai-je accès si je ne suis pas propriétaire de l’organisation?

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

  • Seuls les membres d’un projet et les propriétaires de l’organisation peuvent voir les modèles affinés créés dans ce projet, les fils de discussion des assistants créés et les fichiers ajoutés.

  • Les membres d’un projet peuvent voir tous les autres membres de ce projet ainsi que leurs rôles (p. ex. Propriétaire ou Membre).

Comment modifier le rôle d’un utilisateur dans un projet ou retirer un utilisateur d’un projet?

Seul le propriétaire d’un projet peut modifier le rôle d’un utilisateur dans celui-ci ou en retirer un utilisateur. Consultez la section sur les rôles et autorisations pour en savoir plus.

Pour mettre à jour un utilisateur dans un projet, accédez aux paramètres de l’organisation, sélectionnez le projet, puis cliquez sur Membres. Vous pouvez attribuer à chaque membre le rôle de Membre ou de Propriétaire. Vous pouvez également sélectionner Retirer 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 + Ajouter un membre, vous verrez la liste des utilisateurs de votre organisation qui ont le rôle de Lecteur. Si vous souhaitez ajouter un utilisateur qui ne fait pas actuellement partie de votre organisation, vous devez d’abord l’ajouter à celle-ci (vous pouvez laisser la case « Ajouter au projet par défaut » décochée si vous ne souhaitez pas lui accorder un accès plus étendu). Cette liste n’inclut pas les comptes de service. À cette étape, vous pouvez lui attribuer le rôle de Propriétaire ou de Membre :

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 de Membre ou de Propriétaire. Les membres d’un projet peuvent effectuer des requêtes API qui lisent ou modifient des données, tandis que les propriétaires peuvent aussi modifier les paramètres et les limites de dépenses du projet ainsi que gérer ses membres. Consultez la section sur les rôles et autorisations pour en savoir plus.

Comment créer un compte de service pour un projet

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

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

Accédez ensuite aux paramètres de l’organisation -> Projet -> Membres -> puis cliquez sur + Compte de service :

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é API du compte de service

Après avoir sélectionné le bouton Créer, une clé 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 plus la consulter 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

Par défaut, la clé API du compte de service peut lire et modifier toutes les ressources API du projet. Ces autorisations peuvent être modifiées dans les paramètres des clés API de votre projet.

Les comptes de service figurent avec les membres du projet sur la page des paramètres des membres de celui-ci. Consultez les renseignements disponibles ici pour en savoir plus sur la modification 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 API dans les projets de mon organisation?

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

Pour créer une nouvelle clé secrète, sélectionnez + Créer une nouvelle clé secrète. Vous pouvez également sélectionner l’icône Modifier à côté d’une clé secrète afin de 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 API lorsque vous créez une clé secrète ou modifiez une clé existante.

Trois niveaux d’autorisation sont offerts : Toutes, Restreintes et Lecture seule.

  • Toutes — La clé secrète dispose de toutes les autorisations. Il s’agit du paramètre par défaut.

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

  • Par exemple, vous pouvez créer une clé API qui ne dispose précisément d’aucune autorisation de lecture ou d’écriture pour le point de terminaison /v1/assistants :

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

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 limites de dépenses des projets de mon organisation?

Seuls les propriétaires d’une organisation et d’un projet peuvent définir et gérer les limites de dépenses du projet. Consultez la section sur les rôles et autorisations pour en savoir plus. Pour modifier les limites à l’échelle de l’organisation, accédez aux paramètres de l’organisation, cliquez sur Limites, puis faites défiler la page 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, accédez aux paramètres de l’organisation, cliquez sur le projet à mettre à jour, puis sélectionnez Limites. Vous pouvez modifier votre Limite de dépenses mensuelles, votre Seuil de notification et votre Utilisation des modèles.

La définition d’une limite de dépenses mensuelles vous permet d’établir des seuils de dépenses non contraignants pour votre projet. Lorsque l’utilisation dépasse cette limite au cours d’un mois civil donné (UTC), les requêtes API continuent d’être traitées sans interruption. Cette fonctionnalité vous aide à surveiller l’utilisation grâce à des alertes de limite de dépenses, mais elle n’impose aucun plafond de dépenses strict. Lorsqu’une limite de dépenses est créée pour un projet, une alerte est établie par défaut au seuil de 100 %. Vous pouvez définir des alertes supplémentaires à différents seuils en cliquant sur Ajouter une alerte.

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

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

Comment définir des limites de dépenses pour mon organisation ou mon projet?

OpenAI prend maintenant en charge les limites mensuelles de dépenses d’API aux niveaux de l’organisation et du projet. Une limite de dépenses peut surveiller les dépenses sans les appliquer, ou vous pouvez l’appliquer comme limite stricte afin que les requêtes d’API échouent une fois la limite atteinte. Pour connaître les dernières étapes de configuration et le comportement actuel, consultez Limites de dépenses dans la documentation destinée aux développeurs.

Comment supprimer ou archiver un projet?

Les projets peuvent être archivés à partir de la nouvelle page de liste des projets ou des paramètres d’un projet donné. Une fois archivé, un projet ne peut pas être restauré. Lorsque vous lancerez l’archivage, vous devrez saisir le nom du projet pour continuer.

Vous pouvez consulter la liste de tous les projets archivés sous 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 est impossible de supprimer des projets. Nous conservons l’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 fichiers de 100 Go par projet.

Si ce quota est dépassé, l’erreur suivante s’affichera :

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 d’un projet. Pourquoi ne puis-je pas voir son tableau de bord d’utilisation?

La visibilité du tableau de bord d’utilisation d’un projet n’est pas liée au rôle d’un utilisateur au sein de ce projet. Elle est plutôt déterminée par votre rôle au sein de l’organisation et par les paramètres accessibles à 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 réglé à « Visible par les propriétaires de l’organisation ».

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