Cline là một vòng lặp: nó lên kế hoạch thay đổi, chỉnh sửa tệp, chạy lệnh, đọc kết quả đầu ra và quyết định bước tiếp theo. Vậy tại sao các bài kiểm thử API của bạn lại không nằm trong vòng lặp đó? Chúng nằm trong Apidog phía sau một giao diện người dùng đồ họa (GUI), chờ đợi ai đó nhớ để nhấp. Tác nhân của bạn không bao giờ chạm tới chúng.
Giải pháp chỉ là một khối cấu hình. Apidog CLI là một gói npm, apidog-cli, chạy các kịch bản kiểm thử bạn đã xây dựng trong Apidog trực tiếp từ terminal. Một khi CLI được cài đặt và Cline biết nó tồn tại, tác nhân của bạn sẽ chạy một kịch bản Apidog theo cùng một cách mà nó chạy các bài kiểm thử đơn vị của bạn: kích hoạt lệnh, đọc mã thoát, sửa mã nếu nó trả về màu đỏ.
Nếu bạn chưa cài đặt CLI, hãy làm điều đó trước. Cách cài đặt Apidog CLI với tác nhân mã hóa AI hướng dẫn qua quá trình cài đặt npm, xác thực và lần chạy đầu tiên, với Cline thực hiện việc gõ. Bài viết này giả định rằng apidog --version in ra một con số và tài khoản Apidog của bạn đã được xác thực.
Cline nào được nói đến ở đây
Cline là tác nhân mã hóa tự động mã nguồn mở chạy dưới dạng tiện ích mở rộng VS Code (cũng có bản dựng JetBrains và CLI). Nó đọc kho lưu trữ của bạn, lên kế hoạch ở chế độ Plan, sau đó chuyển sang chế độ Act để chỉnh sửa tệp và chạy lệnh shell, yêu cầu phê duyệt dựa trên cài đặt tự động phê duyệt của bạn. Nó không phải là một chatbot được lưu trữ; mô hình chạy trên cơ sở mã của bạn trên máy của bạn. Nếu bạn đang mở bảng Cline trong VS Code và nó đang hiển thị các khác biệt (diffs) và đầu ra terminal khi nó hoạt động, bạn đang ở đúng chỗ. Cách sử dụng Cline bao gồm các kiến thức cơ bản về cài đặt và chọn một mô hình.
Sự phân biệt này quan trọng bởi vì Cline có cách riêng để tìm hiểu các quy tắc dự án, và cơ chế đó biến một lần “chạy các bài kiểm thử của tôi” thành thứ mà Cline tự thực hiện. Cơ chế đó là thư mục .clinerules/.
Bước 1: Thêm quy tắc vào .clinerules, không phải là nhắc nhở trò chuyện
Cline tải các quy tắc dự án từ thư mục .clinerules/ tại thư mục gốc không gian làm việc của bạn trước khi nó bắt đầu một tác vụ. Nó đọc mọi tệp .md và .txt bên trong thư mục đó và kết hợp chúng thành tập lệnh hướng dẫn mà nó mang theo suốt phiên. Bạn cũng có thể sử dụng một tệp .clinerules duy nhất nếu muốn, nhưng thư mục sẽ mở rộng tốt hơn khi các quy tắc của bạn phát triển. Điều này được ghi lại trong tài liệu tham khảo quy tắc của Cline.
Tạo một tệp như .clinerules/apidog.md tại thư mục gốc của kho lưu trữ của bạn với một khối ngắn như sau:
# Kiểm thử API với Apidog
- Để kiểm thử API, hãy chạy Apidog CLI, không phải curl hoặc các script ad-hoc.
- Lệnh: apidog run -t <scenario_id> -e <env_id> -r cli
- ID kịch bản và ID môi trường đến từ tab CI/CD của Apidog. Sử dụng chính xác các giá trị đó.
- Mã thoát 0 có nghĩa là mọi khẳng định đều vượt qua. Khác 0 có nghĩa là thất bại; mã thoát là nguồn chân lý, không phải tóm tắt của bạn.
- Máy đã được xác thực qua `apidog login`. Không bao giờ thêm --access-token và không bao giờ đặt mã token vào tệp này.
- Nếu một cờ không xác định, hãy chạy `apidog run --help` và sử dụng chính xác cờ từ đó.
Đây là lý do tại sao bạn viết CLI vào .clinerules/ thay vì đề cập nó trong cuộc trò chuyện. Một ID kịch bản được gõ vào tin nhắn Cline sẽ biến mất khi tác vụ kết thúc. Một cái trong .clinerules/apidog.md sẽ có sẵn cho mọi đồng đội kiểm tra kho lưu trữ và mọi tác vụ Cline từ bây giờ. Tệp được kiểm soát phiên bản, vì vậy quy tắc sẽ di chuyển cùng với mã.
Bước 2: Lấy lệnh từ Apidog
Bạn cần lệnh apidog run thực tế, không phải lệnh được đoán. Mở kịch bản kiểm thử trong Apidog, vào tab CI/CD của nó và sao chép lệnh đã tạo. Nó trông như thế này:
apidog run -t 8291 -e 42 -r cli
Giá trị -t là ID kịch bản kiểm thử của bạn và -e là ID môi trường. Đây là những giá trị chính xác thuộc về .clinerules/apidog.md. Dán chúng vào khối quy tắc để Cline luôn có các ID chính xác. Để biết toàn bộ bộ cờ, hãy xem tài liệu tham khảo lệnh apidog run.
Bước 3: Yêu cầu Cline chạy kiểm thử
Với quy tắc đã được thiết lập, hãy bắt đầu một tác vụ trong bảng điều khiển Cline. Cline tải .clinerules/ khi nó bắt đầu, vì vậy nó đã biết CLI có ở đó. Thực hiện một thay đổi liên quan đến API của bạn, hoặc chỉ yêu cầu nó chạy kiểm tra:
Chạy kịch bản kiểm thử Apidog và cho tôi biết kết quả.
Cline lập kế hoạch bước đó, sau đó chuyển sang chế độ Act để phát hành lệnh apidog run từ các quy tắc của bạn. Mức độ nó hỏi trước phụ thuộc vào cài đặt phê duyệt của bạn. Cline đánh giá từng lệnh và đánh dấu nó là an toàn hoặc cần phê duyệt; một kịch bản kiểm thử chỉ đọc chống lại môi trường staging là loại lệnh mà nó coi là an toàn. Nếu cài đặt tự động phê duyệt của bạn cho phép các lệnh an toàn được thực thi, apidog run sẽ chạy mà không cần nhắc. Nếu không, Cline sẽ tạm dừng và hỏi; hãy phê duyệt nó, và bật tự động phê duyệt cho các lệnh thực thi an toàn nếu bạn muốn nó tự chạy các kịch bản trong tương lai. Trình báo cáo -r cli in ra kết quả từng bước và tóm tắt ngay trong terminal, nơi bạn xem từng yêu cầu và khẳng định khi chúng diễn ra.
Bước 4: Đọc báo cáo bên trong Cline
Khi một lần chạy báo đỏ, báo cáo sẽ có câu trả lời. Với -r cli, Cline nhận được một bản phân tích dễ đọc trong bảng đầu ra terminal: mỗi yêu cầu, mỗi khẳng định và cái nào đã thất bại, với giá trị mong đợi so với giá trị thực tế. Khẳng định thất bại sẽ đặt tên chính xác trường hoặc mã trạng thái, điều này thường đủ để Cline tìm ra cách sửa lỗi trong lần chạy tiếp theo.
Để có một báo cáo bạn có thể mở trong trình duyệt hoặc đưa cho đồng đội, hãy thêm trình báo cáo HTML:
apidog run -t 8291 -e 42 -r cli,html
Trình báo cáo html ghi một tệp độc lập vào ./apidog-reports. Giữ cli trong danh sách để Cline vẫn nhận được đầu ra nội tuyến mà nó đọc để quyết định bước tiếp theo. Để biết mọi cờ và trình báo cáo, bao gồm cả bảng điều khiển CI định dạng JUnit, hãy xem hướng dẫn Apidog CLI đầy đủ và hướng dẫn báo cáo kiểm thử Apidog CLI.
Cline kiểm thử trong vòng lặp riêng của nó
Thành quả là những gì xảy ra khi bạn ngừng yêu cầu và Cline tự chạy kịch bản vì .clinerules/ đã chỉ dẫn nó làm vậy.
Hãy hình dung Cline đang chỉnh sửa một handler xây dựng phản hồi thanh toán. Vòng lặp của nó thay đổi: nó chỉnh sửa mã, sau đó, thay vì tuyên bố chiến thắng, chạy kịch bản Apidog của bạn chống lại môi trường staging, đọc mã thoát và hành động dựa trên nó. Màu xanh lá cây, nó tiếp tục. Màu đỏ, nó mở báo cáo, đọc khẳng định nào đã thất bại (mã trạng thái, trường bị thiếu, giá trị sai), thử sửa lỗi và chạy lại. Kiểm thử API trở thành một phần của cùng một vòng lặp chỉnh sửa-kiểm thử-sửa lỗi mà Cline đã chạy các bài kiểm thử đơn vị của bạn. Bạn đã viết một hướng dẫn và Cline đã đưa lệnh đó vào cách nó đã hoạt động.
Đây là mô hình ủy quyền-sau đó-xác minh giúp mọi quy trình làm việc của tác nhân an toàn. Cline chạy lệnh và đọc kết quả; bạn tiếp tục tạo kịch bản một cách trực quan trong Apidog và kiểm tra nhanh rằng tác nhân đọc mã thoát một cách trung thực. Để biết mô hình rộng hơn, hãy xem cách sử dụng tác nhân AI để kiểm thử API và bộ công cụ kiểm thử AI Apidog.
Xác minh Cline thực sự đang chạy CLI
Các tác nhân báo cáo thành công mà họ không đạt được, và Cline cũng không ngoại lệ. Ba kiểm tra, theo thứ tự tần suất chúng phát hiện vấn đề.
Đầu tiên, xác nhận lệnh đã chạy. Cline hiển thị các lệnh nó đã thực thi và đầu ra của chúng trực tiếp trong chế độ xem tác vụ. Tìm dòng apidog run ... theo nghĩa đen và kết quả bên dưới nó. Nếu Cline nói nó đã chạy các bài kiểm thử nhưng bạn không thấy lệnh, nó đã tóm tắt một cái gì đó mà nó chưa bao giờ làm. Yêu cầu nó chạy lại và hiển thị đầu ra thô.
Thứ hai, xác nhận mã thoát, cái quan trọng:
Mã thoát của lệnh apidog run đó là gì?
apidog run thoát với 0 khi mọi khẳng định vượt qua và khác 0 khi có bất kỳ điều gì thất bại. Hành vi đơn lẻ đó cho phép Cline, hoặc một pipeline, coi lần chạy đó như một cổng sạch. Khi văn xuôi của Cline nói “các bài kiểm thử đã vượt qua” nhưng mã thoát khác 0, thì mã thoát mới là đúng.
Thứ ba, xác nhận nó đã sử dụng kịch bản thực. Nếu một lần chạy thất bại với “không tìm thấy kịch bản,” Cline có thể đã tự tạo hoặc nhớ sai một ID. Kiểm tra lại các giá trị -t và -e so với .clinerules/apidog.md và lệnh Apidog đã tạo trong tab CI/CD. Các ID trong tệp quy tắc là sự thật.
Tùy chọn: kết nối máy chủ Apidog MCP
Chạy apidog run từ .clinerules/ bao gồm hầu hết những gì bạn cần. Một lộ trình đi xa hơn.
Cline có hỗ trợ hạng nhất cho Giao thức Ngữ cảnh Mô hình (Model Context Protocol). Trong tiện ích mở rộng VS Code, nhấp vào biểu tượng MCP Servers trong bảng điều khiển Cline, mở Configure, và nhấp vào Configure MCP Servers để mở cline_mcp_settings.json; thêm máy chủ của bạn vào đối tượng mcpServers. Bạn cũng có thể duyệt Thị trường MCP bên trong Cline để cài đặt máy chủ mà không cần chỉnh sửa JSON bằng tay, như mô tả trong tài liệu MCP của Cline. Máy chủ Apidog MCP hiển thị các thông số kỹ thuật API của bạn qua MCP, vì vậy Cline có thể đọc lược đồ của bạn trong khi nó viết mã, không chỉ sau khi sự việc đã xảy ra. CLI chạy các bài kiểm thử; MCP cung cấp thông số kỹ thuật cho tác nhân.
Cline là một tiện ích mở rộng tương tác, vì vậy không có chế độ kiểm thử không tương tác được tích hợp sẵn theo cách mà một trình chạy không giao diện (headless runner) sẽ cung cấp cho bạn. Để chạy apidog run trong một pipeline mà không có Cline, Apidog CLI trong GitHub Actions bao gồm các bí mật, trình báo cáo và kiểm soát bằng mã thoát, và hướng dẫn pipeline CI/CD của Apidog CLI bao gồm thiết lập rộng hơn.
Khi Cline mắc lỗi
Một vài lỗi thường xuất hiện trong quá trình thiết lập.
Nó bỏ qua tệp quy tắc. Nếu Cline chạy một lệnh chung hoặc không chạy gì cả, quy tắc có thể không được tải. Xác nhận rằng thư mục được đặt tên chính xác là .clinerules và nằm ở thư mục gốc không gian làm việc của bạn, và tệp bên trong nó kết thúc bằng .md hoặc .txt. Bắt đầu một tác vụ mới sẽ buộc Cline tải lại các quy tắc.
Nó vẫn truyền một mã truy cập. Nếu Cline cố gắng thêm --access-token, nó đang đoán từ các ví dụ công khai. Quy tắc đã chỉ dẫn nó không làm vậy, vì máy đã được xác thực qua apidog login. Củng cố dòng đó và không bao giờ đặt mã token thực vào .clinerules/. Để biết cách xác thực thực sự hoạt động, hãy xem hướng dẫn xác thực Apidog CLI.
Nó tự tạo một cờ. Lỗi “tùy chọn không xác định” có nghĩa là Cline đã đoán một cờ mà phiên bản của bạn không có. Bảo nó chạy apidog run --help và sao chép cờ chính xác từ đó, điều này luôn đúng với phiên bản đã cài đặt của bạn.
Nó báo cáo vượt qua trên một lần chạy thất bại. Điều tốn kém nhất, và là lý do quy tắc mã thoát có mặt cả trong tệp .clinerules/ của bạn và bước xác minh của bạn. Khi tóm tắt và mã thoát không khớp, mã thoát sẽ thắng.
Từ tác nhân hàng ngày đến vòng lặp được kiểm thử
Đó là thiết lập. Cài đặt apidog-cli một lần theo hướng dẫn cài đặt, thêm một quy tắc Apidog ngắn vào thư mục .clinerules/ của kho lưu trữ của bạn, và Cline biết cách chạy các bài kiểm thử API của bạn và đọc kết quả bên trong cùng một vòng lặp mà nó đã sử dụng để chỉnh sửa mã. Một điểm cuối bị hỏng sẽ được phát hiện khi Cline vẫn đang làm việc trên thay đổi, chứ không phải sau khi nó được triển khai.
Một bài kiểm thử phía sau GUI chạy khi một con người nhấp chuột; một lệnh một dòng chạy bất cứ khi nào Cline quyết định. Bạn tiếp tục xây dựng các kịch bản một cách trực quan trong Apidog, và tác nhân của bạn chạy chúng ở nơi bạn không quan sát. Tải xuống Apidog, xây dựng một kịch bản, thả lệnh apidog run của nó vào .clinerules/apidog.md, và xem Cline tiếp nhận nó trong lần thay đổi tiếp theo.