Quản lý các dự án trên nền tảng API

Các dự án nhằm mục đích cung cấp cho khách hàng khả năng tổ chức công việc của họ. Các tổ chức có thể quản lý quyền truy cập và giới hạn, cung cấp tài khoản dịch vụ (thông qua giao diện người dùng), và theo dõi việc sử dụng trong phạm vi giới hạn của một 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 hóa đơn và đặ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ả các dự án Đang hoạt động và Lưu trữ của họ trongTrang dự án. Tìm hiểu thêm vềvai trò và quyền hạn của người dùng 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 dự án. Vui lòng tham khảovai trò và quyền hạnđể biết thêm thông tin.

Để chuyển đổi giữa các tổ chức, di chuột qua 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 sử dụng kế hoạch thanh toán hợp nhất, các tổ chức phụ được xác định riêng. Không thể tạo dự án trong các tổ chức phụ.

Các dự án hoạt động như thế nào?

Mỗi tổ chức bao gồm một “Dự án mặc định” màkhông thể xóa. Bạn có thể cấu hình giới hạn tỷ lệ, quyền của mô hình ảo và giới hạn 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ể thêm trực tiếp thành viên hoặc tài khoản dịch vụ vào nó.

Làm thế nào để tôi tạo một dự án?

Đầu tiên, di chuột lên tên dự án ở góc trái của trang và chọnTạo dự án.

Cung cấp tên, mô tả và trang web cho dự án của bạn và sau đó chọnTạo.

Làm thế nào để tôi thêm người dùng vào một dự án?

Các 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”. Thành viên mới có thể được mời vào dự án khi họ được mời tham gia 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 thông qua API Quản trị tuân theo các quy tắc được nêu bởicái/tổ chức/mờiđiểm cuối.

Nếu bạn gặp lỗi khi mời người dùng vào một dự án thông 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 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 sẽ tự động được thêm làm chủ sở hữu vào các dự án mới được tạo trong tổ chức.

Các vai trò người dùng khác nhau trong các tổ chức và dự án là gì, và chúng bao gồm những quyền gì?

Trong khiCác tổ chức có vai trò ‘chủ sở hữu’ và ‘người đọc’, cá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 trong tổ chức. Vui lòng tham khảo bảng dưới đây để có mô tả chi tiết hơn về những quyền hạn đi kèm với từng vai trò người dùng.

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ỉ có chủ sở hữu tổ chức mới có thể xem tất cả các dự án, thành viên và khóa API ở cấp dự án, và có quyền truy cập vàoTrang dự án.

• Chỉ các 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 được tinh chỉnh đã được tạo trong dự án đó, các luồng từ bất kỳ Trợ lý nào được tạo, hoặc bất kỳ tệp nào đã được thêm vào.

• Các 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ọ (ví dụ: Chủ sở hữu hoặc Thành viên).

Làm thế nào để tôi cập nhật vai trò dự án của người dùng hoặc gỡ bỏ 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ảovai trò và quyền hạnđể biết thêm thông tin.

Để cập nhật người dùng trong một dự án, hãy đi đến của bạncài đặt tổ chức, chọn dự án, và nhấp vàoThà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ênhoặcChủ sở hữu.Bạn cũng có thể chọnXóagỡ người dùng ra khỏi dự án.

Tài khoản dịch vụ là gì, và nó khác với tài khoản người dùng thông thường như thế nào?

Tài khoản dịch vụ hoạt động như một người dùng giả được thiết kế để truy cập hệ thống, khác với các 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ụ.

Thêm thành viên vào dự án

