Skip to Content
Skip to Content
파일·대화·연동 조회

파일·대화·연동 조회

파일과 대화의 ID를 찾고, 연결된 서비스와 사용 가능한 모델을 터미널에서 확인합니다.

My Drive 조회와 폴더 관리

aipctl drive list aipctl drive usage

My Drive의 항목을 조회하고 저장 공간 사용량을 확인합니다.

aipctl drive mkdir "보고서" aipctl drive rename ENTRY_ID "새 이름"

mkdir는 루트에 폴더를 만듭니다. CLI에서는 생성할 상위 폴더를 지정할 수 없습니다. rename의 ENTRY_ID에는 바꿀 파일 또는 폴더의 ID를 넣습니다.

aipctl drive list aipctl drive delete ENTRY_ID --force

여러 항목을 삭제하려면 ID를 공백으로 나열합니다. 모든 대상을 확인한 뒤 실행하세요.

aipctl drive delete ENTRY_ID_1 ENTRY_ID_2 --force

폴더 삭제는 하위 항목에도 영향을 줍니다. 삭제 전에 내용과 대상을 확인하세요. 폴더와 하위 항목의 합계가 1,000개를 넘으면 삭제가 거절되므로 웹에서 범위를 나눠 정리합니다.

My Drive 파일 전송

접근 가능한 My Drive 파일을 업로드하거나 다운로드합니다. 파일 전송이 제한된 환경에서는 웹을 사용하세요.

aipctl drive upload ./report.pdf aipctl drive list

업로드는 루트에 파일을 등록하며 상위 폴더 지정 옵션은 없습니다. 완료 안내의 ID와 목록을 확인합니다. 저장 공간이나 파일 제한으로 실패했다면 원인을 확인한 뒤 다시 진행하세요. 결과가 불명확하면 중복 업로드 전에 목록을 확인합니다.

aipctl drive download ENTRY_ID --output ./downloads/report.pdf

저장 경로는 필수이며 --output 대신 -o도 사용할 수 있습니다. 같은 경로의 파일은 덮어쓰므로 저장 대상을 먼저 확인하세요. 성공 안내의 파일 경로·크기를 확인합니다. CLI가 해당 명령을 제공하지 않거나 서버가 거절하면 웹으로 전송하세요.

내 대화 조회

aipctl chat list aipctl chat get CONVERSATION_ID aipctl chat messages CONVERSATION_ID

본인 소유 대화만 조회할 수 있습니다. 조직 관리자라도 다른 사용자의 대화 전체를 읽는 기능은 아닙니다.

  • 대화 목록은 한 번에 최대 50개를 조회합니다.
  • 메시지 텍스트는 민감정보를 가린 뒤 메시지당 최대 500자를 표시합니다. 전체 내용은 웹에서 확인하세요.
  • chat messages에는 --json 옵션이 없습니다.
  • 메시지는 최대 1,000개·전체 데이터 8 MiB 범위에서 조회합니다. 한도를 넘으면 일부만 성공한 결과로 표시하지 않고 오류로 종료합니다.
  • 대화 상세는 웹 화면의 첨부파일·태그·보관 상태를 모두 재현하지 않습니다.

Agent에게 질문을 보내려면 버전·서버 조건을 확인한 뒤 Agent 대화를 참고하세요. 새 일반 대화 메시지 전송은 웹에서 진행합니다.

연결된 MCP 서버 확인

aipctl integration list

접근 가능한 연동과 정책 상태를 확인합니다. AI Operator는 추가로 상세·사용 가능한 연동·도구 목록을 조회할 수 있습니다.

aipctl admin integration available aipctl admin integration get INTEGRATION_ID aipctl admin integration tools INTEGRATION_ID

도구 목록은 이름·설명과 정책 상태를 확인하는 기능입니다. 이 명령으로 도구를 실행하지는 않습니다.

연동 연결 테스트·수정·삭제

연동의 연결 상태를 테스트하고 설정을 수정하거나 삭제할 수 있습니다. 해당 작업의 권한이 필요하며, 실행이 제한된 환경에서는 웹에서 진행하세요.

aipctl integration test INTEGRATION_ID

외부 서비스의 연결을 확인하는 요청입니다. 테스트 성공·실패 메시지를 확인하고, 실패하면 계정 인증과 설정을 점검하세요. 연동이 연결 테스트를 지원하지 않으면 거절될 수 있습니다. 테스트 성공이 모든 도구의 실행 성공을 보장하지는 않습니다.

AI Operator는 허용된 환경에서 연동을 수정·삭제할 수 있습니다.

aipctl admin integration get INTEGRATION_ID aipctl admin integration update INTEGRATION_ID ./integration-update.json aipctl admin integration get INTEGRATION_ID

수정 파일은 해당 연동과 서버 버전이 요구하는 설정으로 작성해야 합니다. 모든 연동에 공통으로 쓸 수 있는 JSON 구조는 없으며, 상세 조회 결과를 그대로 수정 입력으로 사용하지 않습니다. 해당 연동의 수정 형식을 확인할 수 없다면 웹에서 설정하세요. 인증정보를 담은 파일은 저장·공유 범위를 제한합니다.

aipctl admin integration delete INTEGRATION_ID --force aipctl integration list

삭제는 해당 연동을 사용하는 Agent·Preset 등에 영향을 줄 수 있습니다. 연결된 작업과 ID를 먼저 확인하고 삭제 후 목록에서 반영 상태를 확인합니다.

모델 목록 확인

aipctl model list

model list는 모델 ID 목록을 조회합니다. 모델을 실제로 실행하거나 이미지를 생성하는 기능과 구분하세요.

Last updated on