Chuyển đến nội dung chính

​
Tổng quan

Nudgen CLI được thiết kế với cách tiếp cận Ưu tiên AI. Mặc dù nó cung cấp giao diện TUI đẹp mắt cho con người, mọi lệnh cũng được tối ưu hóa cho giao tiếp giữa máy với máy.

​
Mô hình Agentic

Khi một AI Agent (như Claude, GPT, hoặc các agent tự động hóa chuyên dụng) sử dụng CLI, nó nên tuân theo các mô hình sau:
  1. Đầu ra JSON: Thêm --json vào mọi lệnh để nhận dữ liệu máy có thể xử lý.
  2. Nhận biết Ngữ cảnh: Luôn kiểm tra ngữ cảnh nhóm trước khi thực hiện các hoạt động.
  3. Không Tương tác: Sử dụng các flag để bỏ qua các nhắc nhở TUI tương tác.

​
Tự động hóa với JSON

Mọi lệnh liệt kê và trạng thái đều hỗ trợ flag --json. Điều này trả về một cấu trúc JSON sạch thay vì một bảng được định dạng. 
# Lấy tất cả chiến dịch dưới dạng JSON
nudgen campaigns list --json

# Lấy danh sách liên hệ trong nhóm hiện tại
nudgen contacts list --json

​
Quy trình Làm việc Đa nhóm cho Agent

Vì Nudgen hỗ trợ nhiều nhóm (teams), một agent phải đảm bảo nó đang hoạt động trên đúng nhóm trước khi tạo hoặc cập nhật tài nguyên. Quy trình được khuyến nghị:
  1. Kiểm tra Nhóm Hiện tại: 
    nudgen teams current --json
  2. Chuyển đổi Nhóm (nếu cần): Nếu id từ bước trước không khớp với nhóm mục tiêu, hãy chuyển đổi: 
    nudgen teams switch <target-team-id>
  3. Thực hiện Lệnh Dữ liệu: Tiếp tục với các lệnh campaigns, contacts, hoặc brand.

​
Thực hành Tốt nhất cho Nhà phát triển Agent

  • Xử lý Lỗi: Theo dõi mã thoát (exit code) của các lệnh CLI. Mã thoát khác 0 cho biết có lỗi (xác thực, mạng hoặc quyền truy cập).
  • Giới hạn Tốc độ (Rate Limiting): CLI giao tiếp với Nudgen API. Đảm bảo các script của agent xử lý các giới hạn tốc độ một cách khéo léo.
  • Chế độ Im lặng: Nếu một lệnh không hỗ trợ flag cụ thể cho mọi lời nhắc, hãy đảm bảo agent của bạn có thể xử lý các luồng stdout/stderr mà không bị kẹt trong vòng lặp TUI.