Nếu bạn nhấp vào+ Thêm thành viênnhấn nút bạn sẽ thấy một danh sách người dùng trong tổ chức của bạn với vai tròĐộc giả. Nếu bạn muốn thêm người dùng hiện không có trong tổ chức của bạn, bạn cần thêm họ vào tổ chức trước (bạn có thể giữ hộp kiểm ‘Thêm vào Dự án Mặc định’ không được chọn nếu bạn 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 các 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ữuhoặcThành viên:

Khi bạn thêm một thành viên vào nhóm, bạn phải gán cho họ một trong haiThành viênhoặcChủ sở hữuvai trò. Thành viên dự án có thể thực hiện các yêu cầu API để đọc hoặc chỉnh sửa dữ liệu, trong khi chủ sở hữu dự án cũng có thể chỉnh sửa cài đặt dự án và giới hạn chi tiêu của dự án và quản lý các thành viên dự án. Vui lòng tham khảovai trò và quyền hạnđể biết thêm thông tin.

Cách tạo một 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 có trong thanh điều hướng:

Sau đó, đi đến của bạncài đặt tổ chức-> Dự án -> Thành viên -> nhấp vào+ Tài khoản dịch vụ:

Đặ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 duy nhất cho một dự án, khi bạn tạo một 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 bao gồm chữ cái, số và dấu gạch ngang để 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ọnTạoNút bấm, 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 ở một 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ó 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ả cá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 của bạn.

Tài khoản dịch vụ được liệt kê cùng với các thành viên dự án trong trang cài đặt thành viên của dự án của bạn. Vui lòng tham khảoở đâyđể tìm hiểu thêm về việc 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 của bạn.

Các tài khoản dịch vụ được quản lý giống như các tài khoản thông thường. Từ Tổ chức ->Menu thành viênbạn có thểXóamột tài khoản dịch vụ hoặc cập nhật vai trò:

Làm thế nào để tôi quản lý các khóa API trong các dự án của tổ chức mình?

Bạn có thể tạo và quản lý các khóa API cho từng dự án trên trang cài đặt của dự án đó. Trong của bạncài đặt tổ chức, chọn dự án, và nhấp vàoKhóa API.

Để tạo một khóa bí mật mới, 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 một 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 bạn tạo khóa bí mật mới hoặc bằng cách chỉnh sửa một khóa hiện có.

Có ba cấp độ quyền truy cập: Tất cả, Hạn chế và Chỉ đọc.

• Tất cả— Quyền đầy đủ được thiết lập 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 thiết lập quyền Không, Đọc và Ghi cho từng điểm cuối.

• Ví dụ, bạn tạo một khóa API mà cụ thể không có quyền Đọc hoặc Ghi vào endpoint /v1/assistants:

• Chỉ đọc— Quyền đọc đã được thiết lập cho tất cả các điểm kết.

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 nhiều dự án theo nhu cầu. Trong một dự án, người dùng có thể tạo một khóa API cá nhân được giới hạn và phạm vi hoá để truy cập dự án đó và các tài nguyên của nó.

Làm thế nào để tôi thiết lập và quản lý giới hạn tốc độ cho các dự án của tổ chức mình?

Chỉ Chủ sở hữu của một tổ chức mới có thể thiết lập và quản lý giới hạn tỷ lệ ở cấp dự án. Vui lòng tham khảovai trò và quyền hạnđể biết thêm thông tin.

Trong của bạncài đặt tổ chức, nhấn vào dự án bạn muốn cập nhật và chọnGiới hạntrong phần Dự án của danh sách điều hướng.Bạn có thể cập nhật của bạnSử dụng mô hìnhtrên trang này.

Sử dụng mô hìnhcho phép bạn cấu hình những mô hình nào có thể được sử dụng bởi dự án, vàgiới hạn tần suấtcó thể được thiết lập cho từng mẫu theo nhu cầu.

Làm thế nào để tôi thiết lập và quản lý giới hạn chi tiêu cho các dự án của tổ chức mình?

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ể thiết lập và quản lý giới hạn chi tiêu của dự án. Vui lòng tham khảovai trò và quyền hạnđể biết thêm thông tin. Để thay đổi giới hạn ở cấp tổ chức, trong của bạncài đặt tổ chức, nhấp vàoGiới hạn,và cuộn xuốngGiới hạn sử dụng.

Để đặt giới hạn dự án của bạn, trong của bạncài đặt tổ chức, nhấn vào dự án bạn muốn cập nhật và chọnGiới hạn.Bạn có thể cập nhật của bạnGiới hạn chi tiêu hàng tháng,Ngưỡng thông báo, vàSử dụng mô hình.

Đang thiết lậpgiới hạn chi tiêu hàng thángcho phép bạn thiết lập 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 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 giám sát mức sử dụng thông qua các cảnh báo giới hạn chi tiêu, nhưng nó không áp đặt một mức chi tiêu cứng. Khi một giới hạn chi tiêu dự án được tạo, theo mặc định, một cảnh báo sẽ được tạo ở ngưỡng 100%. Các cảnh báo bổ sung tại các ngưỡng khác có thể được thiết lập bằng cách nhấpThê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 những tin nhắn này và điều này không thể tùy chỉnh.

Làm thế nào để tôi đặt giới hạn chi tiêu cho tổ chức hoặc dự án của mình?

OpenAI hiện nay hỗ trợ giới hạn chi tiêu API hàng tháng cả ở mức tổ chức và dự án. Một giới hạn chi tiêu có thể theo dõi chi tiêu mà không cần thực thi, hoặc bạn có thể thực thi nó như một giới hạn cứng để các yêu cầu API thất bại sau khi chi tiêu đạt tới giới hạn. Để biết các bước cấu hình và hành vi mới nhất, xemGiới hạn chi tiêutrong tài liệu dành cho nhà phát triển.

Làm thế nào để xóa hoặc lưu trữ một dự án?

Các dự án có thể được lưu trữ thông qua cả phiên bản mớidanh sách dự ántrang hoặc trên cài đặt của một dự án riêng lẻ.Khi một dự án đã được lưu trữ, nó không thể được khôi phục lại. 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ả các dự án đã lưu trữ thông qua tab “Đã lưu trữ” trên cùngdanh sách dự ántrang.

Việc xóa dự án không khả thi. Chúng tôi giữ lịch sử tất cả các dự án để đảm bảo tính liên tục với việc theo dõi sử dụng và thanh toán.

Có giới hạn nào về số lượng dự án mà tôi có thể có trong tổ chức của mình không?

Các tổ chức có thể tạo tới 2.000 dự án theo mặc định.

Có thể chia sẻ tài nguyên giữa các dự án không?

Tài nguyên dự án (chẳng hạn như tệp, trợ lý, bộ nhớ lưu trữ hoặc luồng) được giới hạn trong phạm vi dự án và không thể truy cập bởi các thành viên không phải quản trị viên bên ngoài dự án. Hơn nữa, tài nguyên không thể được di chuyển giữa các dự án.

Dung lượng lưu trữ tập tin theo dự án là bao nhiêu?

Hiện tại OpenAI hỗ trợ hạn mức lưu trữ tệp là 100 GB tệp cho mỗi dự án.

Nếu hạn ngạch này bị vượt quá, bạn sẽ thấy lỗi sau:

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ữ trên tài khoản của bạn. Để tham khảo, bạn có thểxem và liệt kê các tệp vớiAPI.

Tôi là chủ dự án, tại sao tôi không thể thấy Bảng điều khiển Sử dụng cho dự án của mình?

Khả năng hiển thị Bảng điều khiển Sử dụng của một 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ác cài đặt tạihttps://platform.openai.com/settings/organization/data-controls/visibility

Nếu bạn không thể xem Bảng điều khiển Sử dụng, cài đặt này có khả năng được đặt thành “Hiển thị cho chủ sở hữu tổ chức”.