การดำเนินการข้อความ

เอกสารประกอบสำหรับการดำเนินการข้อความใน node OpenAI ใน n8n ซึ่งเป็นแพลตฟอร์มอัตโนมัติของ workflow รวมรายละเอียดการดำเนินการและการกำหนดค่า และลิงก์ไปยังตัวอย่างและข้อมูลประจำตัว

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

เวอร์ชัน node ก่อนหน้า (Previous node versions)

n8n 1.117.0 แนะนำ node OpenAI V2 ที่รองรับ OpenAI Responses API โดยเปลี่ยนชื่อการดำเนินการ 'ส่งข้อความโมเดล' เป็น 'สร้างการแชทให้เสร็จสิ้น' เพื่อชี้แจงความเชื่อมโยงกับ Chat Completions API และแนะนำการดำเนินการ 'สร้างการตอบกลับโมเดล' แยกต่างหากที่ใช้ Responses API

สร้างการแชทให้เสร็จสิ้น

ใช้การดำเนินการนี้เพื่อส่งข้อความหรือแจ้งไปยังโมเดล OpenAI โดยใช้ Chat Completions API และรับการตอบกลับ

ป้อน parameter เหล่านี้:

• Credential to connect with : สร้างหรือเลือกที่มีอยู่ OpenAI credentials.
• Resource : เลือก Text.
• Operation : เลือก Generate a Chat Completion.
• Model : เลือกรุ่นที่คุณต้องการใช้ หากคุณไม่แน่ใจว่าจะใช้รุ่นใด ให้ลองใช้ gpt-4o หากคุณต้องการสติปัญญาสูงหรือ gpt-4o-mini หากคุณต้องการความเร็วที่เร็วที่สุดและต้นทุนต่ำสุด อ้างถึง ภาพรวมโมเดล | แพลตฟอร์ม OpenAI สำหรับข้อมูลเพิ่มเติม
• Messages : ป้อนก Text พร้อมท์และมอบหมาย Role ที่โมเดลจะใช้ในการสร้างการตอบสนอง อ้างถึง พร้อมท์วิศวกรรม | OpenAI สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการเขียนพร้อมท์ที่ดีขึ้นโดยใช้บทบาทเหล่านี้ เลือกจากหนึ่งในบทบาทเหล่านี้:
  • User : ส่งข้อความในฐานะผู้ใช้และรับการตอบกลับจากโมเดล
  • Assistant : บอกให้นางแบบใช้น้ำเสียงหรือบุคลิกภาพที่เฉพาะเจาะจง
  • System : ตามค่าเริ่มต้น จะไม่มีข้อความระบบ คุณสามารถกำหนดคำแนะนำในข้อความผู้ใช้ได้ แต่คำแนะนำที่ตั้งไว้ในข้อความระบบจะมีประสิทธิภาพมากกว่า คุณสามารถตั้งค่าข้อความระบบได้มากกว่าหนึ่งข้อความต่อการสนทนา ใช้สิ่งนี้เพื่อกำหนดพฤติกรรมหรือบริบทของโมเดลสำหรับข้อความผู้ใช้ถัดไป
• Simplify Output : เปิดเพื่อส่งคืนการตอบกลับในเวอร์ชันที่เรียบง่ายแทนข้อมูลดิบ
• ส่งออกเนื้อหาเป็น JSON (Output Content as JSON) : เปิดเพื่อพยายามส่งคืนการตอบกลับในรูปแบบ JSON เข้ากันได้กับ GPT-4 Turbo และทั้งหมด GPT-3.5 Turbo รุ่นที่ใหม่กว่า gpt-3.5-turbo-1106.

Options

• Frequency Penalty : ใช้การลงโทษเพื่อลดแนวโน้มของโมเดลในการทำซ้ำบรรทัดที่คล้ายกัน มีช่วงอยู่ระหว่าง 0.0 และ 2.0.
• Maximum Number of Tokens : กำหนดจำนวน token สูงสุดสำหรับการตอบกลับ token หนึ่งรายการประกอบด้วยอักขระประมาณสี่ตัวสำหรับข้อความภาษาอังกฤษมาตรฐาน ใช้ตัวเลือกนี้เพื่อจำกัดความยาวของ output
• Number of Completions : ค่าเริ่มต้นเป็น 1 กำหนดจำนวนความสำเร็จที่คุณต้องการสร้างสำหรับแต่ละข้อความแจ้ง ใช้อย่างระมัดระวังเนื่องจากการตั้งค่าจำนวนมากจะทำให้ token ของคุณหมดอย่างรวดเร็ว
• Presence Penalty : ใช้การลงโทษเพื่อโน้มน้าวโมเดลเพื่อหารือเกี่ยวกับหัวข้อใหม่ มีช่วงอยู่ระหว่าง 0.0 และ 2.0.
• Output Randomness (Temperature) : ปรับความสุ่มของการตอบกลับ มีช่วงอยู่ระหว่าง 0.0 (กำหนดไว้) และ 1.0 (การสุ่มสูงสุด) เราขอแนะนำให้แก้ไขสิ่งนี้หรือ Output Randomness (Top P) แต่ไม่ใช่ทั้งสองอย่าง เริ่มต้นด้วยอุณหภูมิปานกลาง (ประมาณ 0.7 ) และปรับตามผลลัพธ์ที่คุณสังเกตเห็น หากการตอบสนองซ้ำหรือเข้มงวดเกินไป ให้เพิ่มอุณหภูมิ หากมันวุ่นวายเกินไปหรือออกนอกลู่นอกทาง ให้ลดมันลง ค่าเริ่มต้นเป็น 1.0.
• Output Randomness (Top P) : ปรับการตั้งค่า Top P เพื่อควบคุมความหลากหลายของการตอบสนองของผู้ช่วย ตัวอย่างเช่น 0.5 หมายถึงครึ่งหนึ่งของตัวเลือกที่ถ่วงน้ำหนักความน่าจะเป็นทั้งหมดได้รับการพิจารณา เราขอแนะนำให้แก้ไขสิ่งนี้หรือ Output Randomness (Temperature) แต่ไม่ใช่ทั้งสองอย่าง ค่าเริ่มต้นเป็น 1.0.

