DeepSeek Harness เชื่อมต่อ API ของ B.AI คู่มือการกำหนดค่าอย่างเป็นทางการ

DeepSeek Harness เป็นแอปพลิเคชันพื้นที่ทำงาน AI แบบโอเพนซอร์สที่ได้รับความสนใจอย่างมาก ซึ่งอยู่ในขั้นตอนการพัฒนาสำหรับนักพัฒนา (Developer Preview) ไม่เพียงแต่สามารถวิเคราะห์โค้ดและไฟล์ภายในพื้นที่ทำงานlocal ได้อย่างลึกซึ้ง แต่ยังมอบความยืดหยุ่นอย่างมากให้กับนักพัฒนาผ่านกลไก Custom Provider แบบเปิด ในขณะที่ B.AI ในฐานะโครงสร้างพื้นฐาน AI ขั้นสูง ได้สร้างแพลตฟอร์มบริการโมเดลขนาดใหญ่แบบ Full-Stack ที่ผสานความพร้อมใช้งานสูงและความหน่วงต่ำเข้าด้วยกัน โดยมุ่งมั่นที่จะสร้างเครือข่ายพลังประมวลผลอัจฉริยะที่แข็งแกร่ง มั่นคง และยืดหยุ่นอย่างยิ่งให้กับนักพัฒนาและองค์กร

คู่มือนี้จะสาธิตให้คุณเห็นโดยละเอียดถึงวิธีเริ่มต้นใช้งาน DeepSeek Harness ตั้งแต่ศูนย์ในสภาพแวดล้อม Windows, macOS และ Linux และผสานรวมเข้ากับ B.AI API ได้สำเร็จ ทำตามบทช่วยสอนนี้ คุณจะเชื่อมต่อวงจรการเรียกใช้งานเต็มรูปแบบตั้งแต่พื้นที่ทำงานในเครื่องไปจนถึงโมเดลขนาดใหญ่ ปลดปล่อยศักยภาพด้านการผลิตและนวัตกรรมที่ขับเคลื่อนด้วย AI อย่างเต็มรูปแบบ

เส้นทางการเรียกใช้งานที่ได้ในที่สุด: DeepSeek Harness → B.AI API → โมเดลที่ให้บริการโดย B.AI

1. การเตรียมสภาพแวดล้อม

DeepSeek Harness เริ่มต้นผ่าน npx ที่มาพร้อมกับ Node.js โปรดตรวจสอบให้แน่ใจว่าระบบของคุณได้ติดตั้ง Node.js เวอร์ชัน LTS ที่ใช้งานได้ในปัจจุบันแล้ว

ที่อยู่ดาวน์โหลดอย่างเป็นทางการ: https://nodejs.org/en/download

• Windows

คุณสามารถดาวน์โหลดไฟล์ติดตั้ง .msi ได้โดยตรง หรือค้นหา PowerShell ในเมนูเริ่ม เปิดขึ้นมาแล้วรันคำสั่งติดตั้ง WinGet

winget --version
winget install --id OpenJS.NodeJS.LTS -e --source winget

• macOS

บนหน้าดาวน์โหลดอย่างเป็นทางการของ Node.js เลือก macOS Installer ดาวน์โหลดไฟล์ .pkg และทำตามคำแนะนำเพื่อติดตั้งให้เสร็จสมบูรณ์ หลังการติดตั้งเสร็จสิ้น กด Command + Space เพื่อเปิด Spotlight Search พิมพ์ Terminal แล้วเข้าไปที่เทอร์มินัล

• Linux 

กรุณาเลือก Linux distribution และสถาปัตยกรรมระบบที่คุณใช้บนหน้าดาวน์โหลดอย่างเป็นทางการของ Node.js และติดตั้งเวอร์ชัน LTS ตามคำสั่งตัวจัดการแพ็คเกจที่แสดงบนหน้า เนื่องจากคำสั่งการติดตั้งแตกต่างกันไปตาม distribution เช่น Ubuntu, Debian, Fedora เป็นต้น ขอแนะนำให้ใช้คำสั่งที่สร้างแบบไดนามิกบนหน้าอย่างเป็นทางการเป็นหลัก เพื่อให้กระบวนการติดตั้งราบรื่นและไม่มีข้อผิดพลาด

