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 giao diện người dùng), cũng như theo dõi mức sử dụng trong một phạm vi bị giới hạn của 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 thông tin thanh toán cũng như đặt giới hạn chi tiêu 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ể xóa. Bạn có thể cấu hình giới hạn tốc độ, quyền đối với mô hình ảo và giới hạn chi tiêu (tính đến tháng 11 năm 2024). Dự án này kế thừa toàn bộ cấu hình của tổ chức, nên 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 dự án?
Trước tiên, hãy di chuột lên tên dự án ở góc trái của trang rồi chọn Tạo dự án.
Nhập tên, nội dung mô tả và trang web cho dự án, sau đó chọn Tạo.
Làm cách nào để thêm người dùng vào dự án?
Thành viên mới được thêm vào tổ chức sẽ không tự động được thêm vào “Dự án mặc định”. Bạn có thể mời thành viên mới vào dự án khi mời họ vào tổ chức (bằng cách đánh dấu hộp “Mời vào dự án mặc định”) hoặc sau khi họ chấp nhận lời mời tham gia tổ chức.
Người dùng được mời qua API quản trị sẽ tuân theo các quy tắc được nêu tại điểm cuối /organization/invites.
Nếu gặp lỗi khi mời người dùng vào dự án qua giao diện người dùng hoặc API quản trị, trước tiên hãy xác nhận rằng dự án đích tồn tại và chưa được lưu trữ, rồi 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 tạo trong 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 để xem 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 và 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 giới hạn chi tiêu của tổ chức và giới hạn chi tiêu của dự án. Có thể cấp quyền xem thông tin sử dụng cho những 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, đồng thời có tất cả khả năng của Thành viên. Có thể đặt giới hạn chi tiêu của 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 không phải là Chủ sở hữu trong tổ chức, tôi có thể truy cập những gì?
Người dùng không phải là Chủ sở hữu trong tổ chức chỉ có thể xem những dự án mà họ là thành viên. Chỉ chủ sở hữu tổ chức mới có thể xem 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 trang Dự án.
Chỉ thành viên dự án (và chủ sở hữu tổ chức) mới có thể xem 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 các tệp đã thêm.
Thành viên dự án có thể xem tất cả thành viên khác trong dự án 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 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 chuyển đến phần cài đặt tổ chức, chọn dự án rồi nhấp vào Thành viên. Bạn có thể đặt vai trò của từng người 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
Khi nhấp vào nút + Thêm thành viên, bạn sẽ thấy danh sách người dùng trong tổ chức có vai trò Người đọc. Nếu muốn thêm một người dùng hiện chưa thuộc tổ chức, trước tiên bạn cần thêm họ vào tổ chức (có thể bỏ chọn hộp “Thêm vào Dự án mặc định” nếu không muốn cấp cho họ quyền truy cập rộng hơn). Danh sách này 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à Chủ sở hữu hoặc Thành viên:
Khi thêm một thành viên trong nhóm, bạn phải chỉ định cho họ vai trò Thành viên hoặc Chủ sở hữu. Thành viên dự án có thể gửi yêu cầu API để đọc hoặc sửa đổi dữ liệu, còn chủ sở hữu dự án cũng có thể sửa đổi chế độ cài đặt, giới hạn chi tiêu của dự án và quản lý thành viê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 chọn dự án mà bạn muốn tạo tài khoản dịch vụ từ trình đơn thả xuống trên thanh điều hướng:
Sau đó, chuyển đến phần cài đặt tổ chức -> Dự án -> Thành viên -> nhấp vào + Tài khoản dịch vụ:
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ẽ 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 khóa này qua tài khoản OpenAI của mình. Nếu làm mất khóa bí mật này, bạn sẽ cần tạo khóa mới.
Theo mặc định, khóa API của tài khoản dịch vụ có quyền đọc và ghi đối với tất cả tài nguyên API của dự án. Bạn có thể cập nhật các quyền này trong phần 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ụ trên 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?
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 phần cài đặt tổ chức, hãy chọn dự án rồi nhấp vào Khóa API.
Để tạo khóa bí mật mới, hãy chọn + Tạo khóa bí mật mới. 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 khi tạo khóa bí mật mới hoặc chỉnh sửa khóa hiện có.
Có ba cấp quyền: Tất cả, Hạn chế và Chỉ đọc.
Tất cả — Khóa bí mật được cấp toàn quyền. Đây là chế độ cài đặt mặc định.
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 không có quyền Đọc hoặc Ghi đối với đ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ý giới hạn chi tiêu cho các dự án của tổ chức?
Chỉ Chủ sở hữu tổ chức và Chủ sở hữu dự án mới có thể đặt và quản lý giới hạn chi tiêu của dự án. Vui lòng tham khảo vai trò và quyền để biết thêm thông tin. Để thay đổi giới hạn ở cấp tổ chức, trong phần cài đặt tổ chức, hãy nhấp vào Giới hạn, rồi cuộn xuống Giới hạn sử dụng.
Để đặt giới hạn cho dự án, trong phần cài đặt tổ chức, hãy nhấp vào dự án bạn muốn cập nhật rồi chọn Giới hạn. Bạn có thể cập nhật Giới hạn chi tiêu hằng tháng, Ngưỡng thông báo và Mức sử dụng mô hình.
Việc đặt giới hạn chi tiêu hằng tháng cho phép bạn thiết lập ngưỡng chi tiêu mềm cho dự án. 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 tiếp tục được xử lý mà không bị gián đoạn. Tính năng này giúp bạn theo dõi mức sử dụng thông qua cảnh báo giới hạn chi tiêu, nhưng không áp dụng mức trần chi tiêu cứng. Theo mặc định, khi tạo giới hạn chi tiêu cho dự án, một cảnh báo sẽ được tạo ở ngưỡng 100%. Bạn có thể đặt thêm cảnh báo ở 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à bạn không thể tùy chỉnh điều đó.
Làm cách nào để đặt giới hạn chi tiêu cho tổ chức hoặc dự án?
OpenAI hiện hỗ trợ giới hạn chi tiêu API hằng tháng ở cả cấp tổ chức và cấp dự án. Giới hạn chi tiêu có thể theo dõi chi tiêu mà không cưỡng chế, hoặc bạn có thể cưỡng chế giới hạn này như một giới hạn cứng để các yêu cầu API không thành công sau khi chi tiêu đạt đến giới hạn. Để biết các bước cấu hình và hành vi mới nhất, hãy xem Giới hạn chi tiêu trong tài liệu dành cho nhà phát triển.
Làm cách nào để xóa hoặc lưu trữ dự án?
Bạn có thể lưu trữ dự án 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 được lưu trữ, dự án sẽ không thể khôi phục. Khi tiến hành lưu trữ, bạn sẽ được yêu cầu 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 thẻ “Đã lưu trữ” trên cùng trang danh sách dự án.
Không thể xóa dự án. Chúng tôi lưu giữ lịch sử của tất cả dự án để bảo đảm 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 mức lưu trữ tệp cho mỗi dự án là bao nhiêu?
OpenAI hiện hỗ trợ hạn mức lưu trữ tệp là 100 GB cho mỗi dự án.
Nếu vượt quá hạn mức 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 của dự án?
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 đó, khả năng này được xác định bởi vai trò của bạn trong tổ chức và chế độ cài đặt tại https://platform.openai.com/settings/organization/data-controls/visibility
Nếu bạn không thấy Bảng điều khiển mức sử dụng, chế độ cài đặt này có thể đang được đặt thành “Hiển thị với chủ sở hữu tổ chức”.