Les projets visent à offrir aux clients la possibilité d’organiser leur travail. Les organisations peuvent gérer l’accès et les limites, provisionner des comptes de service (via l’interface utilisateur) et suivre l’utilisation dans un périmètre restreint au sein d’un projet (par ex. modèles, capacités, threads, assistants, fine-tuning, 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 Projects. En savoir plus sur les rôles et autorisations des utilisateurs dans l’API Platform.
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’informations.
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 utilisant un plan de facturation consolidée, les sous-organisations sont identifiées séparément. Les projets ne peuvent pas être créés au sein des 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 du modèle virtuel 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 lui 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.
Indiquez un nom, une description et un site web pour votre projet, puis sélectionnez Create.
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 dans l’organisation (en cochant la case "Inviter au projet par défaut"), soit après que le membre a accepté l’invitation à rejoindre l’organisation.
Les utilisateurs invités via l’Admin API suivent les règles définies par l’endpoint /organization/invites.
Si vous rencontrez une erreur lors de l’invitation d’utilisateurs à un projet via l’interface utilisateur ou l’Admin API, 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 en tant que propriétaires aux nouveaux projets créés au sein d’une organisation.
Quels sont les différents rôles utilisateur au sein des organisations et des 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 de l’organisation. Veuillez consulter le tableau ci-dessous pour une description plus détaillée des autorisations associées à chaque rôle utilisateur.
| Rôle | Périmètre | Description |
|---|---|---|
| Owner | Organisation | Peut créer/voir tous les projets, tous les utilisateurs et toutes les clés API. A la possibilité de surveiller tous les projets de l’organisation via la page Projects . Peut définir les budgets de l’organisation et des projets. Peut accorder à d’autres personnes de l’organisation des autorisations pour voir les informations 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 les utilisateurs. |
| Owner | Projet | Peut ajouter d’autres utilisateurs au projet et renommer le projet, ainsi que disposer de toutes les capacités d’un Member. 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 Owner dans l’organisation, à quoi ai-je accès ?
Les utilisateurs qui ne sont pas Owners 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 de l’organisation) peuvent voir les modèles fine-tunés qui ont été créés dans ce projet, les threads de tous les assistants créés, ou les fichiers qui ont été ajoutés.
Les membres d’un projet peuvent voir qui sont tous les autres membres de ce projet ainsi que leurs rôles (c’est-à-dire Owner ou Member).
Comment mettre à jour le rôle d’un utilisateur dans un projet ou supprimer 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 supprimer un utilisateur d’un projet. Veuillez consulter les rôles et autorisations pour plus d’informations.
Pour mettre à jour un utilisateur dans un projet, accédez à vos paramètres d’organisation, sélectionnez le projet, puis cliquez sur Members. Vous avez la possibilité de définir le rôle de chaque membre comme Member ou Owner. Vous pouvez également sélectionner Remove pour supprimer l’utilisateur du projet.
Qu’est-ce qu’un compte de service et en quoi diffère-t-il d’un compte utilisateur classique ?
Un compte de service agit comme un pseudo-utilisateur conçu pour l’accès système, distinct des comptes utilisateurs individuels. Seuls les propriétaires d’organisation et de 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 souhaitez 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’inclut pas les comptes de service. À 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 Member ou Owner. Les membres du projet peuvent effectuer des requêtes API qui lisent ou modifient des données, tandis que les propriétaires du projet peuvent également 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’informations.
Comment créer un compte de service pour un projet
Commencez par accéder au projet pour lequel vous souhaitez créer un compte de service en le choisissant dans la liste déroulante située dans la barre de navigation :
Ensuite, accédez à vos paramètres d’organisation -> Projet -> Members -> 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 en dehors du projet dans lequel ils ont été créés.
Nommer le compte de service
Que vous créiez le compte de service au niveau de l’organisation ou un compte propre à un projet, vous pouvez créer un identifiant de compte de service unique composé de lettres, de chiffres et de traits d’union afin d’identifier facilement le compte de service.
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’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 via 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, réglées sur lecture et é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 avec les 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 sur la page des paramètres des membres de votre projet.
Tous les comptes de service, tant au niveau des projets que 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 classiques. Depuis le menu Organisation -> Members, 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, puis cliquez sur API Keys.
Pour créer une nouvelle clé secrète, sélectionnez + Create new secret key. Vous pouvez également sélectionner l’icône Modifier à côté d’une clé secrète pour en modifier les autorisations.
Vous pouvez définir les autorisations de 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 les autorisations None, Read et Write pour chaque endpoint.
Par exemple, vous créez une clé API qui n’a spécifiquement pas l’autorisation de Read ou Write sur l’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. Au sein d’un projet, les utilisateurs peuvent générer une clé API personnelle dont le périmètre est limité à 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’informations.
Dans vos paramètres d’organisation, cliquez sur le projet que vous souhaitez mettre à jour et sélectionnez Limits dans la section Projet de la liste de navigation. Vous pouvez mettre à jour l’Model Usage sur cette page.
L’Model Usage 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 selon les besoins.
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’informations. 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 souhaitez mettre à jour et sélectionnez Limits. Vous pouvez mettre à jour votre Monthly budget, le Notification threshold et l’Model Usage.
Définir un budget mensuel vous permet d’établir des seuils souples de dépenses pour votre projet. Lorsque l’usage dépasse cette limite au cours d’un mois calendaire donné (UTC), les requêtes API continuent d’être traitées sans interruption. Cette fonctionnalité est conçue pour vous aider à surveiller l’usage grâce à des alertes budgétaires, mais elle n’applique pas de plafond strict de 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 soit via 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é. Lors de l’archivage, vous serez invité à saisir le nom du projet pour continuer.
Vous pouvez consulter la liste de tous les projets archivés via l’onglet « Archived » sur cette même page de liste des projets.
La suppression de projets n’est pas possible ; 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 projets ?
Les ressources du projet (telles que les fichiers, assistants, le stockage ou les threads) sont limitées au projet et ne sont pas accessibles aux membres non administrateurs en dehors du projet. De plus, les ressources ne peuvent pas être déplacées entre les projets.
La seule exception est que les fine-tunes du « projet par défaut » sont accessibles depuis 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 le message d’erreur suivant :
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 l’assistance.Nous vous recommandons de supprimer les fichiers inutilisés stockés sur 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 au sein d’un projet. Elle est plutôt déterminée par votre rôle au sein de l’organisation et par les paramètres de https://platform.openai.com/settings/organization/data-controls/visibility
Si vous ne parvenez pas à voir un tableau de bord d’utilisation, ce paramètre est probablement défini sur "Visible to organization owners".