omp (Oh My Pi) + JoinGonka Gateway: เอเจนต์พร้อมบทบาทโมเดล

ขั้นตอนที่ 1: ติดตั้ง omp วิธีอย่างเป็นทางการจาก README ของโปรเจกต์:

# macOS and Linux
curl -fsSL https://omp.sh/install | sh

# Homebrew
brew install can1357/tap/omp

# via Bun (requires Bun 1.3.14 or newer)
bun install -g @oh-my-pi/pi-coding-agent

# Windows (PowerShell)
irm https://omp.sh/install.ps1 | iex

ขั้นตอนที่ 2: รับคีย์ ลงทะเบียนที่ gate.joingonka.ai/register ยืนยันที่อยู่ของคุณ และสร้างคีย์ที่มีคำนำหน้า jg- ในส่วน «คีย์ API» คีย์เดียวและยอดคงเหลือเดียวใช้ได้กับทุกโมเดลในเครือข่าย

ขั้นตอนที่ 3: เรียกใช้ตัวติดตั้ง

npx @joingonka/setup --tool omp

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

• เขียนผู้ให้บริการ joingonka ลงใน ~/.omp/agent/models.yml: ที่อยู่เกตเวย์ โปรโตคอล openai-completions คีย์แบบ literal และสามโมเดลของเครือข่ายพร้อมหน้าต่างบริบทและเพดานการตอบกลับจริง ไฟล์จะได้รับสิทธิ์ 600
• ตั้งโมเดลเริ่มต้น — modelRoles.default ใน ~/.omp/agent/config.yml — เป็น DeepSeek V4 Flash แต่เฉพาะเมื่อบทบาทว่างเปล่าหรือชี้ไปยังโมเดลที่ออกจากเครือข่ายแล้ว: จะไม่แทรกแซงการเลือกของผู้อื่น แต่จะแนะนำวิธีสลับ
• ก่อนเขียนจะสำรองไฟล์เดิมไว้ ส่วนผู้ให้บริการ บทบาท และคอมเมนต์อื่น ๆ จะคงไว้เหมือนเดิม
• ในตอนท้ายจะส่งคำขอสดไปยังเกตเวย์และบอกตรง ๆ ว่าคีย์ ที่อยู่ และโมเดลได้รับการยอมรับหรือไม่

โมเดลเริ่มต้นอื่นกำหนดได้ด้วยแฟล็ก --model พร้อมตัวย่อ deepseek, glm หรือ minimax — โมเดลที่ระบุอย่างชัดเจนจะถูกเขียนเสมอ สำหรับ dotfile และเซิร์ฟเวอร์มีโหมดไม่ถามคำถาม ซึ่งคีย์จะถูกดึงจากตัวแปรสภาพแวดล้อม:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool omp --model glm --non-interactive

ตำแหน่งคอนฟิกที่ไม่ได้มาตรฐานตัวติดตั้งจะจัดการเอง: โปรไฟล์ที่มีชื่อ (OMP_PROFILE) และไดเรกทอรีเอเจนต์ที่ย้ายมา (PI_CODING_AGENT_DIR) ไฟล์ models.json แบบเดิมจะถูกย้ายไปยัง models.yml เช่นเดียวกับที่ omp เองจะทำ — ผู้ให้บริการเดิมจะไม่หายไป และถ้ามี settings.json เก่าอยู่ข้าง ๆ โดยไม่มี config.yml ตัวติดตั้งจะไม่สร้าง config.yml เพื่อให้ omp ไม่ข้ามการย้ายการตั้งค่าของตัวเอง: มันจะขอให้เรียกใช้ omp หนึ่งครั้งแล้วทำคำสั่งซ้ำ

ทุกสิ่งที่ตัวติดตั้งทำ คุณสามารถเขียนด้วยมือได้เลย มีอยู่สองไฟล์ และแต่ละไฟล์มีหน้าที่ของตัวเอง: models.yml อธิบายผู้ให้บริการและโมเดล ส่วน config.yml เก็บการตั้งค่า — รวมถึงว่าโมเดลไหนรับบทบาทไหน

