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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เพิ่มสมาชิกในโปรเจกต์

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

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

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

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

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

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

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

บันทึกคีย์ API ของบัญชีบริการ

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

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

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

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

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

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

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

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

มีสิทธิ์อนุญาต 3 ระดับให้ใช้ ได้แก่ ทั้งหมด จำกัด และอ่านอย่างเดียว

• ทั้งหมด — ตั้งค่าสิทธิ์อนุญาตเต็มรูปแบบสำหรับคีย์ลับ นี่คือการตั้งค่าเริ่มต้น

• จำกัด — ช่วยให้ผู้ใช้ตั้งค่าสิทธิ์อนุญาต ไม่มี, อ่าน และเขียน สำหรับแต่ละ endpoint ได้

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

    

• อ่านอย่างเดียว — ตั้งค่าสิทธิ์อ่านสำหรับ endpoint ทั้งหมด

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

หากคุณไม่สามารถเห็นแดชบอร์ดการใช้งาน การตั้งค่านี้น่าจะถูกตั้งเป็น “มองเห็นได้สำหรับเจ้าขององค์กร”