GLM 5.3: วางสัญญาระหว่างหลายไฟล์ก่อนเปลี่ยนระบบ

ตัวอย่าง API ขั้นต่ำ

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

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://dikaya.cc/v1",
    api_key=os.environ["DIKAYA_API_KEY"],
    max_retries=0,
)
response = client.chat.completions.create(
    model="seller-glm-5-3",
    max_tokens=512,
    messages=[{"role": "user", "content": "สร้างรายการตรวจสอบสำหรับงานของฉัน แยกข้อเท็จจริงจากแหล่งข้อมูลออกจากสมมติฐาน"}],
)
print(response.choices[0].message.content)

เริ่มจากขอบเขตการเปลี่ยนที่ตรวจได้

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

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

ส่งแผนที่ไฟล์พร้อมส่วนที่ถูกตัดออก

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

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

เลือก effort และขนาดคำตอบเป็นคนละเรื่อง

รหัสนี้ประกาศระดับ low, high และ max การเลือกระดับไม่ใช่ใบรับรองว่าแพตช์ถูกต้องหรือจะเสร็จในเวลาที่แน่นอน เริ่มจากผลที่ต้องการ เช่น ตารางสัญญาและรายการไฟล์ก่อน หากยังมีคำถามสำคัญ ให้ปิดช่องว่างนั้นก่อนขอสร้างโค้ด ไม่ใช้การเพิ่ม effort แทนการให้เงื่อนไขที่ชัดเจน

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

ทดสอบทั้งเส้นทางใหม่และผู้เรียกแบบเดิม

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

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

ไม่ปล่อยให้การส่งซ้ำซ่อนสถานะจริง

SDK Python อาจส่งคำขอซ้ำตามชนิดข้อผิดพลาด จึงตั้ง max_retries=0 เมื่อต้องการตัดสินใจส่งเองทุกครั้ง แยกการปฏิเสธ HTTP ที่ทราบสถานะออกจากปัญหาการเชื่อมต่อ MDN อธิบายว่า Fetch ไม่ปฏิเสธ Promise เพียงเพราะได้รหัส HTTP ผิดพลาด ต้องตรวจ status ก่อนอธิบายผลให้คนใช้

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

แยกหลักฐานโมเดลจากหลักฐานโปรโตคอล

หน้ารายการโมเดลและราคาของ Dikaya ใช้ตรวจข้อเท็จจริงด้านการตั้งค่า ส่วนเอกสาร SDK และ Fetch ใช้อธิบายกลไกคำขอ ไม่ได้ยืนยันคุณภาพของ GLM หรือความพร้อมในเวลาที่อ่าน ราคาสาธารณะก็ไม่ใช่ราคาส่วนบุคคลหรือหลักฐานว่าการตรวจราคาปัจจุบันผ่านแล้ว เก็บการอ้างอิงตามหน้าที่ของแต่ละแหล่ง

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

คำถามและคำตอบ

เลือกระดับ max แล้วไม่ต้องอ่านแพตช์อีกได้หรือไม่?

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

GLM 5.3 ตัวนี้เป็นรหัสเดียวกับ Pro 2 หรือไม่?

ไม่ใช่ seller-glm-5-3 และ seller-pro-2 เป็นคนละรหัส แม้จะมีข้อมูลพื้นฐานที่เปิดเผยเกี่ยวกับ Pro 2 ก็ไม่ควรใช้ชื่อแทนกันในการตั้งค่า การตรวจสิทธิ์ หรือบันทึกผล เก็บรหัสจริงของแต่ละคำขอไว้ให้ตรวจย้อนหลังได้

เหตุใดต้องส่งตัวอย่างผู้เรียกเก่าด้วย?

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

เอกสาร SDK รับรองว่าโมเดลพร้อมให้บริการหรือไม่?

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

แหล่งข้อมูล

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

• Dikaya: รายการโมเดลและเงื่อนไขการเลือกใช้งาน
  dikaya.cc
• Dikaya: คู่มือ API และขอบเขตของคำขอ
  dikaya.cc
• Dikaya: ราคาสาธารณะสำหรับตรวจสอบเงื่อนไข
  dikaya.cc
• เอกสาร Python SDK: ข้อผิดพลาดและการปิดส่งคำขอซ้ำ
  github.com
• คู่มือ MDN: สถานะ HTTP การอ่านผลและยกเลิก Fetch
  developer.mozilla.org