การจัดการโปรเจกต์ในแพลตฟอร์ม API

โปรเจกต์มีเป้าหมายเพื่อให้ลูกค้าสามารถจัดระเบียบงานของตนได้ องค์กรสามารถจัดการการเข้าถึงและขีดจำกัด จัดเตรียม service account (ผ่าน UI) และติดตามการใช้งานภายใต้ขอบเขตที่กำหนดภายในโปรเจกต์ (เช่น โมเดล ความสามารถ threads assistants fine-tuning พื้นที่จัดเก็บ เป็นต้น) กิจกรรมการใช้งานสามารถแยกตามโปรเจกต์ได้ และผู้ใช้สามารถดูการเรียกเก็บเงินและตั้งงบประมาณต่อโปรเจกต์ได้

เจ้าขององค์กรสามารถดูโปรเจกต์ทั้งหมดทั้ง Active และ Archived ได้ในหน้า Projects ดูข้อมูลเพิ่มเติมเกี่ยวกับบทบาทและสิทธิ์ของผู้ใช้ใน API Platform

ใครบ้างที่สามารถสร้างโปรเจกต์ได้?

มีเพียงเจ้าขององค์กรเท่านั้นที่สามารถสร้างโปรเจกต์ได้ โปรดดู บทบาทและสิทธิ์ สำหรับข้อมูลเพิ่มเติม

หากต้องการสลับระหว่างองค์กร ให้วางเมาส์เหนือชื่อองค์กรของคุณที่มุมซ้ายบนของหน้า แล้วเลือกองค์กรจากรายการ:

สำหรับองค์กรที่ใช้แผนการเรียกเก็บเงินแบบรวม ระบบจะระบุ sub-org แยกต่างหาก ไม่สามารถสร้างโปรเจกต์ภายใน sub-org ได้

โปรเจกต์ทำงานอย่างไร?

ทุกองค์กรจะมี “โปรเจกต์เริ่มต้น” ที่ไม่สามารถลบได้ คุณสามารถกำหนดค่า rate limits สิทธิ์ของ virtual model และงบประมาณการใช้จ่ายได้ (ณ เดือนพฤศจิกายน 2024) โดยจะสืบทอดการกำหนดค่าทั้งหมดขององค์กร จึงไม่สามารถเพิ่มสมาชิกหรือ service account เข้าไปโดยตรงได้

ฉันจะสร้างโปรเจกต์ได้อย่างไร?

ขั้นแรก ให้วางเมาส์เหนือชื่อโปรเจกต์ที่มุมซ้ายของหน้า แล้วเลือก Create project

ระบุชื่อ คำอธิบาย และเว็บไซต์สำหรับโปรเจกต์ของคุณ แล้วเลือก Create

ฉันจะเพิ่มผู้ใช้ไปยังโปรเจกต์ได้อย่างไร?

สมาชิกองค์กรที่เพิ่งเพิ่มเข้ามาจะไม่ถูกเพิ่มไปยัง “โปรเจกต์เริ่มต้น” โดยอัตโนมัติ สมาชิกใหม่สามารถถูกเชิญเข้าโปรเจกต์ได้ทั้งตอนที่เชิญเข้าร่วมองค์กร (โดยเปิดใช้ช่องทำเครื่องหมาย "Invite to default project") หรือหลังจากที่สมาชิกตอบรับคำเชิญเข้าร่วมองค์กรแล้ว

ผู้ใช้ที่ถูกเชิญผ่าน Admin API จะเป็นไปตามกฎที่ระบุไว้ใน endpoint /organization/invites

หากคุณพบข้อผิดพลาดเมื่อเชิญผู้ใช้เข้าโปรเจกต์ผ่าน UI หรือ Admin API ให้ยืนยันก่อนว่าโปรเจกต์เป้าหมายมีอยู่จริงและไม่ได้ถูกเก็บถาวร ก่อนส่งคำเชิญอีกครั้ง

