메인 콘텐츠로 건너뛰기

​
개요

Nudgen CLI는 AI 우선 접근 방식으로 설계되었습니다. 사람을 위해 아름다운 TUI를 제공함과 동시에, 모든 명령이 기계 간 통신에 최적화되어 있습니다.

​
에이전트 패턴

AI 에이전트(Claude, GPT 또는 전용 자동화 에이전트 등)가 CLI를 사용할 때 다음 패턴을 따라야 합니다:
  1. JSON 출력: 모든 명령에 --json을 추가하여 기계 가독형 데이터를 가져옵니다.
  2. 컨텍스트 인식: 작업을 수행하기 전에 항상 팀 컨텍스트를 확인하세요.
  3. 비대화형: 대화형 UI 프롬프트를 건너뛰기 위해 적절한 플래그를 사용합니다.

​
JSON 자동화

모든 목록 및 상태 명령이 --json 플래그를 지원합니다. 이를 통해 포맷된 표 대신 깨끗한 JSON 구조가 반환됩니다. 
# 모든 캠페인을 JSON으로 가져오기
nudgen campaigns list --json

# 현재 팀의 연락처 가져오기
nudgen contacts list --json

​
에이전트를 위한 멀티테넌트 워크플로우

Nudgen은 여러 팀을 지원하므로, 에이전트는 리소스를 조작하기 전에 올바른 팀에서 작동하고 있는지 확인해야 합니다. 권장 워크플로우:
  1. 현재 팀 확인: 
    nudgen teams current --json
  2. 팀 전환 (필요한 경우): 이전 단계에서 가져온 id가 대상 팀과 일치하지 않는 경우 전환합니다: 
    nudgen teams switch <target-team-id>
  3. 데이터 명령 실행: campaigns, contacts 또는 brand 명령을 실행합니다.

​
에이전트 개발을 위한 베스트 프랙티스

  • 에러 핸들링: CLI 명령의 종료 코드를 모니터링하세요. 0이 아닌 종료 코드는 에러(유효성 검사, 네트워크, 인증 등)를 나타냅니다.
  • 요청 제한 (Rate Limiting): CLI는 Nudgen API와 통신합니다. 에이전트 스크립트가 요청 제한을 적절히 처리할 수 있도록 하세요.
  • 자동 응답 모드: 모든 프롬프트에 대해 특정 플래그가 제공되지 않는 경우, 에이전트가 TUI 루프에 갇히지 않고 stdout/stderr 스트림을 처리할 수 있어야 합니다.