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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เมื่อเพิ่มสมาชิกทีม คุณต้องกำหนดบทบาทให้เป็น Member หรือ Owner สมาชิกโปรเจกต์สามารถส่งคำขอ 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% โดยค่าเริ่มต้น คุณสามารถตั้งค่าการแจ้งเตือนเพิ่มเติมที่เกณฑ์อื่นได้โดยคลิก เพิ่มการแจ้งเตือน

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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