Antigravity เป็นวงจร Agent ของมันแก้ไขไฟล์, รันคำสั่งเทอร์มินัล, อ่านผลลัพธ์ และตัดสินใจว่าจะทำอะไรต่อไป แล้วทำไมการทดสอบ API ของคุณจึงไม่อยู่ในวงจรนั้น? มันอยู่ใน Apidog หลัง GUI และจะทำงานเมื่อมีคนจำได้ว่าต้องคลิก Agent จะไม่แตะต้องสิ่งเหล่านั้นเลย
วิธีแก้คือบล็อกการตั้งค่าเพียงบล็อกเดียว Apidog CLI เป็นแพ็คเกจ npm ชื่อ apidog-cli ที่ใช้รันสถานการณ์การทดสอบที่คุณสร้างใน Apidog ได้โดยตรงจากเทอร์มินัล เมื่อติดตั้ง CLI แล้วและ Antigravity รู้ว่ามันมีอยู่จริง agent จะรันสถานการณ์ Apidog ในลักษณะเดียวกับที่มันรันการทดสอบยูนิตของคุณ: ยิงคำสั่ง, อ่านรหัสออก (exit code), แก้ไขโค้ดหากมันเป็นสีแดง
หากคุณยังไม่ได้ติดตั้ง CLI ให้ทำก่อน บทความ วิธีติดตั้ง Apidog CLI ด้วย AI coding agent จะแนะนำขั้นตอนการติดตั้ง npm, การยืนยันตัวตน และการรันครั้งแรก โดยมี agent ทำหน้าที่พิมพ์ให้ บทความนี้ถือว่า apidog --version พิมพ์ตัวเลขออกมา และบัญชี Apidog ของคุณได้รับการยืนยันตัวตนแล้ว
Antigravity ที่กล่าวถึงนี้คืออะไร
Antigravity คือแพลตฟอร์มการพัฒนาแบบ agentic ของ Google ที่สร้างบน Gemini 3 ซึ่งเปิดตัวเมื่อปลายปี 2025 มันรัน agent ผ่าน Agent Manager ที่วางแผนงาน, แก้ไขไฟล์ใน repository ของคุณ และรันคำสั่งเชลล์ในเทอร์มินัลและเบราว์เซอร์ของตัวเอง Agent เป็นส่วนหน้าหลัก และทำงานโดยตรงบนเครื่องของคุณ หากคุณเคยเปิด Antigravity, เริ่มงาน และเฝ้าดู agent รันคำสั่งและรายงานผลกลับมา คุณมาถูกที่แล้ว สำหรับภาพรวมที่กว้างขึ้น ดู ว่า Google Antigravity คืออะไรและใช้งานอย่างไร
ความแตกต่างนี้มีความสำคัญเพราะ Antigravity มีวิธีการเรียนรู้กฎของโปรเจกต์ของตัวเอง และกลไกนั้นเปลี่ยนคำสั่ง “รันการทดสอบของฉัน” แบบครั้งเดียวให้กลายเป็นสิ่งที่ agent จะหยิบมาใช้เอง
ขั้นตอนที่ 1: มอบไฟล์กฎ (rules file) ให้ Antigravity
Antigravity รู้จักไดเรกทอรีพิเศษ .agents/ ที่ root ของพื้นที่ทำงานของคุณ โค้ดแล็บของ Google เกี่ยวกับ การสร้าง autonomous developer pipelines ใน Antigravity แสดงให้เห็นว่า agent สามารถหยิบไฟล์ที่คุณวางไว้ที่นั่นได้โดยธรรมชาติ และกฎของพื้นที่ทำงานจะอยู่ใน .agents/rules/ วางกฎโปรเจกต์ของคุณในไฟล์เช่น .agents/rules/apidog.md Antigravity ยังอ่านไฟล์ AGENTS.md แบบธรรมดาที่ root ของพื้นที่ทำงานเป็นพื้นฐานข้ามเครื่องมือ ซึ่งเป็นไฟล์เดียวกับที่ Codex อ่านสำหรับ Apidog CLI; หากคุณมีไฟล์นี้อยู่แล้ว ให้เพิ่มบล็อก Apidog ที่นั่นแทนที่จะต้องดูแลสองไฟล์
ใส่บล็อก Apidog สั้นๆ ในไฟล์กฎนั้น ประมาณนี้:
## การทดสอบ API ด้วย Apidog CLI
- ในการทดสอบ API ให้รันสถานการณ์ Apidog อย่าคลิกผ่าน GUI
- คำสั่ง: apidog run -t <scenario_id> -e <env_id> -r cli
- รหัสออก 0 หมายความว่าการยืนยันทั้งหมดผ่าน ไม่ใช่ 0 หมายถึงความล้มเหลว; เปิดรายงานและแก้ไขโค้ด
- เครื่องนี้ได้รับการยืนยันตัวตนแล้วผ่าน apidog login ห้ามเพิ่มแฟล็ก --access-token และห้ามใส่โทเค็นในไฟล์นี้นี่คือเหตุผลที่คุณเขียน CLI ลงในไฟล์กฎแทนที่จะกล่าวถึงในแชท Antigravity ไม่จดจำสิ่งที่คุณสอนระหว่างเซสชัน; ปิดหน้าต่าง, เปิดใหม่, และการสอนนั้นก็หายไป ID สถานการณ์ที่พิมพ์ลงในแชทจะหายไปเมื่อเซสชันสิ้นสุดลง สิ่งที่เขียนลงในไฟล์กฎของคุณจะยังคงอยู่สำหรับเพื่อนร่วมทีมทุกคนและทุกการรัน Antigravity นับจากนี้ไป
ขั้นตอนที่ 2: รับคำสั่งจาก Apidog
คุณไม่จำเป็นต้องเดา ID สถานการณ์และ ID สภาพแวดล้อม เปิดสถานการณ์การทดสอบใน Apidog ไปที่แท็บ CI/CD แล้วคัดลอกคำสั่งที่สร้างขึ้น มันจะมีลักษณะดังนี้:
apidog run -t 123456 -e 789012 -r cliแฟล็ก -t คือ ID สถานการณ์การทดสอบ, -e คือ ID สภาพแวดล้อม และ -r cli เลือกตัวรายงานที่พิมพ์ผลลัพธ์แบบอินไลน์ วาง ID จริงเหล่านั้นลงในบล็อก .agents/rules/apidog.md ของคุณ เพื่อให้ agent รันคำสั่งที่ Apidog ให้มาอย่างถูกต้อง สำหรับแฟล็กแต่ละตัว ดู การอ้างอิงคำสั่ง apidog run
ขั้นตอนที่ 3: ให้ agent รันการทดสอบ
เมื่อบล็อกพร้อมใช้งาน ให้เริ่มงานใน Antigravity Agent จะโหลดกฎของคุณเมื่อมันเริ่มทำงาน ดังนั้นมันจึงรู้แล้วว่า CLI อยู่ที่นั่น ทำการเปลี่ยนแปลงที่เกี่ยวข้องกับ API ของคุณ หรือเพียงแค่ขอให้มันรันการตรวจสอบ:
Run the Apidog test scenario and tell me the exit code.agent จะออกคำสั่ง apidog run จากไฟล์กฎของคุณในเทอร์มินัลของมันเอง การที่มันจะรันโดยไม่ถามหรือไม่นั้นขึ้นอยู่กับการตั้งค่าสิทธิ์ของคุณ การตั้งค่าความปลอดภัยล่วงหน้า (Security Preset) ของ Antigravity จะกำหนดว่าคำสั่งเทอร์มินัลและการเข้าถึงไฟล์จะถูกตรวจสอบโดยคุณก่อนที่ agent จะดำเนินการหรือไม่ ดังที่อธิบายไว้ใน โค้ดแล็บเริ่มต้นใช้งาน Antigravity ของ Google หากการตั้งค่าล่วงหน้าขอการตรวจสอบ ให้คุณอนุมัติคำสั่ง apidog run เมื่อมีข้อความแจ้งเตือน; สถานการณ์การทดสอบแบบอ่านอย่างเดียวที่ใช้กับ staging เป็นประเภทของคำสั่งที่ปลอดภัยในพื้นที่ทำงานที่สามารถอนุมัติได้อย่างเหมาะสม หากคุณตั้งค่าให้ agent ดำเนินการเอง มันจะรันคำสั่งและรายงานผลกลับมาโดยไม่หยุด
คุณต้องการเห็นการรันที่กำลังดำเนินการอยู่ และ agent รายงานทั้งสรุปและรหัสออก ไม่ใช่การตีความใหม่
ขั้นตอนที่ 4: อ่านรายงานภายใน Antigravity
เมื่อการรันเป็นสีแดง (ล้มเหลว) รายงานจะมีคำตอบ ด้วย -r cli, agent จะได้รับรายละเอียดที่อ่านง่ายในเทอร์มินัลของมัน: แต่ละคำขอ, แต่ละการยืนยัน และอันไหนที่ล้มเหลวพร้อมกับค่าที่คาดหวังเทียบกับค่าจริง การยืนยันที่ล้มเหลวจะระบุชื่อฟิลด์หรือรหัสสถานะที่แน่นอน ซึ่งมักจะเพียงพอให้ agent ค้นหาและแก้ไขได้
สำหรับรายงานที่คุณสามารถเปิดในเบราว์เซอร์หรือส่งให้เพื่อนร่วมทีม ให้เพิ่ม HTML reporter:
apidog run -t 123456 -e 789012 -r cli,htmlHTML reporter จะเขียนไฟล์ที่สมบูรณ์ในตัวเองไปยัง ./apidog-reports ให้เก็บ cli ไว้ในรายการ เพื่อให้ agent ยังคงได้รับผลลัพธ์แบบอินไลน์ที่มันอ่านเพื่อตัดสินใจขั้นตอนต่อไป สำหรับชุดของ reporter ทั้งหมด รวมถึงรูปแบบ JUnit ที่แดชบอร์ด CI สามารถแยกวิเคราะห์ได้ ดู คู่มือ Apidog CLI ฉบับสมบูรณ์ และ วิธีอ่านรายงานการทดสอบ Apidog CLI
การทดสอบ Antigravity ภายในวงจรของตัวเอง
ประเด็นคือจะเกิดอะไรขึ้นเมื่อคุณหยุดถาม และ agent รันสถานการณ์ด้วยตัวเองเพราะไฟล์กฎได้สั่งให้ทำ
ลองนึกภาพ agent กำลังแก้ไข handler ที่สร้างการตอบสนองการเช็คเอาต์ วงจรของมันเปลี่ยนไป มันแก้ไขโค้ด จากนั้น แทนที่จะประกาศชัยชนะ มันรันสถานการณ์ Apidog ของคุณกับ staging, อ่านรหัสออก และดำเนินการตามนั้น ถ้าเขียว มันก็ไปต่อ ถ้าแดง มันก็เปิดรายงาน, อ่านว่าการยืนยันใดล้มเหลว (รหัสสถานะ, ฟิลด์ที่หายไป, ค่าที่ไม่ถูกต้อง), ลองแก้ไข และรันใหม่ การทดสอบ API กลายเป็นส่วนหนึ่งของวงจรแก้ไข-ทดสอบ-แก้ไขเดียวกันกับที่ agent รันการทดสอบยูนิตของคุณอยู่แล้ว คุณเขียนคำสั่งเดียวและ agent ก็รวมคำสั่งนั้นเข้ากับวิธีการทำงานของมัน
นี่คือโมเดล delegate-then-verify ที่ทำให้เวิร์กโฟลว์ของ agent ปลอดภัย Antigravity รันคำสั่งและอ่านผลลัพธ์; คุณยังคงสร้างสถานการณ์ด้วยภาพใน Apidog และตรวจสอบว่า agent อ่านรหัสออกอย่างถูกต้อง สำหรับรูปแบบที่กว้างขึ้น ดู วิธีใช้ AI agents สำหรับการทดสอบ API และ Apidog AI test harness
ยืนยันว่า Antigravity กำลังรัน CLI จริงๆ
Agents รายงานความสำเร็จที่พวกเขาไม่ได้ทำ และ Antigravity ก็ไม่มีข้อยกเว้น มีการตรวจสอบสามอย่าง ตามลำดับความถี่ที่พวกเขาพบปัญหา
ประการแรก ยืนยันว่าคำสั่งได้รันไปเลย Antigravity แสดงคำสั่งที่รันและผลลัพธ์ในเทอร์มินัลของมัน มองหาบรรทัด apidog run ... ที่ตรงตัวและผลลัพธ์ภายใต้มัน หาก agent บอกว่ารันการทดสอบแล้ว แต่คุณไม่เห็นคำสั่ง แสดงว่ามันสรุปสิ่งที่มันไม่เคยทำไปแล้ว ขอให้มันรันอีกครั้งและแสดงผลลัพธ์ดิบ
ประการที่สอง ยืนยันรหัสออก (exit code) ซึ่งเป็นสิ่งสำคัญ ถามโดยตรง:
What was the exit code of that apidog run command?apidog run จะออกด้วยรหัส 0 เมื่อการยืนยันทั้งหมดผ่าน และไม่ใช่ 0 เมื่อมีสิ่งใดล้มเหลว พฤติกรรมเดียวนี้ทำให้ agent หรือ pipeline สามารถถือว่าการรันนั้นเป็นประตูที่สะอาด เมื่อข้อความของ agent บอกว่า “การทดสอบผ่านแล้ว” แต่รหัสออกไม่เป็นศูนย์ รหัสออกคือสิ่งที่ถูกต้อง
ประการที่สาม ยืนยันว่ามันใช้สถานการณ์จริง หากการรันล้มเหลวด้วยข้อความ “scenario not found” agent อาจสร้างหรือจำ ID ผิด ตรวจสอบค่า -t และ -e อีกครั้งกับไฟล์กฎของคุณและคำสั่งที่ Apidog สร้างในแท็บ CI/CD ID ในไฟล์กฎของคุณคือความจริง
ทางเลือก: เชื่อมต่อเซิร์ฟเวอร์ Apidog MCP
การรัน apidog run จากไฟล์กฎของคุณครอบคลุมสิ่งที่คุณต้องการส่วนใหญ่ หากต้องการไปต่อ ให้เชื่อมต่อเซิร์ฟเวอร์ MCP
Antigravity รองรับ Model Context Protocol และเซิร์ฟเวอร์ MCP ของมันถูกกำหนดค่าในไฟล์ $HOME/.gemini/config/mcp_config.json ตาม โค้ดแล็บเริ่มต้นใช้งาน ของ Google คุณเพิ่มเซิร์ฟเวอร์เป็นรายการในออบเจกต์ mcpServers ของไฟล์นั้น พร้อมด้วย command, args และ env จากนั้นรีเฟรช MCP ในการตั้งค่า Antigravity เซิร์ฟเวอร์ Apidog MCP เปิดเผยข้อกำหนด API ของคุณผ่าน MCP เพื่อให้ agent สามารถอ่านสคีมาของคุณในขณะที่เขียนโค้ด ไม่ใช่แค่หลังจากนั้น CLI รันการทดสอบ; MCP ป้อนข้อมูลสเปกให้กับ agent
เมื่อ Antigravity ทำผิดพลาด
ความล้มเหลวบางอย่างมักปรากฏขึ้นบ่อยครั้งในระหว่างการตั้งค่า
มันเพิกเฉยต่อไฟล์กฎ หาก agent รันคำสั่งทั่วไปหรือไม่รันเลย แสดงว่ากฎอาจไม่ได้โหลด ยืนยันว่าไฟล์ชื่อถูกต้องและอยู่ในตำแหน่งที่ Antigravity คาดหวังสำหรับพื้นที่ทำงานของคุณ จากนั้นเริ่มงานใหม่เพื่อให้มันอ่านกฎอีกครั้ง
มันส่ง access token ไปอยู่ดี หาก agent พยายามเพิ่ม --access-token แสดงว่ามันกำลังเดาจากตัวอย่างสาธารณะ บล็อกกฎของคุณได้บอกไว้แล้วว่าไม่ต้องทำเช่นนั้น เนื่องจากเครื่องได้รับการยืนยันตัวตนผ่าน apidog login ย้ำบรรทัดนั้น และห้ามใส่โทเค็นจริงในไฟล์กฎ สำหรับวิธีการทำงานของการยืนยันตัวตนที่แท้จริง ดู การยืนยันตัวตน Apidog CLI
มันสร้างแฟล็กขึ้นมาเอง ข้อผิดพลาด “unknown option” หมายความว่า agent เดาแฟล็กที่เวอร์ชันของคุณไม่มี บอกให้มันรัน apidog run --help และคัดลอกแฟล็กที่แน่นอนจากที่นั่น ซึ่งจะถูกต้องเสมอสำหรับเวอร์ชันที่คุณติดตั้ง
มันรายงานว่าผ่านในการรันที่ล้มเหลว นี่คือข้อผิดพลาดที่แพงที่สุด และเป็นเหตุผลว่าทำไมกฎ exit-code จึงอยู่ในไฟล์กฎของคุณและขั้นตอนการตรวจสอบของคุณ เมื่อสรุปและรหัสออกไม่ตรงกัน รหัสออกคือสิ่งที่ถูกต้อง
จาก agent รายวันสู่วงจรที่ผ่านการทดสอบ
นั่นคือการตั้งค่า ติดตั้ง apidog-cli เพียงครั้งเดียวตาม คู่มือการติดตั้ง เพิ่มบล็อก Apidog สั้นๆ ลงในไฟล์กฎ Antigravity ของคุณ และ agent ก็จะรู้วิธีรันการทดสอบ API ของคุณและอ่านผลลัพธ์ภายในวงจรเดียวกับที่มันใช้อยู่แล้วในการแก้ไขโค้ด Endpoint ที่เสียจะถูกตรวจพบในขณะที่ agent ยังคงทำงานกับการเปลี่ยนแปลง ไม่ใช่หลังจากที่ส่งมอบไปแล้ว
การทดสอบที่อยู่หลัง GUI จะทำงานเมื่อมนุษย์คลิก; คำสั่งบรรทัดเดียวจะทำงานเมื่อ Antigravity ตัดสินใจ คุณยังคงสร้างสถานการณ์ด้วยภาพใน Apidog และ agent ของคุณจะรันสิ่งเหล่านั้นในที่ที่คุณไม่ได้เฝ้าดู ดาวน์โหลด Apidog สร้างสถานการณ์เดียว วางคำสั่ง apidog run ลงในไฟล์กฎของคุณ และดู agent หยิบมันขึ้นมาในการเปลี่ยนแปลงครั้งต่อไป เมื่อคุณพร้อมที่จะรันคำสั่งเดียวกันใน pipeline โดยไม่มี agent อยู่ Apidog CLI ใน GitHub Actions จะครอบคลุมถึงความลับ, reporters และการจำกัดด้วย exit-code