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

ภาพรวม

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

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

ก่อนเริ่มต้น

คุณต้องมีบทบาทเจ้าขององค์กรจึงจะสร้างโปรเจกต์ได้ ตามค่าเริ่มต้น องค์กรสามารถสร้างโปรเจกต์ได้สูงสุด 2,000 โปรเจกต์

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

หากต้องการสลับองค์กร ให้เปิดเมนูเลือกองค์กร แล้วเลือกองค์กรที่ต้องการใช้

โปรเจกต์เริ่มต้น

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

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

สร้างโปรเจกต์

1. เปิดเมนูเลือกโปรเจกต์ แล้วเลือก สร้างโปรเจกต์

2. ป้อนชื่อ คำอธิบาย และเว็บไซต์ของโปรเจกต์

3. เลือก สร้าง

เจ้าขององค์กรจะได้รับการเพิ่มเป็นเจ้าของโปรเจกต์ใหม่โดยอัตโนมัติ

ทำความเข้าใจบทบาทและสิทธิ์เข้าถึง

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

ดูรายละเอียดเกี่ยวกับบทบาทในองค์กรได้ที่ บทบาทในองค์กร ดูบทบาทเพิ่มเติม บทบาทที่กำหนดเอง และสิทธิ์ทั้งหมดได้ในคู่มือบทบาทและสิทธิ์ API

การมองเห็นโปรเจกต์

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

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

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

ขอบเขตของทรัพยากร

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

ยกเว้นโมเดลที่ปรับแต่งแบบละเอียดในโปรเจกต์เริ่มต้น ซึ่งสามารถเข้าถึงจากโปรเจกต์อื่นได้

จัดการสมาชิกโปรเจกต์

เชิญบุคคลเข้าร่วมองค์กรของคุณ

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

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

คำเชิญที่ส่งผ่าน Admin API จะเป็นไปตามกฎของ endpoint /organization/invites

เพิ่มสมาชิกองค์กรเข้าโปรเจกต์

เจ้าขององค์กรและเจ้าของโปรเจกต์สามารถเพิ่มสมาชิกได้ดังนี้:

1. ไปที่การตั้งค่าองค์กร

2. เลือกโปรเจกต์ แล้วเปิด สมาชิก

3. เลือก + เพิ่มสมาชิก

4. เลือกผู้ใช้และกำหนดบทบาทเป็น สมาชิก หรือ เจ้าของ

รายชื่อผู้ใช้จะแสดงผู้ใช้ในองค์กรที่มีบทบาทผู้อ่าน รายชื่อนี้ไม่รวมบัญชีบริการ

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

เปลี่ยนบทบาทหรือนำสมาชิกออก

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

1. ไปที่การตั้งค่าองค์กร

2. เลือกโปรเจกต์ แล้วเปิด สมาชิก

3. กำหนดบทบาทของผู้ใช้เป็น สมาชิก หรือ เจ้าของ หรือเลือก นำออก เพื่อนำผู้ใช้ออก

สร้างและจัดการบัญชีบริการ

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

การสร้างบัญชีบริการต้องมีสิทธิ์จัดการบัญชีบริการ เจ้าขององค์กรและเจ้าของโปรเจกต์มีสิทธิ์เหล่านี้

สร้างบัญชีบริการ

1. เลือกโปรเจกต์ในเมนูเลือกโปรเจกต์

2. ไปที่การตั้งค่าองค์กร แล้วเลือกโปรเจกต์

3. เปิด สมาชิก แล้วเลือก + บัญชีบริการ

4. ป้อน ID บัญชีบริการที่ไม่ซ้ำ โดยใช้ตัวอักษร ตัวเลข และยัติภังค์

5. เลือก สร้าง

ไม่ว่าคุณจะสร้างบัญชีบริการจากการตั้งค่าระดับองค์กรหรือระดับโปรเจกต์ ก็ใช้รูปแบบ ID เดียวกัน

บัญชีบริการที่สร้างสำหรับโปรเจกต์จะใช้ได้เฉพาะโปรเจกต์นั้น และไม่สามารถใช้นอกโปรเจกต์ได้

บันทึกคีย์ลับ

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

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

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

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

ในเมนูสมาชิกขององค์กร คุณสามารถเปลี่ยนบทบาทของบัญชีบริการ หรือเลือก นำออก ได้

