Dự án nhằm cung cấp cho khách hàng khả năng tổ chức công việc của họ. Tổ chức có thể quản lý quyền truy cập và giới hạn, cấp tài khoản dịch vụ (thông qua UI), và theo dõi mức sử dụng trong một phạm vi giới hạn trong dự án (ví dụ: mô hình, khả năng, threads, assistants, tinh chỉnh, lưu trữ, v.v.). Hoạt động sử dụng có thể được phân tách theo dự án, và người dùng có thể xem thanh toán cũng như đặt ngân sách cho từng dự án.
Chủ sở hữu tổ chức có thể xem tất cả dự án Đang hoạt động và Đã lưu trữ của họ trong trang Projects. Tìm hiểu thêm về vai trò người dùng và quyền trong Nền tảng API.
Ai có thể tạo một dự án?
Chỉ chủ sở hữu tổ chức mới có thể tạo một dự án. Vui lòng tham khảo vai trò và quyền để biết thêm thông tin.
Để chuyển đổi giữa các tổ chức, hãy di chuột lên tên tổ chức của bạn ở phía trên bên trái trang và chọn tổ chức từ danh sách:
Đối với các tổ chức đang sử dụng gói thanh toán hợp nhất, các tổ chức con được xác định riêng biệt. Không thể tạo dự án trong các tổ chức con.
Dự án hoạt động như thế nào?
Mỗi tổ chức đều có một “Dự án mặc định” không thể bị xóa. Bạn có thể cấu hình giới hạn tốc độ, quyền mô hình ảo và ngân sách chi tiêu (tính đến tháng 11 năm 2024). Nó kế thừa toàn bộ cấu hình của tổ chức, vì vậy bạn không thể trực tiếp thêm thành viên hoặc tài khoản dịch vụ vào đó.
Làm cách nào để tạo một dự án?
Trước tiên, hãy di chuột lên tên dự án ở góc bên trái của trang và chọn Create project.
Cung cấp tên, mô tả và trang web cho dự án của bạn rồi chọn Create.
Làm cách nào để thêm người dùng vào một dự án?
Các thành viên tổ chức mới được thêm sẽ không tự động được thêm vào “Dự án mặc định”. Thành viên mới có thể được mời vào dự án ngay khi họ được mời vào tổ chức (bằng cách bật ô chọn "Mời vào dự án mặc định") hoặc sau khi thành viên đã chấp nhận lời mời vào tổ chức.
Người dùng được mời qua Admin API tuân theo các quy tắc được nêu trong điểm cuối /organization/invites.
Nếu bạn gặp lỗi khi mời người dùng vào một dự án thông qua UI hoặc Admin API, trước tiên hãy xác nhận rằng dự án đích tồn tại và chưa bị lưu trữ trước khi gửi lại lời mời.
Chủ sở hữu tổ chức sẽ tự động được thêm làm chủ sở hữu của các dự án mới được tạo trong một tổ chức.
Các vai trò người dùng khác nhau trong tổ chức và dự án là gì, và chúng bao gồm những quyền nào?
Trong khi Tổ chức có vai trò ‘owner’ và ‘reader’, dự án có vai trò ‘owner’ và ‘member’. Thành viên dự án tương tự như reader của tổ chức. Vui lòng tham khảo bảng dưới đây để biết mô tả chi tiết hơn về các quyền đi kèm với từng vai trò người dùng.
| Vai trò | Phạm vi | Mô tả |
|---|---|---|
| Owner | Tổ chức | Có thể tạo/xem tất cả dự án, tất cả người dùng, tất cả khóa API. Có khả năng theo dõi trên tất cả dự án trong tổ chức bằng trang Projects. Có thể đặt ngân sách tổ chức và ngân sách dự án. Có thể cấp quyền xem thông tin mức sử dụng cho người khác trong tổ chức. Có thể lưu trữ dự án. |
| Reader | Tổ chức | Có thể thực hiện suy luận, sử dụng tài nguyên và tạo khóa trong các dự án của họ. Có thể được thêm vào dự án. Không thể tạo dự án và quản lý người dùng. |
| Owner | Dự án | Có thể thêm người dùng khác vào dự án và đổi tên dự án, cũng như có tất cả khả năng của một Member. Có thể đặt ngân sách dự án. Có thể lưu trữ dự án. |
| Member | Dự án | Có thể thực hiện suy luận, sử dụng tài nguyên và tạo khóa ở cấp dự án. |
Nếu tôi không phải là Owner trong tổ chức, tôi có quyền truy cập vào những gì?
Người dùng không phải là Owner trong tổ chức chỉ có thể thấy các dự án mà họ là thành viên. Chỉ chủ sở hữu tổ chức mới có thể thấy tất cả dự án, thành viên và khóa API ở cấp dự án, đồng thời có quyền truy cập vào trang Projects.
Chỉ thành viên của một dự án (và chủ sở hữu tổ chức) mới có thể thấy các mô hình đã tinh chỉnh được tạo trong dự án đó, các thread từ bất kỳ Assistants nào đã được tạo hoặc bất kỳ tệp nào đã được thêm vào.
Thành viên của một dự án có thể thấy tất cả các thành viên khác của dự án đó và vai trò của họ (tức là Owner hoặc Member).
Làm cách nào để cập nhật vai trò dự án của người dùng hoặc xóa người dùng khỏi một dự án?
Chỉ Chủ sở hữu của một dự án mới có thể cập nhật vai trò dự án của người dùng hoặc xóa người dùng khỏi dự án. Vui lòng tham khảo vai trò và quyền để biết thêm thông tin.
Để cập nhật người dùng trong một dự án, hãy vào cài đặt tổ chức của bạn, chọn dự án, rồi nhấp vào Members. Bạn có tùy chọn đặt vai trò của từng thành viên là Member hoặc Owner. Bạn cũng có thể chọn Remove để xóa người dùng khỏi dự án.
Tài khoản dịch vụ là gì và nó khác gì so với tài khoản người dùng thông thường?
Tài khoản dịch vụ hoạt động như một người dùng giả được thiết kế cho truy cập hệ thống, khác với tài khoản người dùng cá nhân. Chỉ chủ sở hữu tổ chức và dự án mới có thể tạo tài khoản dịch vụ.
Tài khoản dịch vụ chỉ được giới hạn trong phạm vi dự án.
Thêm một thành viên vào dự án
Nếu bạn nhấp vào nút + Add member, bạn sẽ thấy danh sách người dùng trong tổ chức của mình với vai trò Reader. Nếu bạn muốn thêm một người dùng hiện chưa thuộc tổ chức của mình, trước tiên bạn cần thêm họ vào tổ chức (bạn có thể để nguyên ô chọn 'Add to Default Project" nếu không muốn cấp cho những người dùng này quyền truy cập rộng hơn). Danh sách này sẽ không bao gồm tài khoản dịch vụ. Trong bước này, bạn có thể chọn vai trò của họ là Owner hoặc Member:
Khi bạn thêm một thành viên nhóm, bạn phải gán cho họ vai trò Member hoặc Owner. Thành viên dự án có thể thực hiện các yêu cầu API để đọc hoặc sửa đổi dữ liệu, trong khi chủ sở hữu dự án còn có thể sửa đổi cài đặt và ngân sách dự án cũng như quản lý thành viên dự án. Vui lòng tham khảo vai trò và quyền để biết thêm thông tin.
Cách tạo tài khoản dịch vụ cho một dự án
Trước tiên, điều hướng đến dự án mà bạn muốn tạo tài khoản dịch vụ bằng cách chọn từ menu thả xuống trong thanh điều hướng:
Sau đó, vào cài đặt tổ chức của bạn -> Project -> Members -> nhấp vào + Service account:
Tài khoản dịch vụ được tạo ở cấp dự án là duy nhất cho dự án đó và không thể được sử dụng bên ngoài dự án mà chúng được tạo trong đó.
Đặt tên cho tài khoản dịch vụ
Bất kể bạn tạo tài khoản dịch vụ ở cấp tổ chức hay tạo một tài khoản riêng cho dự án, khi tạo tài khoản dịch vụ, bạn có thể tạo một ID tài khoản dịch vụ duy nhất gồm chữ cái, số và dấu gạch nối để dễ dàng nhận diện tài khoản dịch vụ.
Lưu khóa API của tài khoản dịch vụ
Sau khi chọn nút Create, một khóa API sẽ ngay lập tức được tạo cho tài khoản dịch vụ và khóa bí mật sẽ được hiển thị. Hãy lưu khóa bí mật này ở nơi an toàn và bảo mật. Vì lý do bảo mật, bạn sẽ không thể xem lại nó qua tài khoản OpenAI của mình. Nếu bạn làm mất khóa bí mật này, bạn sẽ cần tạo một khóa mới.
Quyền của khóa API tài khoản dịch vụ mặc định được đặt là đọc và ghi cho tất cả tài nguyên API của dự án. Các quyền này có thể được cập nhật trong phần cài đặt API Keys của dự án.
Tài khoản dịch vụ được liệt kê cùng với thành viên dự án trên trang cài đặt thành viên của dự án. Vui lòng tham khảo tại đây để tìm hiểu thêm về cách cập nhật hoặc xóa quyền truy cập của tài khoản dịch vụ trong trang cài đặt thành viên của dự án.
Tất cả tài khoản dịch vụ trên cả dự án và tổ chức sẽ được hiển thị cùng với người dùng thật của bạn trên trang thành viên cấp tổ chức.
Tài khoản dịch vụ được quản lý giống như tài khoản thông thường. Từ Organization -> menu Members, bạn có thể Remove một tài khoản dịch vụ hoặc cập nhật vai trò:
Làm cách nào để quản lý khóa API trong các dự án của tổ chức tôi?
Bạn có thể tạo và quản lý khóa API cho từng dự án trên trang cài đặt của dự án đó. Trong cài đặt tổ chức của bạn, chọn dự án, rồi nhấp vào API Keys.
Để tạo một khóa bí mật mới, hãy chọn + Create new secret key. Bạn cũng có thể chọn biểu tượng Chỉnh sửa bên cạnh khóa bí mật để chỉnh sửa quyền của nó.
Bạn có thể đặt quyền cho từng khóa API của mình khi tạo khóa bí mật mới hoặc bằng cách chỉnh sửa khóa hiện có.
Có ba cấp quyền khả dụng: All, Restricted, và Read Only.
All — Quyền đầy đủ được đặt cho khóa bí mật. Đây là cài đặt mặc định.
Restricted — Cho phép người dùng đặt quyền None, Read và Write cho từng điểm cuối.
Ví dụ: bạn tạo một khóa API cụ thể không có quyền Read hoặc Write đối với điểm cuối /v1/assistants:
Read Only — Quyền đọc được đặt cho tất cả điểm cuối.
Quyền truy cập được quản lý như thế nào đối với người dùng thuộc nhiều dự án hoặc tổ chức?
Người dùng có thể là thành viên của bao nhiêu dự án tùy theo nhu cầu. Trong một dự án, người dùng có thể tạo khóa API cá nhân được giới hạn phạm vi và quyền truy cập vào dự án đó cùng các tài nguyên của nó.
Làm cách nào để đặt và quản lý giới hạn tốc độ cho các dự án của tổ chức tôi?
Chỉ Chủ sở hữu của một tổ chức mới có thể đặt và quản lý giới hạn tốc độ ở cấp dự án. Vui lòng tham khảo vai trò và quyền để biết thêm thông tin.
Trong cài đặt tổ chức của bạn, hãy nhấp vào dự án bạn muốn cập nhật và chọn Limits trong phần Project của danh sách điều hướng. Bạn có thể cập nhật Model Usage trên trang này.
Model usage cho phép bạn cấu hình những mô hình nào có thể được dự án sử dụng, và giới hạn tốc độ có thể được đặt cho từng mô hình khi cần.
Làm cách nào để đặt và quản lý ngân sách cho các dự án của tổ chức tôi?
Chỉ Chủ sở hữu của một tổ chức và Chủ sở hữu của một dự án mới có thể đặt và quản lý ngân sách dự án. Vui lòng tham khảo vai trò và quyền để biết thêm thông tin. Để thay đổi các giới hạn ở cấp tổ chức, trong cài đặt tổ chức của bạn, hãy nhấp vào Limits, và cuộn xuống Usage limits.
Để đặt giới hạn cho dự án của bạn, trong cài đặt tổ chức của bạn, hãy nhấp vào dự án bạn muốn cập nhật và chọn Limits. Bạn có thể cập nhật Monthly budget, Notification threshold, và Model Usage.
Việc đặt ngân sách hàng tháng cho phép bạn thiết lập các ngưỡng chi tiêu mềm cho dự án của mình. Khi mức sử dụng vượt quá giới hạn này trong một tháng dương lịch nhất định (UTC), các yêu cầu API vẫn sẽ tiếp tục được xử lý mà không bị gián đoạn. Tính năng này được thiết kế để giúp bạn theo dõi mức sử dụng thông qua cảnh báo ngân sách, nhưng nó không áp dụng giới hạn cứng đối với chi tiêu. Khi ngân sách dự án được tạo, theo mặc định, một cảnh báo sẽ được tạo ở ngưỡng 100%. Có thể đặt thêm ngân sách ở các ngưỡng khác nhau bằng cách nhấp vào Add Alert.
Xin lưu ý rằng chủ sở hữu tổ chức và chủ sở hữu dự án sẽ luôn nhận được các thông báo này và điều này không thể được tùy chỉnh.
Làm cách nào để xóa hoặc lưu trữ một dự án?
Dự án có thể được lưu trữ thông qua trang danh sách dự án mới hoặc trong phần cài đặt của một dự án riêng lẻ. Khi một dự án đã được lưu trữ thì không thể khôi phục. Khi tiếp tục lưu trữ, bạn sẽ được nhắc nhập tên dự án để tiếp tục.
Bạn có thể xem danh sách tất cả dự án đã lưu trữ qua tab “Archived” trên cùng trang danh sách dự án đó.
Không thể xóa dự án; chúng tôi duy trì lịch sử của tất cả dự án để đảm bảo tính liên tục trong việc theo dõi mức sử dụng và thanh toán.
Có giới hạn số lượng dự án tôi có thể có trong tổ chức của mình không?
Theo mặc định, tổ chức có thể tạo tối đa 2.000 dự án.
Tài nguyên có thể được chia sẻ giữa các dự án không?
Tài nguyên dự án (chẳng hạn như tệp, assistants, bộ nhớ, hoặc threads) được giới hạn trong phạm vi dự án và các thành viên không phải quản trị viên bên ngoài dự án không thể truy cập. Ngoài ra, tài nguyên không thể được di chuyển giữa các dự án.
Ngoại lệ duy nhất là các bản tinh chỉnh trong “Dự án mặc định” có thể được truy cập từ các dự án khác.
Hạn ngạch lưu trữ tệp cho mỗi dự án là bao nhiêu?
OpenAI hiện hỗ trợ hạn ngạch lưu trữ tệp là 100 GB tệp cho mỗi dự án.
Nếu vượt quá hạn ngạch này, bạn sẽ thấy lỗi sau:
Bạn đã vượt quá hạn ngạch lưu trữ tệp. Tổ chức bị giới hạn ở 100 GB tệp. Vui lòng giảm kích thước tệp hoặc liên hệ bộ phận hỗ trợ.Chúng tôi khuyên bạn nên xóa các tệp không sử dụng được lưu trữ trong tài khoản của mình. Để tham khảo, bạn có thể xem và liệt kê tệp bằng API.
Tôi là chủ sở hữu dự án, tại sao tôi không thể thấy Bảng điều khiển Mức sử dụng cho dự án của mình?
Khả năng hiển thị Bảng điều khiển Mức sử dụng của dự án không liên quan đến vai trò của người dùng trong dự án. Thay vào đó, nó được xác định bởi vai trò của bạn trong tổ chức và cài đặt tại https://platform.openai.com/settings/organization/data-controls/visibility
Nếu bạn không thể thấy Bảng điều khiển Mức sử dụng, cài đặt này có thể đang được đặt thành "Visible to organization owners".