Cline เป็นวงจร: มันวางแผนการเปลี่ยนแปลง แก้ไขไฟล์ รันคำสั่ง อ่านผลลัพธ์ และตัดสินใจว่าจะทำอะไรต่อไป แล้วทำไมการทดสอบ API ของคุณถึงไม่อยู่ในวงจรนั้นล่ะ มันอยู่ใน Apidog หลัง GUI รอให้ใครบางคนจำได้ที่จะคลิก เอเจนต์ของคุณไม่เคยแตะต้องพวกมันเลย
การแก้ไขนั้นเพียงแค่บล็อกการกำหนดค่าเดียว Apidog CLI เป็นแพ็คเกจ npm ชื่อ apidog-cli ซึ่งรันสถานการณ์การทดสอบที่คุณสร้างไว้ใน Apidog ได้โดยตรงจากเทอร์มินัล เมื่อติดตั้ง CLI แล้วและ Cline รู้ว่ามีอยู่จริง เอเจนต์ของคุณก็จะรันสถานการณ์ Apidog ในแบบเดียวกับที่รันการทดสอบหน่วยของคุณ: รันคำสั่ง อ่านรหัสทางออก และแก้ไขโค้ดหากผลลัพธ์ออกมาเป็นสีแดง
หากคุณยังไม่ได้ติดตั้ง CLI ให้ทำสิ่งนั้นก่อน วิธีติดตั้ง Apidog CLI ด้วย AI coding agent จะอธิบายขั้นตอนการติดตั้ง npm การยืนยันตัวตน และการรันครั้งแรก โดยมี Cline เป็นผู้พิมพ์บทความนี้สมมติว่า apidog --version แสดงตัวเลขและบัญชี Apidog ของคุณได้รับการยืนยันตัวตนแล้ว
Cline ที่กำลังกล่าวถึง
Cline เป็นเอเจนต์การเขียนโค้ดแบบอิสระแบบโอเพนซอร์สที่ทำงานเป็นส่วนขยายของ VS Code (มีเวอร์ชันสำหรับ JetBrains และ CLI ด้วย) มันอ่านพื้นที่เก็บข้อมูลของคุณ วางแผนในโหมด Plan จากนั้นเปลี่ยนไปโหมด Act เพื่อแก้ไขไฟล์และรันคำสั่งเชลล์ โดยจะขอการอนุมัติขึ้นอยู่กับการตั้งค่าการอนุมัติอัตโนมัติของคุณ มันไม่ใช่แชทบอทแบบโฮสต์ โมเดลจะทำงานกับโค้ดเบสของคุณบนเครื่องของคุณ หากคุณเปิดแผง Cline ใน VS Code และมันแสดงความแตกต่างและผลลัพธ์จากเทอร์มินัลในขณะที่ทำงานอยู่ แสดงว่าคุณมาถูกที่แล้ว วิธีใช้ Cline ครอบคลุมพื้นฐานของการติดตั้งและการเลือกรุ่นโมเดล
ความแตกต่างนี้สำคัญเพราะ Cline มีวิธีของตัวเองในการเรียนรู้กฎของโปรเจกต์ และกลไกนี้จะเปลี่ยนจาก "รันการทดสอบของฉัน" แบบครั้งเดียว ให้กลายเป็นสิ่งที่ Cline สามารถทำได้เอง กลไกนั้นคือไดเรกทอรี .clinerules/
ขั้นตอนที่ 1: เพิ่มกฎลงใน .clinerules ไม่ใช่การเตือนในแชท
Cline โหลดกฎของโปรเจกต์จากไดเรกทอรี .clinerules/ ที่ root ของพื้นที่ทำงานของคุณก่อนที่จะเริ่มงาน มันอ่านไฟล์ .md และ .txt ทุกไฟล์ในโฟลเดอร์นั้นและรวมเข้าด้วยกันเป็นชุดคำสั่งที่ใช้ตลอดเซสชัน คุณยังสามารถใช้ไฟล์ .clinerules เดียวได้หากต้องการ แต่ไดเรกทอรีจะปรับขนาดได้ดีกว่าเมื่อกฎของคุณมีมากขึ้น สิ่งนี้มีบันทึกไว้ใน เอกสารอ้างอิงกฎ Cline
สร้างไฟล์เช่น .clinerules/apidog.md ที่ root ของ repo ของคุณพร้อมบล็อกสั้นๆ ดังนี้:
# การทดสอบ API ด้วย Apidog
- หากต้องการทดสอบ API ให้รัน Apidog CLI ไม่ใช่ curl หรือสคริปต์เฉพาะกิจ
- คำสั่ง: apidog run -t <scenario_id> -e <env_id> -r cli
- ID ของสถานการณ์และ ID ของสภาพแวดล้อมมาจากแท็บ CI/CD ของ Apidog ใช้ค่าเหล่านั้นให้ถูกต้อง
- รหัสทางออก 0 หมายถึงทุกการยืนยันผ่านหมด รหัสที่ไม่ใช่ศูนย์หมายถึงความล้มเหลว; รหัสทางออกคือแหล่งที่มาของความจริง ไม่ใช่สรุปของคุณ
- เครื่องนี้ได้รับการยืนยันตัวตนแล้วผ่าน `apidog login` ห้ามเพิ่ม --access-token และห้ามใส่โทเค็นในไฟล์นี้เด็ดขาด
- หากแฟล็กไม่รู้จัก ให้รัน `apidog run --help` และใช้แฟล็กที่ถูกต้องจากที่นั่น
นี่คือเหตุผลที่คุณเขียน CLI ลงใน .clinerules/ แทนที่จะพูดถึงในแชท ID สถานการณ์ที่พิมพ์ในข้อความ Cline จะหายไปเมื่อภารกิจสิ้นสุดลง แต่ ID ที่อยู่ใน .clinerules/apidog.md จะอยู่ตรงนั้นสำหรับเพื่อนร่วมทีมทุกคนที่ดึง repo นี้ไปและสำหรับทุกภารกิจของ Cline ตั้งแต่นี้เป็นต้นไป ไฟล์นี้มีการควบคุมเวอร์ชัน ดังนั้นกฎนี้จะเดินทางไปพร้อมกับโค้ด
ขั้นตอนที่ 2: รับคำสั่งจาก Apidog
คุณต้องการคำสั่ง apidog run ที่ถูกต้อง ไม่ใช่คำสั่งที่คาดเดาขึ้นมา เปิดสถานการณ์การทดสอบใน Apidog ไปที่แท็บ CI/CD และคัดลอกคำสั่งที่สร้างขึ้นมา มันจะมีลักษณะดังนี้:
apidog run -t 8291 -e 42 -r cli
ค่า -t คือ ID สถานการณ์ทดสอบของคุณ และ -e คือ ID สภาพแวดล้อม นี่คือค่าที่ถูกต้องที่ควรอยู่ใน .clinerules/apidog.md วางค่าเหล่านั้นลงในบล็อกกฎเพื่อให้ Cline มี ID ที่ถูกต้องอยู่เสมอ สำหรับชุดแฟล็กทั้งหมด โปรดดู เอกสารอ้างอิงคำสั่ง apidog run
ขั้นตอนที่ 3: ให้ Cline รันการทดสอบ
เมื่อมีกฎอยู่แล้ว ให้เริ่มงานในแผง Cline Cline จะโหลด .clinerules/ เมื่อเริ่มต้น ดังนั้นมันจึงรู้แล้วว่ามี CLI อยู่ ทำการเปลี่ยนแปลงที่เกี่ยวข้องกับ API ของคุณ หรือเพียงแค่ขอให้มันรันการตรวจสอบ:
รันสถานการณ์ทดสอบ Apidog และบอกผลลัพธ์ให้ฉันทราบ
Cline จะวางแผนขั้นตอน จากนั้นเปลี่ยนไปสู่โหมด Act เพื่อออกคำสั่ง apidog run จากกฎของคุณ การถามมากน้อยแค่ไหนนั้นขึ้นอยู่กับการตั้งค่าการอนุมัติของคุณ Cline จะประเมินแต่ละคำสั่งและทำเครื่องหมายว่าเป็นปลอดภัยหรือต้องได้รับการอนุมัติ สถานการณ์การทดสอบแบบอ่านอย่างเดียวกับสภาพแวดล้อม staging เป็นคำสั่งที่ถือว่าปลอดภัย หากการตั้งค่าการอนุมัติอัตโนมัติของคุณอนุญาตให้คำสั่งที่ปลอดภัยทำงานได้ apidog run จะทำงานโดยไม่ต้องมีข้อความแจ้ง หากไม่ Cline จะหยุดและถาม; อนุมัติมัน และเปิดการอนุมัติอัตโนมัติสำหรับ execute-safe-commands หากคุณต้องการให้มันรันสถานการณ์ในอนาคตด้วยตัวเอง ตัวรายงาน -r cli จะพิมพ์ผลลัพธ์ทีละขั้นตอนและสรุปในเทอร์มินัล ที่คุณสามารถดูคำขอและการยืนยันแต่ละครั้งในขณะที่มันเกิดขึ้น
ขั้นตอนที่ 4: อ่านรายงานภายใน Cline
เมื่อการรันไม่ผ่าน (ขึ้นสีแดง) รายงานจะมีคำตอบ ด้วย -r cli Cline จะได้รับรายละเอียดที่อ่านง่ายในแผงแสดงผลของเทอร์มินัล: แต่ละคำขอ การยืนยันแต่ละรายการ และรายการที่ล้มเหลว พร้อมค่าที่คาดหวังเทียบกับค่าจริง การยืนยันที่ล้มเหลวจะระบุชื่อฟิลด์หรือรหัสสถานะที่แน่นอน ซึ่งโดยปกติแล้วเพียงพอสำหรับ Cline ที่จะหาวิธีแก้ไขในการทำงานครั้งต่อไป
สำหรับรายงานที่คุณสามารถเปิดในเบราว์เซอร์หรือส่งให้เพื่อนร่วมทีมได้ ให้เพิ่มตัวรายงาน HTML:
apidog run -t 8291 -e 42 -r cli,html
ตัวรายงาน html จะเขียนไฟล์ที่สมบูรณ์ในตัวเองไปที่ ./apidog-reports ให้เก็บ cli ไว้ในรายการเพื่อให้ Cline ยังคงได้รับผลลัพธ์แบบอินไลน์ที่ใช้อ่านเพื่อตัดสินใจขั้นตอนต่อไป สำหรับแฟล็กและตัวรายงานทุกชนิด รวมถึงรูปแบบ JUnit ที่แดชบอร์ด CI สามารถอ่านได้ โปรดดู คู่มือ Apidog CLI ฉบับสมบูรณ์ และ คู่มือรายงานการทดสอบ Apidog CLI
Cline ทดสอบในวงจรของตัวเอง
ผลตอบแทนคือสิ่งที่เกิดขึ้นเมื่อคุณหยุดถาม และ Cline รันสถานการณ์ด้วยตัวเองเพราะ .clinerules/ บอกให้มันทำ
ลองจินตนาการว่า Cline กำลังแก้ไขตัวจัดการที่สร้างการตอบกลับการชำระเงิน วงจรของมันเปลี่ยนไป: มันแก้ไขโค้ด จากนั้น แทนที่จะประกาศชัยชนะ มันจะรันสถานการณ์ Apidog ของคุณกับสภาพแวดล้อม staging อ่านรหัสทางออก และดำเนินการตามนั้น หากผ่าน (สีเขียว) มันก็ดำเนินการต่อไป หากไม่ผ่าน (สีแดง) มันจะเปิดรายงาน อ่านว่าการยืนยันใดล้มเหลว (รหัสสถานะ ฟิลด์ที่หายไป ค่าที่ไม่ถูกต้อง) ลองแก้ไข และรันใหม่ การทดสอบ API กลายเป็นส่วนหนึ่งของวงจรแก้ไข-ทดสอบ-แก้ไขเดียวกันกับที่ Cline ใช้รันการทดสอบหน่วยของคุณอยู่แล้ว คุณเขียนคำสั่งเดียวและ Cline ก็รวมคำสั่งนั้นเข้ากับวิธีการทำงานของมันแล้ว
นี่คือโมเดลการมอบหมายแล้วตรวจสอบ (delegate-then-verify) ที่ทำให้เวิร์กโฟลว์ของเอเจนต์ปลอดภัย Cline รันคำสั่งและอ่านผลลัพธ์; คุณยังคงสร้างสถานการณ์ด้วยภาพใน Apidog และตรวจสอบว่าเอเจนต์อ่านรหัสทางออกอย่างซื่อสัตย์ สำหรับรูปแบบที่กว้างขึ้น โปรดดู วิธีใช้เอเจนต์ AI สำหรับการทดสอบ API และ ชุดทดสอบ Apidog AI
ตรวจสอบว่า Cline รัน CLI จริงๆ
เอเจนต์รายงานความสำเร็จที่ไม่ได้มาด้วยตัวเอง และ Cline ก็ไม่ใช่ข้อยกเว้น มีการตรวจสอบสามอย่าง ตามลำดับความถี่ที่พบปัญหา
ประการแรก ยืนยันว่าคำสั่งได้รันจริงหรือไม่ Cline จะแสดงคำสั่งที่ดำเนินการและผลลัพธ์ของมันในมุมมองงาน มองหาบรรทัด apidog run ... และผลลัพธ์ใต้บรรทัดนั้น หาก Cline บอกว่ารันการทดสอบแล้วแต่คุณไม่เห็นคำสั่ง แสดงว่ามันสรุปสิ่งที่มันไม่เคยทำ ขอให้มันรันอีกครั้งและแสดงผลลัพธ์ดิบ
ประการที่สอง ยืนยันรหัสทางออก ซึ่งเป็นสิ่งสำคัญที่สุด:
รหัสทางออกของคำสั่ง apidog run นั้นคืออะไร?
apidog run จะส่งคืนค่า 0 เมื่อทุกการยืนยันผ่าน และค่าที่ไม่ใช่ศูนย์เมื่อมีสิ่งใดล้มเหลว พฤติกรรมเดียวนี้ทำให้ Cline หรือไปป์ไลน์สามารถถือว่าการรันนั้นเป็นประตูที่สะอาด เมื่อข้อความของ Cline ระบุว่า "การทดสอบผ่าน" แต่รหัสทางออกไม่ใช่ศูนย์ รหัสทางออกคือสิ่งที่ถูกต้อง
ประการที่สาม ยืนยันว่ามันใช้สถานการณ์จริง หากการรันล้มเหลวด้วยข้อความ "scenario not found" (ไม่พบสถานการณ์) Cline อาจสร้างหรือจำ ID ผิด ตรวจสอบค่า -t และ -e กับ .clinerules/apidog.md และคำสั่งที่ Apidog สร้างขึ้นในแท็บ CI/CD อีกครั้ง ID ในไฟล์กฎคือความจริง
ทางเลือก: เชื่อมต่อเซิร์ฟเวอร์ Apidog MCP
การรัน apidog run จาก .clinerules/ ครอบคลุมสิ่งที่คุณต้องการส่วนใหญ่ แต่มีอีกวิธีหนึ่งที่ไปได้ไกลกว่านั้น
Cline มีการสนับสนุนระดับเฟิร์สคลาสสำหรับ Model Context Protocol ในส่วนขยาย VS Code ให้คลิกไอคอน MCP Servers ในแผง Cline เปิด Configure และคลิก Configure MCP Servers เพื่อเปิด cline_mcp_settings.json; เพิ่มเซิร์ฟเวอร์ของคุณภายใต้ออบเจกต์ mcpServers คุณยังสามารถเรียกดู MCP Marketplace ภายใน Cline เพื่อติดตั้งเซิร์ฟเวอร์โดยไม่ต้องแก้ไข JSON ด้วยตนเอง ตามที่อธิบายไว้ใน เอกสารประกอบ Cline MCP เซิร์ฟเวอร์ Apidog MCP เปิดเผยข้อกำหนด API ของคุณผ่าน MCP ดังนั้น Cline จึงสามารถอ่าน Schema ของคุณในขณะที่เขียนโค้ด ไม่ใช่แค่หลังจากนั้น CLI รันการทดสอบ; MCP ป้อนข้อมูลสเปคให้เอเจนต์
Cline เป็นส่วนขยายแบบโต้ตอบ ดังนั้นจึงไม่มีโหมดการทดสอบแบบไม่โต้ตอบในตัวเหมือนที่รันเนอร์แบบไม่มีส่วนหัวจะให้คุณ หากต้องการรัน apidog run ในไปป์ไลน์โดยไม่มี Cline อยู่ Apidog CLI ใน GitHub Actions ครอบคลุมเรื่องความลับ ตัวรายงาน และการควบคุมรหัสทางออก และ คู่มือไปป์ไลน์ Apidog CLI CI/CD ครอบคลุมการตั้งค่าที่กว้างขึ้น
เมื่อ Cline ทำผิดพลาด
ความล้มเหลวบางอย่างมักจะปรากฏขึ้นบ่อยครั้งในระหว่างการตั้งค่า
มันละเว้นไฟล์กฎ หาก Cline รันคำสั่งทั่วไปหรือไม่รันเลย กฎอาจไม่ถูกโหลด ยืนยันว่าโฟลเดอร์ชื่อ .clinerules อย่างถูกต้องและอยู่ใน root ของพื้นที่ทำงานของคุณ และไฟล์ภายในโฟลเดอร์นั้นลงท้ายด้วย .md หรือ .txt การเริ่มต้นงานใหม่จะบังคับให้ Cline โหลดกฎใหม่
มันส่งโทเค็นการเข้าถึงอยู่ดี หาก Cline พยายามเพิ่ม --access-token แสดงว่ามันเดาจากตัวอย่างสาธารณะ กฎได้บอกมันแล้วว่าจะไม่ทำเช่นนั้น เนื่องจากเครื่องได้รับการยืนยันตัวตนผ่าน apidog login ย้ำบรรทัดนั้น และห้ามใส่โทเค็นจริงใน .clinerules/ สำหรับวิธีการยืนยันตัวตนที่แท้จริง โปรดดู คู่มือการยืนยันตัวตน Apidog CLI
มันสร้างแฟล็กขึ้นมาเอง ข้อผิดพลาด "unknown option" หมายความว่า Cline เดาแฟล็กที่เวอร์ชันของคุณไม่มี บอกให้มันรัน apidog run --help และคัดลอกแฟล็กที่ถูกต้องจากที่นั่น ซึ่งจะถูกต้องเสมอสำหรับเวอร์ชันที่คุณติดตั้ง
มันรายงานว่าผ่านในการรันที่ล้มเหลว นี่เป็นความผิดพลาดที่แพงที่สุด และเป็นเหตุผลที่กฎรหัสทางออกอยู่ในทั้งไฟล์ .clinerules/ ของคุณและขั้นตอนการตรวจสอบของคุณ เมื่อสรุปและรหัสทางออกไม่ตรงกัน รหัสทางออกคือสิ่งที่ถูกต้อง
จากเอเจนต์รายวันสู่วงจรการทดสอบ
นั่นคือการตั้งค่า ติดตั้ง apidog-cli เพียงครั้งเดียวตาม คู่มือการติดตั้ง เพิ่มกฎ Apidog สั้นๆ ลงในไดเรกทอรี .clinerules/ ของ repo ของคุณ แล้ว Cline ก็จะรู้วิธีรันการทดสอบ API ของคุณและอ่านผลลัพธ์ภายในวงจรเดียวกับที่มันใช้แก้ไขโค้ดอยู่แล้ว จุดสิ้นสุดที่เสียจะถูกตรวจพบในขณะที่ Cline ยังคงทำงานกับการเปลี่ยนแปลง ไม่ใช่หลังจากที่ส่งมอบไปแล้ว
การทดสอบหลัง GUI จะทำงานเมื่อมนุษย์คลิก; คำสั่งบรรทัดเดียวจะทำงานเมื่อใดก็ตามที่ Cline ตัดสินใจ คุณยังคงสร้างสถานการณ์ด้วยภาพใน Apidog และเอเจนต์ของคุณจะรันมันในที่ที่คุณไม่ได้สังเกต ดาวน์โหลด Apidog สร้างสถานการณ์เดียว ใส่คำสั่ง apidog run ลงใน .clinerules/apidog.md แล้วดูว่า Cline จะหยิบมันขึ้นมาในการเปลี่ยนแปลงครั้งต่อไป