เจ้าขององค์กรจะถูกเพิ่มเป็นเจ้าของในโปรเจกต์ใหม่ที่สร้างภายในองค์กรโดยอัตโนมัติ

บทบาทผู้ใช้แบบต่างๆ ภายในองค์กรและโปรเจกต์มีอะไรบ้าง และมีสิทธิ์ใดบ้าง?

ในขณะที่องค์กรมีบทบาท ‘owner’ และ ‘reader’ โปรเจกต์มีบทบาท ‘owner’ และ ‘member’ สมาชิกโปรเจกต์มีลักษณะใกล้เคียงกับ reader ขององค์กร โปรดดูตารางด้านล่างสำหรับคำอธิบายโดยละเอียดเพิ่มเติมเกี่ยวกับสิทธิ์ที่มาพร้อมกับแต่ละบทบาทผู้ใช้

หากฉันไม่ได้เป็น Owner ในองค์กร ฉันจะเข้าถึงอะไรได้บ้าง?

ผู้ใช้ที่ไม่ได้เป็น Owner ในองค์กรจะเห็นได้เฉพาะโปรเจกต์ที่ตนเป็นสมาชิกเท่านั้น มีเพียงเจ้าขององค์กรเท่านั้นที่สามารถเห็นโปรเจกต์ทั้งหมด สมาชิกทั้งหมด และคีย์ API ในระดับโปรเจกต์ และสามารถเข้าถึงหน้า Projectsได้

• มีเพียงสมาชิกของโปรเจกต์ (และเจ้าขององค์กร) เท่านั้นที่สามารถเห็นโมเดล fine-tuned ที่ถูกสร้างภายในโปรเจกต์นั้น threads จาก Assistants ที่สร้างขึ้น หรือไฟล์ใดๆ ที่ถูกเพิ่มเข้าไป

• สมาชิกของโปรเจกต์สามารถเห็นได้ว่าใครคือสมาชิกคนอื่นทั้งหมดของโปรเจกต์นั้นและบทบาทของพวกเขา (เช่น Owner หรือ Member)

ฉันจะอัปเดตบทบาทผู้ใช้ในโปรเจกต์ หรือนำผู้ใช้ออกจากโปรเจกต์ได้อย่างไร?

มีเพียง Owner ของโปรเจกต์เท่านั้นที่สามารถอัปเดตบทบาทผู้ใช้ในโปรเจกต์ หรือนำผู้ใช้ออกจากโปรเจกต์ได้ โปรดดู บทบาทและสิทธิ์ สำหรับข้อมูลเพิ่มเติม

หากต้องการอัปเดตผู้ใช้ในโปรเจกต์ ให้ไปที่ การตั้งค่าองค์กร ของคุณ เลือกโปรเจกต์ แล้วคลิก Members คุณมีตัวเลือกในการตั้งค่าบทบาทของสมาชิกแต่ละคนเป็น Member หรือ Owner. คุณยังสามารถเลือก Remove เพื่อนำผู้ใช้ออกจากโปรเจกต์ได้

service account คืออะไร และต่างจากบัญชีผู้ใช้ทั่วไปอย่างไร?

service account ทำหน้าที่เป็นผู้ใช้เสมือนที่ออกแบบมาสำหรับการเข้าถึงระบบ ซึ่งแตกต่างจากบัญชีผู้ใช้รายบุคคล มีเพียงเจ้าขององค์กรและเจ้าของโปรเจกต์เท่านั้นที่สามารถสร้าง service account ได้

เพิ่มสมาชิกไปยังโปรเจกต์

