ค้นพบความสนใจของคุณ ไปด้วยกัน

ดีลจริง รีวิวตรงไปตรงมา และเรื่องราวการช้อปปิ้งจากคนที่มีความสนใจเดียวกับคุณ — ทุกวันบน ZestBuy

ค้นพบความสนใจของคุณ ไปด้วยกันดีลจริง รีวิวตรงไปตรงมา และเรื่องราวการช้อปปิ้งจากคนที่มีความสนใจเดียวกับคุณ — ทุกวันบน ZestBuy

คู่มือย้ายโค้ด Claude API และตั้งค่า User Profiles

คู่มือย้ายโค้ด Claude API และตั้งค่า User Profiles
ความสนใจ|เทคนิคการใช้ AI

เริ่มย้าย API ด้วยการตรวจคำขอที่ส่งอยู่

Claude API migration คือกระบวนการปรับโค้ดและการเชื่อมต่อของแอปให้ทำงานกับ API version 2026-10-21 และ SDK รุ่นใหม่ โดยตรวจจุดที่เปลี่ยนแปลงเพื่อป้องกันคำขอผิดรูปแบบและบริการหยุดทำงาน

จุดที่ต้องจัดการก่อนคือพารามิเตอร์ temperature, top_p และ top_k ซึ่งถูกนำออกจาก API version 2026-10-21 หากยังส่งฟิลด์ใดฟิลด์หนึ่งไป แม้ใช้ค่าเริ่มต้น ระบบจะตอบกลับ 400 กับทุกโมเดล ดังนั้นให้ค้นหาทั้งโค้ดเรียก API, ค่าเริ่มต้นในชั้นตั้งค่า และตัวแปลงคำขอของ gateway แล้วลบฟิลด์เหล่านี้ออก ไม่ใช่เพียงตั้งค่าเป็นค่าเดิม หากงานยังต้องพึ่งค่าการสุ่มที่ไม่ใช่ค่าเริ่มต้น ให้คงคำขอนั้นไว้ที่เวอร์ชัน 2023-06-01 เพราะไม่มีค่าทดแทนในเวอร์ชันใหม่ การอัปเกรดจึงควรเริ่มจากชุดทดสอบคำขอจริง ไม่ใช่แก้เลขเวอร์ชันแล้วปล่อยขึ้นระบบทันที

อัปเกรด SDK และแก้ชั้นยืนยันตัวตน

การเปลี่ยนเวอร์ชัน API ไม่ใช่งานทั้งหมด เพราะ SDK ก็ปรับรุ่นใหญ่พร้อมกันและมีการเปลี่ยนแปลงที่แยกจาก API การอัปเดต SDK major version update แบบอัตโนมัติโดยไม่ตรวจโค้ดจึงเสี่ยงทำให้ build หรือ gateway พัง

รุ่นหลักที่ประกาศมี Python 2.0.0, TypeScript 1.0.0, Go 2.0.0, C# 13.0.0, Java 3.0.0, PHP 1.0.0, Ruby 2.0.0 และ ant CLI 2.0.0 เริ่มจากตรึงรุ่น dependency ในสภาพแวดล้อมทดสอบ แล้วตรวจชนิดข้อมูลและวิธีสร้างข้อความ โดยเฉพาะโค้ดที่เรียก MessageParam เป็นฟังก์ชัน เพราะรูปแบบนั้นจะเกิด TypeError ส่วน Go ต้องเปลี่ยนไปใช้ module path github.com/anthropics/anthropic-sdk-go/v2 อย่าพึ่งพา X-Api-Key ใน proxy, ตัวกรอง log หรือ test stub เพราะ SDK ใหม่ส่ง API key ผ่าน Authorization: Bearer เป็นค่าเริ่มต้น แม้ API ยังรับ X-Api-Key ได้ก็ตาม จากนั้นจึงทดสอบเส้นทางเรียกจริงและการจัดการข้อผิดพลาดก่อนปล่อยใช้งาน

ตั้งค่า User Profiles ให้แต่ละลูกค้าในแพลตฟอร์ม

สำหรับ multi-tenant platform ที่ขายต่อ Claude การระบุตัวผู้ใช้ปลายทางทุกคำขอช่วยจำกัดผลกระทบจากการบังคับใช้นโยบาย หากไม่มี profile ลูกค้ารายเดียวอาจทำให้มาตรการบังคับใช้มีผลกับทั้ง organization และกระทบลูกค้ารายอื่น

  1. สร้าง profile ให้ลูกค้าแต่ละรายเพียงครั้งเดียวระหว่าง onboarding ด้วย POST /v1/user_profiles แล้วเก็บ ID ที่ขึ้นต้นด้วย uprof_ ไว้ในข้อมูลลูกค้า
  2. เลือก access_type เป็น application สำหรับผู้ใช้รายบุคคลในแอป หรือ passthrough สำหรับบริษัทที่ซื้อผ่าน gateway โดยใช้หนึ่ง profile ต่อหนึ่งบริษัท
  3. แนบ ID ทุกครั้งที่เรียก API แทนลูกค้ารายนั้น ด้วย header anthropic-user-profile-id หรืออาร์กิวเมนต์ user_profile_id ใน SDK
  4. สำหรับ passthrough ให้ส่งตัวระบุผู้ใช้แต่ละคนใน metadata.user_id ด้วย

นี่คือวิธีใช้ User Profiles Claude เพื่อผูกคำขอกับลูกค้าปลายทาง แทนการนับทุกคำขอเป็นของผู้ให้บริการเอง โปรไฟล์ผูกกับ organization ไม่ใช่ workspace ดังนั้นการแยก workspace อย่างเดียวไม่ใช่ขอบเขตแยกการบังคับใช้ที่เพียงพอ

คู่มือย้ายโค้ด Claude API และตั้งค่า User Profiles

ตรวจสถานะการบังคับใช้และหลีกเลี่ยงข้อผิดพลาด

เมื่อผูก profile ถูกต้องแล้ว ผู้ให้บริการตรวจสถานะลูกค้าผ่าน API ได้ โดย enforcement_status ระบุ unrestricted, restricted หรือ banned ส่วน enforcement_actions แสดงรายการมาตรการที่ยังมีผล รวมถึงเหตุผลและเวลาสิ้นสุด ใช้ข้อมูลนี้แยกตรวจปัญหาเป็นรายลูกค้า แทนการคาดเดาจากอาการที่เกิดกับทั้งแพลตฟอร์ม

ข้อผิดพลาดที่ควรป้องกันมีสองเรื่อง ประการแรก POST /v1/user_profiles ไม่ใช่ idempotent การเรียกซ้ำสร้าง profile ใหม่แม้ใช้ reference_id เดิม จึงต้องสร้างครั้งเดียวและบันทึก ID ให้ครบ ประการที่สอง หากส่ง beta header user-profiles-2026-09-04 ฟิลด์ enforcement จะไม่ถูกส่งกลับมา อีกทั้ง updated_at อาจไม่เปลี่ยนเมื่อสถานะบังคับใช้เปลี่ยน จึงควรตรวจค่าของสถานะโดยตรง ไม่ใช้เวลาอัปเดตเป็นตัวแทน ส่วน webhook สำหรับเหตุการณ์ enforcement ยังไม่มีการส่ง event จริง อย่าใช้เป็นช่องทางแจ้งเตือนที่ต้องทำงานทันที

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

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

You May Also Like

Comments
พูดอะไรบางอย่าง...
ยังไม่มีความคิดเห็น มาเป็นคนแรกที่แบ่งปันความคิดเห็นของคุณ!