AI Platform CLI
AI Platform CLI는 터미널에 명령을 입력해 Skill, Agent, 자동화 등을 조회하고 관리하는 도구입니다. 브라우저에서 로그인한 계정으로 사용할 수 있으며, 터미널에서는 aipctl이라는 이름으로 실행합니다.
Skill 파일을 PC로 내려받거나, Agent 설정을 바꾸거나, 반복하는 조회를 스크립트로 처리할 때 사용할 수 있습니다. PC 터널을 연결하는 기능도 제공합니다.
처음 시작하기
처음 사용한다면 설치와 로그인을 따라 진행하세요. 다음 순서로 첫 Skill 목록을 확인할 수 있습니다.
- 설치하기 — Node.js를 준비하고 CLI를 설치합니다.
- 로그인하기 — 접속 주소를 설정하고 브라우저에서 로그인합니다.
- 첫 명령 실행하기 — 로그인한 조직의 Skill 목록을 조회합니다.
설치와 로그인을 마쳤다면 원하는 작업을 아래에서 찾아보세요. PC를 연결하려면 PC 터널 연결로 이동하세요.
사용 가능한 명령 확인하기
--help 또는 -h를 입력하면 사용할 수 있는 명령을 확인할 수 있습니다.
aipctl --help작업 이름 뒤에 --help를 붙이면 하위 명령과 옵션을 확인할 수 있습니다.
# Skill 관련 명령 확인
aipctl skill --help
# Skill 다운로드의 입력과 옵션 확인
aipctl skill download --help명령별 입력 형식과 자세한 사용법은 전체 명령 참조를 참고하세요.
CLI로 할 수 있는 일
| 하고 싶은 작업 | 사용할 기능 |
|---|---|
| Skill을 찾고 파일로 가져오거나 등록하기 | 목록·상세·라이브러리·업로드·다운로드 |
| 조직 Skill을 GitHub에서 가져와 업데이트하기 | GitHub 가져오기와 변경 반영 |
| Agent 설정을 확인하고 생성·수정하기 | Agent 조회·생성·활성화 |
| 자동화의 설정과 실행 이력을 관리하기 | 자동화 조회·생성·변경·활성화 |
| 파일·대화·연동·모델 정보를 확인하기 | 리소스 조회와 폴더 관리 |
| 조직을 관리하고 사용량 확인하기 | 조직·사용량 |
| PC에 연결하기 | PC 터널 연결 |
| 목록을 JSON으로 받아 다른 작업에 활용하기 | 스크립트와 목록 조회 |
사용 전에 알아두세요
-
로그인한 계정과 선택한 조직을 기준으로 사용합니다. CLI에서도 계정에 부여된 권한 안에서 자료를 확인하고 작업할 수 있습니다. 여러 조직에 속해 있다면 작업할 조직이 맞는지 먼저 확인하세요. 조직에서 함께 사용하는 Skill이나 Agent를 관리하려면 AI Operator 등 해당 작업을 허용하는 권한이 필요합니다. 권한이 없다는 안내가 나오면 조직 관리자에게 문의하세요.
-
하려는 작업에 맞는 명령을 확인하세요. 예를 들어
aipctl model list는 사용할 수 있는 모델 목록을 보여주고,aipctl chat list는 내 대화 목록을 보여줍니다. 이 명령만으로 모델을 실행하거나 새 메시지를 보내지는 않습니다. 원하는 작업을 찾으려면 아래 기능별 안내나 전체 명령 참조를 확인하세요. -
설치한 버전과 조직의 서비스 환경에 따라 사용할 수 있는 기능이 달라질 수 있습니다. 매뉴얼의 명령을 찾을 수 없다면
aipctl --version으로 설치 버전을 확인하고,aipctl --help에서 제공되는 명령을 살펴보세요. 명령은 있지만 실행이 거절된다면 안내된 오류 내용을 확인하세요. 제약사항과 문제 해결에서 상황별 확인 방법을 안내합니다.
명령 예시 읽는 방법
aipctl skill get SKILL_IDSKILL_ID처럼 대문자로 적힌 부분은 자신의 값으로 바꿔 입력합니다. 위 예시에서는 Skill 목록에서 확인한 ID를 사용합니다. 공백이 있는 이름과 문장은 따옴표로 묶습니다.
코드 블록 안의 명령을 복사해 터미널에 붙여 넣고 Enter를 누르면 실행됩니다. 여러 줄이 있는 경우에는 한 줄씩 실행하고 결과를 확인한 뒤 다음 줄로 진행하세요.