หลังการติดตั้งเสร็จสิ้น ให้ปิดหน้าต่างเทอร์มินัลทั้งหมดที่เปิดอยู่ แล้วเปิดเทอร์มินัลใหม่ (ผู้ใช้ Windows โปรดใช้ PowerShell ผู้ใช้ macOS ใช้ Terminal ผู้ใช้ Linux ใช้เทอร์มินัลของระบบ)

ในทั้งสามระบบ ให้รันชุดคำสั่งตรวจสอบเดียวกันดังต่อไปนี้:

node -v
npm -v
npx -v

หากทั้งสามคำสั่งคืนค่าหมายเลขเวอร์ชัน แสดงว่าสภาพแวดล้อมพร้อมแล้ว

Node.js v24.19.0
npm 11.17.0
npx 11.17.0

หากคุณวางแผนที่จะสร้างและรันโปรเจกต์จากซอร์สโค้ดบน GitHub คุณจะต้องพึ่งพาสภาพแวดล้อม Git ขั้นแรก ให้รัน git --version ในเทอร์มินัลเพื่อตรวจสอบว่าติดตั้งแล้วหรือไม่ หากยังไม่ได้ติดตั้ง ให้รันคำสั่งต่อไปนี้ตามระบบปฏิบัติการของคุณ:

Windows 

winget install --id Git.Git -e --source winget

macOS 

xcode-select --install

Ubuntu หรือ Debian 

sudo apt update
sudo apt install git

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

2.  เริ่มต้น DeepSeek Harness ด้วย npx (แนะนำ)

สำหรับนักพัฒนาที่ใช้งานทั่วไปและกำหนดค่า B.AI API ขอแนะนำให้เริ่มต้นด้วย npx โดยตรง

รันคำสั่งต่อไปนี้ในเทอร์มินัล (ใช้ร่วมกันได้ทั้งสามระบบ):

npx @deepseek-ai/dsh web

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

Need to install the following packages
@deepseek-ai/dsh@...
Ok to proceed? (y)

หากมีคำเตือนเกี่ยวกับการเลิกใช้งาน dependencies ในระหว่างการเริ่มต้น นี่เป็นเรื่องปกติ ไม่จำเป็นต้องเข้าไปยุ่ง

npm warn deprecated node-domexception@1.0.0

เมื่อเทอร์มินัลแสดงที่อยู่ local หมายความว่าเว็บเซอร์วิสของ DeepSeek Harness เริ่มต้นสำเร็จแล้ว

dsh web: http://127.0.0.1:3080

ให้เปิดหน้าต่างเทอร์มินัลไว้ จากนั้นพิมพ์ในแถบที่อยู่ของเบราว์เซอร์:

http://127.0.0.1:3080

ที่อยู่นี้สามารถเข้าถึงได้จากเครื่องนี้เท่านั้น หากคุณปิดหน้าต่างเทอร์มินัลหรือกด Ctrl+C ในหน้าต่าง บริการ local จะหยุดทำงานตามไปด้วย หากเบราว์เซอร์ไม่สามารถเปิด 127.0.0.1:3080 ได้ โปรดตรวจสอบก่อนว่าเทอร์มินัลยังคงทำงานอยู่หรือไม่ และยืนยันว่าเทอร์มินัลได้แสดงที่อยู่ dsh web ข้างต้นแล้วหรือไม่ หากจำเป็น โปรดรันคำสั่งเริ่มต้นอีกครั้ง

npx @deepseek-ai/dsh web

3. วิธีการสร้างจากซอร์สโค้ด (ขั้นสูง)

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

คลังอย่างเป็นทางการ: https://github.com/deepseek-ai/deepseek-harness

โปรดทราบว่า GitHub ให้ซอร์สโค้ดของโปรเจกต์ ซึ่งหลังจากดาวน์โหลดแล้ว คุณต้องติดตั้ง dependencies และสร้างโปรเจกต์ผ่านเทอร์มินัลเท่านั้น ไม่สามารถรันได้โดยการดับเบิลคลิกที่ไฟล์ คุณสามารถรับและรันซอร์สโค้ดได้สองวิธีต่อไปนี้:

วิธีที่ 1: ดาวน์โหลดแพ็คเกจซอร์ส ZIP บนหน้าคลัง คลิกปุ่ม Code สีเขียว แล้วเลือก Download ZIP หลังจากดาวน์โหลดและแตกไฟล์แล้ว เปิดเทอร์มินัล ใช้คำสั่ง cd เพื่อเข้าไปยังไดเรกทอรีโปรเจกต์ที่แตกแล้ว จากนั้นรันคำสั่งต่อไปนี้ตามลำดับ:

npm install -g pnpm
pnpm install
pnpm run build
pnpm dsh web

วิธีที่ 2: ใช้ Git Clone ขอแนะนำให้รัน git --version ก่อนเพื่อตรวจสอบว่าสภาพแวดล้อม Git มีอยู่หรือไม่ หากยังไม่ได้ติดตั้ง โปรดอ้างอิงส่วน "การเตรียมสภาพแวดล้อม" ข้างต้นเพื่อติดตั้ง Git สำหรับระบบที่เกี่ยวข้อง หลังจากยืนยันว่าสภาพแวดล้อมถูกต้องแล้ว ให้เปิดเทอร์มินัลใหม่แล้วรันคำสั่งต่อไปนี้:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
npm install -g pnpm
pnpm install
pnpm run build
pnpm dsh web

ไม่ว่าจะใช้วิธี ZIP หรือ Git หลังจากสร้างและเริ่มต้นสำเร็จ ที่อยู่สำหรับเข้าถึงก็ยังคงเป็น http://127.0.0.1:3080 เช่นเดียวกัน

4. การกำหนดค่า Custom Provider ของ B.AI

ขั้นตอนที่ 1: ข้ามการกำหนดค่าเริ่มต้นอย่างเป็นทางการ

เมื่อเข้าสู่ DeepSeek Harness ครั้งแรก ระบบจะแสดงหน้าต่างกรอก API Key ของโมเดลอย่างเป็นทางการ โปรดคลิก "กำหนดค่าทีหลัง" อย่างยิ่ง หากกรอก Key ของ B.AI ลงในตำแหน่งนี้ ระบบจะไม่สามารถระบุได้อย่างถูกต้อง

ขั้นตอนที่ 2: เข้าสู่หน้าการกำหนดค่าแบบกำหนดเอง

คลิก "การตั้งค่า" ที่มุมซ้ายล่างของหน้า เลือก "โมเดล" ในเมนูด้านซ้าย จากนั้นคลิก "เพิ่ม Custom Provider" ทางด้านขวา หมายเหตุ: การที่ Provider อย่างเป็นทางการแสดงจุดสีแดงในเวลานี้เป็นเรื่องปกติ และไม่ส่งผลกระทบต่อการดำเนินการในภายหลัง

ขั้นตอนที่ 3: กรอกข้อมูลอินเทอร์เฟซของ B.AI

หลังจากเปิด Custom Provider แล้ว ให้กรอกตามเนื้อหาด้านล่าง

Provider ID bai
ชื่อที่แสดง B.AI
ที่อยู่ API https://api.b.ai/v1
โปรโตคอล API openai-completions
API Key คีย์ API ที่ใช้งานได้ซึ่งสร้างจากแบ็กเอนด์ของ B.AI

ขั้นตอนที่ 4: รับรายการโมเดลและสร้าง Provider ให้เสร็จสมบูรณ์

หลังจากกรอกข้อมูลพื้นฐานเสร็จสิ้น โปรดเลื่อนลงไปยังพื้นที่ "รายการโมเดล" ระบบมีสองวิธีในการเพิ่ม: คลิก "เพิ่มโมเดล" เพื่อกรอก ID โมเดลด้วยตนเอง หรือคลิก "รับโมเดลที่พร้อมใช้งาน" ที่มุมขวาบน

การดำเนินการที่แนะนำ: ขอแนะนำให้คลิก "รับโมเดลที่พร้อมใช้งาน" ก่อน ให้ DeepSeek Harness ส่งคำขอไปยัง B.AI โดยตรงเพื่อรับรายการโมเดลที่บัญชีปัจจุบันใช้งานได้ หากรายการโมเดลสามารถส่งกลับมาได้ตามปกติ นั่นเป็นการพิสูจน์ว่า API Key ของ B.AI, https://api.b.ai/v1, โปรโตคอล openai-completions และอินเทอร์เฟซรายการโมเดลได้รับการเชื่อมต่อสำเร็จแล้ว