อ้างถึง เสร็จสิ้นการแชท | OpenAI เอกสารประกอบสำหรับข้อมูลเพิ่มเติม

สร้างแบบจำลองการตอบกลับ

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

ป้อน parameter เหล่านี้:

• Credential to connect with : สร้างหรือเลือกที่มีอยู่ OpenAI credentials.
• Resource : เลือก Text.
• Operation : เลือก Generate a Model Response.
• Model : เลือกรุ่นที่คุณต้องการใช้ อ้างถึง ภาพรวมโมเดล | แพลตฟอร์ม OpenAI สำหรับภาพรวม
• Messages : เลือกจากข้อใดข้อหนึ่งต่อไปนี้ Message Types:
  • Text : ป้อนก Text พร้อมท์และมอบหมาย Role ที่โมเดลจะใช้ในการสร้างการตอบสนอง อ้างถึง พร้อมท์วิศวกรรม | OpenAI สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการเขียนพร้อมท์ที่ดีขึ้นโดยใช้บทบาทเหล่านี้
  • Image : ให้ Image ไม่ว่าจะผ่าน URL รูปภาพ, รหัสไฟล์ (โดยใช้นามสกุล API ไฟล์ OpenAI ) หรือโดยการส่งข้อมูลไบนารีจาก node ก่อนหน้าใน workflow ของคุณ
  • File : ให้ File ในรูปแบบที่รองรับ (ปัจจุบัน: PDF เท่านั้น) ไม่ว่าจะผ่าน URL ไฟล์ รหัสไฟล์ (โดยใช้นามสกุลไฟล์ API ไฟล์ OpenAI ) หรือโดยการส่งข้อมูลไบนารีจาก node ก่อนหน้าใน workflow ของคุณ
  • สำหรับข้อความประเภทใดก็ตาม คุณสามารถเลือกจากบทบาทใดบทบาทหนึ่งต่อไปนี้
    • User : ส่งข้อความในฐานะผู้ใช้และรับการตอบกลับจากโมเดล
    • Assistant : บอกให้นางแบบใช้น้ำเสียงหรือบุคลิกภาพที่เฉพาะเจาะจง
    • System : ตามค่าเริ่มต้น ข้อความของระบบจะเป็น "You are a helpful assistant" . คุณสามารถกำหนดคำแนะนำในข้อความผู้ใช้ได้ แต่คำแนะนำที่ตั้งไว้ในข้อความระบบจะมีประสิทธิภาพมากกว่า คุณสามารถตั้งค่าข้อความระบบได้เพียงข้อความเดียวต่อการสนทนา ใช้สิ่งนี้เพื่อกำหนดพฤติกรรมหรือบริบทของโมเดลสำหรับข้อความผู้ใช้ถัดไป
• Simplify Output : เปิดเพื่อส่งคืนการตอบกลับในเวอร์ชันที่เรียบง่ายแทนข้อมูลดิบ

Built-in Tools

OpenAI Responses API มีช่วงของ เครื่องมือในตัว เพื่อเพิ่มการตอบสนองของโมเดล:

• Web Search : อนุญาตให้โมเดลค้นหาข้อมูลล่าสุดบนเว็บก่อนสร้างการตอบกลับ
• MCP Servers : อนุญาตให้โมเดลเชื่อมต่อกับเซิร์ฟเวอร์ MCP ระยะไกล ค้นหาข้อมูลเพิ่มเติมเกี่ยวกับ โดยใช้เซิร์ฟเวอร์ MCP ระยะไกลเป็นเครื่องมือ .
• File Search : อนุญาตให้โมเดลค้นหาฐานความรู้ของคุณจากไฟล์ที่อัปโหลดก่อนหน้านี้เพื่อหาข้อมูลที่เกี่ยวข้องก่อนที่จะสร้างการตอบกลับ อ้างถึง เอกสาร OpenAI สำหรับข้อมูลเพิ่มเติม
• Code Interpreter : อนุญาตให้โมเดลเขียนและรันโค้ด Python ในสภาพแวดล้อมแบบแซนด์บ็อกซ์

