Проекты призваны дать клиентам возможность организовывать свою работу. Организации могут управлять доступом и лимитами, предоставлять сервисные аккаунты (через UI) и отслеживать использование в рамках ограниченной области проекта (например, модели, возможности, threads, assistants, файнтюнинг, хранилище и т. д.). Активность использования можно разбивать по проектам, а пользователи могут просматривать биллинг и задавать бюджеты для каждого проекта.
Владельцы организации могут просматривать все свои активные и архивированные проекты на странице Projects. Узнайте больше о ролях пользователей и разрешениях на платформе API.
Кто может создать проект?
Только владельцы организации могут создавать проекты. Подробнее см. в разделе роли и разрешения.
Чтобы переключаться между организациями, наведите указатель на название вашей организации в левом верхнем углу страницы и выберите организацию из списка:
Для организаций с консолидированным планом биллинга подорганизации выделяются отдельно. В подорганизациях проекты создавать нельзя.
Как работают проекты?
У каждой организации есть «Проект по умолчанию», который нельзя удалить. Вы можете настраивать лимиты скорости, разрешения для виртуальных моделей и бюджеты расходов (по состоянию на ноябрь 2024 года). Он наследует полную конфигурацию организации, поэтому напрямую добавлять в него участников или сервисные аккаунты нельзя.
Как создать проект?
Сначала наведите указатель на название проекта в левом углу страницы и выберите Create project.
Укажите название, описание и веб-сайт для проекта, затем выберите Create.
Как добавить пользователей в проект?
Новые участники организации не добавляются автоматически в «Проект по умолчанию». Новых участников можно пригласить в проект либо при их приглашении в организацию (включив флажок "Invite to default project"), либо после того, как участник примет приглашение в организацию.
Пользователи, приглашённые через Admin API, следуют правилам, описанным для конечной точки /organization/invites.
Если при приглашении пользователей в проект через UI или Admin API возникает ошибка, сначала убедитесь, что целевой проект существует и не архивирован, а затем повторно отправьте приглашение.
Владельцы организации автоматически добавляются как владельцы в новые проекты, созданные в организации.
Какие бывают роли пользователей в организациях и проектах и какие разрешения они дают?
Если в организациях есть роли ‘owner’ и ‘reader’, то в проектах есть роли ‘owner’ и ‘member’. Участники проекта аналогичны читателям организации. Более подробное описание разрешений для каждой роли пользователя см. в таблице ниже.
| Роль | Область | Описание |
|---|---|---|
| Owner | Организация | Может создавать/просматривать все проекты, всех пользователей, все ключи API. Имеет возможность отслеживать данные по всем проектам в организации с помощью страницы Projects . Может задавать бюджеты организации и проектов. Может выдавать другим в организации разрешения на просмотр информации об использовании. Может архивировать проекты. |
| Reader | Организация | Может выполнять inference, использовать ресурсы и создавать ключи в своих проектах. Может быть добавлен в проекты. Не может создавать проекты и управлять пользователями. |
| Owner | Проект | Может добавлять в проект других пользователей и переименовывать проект, а также имеет все возможности участника Member. Может задавать бюджеты проекта. Может архивировать проект. |
| Member | Проект | Может выполнять inference, использовать ресурсы и создавать ключи на уровне проекта. |
Если я не Owner в организации, к чему у меня есть доступ?
Пользователи, не являющиеся Owners в организации, могут видеть только те проекты, участниками которых они являются. Только владелец организации может видеть все проекты, участников и API-ключи на уровне проекта, а также имеет доступ к странице Projects.
Только участники проекта (и владельцы организации) могут видеть файнтюн-модели, созданные в этом проекте, threads из любых созданных Assistants и любые добавленные файлы.
Участники проекта могут видеть всех остальных участников этого проекта и их роли (то есть Owner или Member).
Как изменить роль пользователя в проекте или удалить пользователя из проекта?
Только владелец проекта может изменить роль пользователя в проекте или удалить пользователя из проекта. Подробнее см. в разделе роли и разрешения.
Чтобы обновить данные пользователя в проекте, перейдите в настройки организации, выберите проект и нажмите Members. У вас есть возможность назначить каждому участнику роль Member или Owner. Также можно выбрать Remove, чтобы удалить пользователя из проекта.
Что такое сервисный аккаунт и чем он отличается от обычной учётной записи пользователя?
Сервисный аккаунт действует как псевдопользователь, предназначенный для системного доступа, и отличается от индивидуальных учётных записей пользователей. Только владельцы организации и проекта могут создавать сервисные аккаунты.
Сервисные аккаунты ограничены только проектами.
Добавление участника в проект
Если нажать кнопку + Add member, вы увидите список пользователей вашей организации с ролью Reader. Если вы хотите добавить пользователя, которого сейчас нет в вашей организации, сначала нужно добавить его в организацию (можно оставить флажок 'Add to Default Project" снятым, если вы не хотите давать этим пользователям более широкий доступ). В этот список не входят сервисные аккаунты. На этом этапе можно выбрать для них роль Owner или Member:
Когда вы добавляете участника команды, необходимо назначить ему роль Member или Owner. Участники проекта могут выполнять API-запросы, которые читают или изменяют данные, тогда как владельцы проекта также могут изменять настройки и бюджеты проекта и управлять участниками проекта. Подробнее см. в разделе роли и разрешения.
Как создать сервисный аккаунт для проекта
Сначала перейдите к проекту, для которого хотите создать сервисный аккаунт, выбрав его в раскрывающемся списке на панели навигации:
Затем перейдите в настройки организации -> Project -> Members -> нажмите + Service account:
Сервисные аккаунты, созданные на уровне проекта, уникальны для проекта и не могут использоваться за пределами проекта, в котором они созданы.
Имя сервисного аккаунта
Независимо от того, создаёте ли вы сервисный аккаунт на уровне организации или уникальный для проекта, при создании сервисного аккаунта можно задать уникальный ID сервисного аккаунта, состоящий из букв, цифр и дефисов, чтобы его было легко идентифицировать.
Сохраните API-ключ сервисного аккаунта
После нажатия кнопки Create для сервисного аккаунта сразу создаётся API-ключ, и будет показан секретный ключ. Сохраните этот секретный ключ в безопасном месте. По соображениям безопасности вы больше не сможете просмотреть его через свой аккаунт OpenAI. Если вы потеряете этот секретный ключ, вам потребуется сгенерировать новый.
По умолчанию разрешения API-ключа сервисного аккаунта включают чтение и запись для всех API-ресурсов проекта. Эти разрешения можно обновить в настройках API Keys вашего проекта.
Сервисные аккаунты перечислены вместе с участниками проекта на странице настроек участников проекта. Подробнее об обновлении или удалении доступа сервисного аккаунта на странице настроек участников проекта см. здесь.
Все сервисные аккаунты как в проектах, так и в организациях будут отображаться вместе с вашими пользовательскими аккаунтами на странице участников на уровне организации.
Сервисные аккаунты управляются так же, как обычные аккаунты. В меню Organization -> Members можно Remove сервисный аккаунт или обновить его роль:
Как управлять API-ключами в проектах моей организации?
Вы можете создавать API-ключи и управлять ими для каждого проекта на странице настроек этого проекта. В настройках организации выберите проект и нажмите API Keys.
Чтобы создать новый секретный ключ, выберите + Create new secret key. Вы также можете нажать значок Edit рядом с секретным ключом, чтобы изменить его разрешения.
Вы можете задавать разрешения для каждого API-ключа при создании нового секретного ключа или при редактировании существующего ключа.
Доступны три уровня разрешений: All, Restricted и Read Only.
All — для секретного ключа задаются полные разрешения. Это настройка по умолчанию.
Restricted — позволяет пользователю задавать разрешения None, Read и Write для каждой конечной точки.
Например, вы создаёте API-ключ, у которого специально нет разрешения Read или Write для конечной точки /v1/assistants:
Read Only — для всех конечных точек задаются разрешения на чтение.
Как управляется доступ для пользователей, принадлежащих к нескольким проектам или организациям?
Пользователи могут быть участниками любого необходимого количества проектов. Внутри проекта пользователи могут генерировать персональный API-ключ, область действия которого ограничена доступом к этому проекту и его ресурсам.
Как задавать лимиты скорости для проектов моей организации и управлять ими?
Только владелец организации может задавать лимиты скорости на уровне проекта и управлять ими. Подробнее см. в разделе роли и разрешения.
В настройках организации нажмите на проект, который хотите обновить, и выберите Limits в разделе Project списка навигации. На этой странице вы можете обновить Model Usage.
Model Usage позволяет настроить, какие модели могут использоваться проектом, а для каждой модели при необходимости можно задать лимиты скорости.
Как задавать бюджеты для проектов организации и управлять ими?
Только владельцы организации и владельцы проекта могут задавать бюджеты проекта и управлять ими. Подробнее см. в разделе роли и разрешения. Чтобы изменить лимиты на уровне организации, в настройках организации нажмите Limits, а затем прокрутите вниз до Usage limits.
Чтобы задать лимиты проекта, в настройках организации нажмите на проект, который хотите обновить, и выберите Limits. Вы можете обновить Monthly budget, Notification threshold и Model Usage.
Настройка monthly budget позволяет задать мягкие пороги расходов для вашего проекта. Когда использование превышает этот лимит в пределах календарного месяца (UTC), API-запросы продолжают обрабатываться без прерывания. Эта функция помогает отслеживать использование с помощью бюджетных уведомлений, но не устанавливает жёсткий предел расходов. При создании бюджета проекта по умолчанию создаётся уведомление на пороге 100%. Дополнительные бюджеты с другими порогами можно задать, нажав Add Alert.
Обратите внимание, что владелец(ы) организации и владелец(ы) проекта всегда будут получать эти сообщения, и это нельзя настроить.
Как удалить или архивировать проект?
Проекты можно архивировать либо через новую страницу списка проектов, либо в настройках отдельного проекта. После архивации проект нельзя восстановить. При архивации вам будет предложено ввести имя проекта для подтверждения.
Вы можете просмотреть список всех архивированных проектов на вкладке «Archived» на той же странице списка проектов.
Удалить проекты невозможно: мы храним историю всех проектов, чтобы обеспечить непрерывность отслеживания использования и биллинга.
Есть ли ограничение на количество проектов в моей организации?
По умолчанию организации могут создавать до 2 000 проектов.
Можно ли совместно использовать ресурсы между проектами?
Ресурсы проекта (такие как файлы, assistants, хранилище или threads) ограничены рамками проекта и недоступны для неадминистративных участников вне проекта. Кроме того, ресурсы нельзя переносить между проектами.
Единственное исключение заключается в том, что файнтюны в «Проекте по умолчанию» доступны из других проектов.
Какова квота на хранение файлов для проекта?
OpenAI в настоящее время поддерживает квоту на хранение файлов в размере 100 ГБ на проект.
Если эта квота превышена, вы увидите следующую ошибку:
Вы превысили квоту на хранение файлов. Для организаций действует ограничение в 100 ГБ файлов. Уменьшите размер файлов или обратитесь в поддержку.Мы рекомендуем удалить неиспользуемые файлы, хранящиеся в вашем аккаунте. Для справки: с помощью API можно просматривать и перечислять файлы.
Я владелец проекта. Почему я не вижу панель Usage Dashboard для своего проекта?
Видимость Usage Dashboard проекта не связана с ролью пользователя в проекте. Вместо этого она определяется вашей ролью в организации и настройками по адресу https://platform.openai.com/settings/organization/data-controls/visibility
Если вы не видите Usage Dashboard, вероятно, этот параметр установлен в значение "Visible to organization owners".