ข้อควรระวังในการเลือกและเพิ่มโมเดล:

• ในรายการที่ส่งกลับมา ให้เลือกโมเดล DeepSeek ที่ B.AI ใช้งานได้ในปัจจุบัน (ตัวอย่างในภาพเห็นได้ว่า deepseek-v4-flash หรือ deepseek-v4-pro โปรดทราบว่าโมเดลที่ใช้งานได้จริงจะเปลี่ยนแปลงแบบไดนามิกตามสิทธิ์ของบัญชีและเวลา โปรดยึดตามผลลัพธ์ที่ส่งกลับมาจริงเป็นหลัก)
• ห้ามแก้ไข ID โมเดล: ID โมเดลต้องตรงกับรายการที่ B.AI ส่งกลับมาจริงทุกประการ ห้ามเปลี่ยนแปลงตัวพิมพ์ใหญ่ ตัวพิมพ์เล็ก ยัติภังค์ หรือหมายเลขเวอร์ชันด้วยตนเอง มิฉะนั้น มีแนวโน้มสูงที่จะเกิดข้อผิดพลาด model not found ในการเรียกใช้งานครั้งต่อไป

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

หลังจากสร้างสำเร็จ หน้าตั้งค่าจะมี Custom Provider ใหม่ชื่อ B.AI เพิ่มขึ้นมา และมีจุดสีเขียวแสดงอยู่ข้างๆ ซึ่งหมายความว่า Custom Provider ของ B.AI ได้ถูกบันทึกสำเร็จและอยู่ในสถานะพร้อมใช้งาน หมายเหตุ: หากในเวลานี้ Provider อย่างเป็นทางการของ DeepSeek ยังคงแสดงจุดสีแดง สาเหตุมาจากยังไม่ได้กรอก API Key อย่างเป็นทางการของ DeepSeek ซึ่งไม่ส่งผลกระทบต่อการใช้งานอินเทอร์เฟซ B.AI ที่สอดคล้องกับจุดสีเขียวตามปกติ

ขั้นตอนที่ 5: การตรวจสอบความเชื่อมต่อของ链路

ปิดหน้าต่างการตั้งค่า กลับไปที่หน้าหลักเพื่อสร้างเซสชันใหม่ ในตัวเลือกโมเดล เลือก B.AI Provider จากนั้นเลือกโมเดล DeepSeek ที่เพิ่งเพิ่มเข้าไป เพื่อทำการทดสอบต่อไปนี้:

การทดสอบการสนทนาพื้นฐาน: เลือก B.AI และโมเดลที่เกี่ยวข้องในตัวเลือกโมเดล แล้วส่งคำสั่ง:

โปรดแนะนำตัวเองและระบุโมเดลที่กำลังใช้งานอยู่ในปัจจุบัน

สังเกตว่าสามารถส่งกลับเนื้อหาได้ตามปกติหรือไม่ มีการส่งออกแบบสตรีมมิ่งหรือไม่ พร้อมยืนยันว่า Provider ปัจจุบันคือ B.AI และ ID โมเดลตรงกับที่คุณเลือก

การทดสอบการเรียกใช้เครื่องมือ: ส่งคำสั่งแบบอ่านอย่างเดียวเพื่อตรวจสอบ链路ของเครื่องมือ:

โปรดดูไฟล์ในพื้นที่ทำงานปัจจุบันและสรุปโครงสร้างไดเรกทอรี ห้ามแก้ไขหรือลบไฟล์ใดๆ

การเน้นย้ำเป็นพิเศษในคำสั่งว่า "ห้ามแก้ไขหรือลบไฟล์ใดๆ" มีไว้เพื่อตรวจสอบอย่างปลอดภัยและรวดเร็วว่า链路การเรียกใช้เครื่องมือของ Harness ทำงานได้อย่างราบรื่นหรือไม่ โดยไม่เปลี่ยนแปลงพื้นที่ทำงานปัจจุบัน

ในระหว่างการทดสอบสองรายการข้างต้น โปรดหันกลับไปดูหน้าต่างเทอร์มินัลที่รัน DeepSeek Harness เพื่อยืนยันว่าคอนโซลไม่มีข้อผิดพลาด 401, 404, model not found หรือข้อผิด