หากคุณคลิกปุ่ม + Add member คุณจะเห็นรายชื่อผู้ใช้ในองค์กรของคุณที่มีบทบาท Reader หากคุณต้องการเพิ่มผู้ใช้ที่ยังไม่ได้อยู่ในองค์กรของคุณ คุณจะต้องเพิ่มผู้ใช้นั้นเข้าองค์กรก่อน (คุณสามารถปล่อยช่องทำเครื่องหมาย 'Add to Default Project" ไว้โดยไม่ต้องเลือกได้ หากคุณไม่ต้องการให้ผู้ใช้เหล่านี้เข้าถึงได้กว้างขึ้น) รายชื่อนี้จะไม่รวม service account ในขั้นตอนนี้ คุณสามารถเลือกบทบาทให้เป็น Owner หรือ Member:

เมื่อคุณเพิ่มสมาชิกทีม คุณต้องกำหนดบทบาท Member หรือ Owner ให้กับพวกเขา สมาชิกโปรเจกต์สามารถส่งคำขอ API ที่อ่านหรือแก้ไขข้อมูลได้ ขณะที่เจ้าของโปรเจกต์ยังสามารถแก้ไขการตั้งค่าและงบประมาณของโปรเจกต์ รวมถึงจัดการสมาชิกโปรเจกต์ได้ด้วย โปรดดู บทบาทและสิทธิ์ สำหรับข้อมูลเพิ่มเติม

วิธีสร้าง service account สำหรับโปรเจกต์

ขั้นแรก ไปยังโปรเจกต์ที่คุณต้องการสร้าง service account โดยเลือกจากเมนูดรอปดาวน์ในแถบนำทาง:

จากนั้น ไปที่ การตั้งค่าองค์กร ของคุณ -> Project -> Members -> คลิก + Service account:

การตั้งชื่อ service account

ไม่ว่าคุณจะสร้าง service account ในระดับองค์กรหรือสร้างแบบเฉพาะสำหรับโปรเจกต์ เมื่อคุณสร้าง service account คุณสามารถสร้าง ID ของ service account ที่ไม่ซ้ำกันซึ่งประกอบด้วยตัวอักษร ตัวเลข และเครื่องหมายขีดกลาง เพื่อให้ระบุ service account ได้ง่าย

บันทึกคีย์ API ของ service account

หลังจากเลือกปุ่ม Create ระบบจะสร้างคีย์ API สำหรับ service account ทันที และ secret key จะแสดงขึ้นมา ให้บันทึก secret key นี้ไว้ในที่ที่ปลอดภัยและมั่นคง ด้วยเหตุผลด้านความปลอดภัย คุณจะไม่สามารถดูมันได้อีกผ่านบัญชี OpenAI ของคุณ หากคุณทำ secret key นี้หาย คุณจะต้องสร้างใหม่

สิทธิ์ของคีย์ API ของ service account จะถูกตั้งค่าเริ่มต้นให้สามารถอ่านและเขียนทรัพยากร API ทั้งหมดของโปรเจกต์ได้ สิทธิ์เหล่านี้สามารถอัปเดตได้ในการตั้งค่า API Keys ของโปรเจกต์

service account จะแสดงร่วมกับสมาชิกโปรเจกต์ในหน้าการตั้งค่าสมาชิกของโปรเจกต์ โปรดดูที่นี่เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับการอัปเดตหรือนำการเข้าถึงของ service account ออกจากหน้าการตั้งค่าสมาชิกของโปรเจกต์

service account ได้รับการจัดการเช่นเดียวกับบัญชีปกติ จากเมนู Organization -> Members คุณสามารถRemove service account หรืออัปเดตบทบาทได้:

ฉันจะจัดการคีย์ API ภายในโปรเจกต์ขององค์กรได้อย่างไร?

คุณสามารถสร้างและจัดการคีย์ API สำหรับแต่ละโปรเจกต์ได้ในหน้าการตั้งค่าของโปรเจกต์นั้น ใน การตั้งค่าองค์กร ของคุณ ให้เลือกโปรเจกต์ แล้วคลิก API Keys

หากต้องการสร้าง secret key ใหม่ ให้เลือก + Create new secret key คุณยังสามารถเลือกไอคอน Edit ที่อยู่ถัดจาก secret key เพื่อแก้ไขสิทธิ์ของมันได้

คุณสามารถตั้งค่าสิทธิ์สำหรับคีย์ API แต่ละคีย์ของคุณได้เมื่อสร้าง secret key ใหม่ หรือโดยการแก้ไขคีย์ที่มีอยู่

มีสิทธิ์ให้เลือกสามระดับ: All, Restricted และ Read Only

• All — ตั้งค่าสิทธิ์แบบเต็มให้กับ secret key ซึ่งเป็นการตั้งค่าเริ่มต้น

• Restricted — ช่วยให้ผู้ใช้ตั้งค่าสิทธิ์ None, Read และ Write สำหรับแต่ละ endpoint ได้

  • ตัวอย่างเช่น คุณสร้างคีย์ API ที่ไม่มีสิทธิ์ Read หรือ Write ไปยัง endpoint /v1/assistants โดยเฉพาะ:

    

• Read Only — ตั้งค่าสิทธิ์ Read สำหรับ endpoint ทั้งหมด

มีการจัดการการเข้าถึงอย่างไรสำหรับผู้ใช้ที่อยู่ในหลายโปรเจกต์หรือหลายองค์กร?

ผู้ใช้สามารถเป็นสมาชิกของโปรเจกต์ได้มากเท่าที่จำเป็น ภายในโปรเจกต์ ผู้ใช้สามารถสร้างคีย์ API ส่วนตัวที่ถูกกำหนดขอบเขตและจำกัดให้เข้าถึงได้เฉพาะโปรเจกต์นั้นและทรัพยากรของมัน

ฉันจะตั้งค่าและจัดการ rate limits สำหรับโปรเจกต์ขององค์กรได้อย่างไร?

มีเพียง Owner ขององค์กรเท่านั้นที่สามารถตั้งค่าและจัดการ rate limits ระดับโปรเจกต์ได้ โปรดดู บทบาทและสิทธิ์ สำหรับข้อมูลเพิ่มเติม

ใน การตั้งค่าองค์กร ของคุณ ให้คลิกโปรเจกต์ที่ต้องการอัปเดต แล้วเลือก Limits ในส่วน Project ของรายการนำทาง. คุณสามารถอัปเดต Model Usage ได้ในหน้านี้


Model usage ช่วยให้คุณกำหนดค่าได้ว่าโปรเจกต์สามารถใช้โมเดลใดได้บ้าง และสามารถตั้งค่า rate limits สำหรับแต่ละโมเดลได้ตามต้องการ

ฉันจะตั้งค่าและจัดการงบประมาณสำหรับโปรเจกต์ขององค์กรได้อย่างไร?

มีเพียง Owner ขององค์กรและ Owner ของโปรเจกต์เท่านั้นที่สามารถตั้งค่าและจัดการงบประมาณโปรเจกต์ได้ โปรดดู บทบาทและสิทธิ์ สำหรับข้อมูลเพิ่มเติม หากต้องการเปลี่ยนขีดจำกัดในระดับองค์กร ใน การตั้งค่าองค์กร ของคุณ ให้คลิก Limits, แล้วเลื่อนลงไปที่ Usage limits.

หากต้องการตั้งค่าขีดจำกัดของโปรเจกต์ ใน การตั้งค่าองค์กร ของคุณ ให้คลิกโปรเจกต์ที่ต้องการอัปเดตแล้วเลือก Limits. คุณสามารถอัปเดต Monthly budget, Notification threshold และ Model Usage ได้

การตั้งค่า monthly budget ช่วยให้คุณกำหนดเกณฑ์การใช้จ่ายแบบไม่บังคับสำหรับโปรเจกต์ได้ เมื่อการใช้งานเกินขีดจำกัดนี้ภายในเดือนปฏิทินที่กำหนด (UTC) คำขอ API จะยังคงถูกประมวลผลต่อไปโดยไม่หยุดชะงัก ฟีเจอร์นี้ออกแบบมาเพื่อช่วยให้คุณติดตามการใช้งานผ่านการแจ้งเตือนงบประมาณ แต่ไม่ได้บังคับเพดานการใช้จ่ายแบบตายตัว เมื่อมีการสร้างงบประมาณโปรเจกต์ ระบบจะสร้างการแจ้งเตือนที่เกณฑ์ 100% ให้โดยค่าเริ่มต้น และสามารถตั้งค่างบประมาณเพิ่มเติมที่เกณฑ์อื่นได้โดยคลิก Add Alert

โปรดทราบว่า owner ขององค์กรและ owner ของโปรเจกต์จะได้รับข้อความเหล่านี้เสมอ และไม่สามารถปรับแต่งได้

ฉันจะลบหรือเก็บถาวรโปรเจกต์ได้อย่างไร?

สามารถเก็บถาวรโปรเจกต์ได้ผ่านหน้รายการโปรเจกต์ใหม่ หรือจากหน้าการตั้งค่าของแต่ละโปรเจกต์ เมื่อโปรเจกต์ถูกเก็บถาวรแล้ว จะไม่สามารถกู้คืนได้ เมื่อดำเนินการเก็บถาวร ระบบจะขอให้คุณป้อนชื่อโปรเจกต์เพื่อดำเนินการต่อ

คุณสามารถดูรายการโปรเจกต์ที่เก็บถาวรทั้งหมดได้ผ่านแท็บ “Archived” บนหน้ารายการโปรเจกต์เดียวกัน

ไม่สามารถลบโปรเจกต์ได้ เราเก็บประวัติโปรเจกต์ทั้งหมดไว้เพื่อให้การติดตามการใช้งานและการเรียกเก็บเงินมีความต่อเนื่อง

มีข้อจำกัดจำนวนโปรเจกต์ที่ฉันสามารถมีในองค์กรหรือไม่?

โดยค่าเริ่มต้น องค์กรสามารถสร้างโปรเจกต์ได้สูงสุด 2,000 โปรเจกต์

สามารถแชร์ทรัพยากรข้ามโปรเจกต์ได้หรือไม่?

ทรัพยากรของโปรเจกต์ (เช่น ไฟล์ assistants พื้นที่จัดเก็บ หรือ threads) อยู่ภายใต้ขอบเขตของโปรเจกต์นั้นและไม่สามารถเข้าถึงได้โดยสมาชิกที่ไม่ใช่แอดมินจากภายนอกโปรเจกต์ นอกจากนี้ยังไม่สามารถย้ายทรัพยากรระหว่างโปรเจกต์ได้

โควต้าพื้นที่จัดเก็บไฟล์ต่อโปรเจกต์คือเท่าไร?

ขณะนี้ OpenAI รองรับโควต้าพื้นที่จัดเก็บไฟล์ 100 GB ต่อโปรเจกต์

หากเกินโควต้านี้ คุณจะเห็นข้อผิดพลาดต่อไปนี้:

เราแนะนำให้คุณลบไฟล์ที่ไม่ได้ใช้งานซึ่งจัดเก็บอยู่ในบัญชีของคุณ และเพื่อใช้อ้างอิง คุณสามารถดูและแสดงรายการไฟล์ด้วย API ได้

ฉันเป็นเจ้าของโปรเจกต์ แล้วทำไมจึงมองไม่เห็นแดชบอร์ดการใช้งานของโปรเจกต์?

การมองเห็นแดชบอร์ดการใช้งานของโปรเจกต์ไม่ได้เกี่ยวข้องกับบทบาทของผู้ใช้ภายในโปรเจกต์ แต่ถูกกำหนดโดยบทบาทของคุณภายในองค์กร และ การตั้งค่าที่ https://platform.openai.com/settings/organization/data-controls/visibility

หากคุณไม่สามารถดูแดชบอร์ดการใช้งานได้ เป็นไปได้ว่าการตั้งค่านี้ถูกตั้งเป็น "Visible to organization owners"