Les projets visent à donner aux clients la possibilité d’organiser leur travail. Les organisations peuvent gérer l’accès et les limites, provisionner des comptes de service (par l’interface utilisateur) et suivre l’utilisation dans une portée limitée au sein d’un projet (p. ex. modèles, capacités, fils, 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 d’organisation peuvent voir tous leurs projets actifs et archivés sur la page Projects. Apprenez-en plus sur les rôles et autorisations des utilisateurs dans la plateforme API.
Qui peut créer un projet?
Seuls les propriétaires de l’organisation peuvent créer un projet. Veuillez consulter les rôles et autorisations pour plus d’information.
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 :
Pour les organisations qui ont 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.
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.
Fournissez un nom, une description et un site Web pour votre projet, puis sélectionnez Create.
Comment ajouter des utilisateurs à un projet?
Les nouveaux membres 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 au moment où ils sont invités à l’organisation (en activant la case « Invite to default project »), soit après que le membre a accepté l’invitation à l’organisation.
Les utilisateurs invités via l’API Admin suivent les règles décrites par l’/organization/invites endpoint.
Si vous obtenez une erreur en invitant des utilisateurs à un projet par l’interface utilisateur ou l’API Admin, confirmez 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 dans une organisation.
Quels sont les différents rôles utilisateur dans les organisations et les projets, et quelles autorisations impliquent-ils?
Alors que les organisations ont les rôles « owner » et « reader », les projets ont les rôles « owner » et « member ». Les membres de projet sont analogues aux lecteurs d’organisation. Veuillez consulter le tableau ci-dessous pour une description plus détaillée des autorisations associées à chaque rôle utilisateur.
| Rôle | Portée | Description |
|---|---|---|
| Owner | Organisation | Peut créer/voir tous les projets, tous les utilisateurs, toutes les clés API. A la capacité de surveiller tous les projets de l’organisation avec la page Projects . Peut définir les budgets d’organisation et de projet. Peut accorder des autorisations pour permettre à d’autres dans l’organisation de voir l’information d’utilisation. Peut archiver des projets. |
| Reader | Organisation | Peut 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. |
| Owner | Projet | Peut ajouter d’autres utilisateurs au projet et renommer le projet, en plus de toutes les capacités d’un membre. Peut définir les budgets du projet. Peut archiver le projet. |
| Member | Projet | Peut 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 API au niveau du projet, et accéder à la page Projects.
Seuls les membres d’un projet (et les propriétaires d’organisation) peuvent voir les modèles ajustés finement qui ont été créés dans ce projet, les fils de toute ressource Assistants créée ou tout fichier qui a été ajouté.
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 de projet d’un utilisateur ou retirer un utilisateur d’un projet?
Seul le propriétaire d’un projet peut mettre à jour le rôle de projet d’un utilisateur ou retirer un utilisateur d’un projet. Veuillez consulter les rôles et autorisations pour plus d’information.
Pour mettre à jour un utilisateur dans un projet, accédez à vos paramètres d’organisation, sélectionnez le projet et cliquez sur Members. Vous avez l’option de définir le rôle de chaque membre comme Membre ou Propriétaire. Vous pouvez aussi sélectionner Remove 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 « Add to Default Project » 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. Pendant cette étape, vous pouvez choisir si leur rôle est Owner ou Member :
Lorsque vous ajoutez un membre d’équipe, vous devez lui attribuer le rôle Membre ou Propriétaire. Les membres du projet peuvent faire des requêtes 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 et gérer les membres du projet. Veuillez consulter les rôles et autorisations pour plus d’information.
Comment créer un compte de service pour un projet
Commencez par accéder 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 :
Ensuite, allez dans vos paramètres d’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.
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 Create, une clé API est immédiatement créée pour le compte de service et la clé secrète s’affichera. 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.
Les autorisations de la clé API du compte de service sont par défaut définies sur la lecture et l’écriture pour toutes les ressources API du projet. Ces autorisations peuvent être mises à jour dans les paramètres API Keys de votre projet.
Les comptes de service sont listés aux côtés des membres du projet sur la page des paramètres des membres de votre projet. Veuillez consulter ici 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 aux côtés de 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. À partir du menu Organisation -> Membres, vous pouvez Remove un compte de service ou mettre à jour son rôle :
Comment gérer les clés API dans les projets de mon organisation?
Vous pouvez créer et gérer des clés API pour chaque projet sur la page des paramètres de ce projet. Dans vos paramètres d’organisation, sélectionnez le projet et cliquez sur API Keys.
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.
Vous pouvez définir des autorisations pour chacune de vos clés API lorsque vous créez une nouvelle clé secrète ou en modifiant une clé existante.
Trois niveaux d’autorisations sont disponibles : All, Restricted et Read Only.
All — Les autorisations complètes sont définies pour la clé secrète. Il s’agit du paramètre par défaut.
Restricted — Permet à l’utilisateur de définir des autorisations None, Read et Write pour chaque endpoint.
Par exemple, vous créez une clé API qui n’a précisément pas l’autorisation de Read ou Write vers le endpoint /v1/assistants :
Read Only — Les 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 du projet. Veuillez consulter les rôles et autorisations pour plus d’information.
Dans vos paramètres d’organisation, cliquez sur le projet que vous voulez mettre à jour et sélectionnez Limits dans la section Projet de la liste de navigation. Vous pouvez mettre à jour votre Model Usage sur cette page.
L’utilisation du modèle vous permet de configurer quels modèles peuvent être utilisés par le projet, 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 autorisations pour plus d’information. Pour modifier les limites au niveau de l’organisation, dans vos paramètres d’organisation, cliquez sur Limits, puis faites défiler jusqu’à Usage limits.
Pour définir les limites de votre projet, dans vos paramètres d’organisation, cliquez sur le projet que vous voulez mettre à jour et sélectionnez Limits. Vous pouvez mettre à jour votre Monthly budget, Notification threshold et Model Usage.
La définition d’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 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 sur les 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 Add Alert.
Veuillez noter que le ou les propriétaires de l’organisation et le ou les propriétaires du projet recevront toujours ces messages, et cela ne peut pas être personnalisé.
Comment supprimer ou archiver un projet?
Les projets peuvent être archivés à partir soit de la nouvelle page de liste des projets, soit des paramètres d’un projet individuel. Une fois qu’un projet est archivé, il ne peut pas être restauré. En poursuivant l’archivage, vous serez invité à saisir le nom du projet pour continuer.
Vous pouvez voir une liste de tous les projets archivés dans l’onglet « Archived » sur cette même page de liste des projets.
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 afficher et lister les fichiers avec l’API.
Je suis propriétaire d’un 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 dans l’organisation et par les paramètres à l’adresse https://platform.openai.com/settings/organization/data-controls/visibility
Si vous ne pouvez pas voir un tableau de bord d’utilisation, ce paramètre est probablement réglé à « Visible to organization owners ».