Skip to Content
Skip to Content
AI Platform CLI 소개

AI Platform CLI

AI Platform CLI는 터미널에 명령을 입력해 Skill, Agent, 자동화 등을 조회하고 관리하는 도구입니다. 브라우저에서 로그인한 계정으로 사용할 수 있으며, 터미널에서는 aipctl이라는 이름으로 실행합니다.

Skill 파일을 PC로 내려받거나, Agent 설정을 바꾸거나, 반복하는 조회를 스크립트로 처리할 때 사용할 수 있습니다. PC 터널을 연결하는 기능도 제공합니다.

처음 시작하기

처음 사용한다면 설치와 로그인을 따라 진행하세요. 다음 순서로 첫 Skill 목록을 확인할 수 있습니다.

  1. 설치하기 — Node.js를 준비하고 CLI를 설치합니다.
  2. 로그인하기 — 접속 주소를 설정하고 브라우저에서 로그인합니다.
  3. 첫 명령 실행하기 — 로그인한 조직의 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_ID

SKILL_ID처럼 대문자로 적힌 부분은 자신의 값으로 바꿔 입력합니다. 위 예시에서는 Skill 목록에서 확인한 ID를 사용합니다. 공백이 있는 이름과 문장은 따옴표로 묶습니다.

코드 블록 안의 명령을 복사해 터미널에 붙여 넣고 Enter를 누르면 실행됩니다. 여러 줄이 있는 경우에는 한 줄씩 실행하고 결과를 확인한 뒤 다음 줄로 진행하세요.

Last updated on