Options

• Maximum Number of Tokens : กำหนดจำนวน token สูงสุดสำหรับการตอบกลับ token หนึ่งรายการประกอบด้วยอักขระประมาณสี่ตัวสำหรับข้อความภาษาอังกฤษมาตรฐาน ใช้ตัวเลือกนี้เพื่อจำกัดความยาวของ output
• Output Randomness (Temperature) : ปรับความสุ่มของการตอบกลับ มีช่วงอยู่ระหว่าง 0.0 (กำหนดไว้) และ 1.0 (การสุ่มสูงสุด) เราขอแนะนำให้แก้ไขสิ่งนี้หรือ Output Randomness (Top P) แต่ไม่ใช่ทั้งสองอย่าง เริ่มต้นด้วยอุณหภูมิปานกลาง (ประมาณ 0.7 ) และปรับตามผลลัพธ์ที่คุณสังเกตเห็น หากการตอบสนองซ้ำหรือเข้มงวดเกินไป ให้เพิ่มอุณหภูมิ หากมันวุ่นวายเกินไปหรือออกนอกลู่นอกทาง ให้ลดมันลง ค่าเริ่มต้นเป็น 1.0.
• Output Randomness (Top P) : ปรับการตั้งค่า Top P เพื่อควบคุมความหลากหลายของการตอบสนองของผู้ช่วย ตัวอย่างเช่น 0.5 หมายถึงครึ่งหนึ่งของตัวเลือกที่ถ่วงน้ำหนักความน่าจะเป็นทั้งหมดได้รับการพิจารณา เราขอแนะนำให้แก้ไขสิ่งนี้หรือ Output Randomness (Temperature) แต่ไม่ใช่ทั้งสองอย่าง ค่าเริ่มต้นเป็น 1.0.
• Conversation ID : บทสนทนาที่การตอบกลับนี้เป็นของ รายการ input และ output จากการตอบกลับนี้จะถูกเพิ่มลงในการสนทนานี้โดยอัตโนมัติหลังจากการตอบกลับนี้เสร็จสิ้น
• Previous Response ID : ID ของการตอบกลับก่อนหน้าเพื่อดำเนินการต่อ ไม่สามารถใช้ร่วมกับรหัสการสนทนาได้
• Reasoning : ระดับของความพยายามในการให้เหตุผลที่แบบจำลองควรใช้เพื่อสร้างการตอบสนอง รวมถึงความสามารถในการคืนก Summary ของการให้เหตุผลที่ดำเนินการโดยแบบจำลอง (ตัวอย่างเช่น เพื่อวัตถุประสงค์ในการแก้ไขจุดบกพร่อง)
• Store : ว่าจะจัดเก็บการตอบสนองของโมเดลที่สร้างขึ้นเพื่อการดึงข้อมูลในภายหลังผ่าน API หรือไม่ ค่าเริ่มต้นเป็น true.
• Output Format : ไม่ว่าจะส่งคืนการตอบกลับเป็น Text , ในแบบที่กำหนด JSON Schema หรือเป็น JSON Object.
• Background : ไม่ว่าจะรันโมเดลหรือไม่ โหมดพื้นหลัง . ช่วยให้สามารถดำเนินงานที่ใช้เวลานานได้อย่างน่าเชื่อถือมากขึ้น

อ้างถึง ตอบกลับ | OpenAI เอกสารประกอบสำหรับข้อมูลเพิ่มเติม

จำแนกข้อความสำหรับการละเมิด

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

• flagged : ช่อง boolean ที่ระบุว่าเนื้อหาอาจเป็นอันตรายหรือไม่
• categories : รายการธงการละเมิดเฉพาะหมวดหมู่
• category_scores : คะแนนแต่ละหมวด

ป้อน parameter เหล่านี้:

• Credential to connect with : สร้างหรือเลือกที่มีอยู่ OpenAI credentials.
• Resource : เลือก Text.
• Operation : เลือก Classify Text for Violations.
• Text Input : ป้อนข้อความเพื่อจัดประเภทหากละเมิดนโยบายการกลั่นกรอง
• Simplify Output : เปิดเพื่อส่งคืนการตอบกลับในเวอร์ชันที่เรียบง่ายแทนข้อมูลดิบ

Options

• Use Stable Model : เปิดเพื่อใช้รุ่นเสถียรแทนรุ่นล่าสุด ความแม่นยำอาจลดลงเล็กน้อย

อ้างถึง การกลั่นกรอง | OpenAI เอกสารประกอบสำหรับข้อมูลเพิ่มเติม

ปัญหาทั่วไป

สำหรับข้อผิดพลาดหรือปัญหาทั่วไปและขั้นตอนการแก้ปัญหาที่แนะนำ โปรดดูที่ Common issues.