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 phát 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 bị ràng buộc trong dự án (ví dụ: mô hình, khả năng, luồng, trợ lý, 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ọ trên trang Dự án. 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 dự án?
Chỉ chủ sở hữu tổ chức mới có thể tạo 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 ở góc trên bên trái của trang và chọn tổ chức từ danh sách:
Đối với những tổ chức đang dùng gói thanh toán hợp nhất, các tổ chức con được nhận diện 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?
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 khi họ được mời vào tổ chức (bằng cách bật hộp kiểm “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 tham gia 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 dự án thông qua UI hoặc Admin API, trước tiên hãy xác nhận rằng dự án mục tiêu tồn tại và chưa được lưu trữ trước khi gửi lại lời mời.
Chủ sở hữu tổ chức được tự động thêm làm chủ sở hữu vào 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ò “chủ sở hữu” và “người đọc”, dự án có vai trò “chủ sở hữu” và “thành viên”. Thành viên dự án tương tự như người đọc của tổ chức. Vui lòng tham khảo bảng bên dưới để 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ả |
|---|---|---|
| Chủ sở hữu | 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 giám sát trên tất cả dự án trong tổ chức bằng trang Dự án . 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. |
| Người đọc | 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. |
| Chủ sở hữu | 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 Thành viên. Có thể đặt ngân sách dự án. Có thể lưu trữ dự án. |
| Thành viên | 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à Chủ sở hữu 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à Chủ sở hữu 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, và có quyền truy cập vào trang Dự án.
Chỉ các thành viên của 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 luồng từ bất kỳ Trợ lý nào đã tạo, hoặc bất kỳ tệp nào đã được thêm.
Thành viên của dự án có thể thấy tất cả thành viên khác của dự án đó là ai và vai trò của họ (tức là Chủ sở hữu hoặc Thành viên).
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 dự án?
Chỉ Chủ sở hữu của 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 dự án, hãy đi tới cài đặt tổ chức của bạn, chọn dự án và nhấp vào Thành viên. Bạn có tùy chọn đặt vai trò của từng thành viên là Thành viên hoặc Chủ sở hữu. Bạn cũng có thể chọn Xóa để 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 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 có vai trò Reader. Nếu muốn thêm người dùng hiện chưa ở trong tổ chức của bạn, trước tiên bạn cần thêm họ vào tổ chức (bạn có thể bỏ chọn hộp kiểm “Thêm vào Dự án mặc định” 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 thêm một thành viên nhóm, bạn phải gán cho họ vai trò Thành viên hoặc Chủ sở hữu. 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ũng có thể sửa đổi cài đặt dự án 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 dự án
Trước tiên, hãy đ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 đó, đi tới cài đặt tổ chức của bạn -> Dự án -> Thành viên -> 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 Tạo, một khóa API sẽ được tạo ngay cho tài khoản dịch vụ và khóa bí mật sẽ được hiển thị. 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 khóa này thông qua tài khoản OpenAI của mình. Nếu bạn 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 là đọc và ghi 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 cài đặt Khóa API 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 là con người 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ừ Tổ chức -> menu Thành viên, bạn có thể Xóa 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, hãy chọn dự án và nhấp vào Khóa API.
Để tạo 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 khóa đó.
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: Tất cả, Bị hạn chế và Chỉ đọc.
Tất cả — Quyền đầy đủ được đặt cho khóa bí mật. Đây là cài đặt mặc định.
Bị hạn chế — Cho phép người dùng đặt quyền Không có, Đọc và Ghi 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 Đọc hoặc Ghi vào điểm cuối /v1/assistants:
Chỉ đọc — 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 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 Giới hạn trong phần Dự án của danh sách điều hướng. Bạn có thể cập nhật Mức sử dụng mô hình trên trang này.
Mức sử dụng mô hình 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à có thể đặt giới hạn tốc độ 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 tổ chức và Chủ sở hữu của 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 Giới hạn, và cuộn xuống Giới hạn sử dụng.
Để đặt giới hạn dự á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 Giới hạn. Bạn có thể cập nhật Ngân sách hằng tháng, Ngưỡng thông báo và Mức sử dụng mô hình.
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 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 không áp dụng giới hạn cứng cho 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%. Bạn có thể đặt thêm ngân sách ở các ngưỡng khác nhau bằng cách nhấp vào Thêm cảnh báo.
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ể tùy chỉnh.
Làm cách nào để xóa hoặc lưu trữ một dự án?
Có thể lưu trữ dự án thông qua trang danh sách dự án mới hoặc trong phần cài đặt của từng dự án. Sau khi dự án được lưu trữ, dự án đó không thể được khôi phục. Khi tiến hành 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ữ thông qua tab “Đã lưu trữ” 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 dùng đến được lưu trữ trên tài khoản của bạn. Để 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ấ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 đó, điều này được xác định bởi vai trò của bạn trong tổ chức và các 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 “Hiển thị với chủ sở hữu tổ chức”.