스크립트와 목록 조회
조회 결과를 파일로 저장하거나 다른 프로그램에 전달할 때는 명령이 지원하는 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이면 안내된 대기 시간 이후 요청 빈도를 낮춰 조회합니다.- 생성·수정·삭제가 중단되면 먼저 목록·상세를 조회합니다. 결과를 모른 채 같은 변경을 반복하지 않습니다.
- 실행 버전을 고정하려면 버전 고정 방법을 사용합니다.