# ~/.omp/agent/models.yml
providers:
  joingonka:
    baseUrl: https://gate.joingonka.ai/v1
    api: openai-completions
    apiKey: jg-your-key
    models:
      - id: deepseek-ai/DeepSeek-V4-Flash-0731
        name: DeepSeek V4 Flash (Gonka)
        input: [text]
        contextWindow: 380000
        maxTokens: 32768
        reasoning: true
      - id: zai-org/GLM-5.3-Flash
        name: GLM-5.3 Flash (Gonka)
        input: [text]
        contextWindow: 390000
        maxTokens: 8192
        reasoning: true
      - id: MiniMaxAI/MiniMax-M2.7
        name: MiniMax M2.7 (Gonka)
        input: [text]
        contextWindow: 200000
        maxTokens: 8192

# ~/.omp/agent/config.yml
modelRoles:
  default: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731

การใส่คีย์แบบลิตเทอรัลเป็นวิธีที่ปัญหาน้อยที่สุด: omp เริ่มทำงานได้จากทุกสภาพแวดล้อม และปิดการเข้าถึงไฟล์ได้ด้วยคำสั่ง chmod 600 ~/.omp/agent/models.yml หากอยากเก็บคีย์ไว้นอกไฟล์ ให้ใส่ชื่อตัวแปรลงใน apiKey เช่น JOINGONKA_API_KEY แล้ว export ในเชลล์ที่คุณใช้รัน omp — ลำดับการค้นหาคีย์แบบนี้คือสิ่งที่เอกสารของโปรเจกต์ระบุไว้

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

ตัวเลือกโมเดลเขียนในรูปแบบ provider/model-id ชื่อผู้ให้บริการจะถูกแยกที่เครื่องหมายทับตัวแรก ดังนั้น ID ของเครือข่ายที่มีเครื่องหมายทับของตัวเองจะเขียนตามจริง: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731 แทนที่จะแก้ config.yml คุณกำหนดบทบาทได้จากอินเทอร์เฟซ — ด้วยคำสั่ง /model ในเซสชัน หรือในตัวช่วย omp setup

ใน omp ไม่ได้มีการเลือกโมเดลเพียงหนึ่งเดียวสำหรับทุกอย่าง แต่เลือกตามบทบาท (roles) ซึ่งเป็นหัวใจสำคัญของการตั้งค่า บทบาทในตัวสำหรับโต้ตอบ: default, smol, slow, plan, commit, task, tiny, memory, advisor และ vision ไม่จำเป็นต้องกำหนดค่าทั้งหมด: smol และ slow ที่ไม่ได้กำหนดไว้จะดึงโมเดลของบทบาท default มาใช้ก่อน, sub-agents ที่ไม่มีบทบาท task จะทำงานบนโมเดลของเซสชันปัจจุบัน, ส่วน commit และ tiny จะตามหลัง smol การกำหนดค่าเพียงบรรทัดเดียวอย่าง default ก็ใช้งานได้เต็มรูปแบบแล้ว

การแบ่งบทบาทระหว่างโมเดลในเครือข่ายไม่ได้ทำเพื่อประหยัดต้นทุน — เนื่องจากราคาของ DeepSeek V4 Flash, GLM-5.3 Flash และ MiniMax M2.7 นั้นเท่ากัน — แต่ทำเพื่อพฤติกรรมและความจุ: โมเดลที่เน้นการใช้เหตุผล (reasoning) จะวางแผนได้ดีกว่า, โมเดลที่ตอบยาวได้ดีกว่าจะเขียนได้ดีกว่า, และงานเบื้องหลังเล็กๆ น้อยๆ ไม่จำเป็นต้องไปอยู่ในคิวเดียวกับงานหลัก

# ~/.omp/agent/config.yml
modelRoles:
  default: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
  slow: joingonka/zai-org/GLM-5.3-Flash
  plan: joingonka/zai-org/GLM-5.3-Flash
  tiny: joingonka/MiniMaxAI/MiniMax-M2.7

