Skip to Content
Skip to Content
스크립트와 목록 조회

스크립트와 목록 조회

조회 결과를 파일로 저장하거나 다른 프로그램에 전달할 때는 명령이 지원하는 JSON 옵션과 종료 코드를 사용하세요.

JSON 결과 저장하기

aipctl skill list --org ORG_SLUG --json > skills.json aipctl agent list --org ORG_SLUG --json > agents.json aipctl org list --json > organizations.json

--json은 모든 명령의 공통 옵션이 아닙니다. 먼저 aipctl COMMAND --help로 지원 여부를 확인하세요. 예를 들어 config status, auth whoami, chat messages에는 이 옵션을 붙이지 않습니다.

JSON 출력에서도 민감정보는 가려질 수 있습니다. 일반 텍스트 출력은 안내·진행 문구를 포함할 수 있으므로 데이터를 처리하는 스크립트는 지원하는 JSON 출력을 사용하세요.

다음 페이지까지 조회하기

조직 공용 Skill 목록은 --page로 페이지를, --page-size로 한 번에 조회할 개수를 지정할 수 있습니다.

aipctl admin skill list --page 1 --page-size 20 --json aipctl admin skill list --page 2 --page-size 20 --json

다음 페이지를 조회할 때는 --page 값을 1씩 늘리고, 조직·검색 조건과 --page-size는 동일하게 유지하세요. admin skill list를 사용하려면 AI Operator 권한이 필요합니다.

목록마다 다른 옵션

명령검색·페이지 옵션JSON 출력
skill list--search--json
skill library, skill built-in--search지원하지 않음
drive list없음지원하지 않음
chat list없음--json
admin skill list--search, --page, --page-size--json
automation list--name--json

페이지 옵션이 없는 명령에는 조회 개수나 다음 페이지를 지정하는 옵션을 붙이지 않습니다. 목록에서 필요한 항목을 찾을 수 없다면 웹에서도 확인하세요.

옵션의 대소문자와 하이픈을 그대로 사용하세요. 조회 도중 항목이 추가·삭제되면 페이지 사이에 중복이나 누락이 생길 수 있습니다. 중요한 전체 수집은 결과 ID를 확인하고 변경이 적은 시간에 진행하세요.

실패 여부 확인하기

지원하는 JSON 조회 명령의 API 오류는 표준 오류(stderr)에 출력됩니다. 성공 데이터와 오류를 구분해 저장할 수 있습니다.

aipctl skill list --json > skills.json 2> skills-error.json

성공 여부는 파일 크기만으로 판단하지 말고 종료 코드를 확인하세요. 빈 목록도 정상 성공일 수 있습니다. 다음 값은 일반 관리 명령을 처리할 때 참고할 수 있습니다.

종료 코드의미와 다음 행동
0명령 완료. 여러 항목을 처리했다면 항목별 결과도 확인
1요청·인증 등 실패. 오류 코드와 메시지 확인
2일반 배포에서 제공하지 않는 명령의 실행 거절 등에 사용
130사용자가 Ctrl+C로 중단. 서버 작업 완료·취소 여부는 별도 확인

옵션 입력 오류와 MCP 연결 명령은 같은 JSON 오류 형식을 사용한다고 가정하지 마세요.

반복 실행할 때

  • 대상 조직은 --org로 명시해 기본 조직 변경에 따른 실수를 줄입니다.
  • 요청을 한꺼번에 많이 보내지 말고 간격과 동시 실행 수를 제한합니다.
  • 429이면 안내된 대기 시간 이후 요청 빈도를 낮춰 조회합니다.
  • 생성·수정·삭제가 중단되면 먼저 목록·상세를 조회합니다. 결과를 모른 채 같은 변경을 반복하지 않습니다.
  • 실행 버전을 고정하려면 버전 고정 방법을 사용합니다.
Last updated on