สร้างและจัดการคีย์ API

แต่ละโปรเจกต์มีคีย์ API ของตนเอง:

1. ไปที่การตั้งค่าองค์กร

2. เลือกโปรเจกต์ แล้วเปิด คีย์ API

3. เลือก + สร้างคีย์ลับใหม่ เพื่อสร้างคีย์ หรือเลือกไอคอนแก้ไขข้างคีย์ที่มีอยู่เพื่อเปลี่ยนสิทธิ์ของคีย์นั้น

เลือกสิทธิ์ของคีย์

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

• ทั้งหมด: มีสิทธิ์ครบถ้วน นี่คือค่าเริ่มต้น

• จำกัด: เลือกขอบเขตสิทธิ์สำหรับทรัพยากรหรือ endpoint ที่ต้องการ ตัวเลือกที่ใช้ได้ขึ้นอยู่กับทรัพยากร โดยอาจมี ไม่มี, อ่าน, เขียน หรือสิทธิ์เฉพาะสำหรับคำขอ

• อ่านอย่างเดียว: มีสิทธิ์อ่านสำหรับทุก endpoint

ตัวอย่างเช่น คีย์แบบจำกัดสามารถปิดสิทธิ์อ่านและเขียนสำหรับ endpoint /v1/assistants ได้

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

กำหนดสิทธิ์เข้าถึงโมเดลและลิมิตการใช้งาน

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

1. ไปที่การตั้งค่าองค์กร

2. เลือกโปรเจกต์ แล้วเปิด ขีดจำกัด

3. ใช้ การใช้งานโมเดล เพื่อเลือกโมเดลที่โปรเจกต์สามารถใช้ได้

4. กำหนดลิมิตการใช้งานสำหรับแต่ละโมเดลตามต้องการ

กำหนดวงเงินใช้จ่ายและการแจ้งเตือน

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

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

การแจ้งเตือนค่าใช้จ่ายจะแจ้งให้คุณทราบเมื่อค่าใช้จ่ายถึงเกณฑ์ที่กำหนด แต่จะไม่หยุดรับคำขอ

กำหนดวงเงินค่าใช้จ่ายขององค์กร

1. ไปที่การตั้งค่าองค์กร

2. เปิด ขีดจำกัด แล้วค้นหา ค่าใช้จ่าย

กำหนดวงเงินค่าใช้จ่ายของโปรเจกต์

1. ไปที่การตั้งค่าองค์กร

2. เลือกโปรเจกต์ แล้วเปิด ขีดจำกัด

3. ตั้งค่า วงเงินค่าใช้จ่ายรายเดือน และ แจ้งเตือนเมื่อค่าใช้จ่ายถึง

4. เปิด บังคับใช้ขีดจำกัดแบบตายตัว หากต้องการหยุดรับคำขอ API เมื่อค่าใช้จ่ายที่ติดตามถึงวงเงินที่กำหนด

คุณยังเปลี่ยน การใช้งานโมเดล ได้ในหน้านี้

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

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

จัดการการแจ้งเตือนค่าใช้จ่าย

เมื่อกำหนดวงเงินค่าใช้จ่ายของโปรเจกต์ ระบบจะสร้างการแจ้งเตือนเมื่อค่าใช้จ่ายถึง 100% ของวงเงินให้ด้วยโดยค่าเริ่มต้น เลือก เพิ่มการแจ้งเตือน เพื่อเพิ่มการแจ้งเตือนที่เกณฑ์อื่น

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

ดูขั้นตอนการตั้งค่าและวิธีบังคับใช้ล่าสุดได้ในคู่มือวงเงินใช้จ่าย

ดูการใช้งานและการเรียกเก็บเงิน

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

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

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

จัดการพื้นที่จัดเก็บไฟล์

แต่ละโปรเจกต์มีโควตาพื้นที่จัดเก็บไฟล์ 100 GB หากใช้เกินโควตา คุณอาจเห็นข้อผิดพลาดนี้:

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

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

เก็บโปรเจกต์ถาวร

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

การเก็บถาวรมีผลถาวร: ไม่สามารถกู้คืนโปรเจกต์ที่เก็บถาวรแล้วได้

หากต้องการดูโปรเจกต์ที่เก็บถาวรแล้ว ให้เปิดแท็บ เก็บถาวรแล้ว ในหน้าโปรเจกต์

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