คุณมี AI coding agent เปิดอยู่แล้ว ตัวแทนนี้แก้ไขไฟล์ของคุณ รันการทดสอบของคุณ และอ่านผลลัพธ์จากเทอร์มินัลของคุณ แล้วทำไมคุณถึงจะติดตั้งเครื่องมือ command-line ด้วยตัวเอง โดยคัดลอกคำสั่ง npm จากแท็บแล้ววางทีละคำสั่ง?
คุณไม่จำเป็นต้องทำเช่นนั้น Apidog CLI คือแพ็คเกจ npm ที่ชื่อ apidog-cli ซึ่งรันสถานการณ์การทดสอบ API ที่คุณสร้างไว้ใน Apidog โดยตรงจากเทอร์มินัล การติดตั้งประกอบด้วยลำดับของคำสั่งเชลล์สั้นๆ, ขั้นตอนการยืนยันตัวตน, และการรันครั้งแรก ซึ่งเป็นงานเชิงกลที่ตัวแทนอย่าง Claude Code, Cursor, Windsurf, หรือ GitHub Copilot ในโหมด agent ทำได้ดี คุณอธิบายเป้าหมาย ตัวแทนจะรันคำสั่งจริง และคุณตรวจสอบงานของมัน
คู่มือนี้แสดงขั้นตอนการทำงานแบบ end-to-end คุณจะได้เห็นพร้อมต์ที่ชัดเจนเพื่อส่งให้ตัวแทน, คำสั่งที่ตัวแทนจะรัน, และวิธีตรวจสอบแต่ละขั้นตอนแทนที่จะเชื่อตามที่ตัวแทนบอก ผลตอบแทนสุดท้ายที่คุ้มค่ากับการตั้งค่าคือ: เมื่อ CLI ได้รับการติดตั้งและยืนยันตัวตนแล้ว ตัวแทนของคุณสามารถรันการทดสอบ Apidog ของคุณได้เอง ภายในลูปของมันเองหรือใน CI และอ่านผลลัพธ์ที่ผ่านหรือไม่ผ่าน ในการดำเนินการตามคุณต้องมีบัญชี Apidog ที่มีอย่างน้อยหนึ่งโปรเจกต์ ดาวน์โหลด Apidog ก่อนหากคุณยังไม่มี
ทำไมต้องให้ Agent ทำการติดตั้ง
ไม่มีอะไรเปลี่ยนแปลงเกี่ยวกับคำสั่งการติดตั้งเมื่อ Agent รันมัน มันคือ npm install -g apidog-cli@latest เดียวกันกับที่คุณจะพิมพ์เอง สิ่งที่เปลี่ยนแปลงคือใครเป็นคนพิมพ์และใครเป็นคนอ่านผลลัพธ์
Agent เก่งในเรื่องนี้ด้วยสามเหตุผลที่ชัดเจน มันสามารถรันคำสั่ง อ่านสถานะการออกและข้อความที่พิมพ์ออกมา และตัดสินใจขั้นตอนต่อไปจากสิ่งที่มันเห็นจริงๆ ดังนั้น "command not found" จะไม่หยุดชะงักเหมือนที่เกิดขึ้นในลูป copy-paste มันมีเชลล์ของคุณ, เวอร์ชัน Node ของคุณ, และ PATH ของคุณอยู่แล้ว ดังนั้นมันจึงปรับการแก้ไขให้เข้ากับเครื่องของคุณแทนที่จะเป็นแบบทั่วไป และมันทำงานส่วนที่น่าเบื่อ เช่น การตรวจสอบ Node ก่อน, การยืนยันเวอร์ชันหลังการติดตั้ง, การยืนยันการอนุญาต โดยที่คุณไม่ต้องดูแลแต่ละบรรทัด
สิ่งที่คุณต้องมีก่อนเริ่มต้น
CLI จัดส่งเป็นแพ็คเกจ npm ดังนั้นการพึ่งพาระบบเพียงอย่างเดียวคือรันไทม์ Node.js สามสิ่งต้องเป็นจริง:
- ติดตั้ง Node.js และ npm แล้ว แพ็คเกจติดตั้งผ่าน npm และรันบน Node การเลือกเวอร์ชัน LTS ปัจจุบันเป็นทางเลือกที่ปลอดภัยสำหรับเครื่องนักพัฒนาทุกคน
- บัญชี Apidog พร้อมสิทธิ์เข้าถึงโปรเจกต์ CLI ไม่ได้เก็บการทดสอบของตัวเอง มันเข้าถึงโปรเจกต์ Apidog ของคุณและรันสถานการณ์ที่อยู่ในนั้น ดังนั้นคุณต้องมีบัญชีที่สามารถมองเห็นอย่างน้อยหนึ่งโปรเจกต์
- สถานการณ์การทดสอบที่จะรัน ตัวรันจะดำเนินการกับสถานการณ์ ไม่ใช่คำขอที่ไม่มีโครงสร้าง สร้างสถานการณ์หนึ่งในแอป Apidog ก่อน: เชื่อมต่อคำขอหลายๆ อัน เพิ่มการยืนยัน และบันทึก หากคุณยังใหม่กับการเขียนการตรวจสอบการตอบกลับ การยืนยัน API: คู่มือฉบับปฏิบัติ จะอธิบายรายละเอียด
คุณยังต้องมี AI coding agent ที่ได้รับอนุญาตให้รันคำสั่งเชลล์ Claude Code, agent ของ Cursor, Cascade ของ Windsurf, และโหมด agent ของ GitHub Copilot ล้วนเข้าเกณฑ์ สิ่งเดียวที่ต้องยืนยันก่อนเริ่มต้นคือ agent ของคุณได้รับอนุญาตให้รันคำสั่งในเทอร์มินัลของคุณ ไม่ใช่แค่แนะนำเท่านั้น หากมันสามารถพิมพ์คำสั่งให้คุณวางได้ คุณยังคงสามารถทำตามคู่มือนี้ได้ เพียงแต่คุณจะเป็นคนกด Enter
ขั้นตอนที่ 1: ให้ Agent ตรวจสอบสภาพแวดล้อม
เริ่มต้นโดยให้ Agent ยืนยันว่า Node มีอยู่ เพื่อให้มันรู้ว่าสามารถติดตั้งได้หรือไม่ พร้อมต์เช่นนี้ใช้ได้:
ตรวจสอบว่า Node.js และ npm ได้รับการติดตั้งบนเครื่องนี้หรือไม่ รันnode -vและnpm -vและบอกเวอร์ชันให้ฉันทราบ หากมีอันใดอันหนึ่งหายไป ให้บอกฉัน อย่าพยายามติดตั้ง Node เอง
Agent จะรัน:
node -v
npm -v
มันควรรายงานหมายเลขเวอร์ชันสองตัวกลับมาให้คุณ การตรวจสอบของคุณ: อ่านเวอร์ชันที่มันพิมพ์ หากมันอ้างว่า Node ติดตั้งแล้วแต่ไม่แสดงสตริงเวอร์ชัน ให้ขอให้มันวางผลลัพธ์คำสั่งดิบ เหตุผลสำหรับข้อความ "อย่าติดตั้ง Node เอง" ในพร้อมต์คือการติดตั้งรันไทม์เป็นการตัดสินใจที่ใหญ่กว่าและเฉพาะเจาะจงกับเครื่อง ซึ่งคุณต้องการตัดสินใจอย่างรอบคอบ ไม่ใช่สิ่งที่ต้องปล่อยให้ทำไปโดยไม่รู้ หาก Node หายไป ให้ติดตั้งจาก nodejs.org ด้วยตัวเอง แล้วดำเนินการต่อ
ขั้นตอนที่ 2: ให้ Agent ติดตั้ง CLI
เมื่อ Node ได้รับการยืนยันแล้ว ให้ส่งมอบการติดตั้ง:
อ่าน https://apidog.com/apidog-cli-installation-guide.md และทำตามคำแนะนำ
Agent จะรันคำสั่งการติดตั้ง
แฟล็ก -g จะวางไบนารี apidog ไว้บน PATH ทั่วโลกของคุณ แทนที่จะอยู่ใน node_modules ของโปรเจกต์ใดโปรเจกต์หนึ่ง แท็ก @latest จะดึงเวอร์ชันล่าสุดที่เผยแพร่ ซึ่งเป็นสิ่งที่คุณต้องการสำหรับการติดตั้งครั้งแรก เมื่อ npm เสร็จสิ้น ไบนารีจะชื่อ apidog ดังนั้นทุกคำสั่งจากนี้ไปจะเริ่มต้นด้วย apidog
จากนั้นมันจะยืนยัน:
apidog --version
apidog --help
การตรวจสอบของคุณ: นี่คือการยืนยันที่สำคัญที่สุดในกระบวนการทั้งหมด เพราะเป็นจุดที่ Agent สามารถอ้างความสำเร็จที่ยังไม่เกิดขึ้นได้ง่ายที่สุด ตรวจสอบให้แน่ใจว่า apidog --version พิมพ์หมายเลขเวอร์ชันจริง ไม่ใช่ "command not found" ที่ Agent มองข้ามไป ผลลัพธ์ --help ควรแสดง apidog run และตัวเลือกต่างๆ หากคุณต้องการคำสั่งบรรทัดเดียวที่คุณสามารถรันเองเพื่อยืนยันว่าไบนารีและรันไทม์เบื้องหลังทั้งคู่แก้ไขได้ ให้ขอให้ Agent รันสิ่งนี้และวางผลลัพธ์:
node -v && apidog --version && which node && which apidog
หากทุกบรรทัดคืนค่าเวอร์ชันหรือพาธ การติดตั้งถือว่าสะอาด หาก Agent รายงานปัญหา สาเหตุที่พบบ่อยที่สุดคือไดเรกทอรี bin ทั่วโลกไม่ได้อยู่ใน PATH ของคุณ; ส่วนการแก้ไขปัญหาใกล้ท้ายจะครอบคลุมเรื่องนี้
หากคุณไม่ต้องการให้ Agent เปลี่ยนแปลงแพ็คเกจทั่วโลกของคุณ ให้บอกให้ใช้ npx แทน npx apidog-cli --version จะดึงแพ็คเกจ รัน และไม่ทิ้งสิ่งใดไว้บน PATH ของคุณ ซึ่งเหมาะสำหรับเครื่องที่ใช้ร่วมกันหรือ CI runner ชั่วคราว สำหรับเครื่องที่คุณใช้ทุกวัน การติดตั้งทั่วโลกจะง่ายกว่าและเร็วกว่าในการเรียกซ้ำ
ขั้นตอนที่ 3: ให้ Agent ยืนยันตัวตน แต่คุณจัดการโทเค็นเอง
CLI รันสถานการณ์จากบัญชีของคุณ ดังนั้นจึงต้องพิสูจน์ว่าได้รับอนุญาตให้ทำได้ มันทำได้โดยใช้โทเค็นการเข้าถึง นี่คือขั้นตอนเดียวที่คุณไม่ได้มอบหมายให้ทั้งหมด เพราะโทเค็นเป็นความลับ และคุณไม่ต้องการให้มันถูกวางลงในบันทึกการแชท, ไฟล์บันทึก, หรือที่ใดก็ตามที่ Agent อาจสะท้อนกลับ
สร้างโทเค็นด้วยตัวคุณเองก่อน เปิดแอป Apidog หรือคอนโซลเว็บ คลิกรูปโปรไฟล์ผู้ใช้ของคุณ ไปที่ Account Settings จากนั้น API Access Token และสร้างโทเค็นใหม่ คัดลอกไปที่ที่ปลอดภัยและถือว่าเป็นรหัสผ่าน เพราะใครก็ตามที่มีโทเค็นนี้สามารถรันสถานการณ์ในนามของคุณได้
จากนั้นให้พร้อมต์ Agent โดยไม่ต้องใส่โทเค็นลงในพร้อมต์:
ฉันจะยืนยันตัวตน Apidog CLI ด้วยตัวเอง เพื่อให้โทเค็นไม่อยู่ในการแชทนี้ บอกคำสั่งapidog loginที่แน่นอนให้ฉันรัน จากนั้นหลังจากฉันยืนยันว่ารันแล้ว ให้รันapidog whoamiเพื่อยืนยันว่า CLI ได้รับการยืนยันตัวตนแล้ว และแสดงผลลัพธ์ให้ฉันดู
คุณรันคำสั่งล็อกอินในเทอร์มินัลของคุณเอง:
apidog login --with-token YOUR_ACCESS_TOKEN
ให้ Agent รันการตรวจสอบ:
apidog whoami
การตรวจสอบของคุณ: apidog whoami ควรสรุปบัญชีของคุณ หากทำได้ แสดงว่าการยืนยันตัวตนเรียบร้อย เหตุผลที่ต้องเก็บโทเค็นไว้ในมือคุณคือสุขอนามัยในการปฏิบัติงานที่เรียบง่าย: โทเค็นที่อยู่ในหน้าต่างบริบทของ Agent อาจไปปรากฏในบันทึกหรือบันทึกการถอดเสียงที่บันทึกไว้ คำสั่งล็อกอินจะจัดเก็บไว้ในเครื่องของคุณ เพื่อที่ Agent จะไม่ต้องเห็นสตริงดิบเพื่อรันการทดสอบในภายหลัง สำหรับ CI กฎเดียวกันแต่เข้มงวดกว่า ซึ่งส่วนสุดท้ายจะครอบคลุม
ขั้นตอนที่ 4: ให้ Agent ทำการทดสอบครั้งแรก
ตอนนี้เปลี่ยนจาก "ติดตั้งแล้ว" เป็น "มันรันจริง" คำสั่งหลักคือ apidog run โดยชี้ไปที่สถานการณ์ด้วย ID ของมัน
วิธีที่สะอาดที่สุดในการรับคำสั่งที่ถูกต้องคือการให้ Apidog สร้างให้คุณ เปิดสถานการณ์การทดสอบใน Apidog สลับไปที่แท็บ CI/CD เลือกตัวเลือก command-line และ Apidog จะสร้างคำสั่ง apidog run ที่สมบูรณ์พร้อม ID สถานการณ์, ID สภาพแวดล้อม และโทเค็นการเข้าถึงที่กรอกไว้แล้ว คัดลอกสิ่งนั้น และคุณจะมีจุดเริ่มต้นที่ถูกต้องตามที่รับประกัน มันมีลักษณะดังนี้:
apidog run --access-token YOUR_ACCESS_TOKEN -t 605067 -e 1629989 -n 1 -r cli
นี่คือสิ่งที่แต่ละส่วนทำ --access-token ยืนยันตัวตนการรัน -t ระบุชื่อสถานการณ์การทดสอบด้วย ID (605067 เป็นตัวยึด; ของคุณจะแตกต่างกัน) -e เลือกสภาพแวดล้อมที่จะรัน เช่น dev หรือ staging -n 1 รันสถานการณ์หนึ่งครั้ง -r cli เขียนรายงานที่อ่านได้ไปยังเทอร์มินัลของคุณ
เนื่องจากคุณล็อกอินแล้ว คุณสามารถส่ง ID ให้ Agent โดยไม่ต้องใช้โทเค็นและให้มันรัน:
รันสถานการณ์การทดสอบ Apidog ของฉันด้วย CLI ฉันได้ยืนยันตัวตนแล้ว ดังนั้นไม่ต้องส่งโทเค็นการเข้าถึง ใช้: apidog run -t 605067 -e 1629989 -n 1 -r cli แสดงผลลัพธ์ทั้งหมดและบอกรหัสการออกให้ฉันทราบAgent จะรันสถานการณ์และรายงานผลลัพธ์การดำเนินการทีละขั้นตอนและสรุป การตรวจสอบของคุณ: ขอรหัสการออกอย่างชัดเจน เพราะนั่นคือสัญญาณที่ทุกสิ่งทุกอย่างที่ตามมาขึ้นอยู่กับ apidog run จะออก 0 เมื่อการยืนยันทุกอย่างผ่าน และรหัสที่ไม่ใช่ศูนย์เมื่อมีบางอย่างล้มเหลว พฤติกรรมเดียวนั้นคือสิ่งที่ทำให้ pipeline หรือ Agent ถือว่าการรันเป็นการผ่านหรือล้มเหลวที่สะอาดโดยไม่ต้องมีการเชื่อมต่อเพิ่มเติม หาก Agent บอกว่า "การทดสอบผ่าน" แต่รหัสการออกไม่ใช่ศูนย์ แสดงว่าผิด ให้เชื่อรหัส ไม่ใช่ข้อความ
ต้องการรูปแบบรายงานอื่นหรือการวนซ้ำเพิ่มเติมหรือไม่? ให้ Agent รัน apidog run --help ซึ่งจะพิมพ์ทุกแฟล็กที่ตัวรันรองรับ รวมถึงรายงานอื่นๆ และตัวเลือกการวนซ้ำแบบขับเคลื่อนด้วยข้อมูล สำหรับการอ้างอิงแฟล็กทั้งหมดและตัวอย่าง CI คู่มือ Apidog CLI ฉบับสมบูรณ์ ครอบคลุมแต่ละอัน
ผลลัพธ์: ตอนนี้ Agent สามารถทดสอบได้เอง
นี่คือเหตุผลที่การตั้งค่านี้คุ้มค่า เมื่อ CLI ได้รับการติดตั้งและยืนยันตัวตนแล้ว การรันการทดสอบ Apidog กลายเป็นคำสั่งเชลล์เพียงคำสั่งเดียวที่ Agent ของคุณสามารถออกคำสั่งได้ตลอดเวลา และอ่านผลลัพธ์ได้ สิ่งนี้ทำให้การทดสอบ API เข้าไปในลูปปกติของ Agent
ลองนึกภาพ Agent ที่กำลังเปลี่ยนแฮนด์เลอร์ที่เกี่ยวข้องกับเอนด์พอยต์ แทนที่จะแก้ไขโค้ดและประกาศชัยชนะ มันสามารถรันสถานการณ์ Apidog ของคุณกับสภาพแวดล้อมที่ได้รับผลกระทบ อ่านรหัสการออก และดำเนินการตามนั้น: ถ้าสีเขียว ก็ดำเนินการต่อ; ถ้าสีแดง มันจะอ่านการยืนยันที่ล้มเหลวในรายงานและพยายามแก้ไข การทดสอบกลายเป็นส่วนหนึ่งของลูปคำติชมของ Agent เช่นเดียวกับที่มันรันการทดสอบหน่วยของคุณอยู่แล้ว สำหรับภาพรวมที่กว้างขึ้นของรูปแบบนี้ วิธีใช้ AI agents สำหรับการทดสอบ API ครอบคลุมถึงความเหมาะสมและไม่เหมาะสม
สิ่งนี้เกิดขึ้นโดยตรงใน CI ซึ่งแม้ Agent จะไม่ได้อยู่ด้วย เมื่อคุณเห็นคำสั่งทำงานในเครื่องแล้ว คุณสามารถให้ Agent เขียนขั้นตอนของ pipeline ที่จะรันมันในการ push ทุกครั้ง กลไกของสิ่งนั้น, ความลับ, ผู้รายงาน, การควบคุมรหัสการออก มีอยู่ใน Apidog CLI ใน GitHub Actions
หากคุณต้องการให้การรวม Agent เข้าไปลึกกว่าการรันคำสั่งเชลล์ คุณสมบัติ Apidog สองประการจะเชื่อมต่อ Agent เข้ากับข้อมูลจำเพาะและสถานการณ์ API ของคุณโดยตรงมากขึ้น เซิร์ฟเวอร์ Apidog MCP เปิดเผยข้อมูลจำเพาะ API ของคุณไปยังเครื่องมือเขียนโค้ด AI ผ่าน Model Context Protocol เพื่อให้ Agent สามารถอ่านสคีมาของคุณขณะเขียนโค้ด และ Apidog CLI พร้อม Claude Skills จะรวมเวิร์กโฟลว์ CLI เข้าเป็นทักษะที่นำกลับมาใช้ใหม่ได้ ดังนั้นขั้นตอนการรันการทดสอบจึงกลายเป็นสิ่งที่ Claude สามารถทำได้ด้วยตัวเอง ทั้งสองสร้างขึ้นบน apidog-cli ที่คุณเพิ่งตั้งค่า
จากการติดตั้งที่มอบหมายสู่ลูปที่ผ่านการทดสอบ
นั่นคือเส้นทางทั้งหมด คุณยืนยัน Node, Agent ติดตั้ง apidog-cli ด้วยคำสั่ง npm หนึ่งคำสั่ง, คุณตรวจสอบด้วย apidog --version, คุณยืนยันตัวตนด้วยโทเค็นที่คุณเก็บไว้ในมือของคุณเอง, และ Agent รัน apidog run ครั้งแรกในขณะที่คุณตรวจสอบรหัสการออก ใช้เวลาไม่กี่นาทีในการมอบหมายงานแล้วตรวจสอบ และตอนนี้ Agent ของคุณสามารถรันการทดสอบ API ของคุณได้เอง
เหตุผลที่สิ่งนี้สำคัญก็เหมือนกับเหตุผลที่การทดสอบใดๆ ก็ตามสำคัญ โดยมีข้อดีเพิ่มเติม การทดสอบที่ติดอยู่เบื้องหลัง GUI จะรันก็ต่อเมื่อมีมนุษย์คลิกเท่านั้น คำสั่งบรรทัดเดียวจะรันทุกครั้งที่ push และเมื่อคำสั่งนั้นเข้าถึง Agent เขียนโค้ดของคุณได้แล้ว มันจะรันภายในลูปการแก้ไข-ทดสอบ-แก้ไขของ Agent เอง ในการเปลี่ยนแปลงที่คุณยังไม่ได้ตรวจสอบด้วยซ้ำ คุณยังคงสร้างสถานการณ์ด้วยภาพใน Apidog และทั้ง pipeline และ Agent ของคุณจะรันมันในที่ที่ไม่มีมนุษย์เฝ้าดู
จากตรงนี้ ให้ชี้คำสั่งเดียวกันไปที่ CI ใน Apidog CLI ใน GitHub Actions หรืออ่านการอ้างอิงแฟล็กทั้งหมดใน คู่มือ Apidog CLI ฉบับสมบูรณ์