retry:
  fallbackChains:
    default:
      - joingonka/zai-org/GLM-5.3-Flash

บล็อก retry.fallbackChains คือประกันภัยในช่วงเวลาเร่งด่วน: เมื่อโมเดลหลักตอบกลับ 429 อย่างต่อเนื่อง omp จะส่งส่วนที่เหลือของขั้นตอนไปยังรายการถัดไปในสายโซ่ และกลับไปหาโมเดลหลักหลังจากหยุดพัก คีย์ของสายโซ่สามารถเป็นบทบาท, โมเดลเฉพาะ, หรือผู้ให้บริการทั้งหมด (joingonka/*) ก็ได้

ในการเรียกใช้หนึ่งครั้ง สามารถกำหนดบทบาทใหม่ได้ด้วยแฟล็ก: omp --model slow จะเริ่มเซสชันบนโมเดลบทบาท slow, และ --smol, --slow, --plan จะแทนที่โมเดลของบทบาทนั้นๆ ภายในเซสชัน Ctrl+P จะวนรอบโมเดลของบทบาท, และ /model จะเปิดตัวเลือกการเลือก; ในแท็บ Roles คุณสามารถกำหนดบทบาทและตัวสำรองได้เช่นกัน

ที่ค่าของบทบาท คุณสามารถเพิ่มระดับการคิดได้ — :low, :medium, :high นี่คือไวยากรณ์ของ omp ส่วนการที่โมเดลแต่ละตัวจะเข้าใจระดับนี้อย่างไรขึ้นอยู่กับตัวโมเดลเอง: ตัวอย่างเช่น GLM-5.3 Flash จะเป็นสวิตช์เลขฐานสอง — รายละเอียดอยู่ใน การรีวิวโมเดล และอีกหนึ่งรายละเอียดที่เป็นประโยชน์: คุณสามารถกำหนดบทบาทใหม่สำหรับที่เก็บข้อมูล (repository) หนึ่งแห่งโดยใช้ไฟล์ <repo>/.omp/config.yml ที่มีบล็อก modelRoles เดียวกัน ผู้ให้บริการและคีย์จะยังคงอยู่ในไดเรกทอรีหลัก (home directory) ดังนั้นคีย์จะไม่หลุดเข้าไปในที่เก็บข้อมูล

เริ่มจากตรวจสอบว่า omp มองเห็นผู้ให้บริการหรือไม่:

omp models joingonka

ระบบจะตอบกลับเป็นตารางสามบรรทัด แสดงหน้าต่างบริบทและเพดานคำตอบจาก models.yml โดยปัดเป็นหลักพัน (ตัวอย่างย่อ: จริง ๆ omp ยังมีคอลัมน์ thinking และ images อีก):

joingonka (3)
model                                context  max-out
deepseek-ai/DeepSeek-V4-Flash-0731      380K      33K
MiniMaxAI/MiniMax-M2.7                  200K     8.2K
zai-org/GLM-5.3-Flash                   390K     8.2K

ต่อไปลองรันแบบครั้งเดียวโดยไม่ใช้อินเทอร์เฟซ วางไฟล์ที่มีบั๊กชัด ๆ ไว้ในไดเรกทอรีว่าง แล้วสั่งให้มันหาบั๊ก:

omp -p "Read calc.py and tell me in one sentence whether it has a bug."

เอเจนต์ต้องเรียกเครื่องมืออ่านไฟล์เองและตอบตรงประเด็น พร้อมระบุว่านิพจน์ไหนมีบั๊ก ในการรันของเราเมื่อวันที่ 21 กันยายน 2026 ลูปนี้ — คำขอ เรียกเครื่องมือ ได้ผลลัพธ์ ตอบกลับ — ผ่านไปได้อย่างราบรื่นทั้ง DeepSeek V4 Flash และ GLM-5.3 Flash ส่วน MiniMax M2.7 โปรดดูแถวล่างของตารางด้านล่าง

การตรวจสอบที่สามคือมองจากฝั่งเกตเวย์: ในแดชบอร์ดที่หัวข้อ «การใช้งาน» คำขอจะปรากฏในมุมมอง «ตามโมเดล» และในบล็อก «ตามคีย์» เวลาของคำขอล่าสุดจะอัปเดต ถ้าตรงนั้นว่างเปล่า แปลว่า omp กำลังวิ่งไปหาผู้ให้บริการรายอื่น ลองดูว่าตั้งค่าที่บทบาทไว้อย่างไรด้วยคำสั่ง omp config get modelRoles

ถ้ามีอะไรผิดพลาดขึ้นมา โดยปกติแล้ววินิจฉัยได้จากข้อความแสดงข้อผิดพลาดตรง ๆ เลย:

เครื่องมือตัวแทน (Agentic tool) ใช้โทเค็นต่างจากการแชททั่วไป: ในทุกประโยคของคุณ omp จะเพิ่มระบบพร้อมท์ (system prompt) และคำอธิบายเครื่องมือเข้าไป ซึ่งงานมักจะต้องใช้หลายขั้นตอน ในการทดสอบของเรา แม้จะเปิดใช้งานแค่เครื่องมืออ่านไฟล์เพียงอย่างเดียว แต่ละขั้นตอนก็ใช้โทเค็นขาเข้าประมาณ 3,500 โทเค็น และถ้าใช้ครบทุกเครื่องมือก็จะมากกว่านั้น ดังนั้นราคาต่อโทเค็นจึงมีความสำคัญ

ผ่าน JoinGonka Gateway โทเค็นมีราคา $0.0069 ต่อล้านโทเค็นขาเข้า และ $0.021 ต่อล้านโทเค็นขาออก — ราคาเท่ากันสำหรับโมเดลทุกตัวในเครือข่ายและถูกดึงมาแสดงบนหน้านี้จากแหล่งข้อมูลจริง

ตัวเลขประมาณการในคอลัมน์ขวาอ้างอิงจากราคา ณ เดือนกันยายน 2026 สำหรับการเปรียบเทียบ — วิธีการชำระเงินสำหรับโมเดลใน omp มีดังนี้:

แถบสถานะของ omp จะแสดงการประมาณราคาของเซสชัน โดยคำนวณจากฟิลด์ cost ใน models.yml: ตัวติดตั้งจะใส่ราคาเกตเวย์ ณ เวลาที่ติดตั้งลงไป แต่เนื่องจากราคาดอลลาร์ในเครือข่ายผันผวนตามอัตราแลกเปลี่ยน GNK การประเมินนี้จึงเป็นเพียงแนวทางเท่านั้น การใช้งานจริงและยอดคงเหลือสามารถดูได้ในระบบจัดการ ในหัวข้อ "Usage" (การใช้งาน) และ "Billing" (การเรียกเก็บเงิน) สาเหตุที่เลือก DeepSeek V4 Flash เป็นค่าเริ่มต้นได้อธิบายไว้อย่างละเอียดใน บทวิเคราะห์โมเดล

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

omp config set tools.approvalMode write

ในโหมด write เอเจนต์จะขออนุญาตเฉพาะการรันคำสั่ง ส่วน always-ask จะขอเพิ่มสำหรับการเขียนด้วย สำหรับการรันครั้งเดียวสามารถกำหนดได้ด้วยแฟล็ก --approval-mode นี่เป็นคุณสมบัติของตัว omp เอง ไม่ได้ขึ้นอยู่กับผู้ให้บริการโมเดล

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

หลายสภาพแวดล้อม โปรไฟล์แบบมีชื่อ (omp --profile work หรือตัวแปร OMP_PROFILE) จะย้ายการตั้งค่าทั้งหมดไปที่ ~/.omp/profiles/<name>/agent สะดวกสำหรับแยกคีย์งานออกจากคีย์ส่วนตัว ไดเรกทอรีเอเจนต์ปัจจุบันดูได้จาก omp config path

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