자동화 관리
자동화의 설정과 실행 이력을 조회하고, 지원하는 트리거의 자동화를 생성·수정하거나 활성 상태를 변경합니다. 접근 가능한 자동화와 변경 권한은 계정·조직 정책에 따라 달라집니다.
설정과 이력 확인하기
aipctl automation list
aipctl automation list --name "업무 정리" --json
aipctl automation get AUTOMATION_ID
aipctl automation get AUTOMATION_ID --json
aipctl automation history AUTOMATION_ID
aipctl automation history AUTOMATION_ID --page 2목록에서 ID를 확인한 뒤 상세 설정과 실행 이력을 살펴보세요. 목록은 첫 50개를 조회하며 다음 페이지 옵션이 없습니다. 더 많은 자동화를 확인해야 한다면 웹을 사용하세요. 실행 이력은 --page로 다음 페이지를 조회할 수 있습니다.
트리거 설정 정보 조회하기
automation triggers는 자동화 목록이 아니라, 트리거를 설정할 때 필요한 서비스별 정보를 조회합니다. Webhook은 서비스 종류를 필수로 지정합니다.
aipctl automation triggers webhook --service-type GITHUB--service-type에는 GITHUB, JIRA, SALESFORCE, CUSTOM을 지정할 수 있습니다. 출력된 설정 정보를 확인한 뒤 해당 Webhook 설정에 사용하세요. 이 명령이 자동화를 생성하거나 Webhook을 실행하지는 않습니다.
도움말에는 외부 서비스용 --account-id·--folder-id도 표시되지만, 현재 CLI에서는 Gmail·Outlook·Google Drive·Box의 트리거 설정 정보 조회가 제한됩니다. 해당 연결 설정은 웹에서 진행하세요. 예약·My Drive의 설정을 조회하기 위해 이 명령에 schedule·my-drive를 넣는 방식은 지원하지 않습니다.
예약 자동화 만들기
사용할 Agent를 먼저 확인합니다.
aipctl agent list다음 내용을 automation.json으로 저장하고 AGENT_ID를 실제 ID로 바꿉니다. 매일 서울 시간 오전 9시에 실행하는 예시입니다.
{
"name": "매일 업무 정리",
"triggerType": "SCHEDULE",
"agentId": "AGENT_ID",
"prompt": "오늘 확인할 업무를 정리해 주세요.",
"triggerProviderType": "SCHEDULE",
"trigger": {
"schedule": {
"timeZone": "Asia/Seoul",
"recurrenceType": "DAILY",
"recurrence": {
"daily": { "frequency": 1, "timeOfDay": "09:00" }
}
}
}
}aipctl automation create ./automation.json
aipctl automation get NEW_AUTOMATION_ID생성 결과의 ID로 시간대·주기·Agent·활성 상태를 확인합니다. 활성화하면 예약 조건에 따라 Agent가 실행되므로 프롬프트와 사용할 리소스를 검토한 뒤 진행하세요.
aipctl automation enable NEW_AUTOMATION_ID실행 후에는 automation history로 결과를 확인합니다. 생성·활성화 성공과 개별 실행 성공은 별개입니다.
설정 변경하기
다음 내용을 automation-update.json으로 저장하고 AGENT_ID를 사용할 실제 ID로 바꿉니다. 매일 오전 10시로 변경하는 예시입니다. 수정 요청에는 생성 요청의 triggerType을 넣지 않습니다.
{
"name": "매일 업무 정리",
"agentId": "AGENT_ID",
"prompt": "오늘 확인할 업무와 우선순위를 정리해 주세요.",
"triggerProviderType": "SCHEDULE",
"trigger": {
"schedule": {
"timeZone": "Asia/Seoul",
"recurrenceType": "DAILY",
"recurrence": {
"daily": { "frequency": 1, "timeOfDay": "10:00" }
}
}
}
}aipctl automation disable AUTOMATION_ID
aipctl automation update AUTOMATION_ID ./automation-update.json
aipctl automation get AUTOMATION_ID
aipctl automation enable AUTOMATION_ID수정 파일은 바꾸려는 한 항목만 넣는 파일이 아닙니다. 유지할 설정도 함께 입력하고 변경 후 상세를 다시 확인하세요. 조회 결과 전체를 그대로 입력 파일로 사용하지 마세요.
Webhook·My Drive 자동화의 입력
생성·수정 명령은 같은 JSON 파일 입력 방식을 사용하지만 트리거에 따라 필드가 달라집니다.
| 종류 | 생성 시 triggerType | triggerProviderType | trigger에 넣는 항목 |
|---|---|---|---|
| 예약 | SCHEDULE | SCHEDULE | schedule |
| Webhook | WEBHOOK | WEBHOOK | webhook |
| My Drive 폴더 감시 | FOLDER_WATCH | MY_DRIVE | myDrive |
예를 들어 My Drive 폴더에 들어오는 PDF를 처리하려면 생성 파일을 다음과 같이 작성합니다. AGENT_ID와 FOLDER_ID는 실제 값으로 바꾸세요. 폴더 ID는 aipctl drive list에서 확인합니다.
{
"name": "PDF 자료 정리",
"triggerType": "FOLDER_WATCH",
"agentId": "AGENT_ID",
"prompt": "등록된 PDF 자료를 요약해 주세요.",
"triggerProviderType": "MY_DRIVE",
"trigger": {
"myDrive": {
"folderId": "FOLDER_ID",
"watchSubfolders": false,
"fileNamePatterns": ["*.pdf"]
}
}
}watchSubfolders는 하위 폴더까지 감시할지, fileNamePatterns는 어떤 파일명을 대상으로 할지 정합니다. 파일을 읽고 처리하는 데 필요한 Agent 설정과 권한도 확인하세요.
Webhook을 생성할 때는 webhook에 serviceType과 필요한 config를 넣습니다. config의 항목은 위의 automation triggers webhook --service-type ... 결과를 기준으로 작성하세요. Webhook 주소·비밀정보는 상세 조회에 그대로 표시되지 않을 수 있으므로 연결 설정은 웹의 안내를 함께 사용합니다.
중지하거나 삭제하기
aipctl automation disable AUTOMATION_ID
aipctl automation get AUTOMATION_ID
aipctl automation delete AUTOMATION_ID --forcedisable은 자동화의 활성 상태를 바꿉니다. 이미 실행 중인 작업이 즉시 취소되었다는 의미는 아닙니다. 이력에서 진행 상태를 확인하세요.
지원하는 범위
| 작업 | 사용 범위 |
|---|---|
| 생성·수정·삭제·활성 상태 변경 | 예약(SCHEDULE), Webhook(WEBHOOK), My Drive(MY_DRIVE) 트리거 |
| 다른 외부 서비스의 자동화 | 저장된 상세를 조회할 수 있어도 CLI에서 변경하는 기능은 제한됩니다. 설정은 웹에서 진행하세요. |
| 즉시 실행·실행 취소·Webhook 주소 재발급 | 해당 작업이 허용된 환경에서 사용합니다. |
트리거 설정은 종류에 맞는 항목 하나만 넣습니다. 예약 예시의 schedule을 다른 종류의 자동화에 그대로 사용하지 마세요. Webhook·My Drive 설정 방법은 웹 자동화 가이드도 참고할 수 있습니다.
즉시 실행과 실행 취소
자동화를 즉시 실행하거나 실행 이력의 특정 작업에 취소를 요청합니다. 실행이 제한된 환경에서는 웹에서 진행하세요.
aipctl automation get AUTOMATION_ID
aipctl automation run AUTOMATION_ID
aipctl automation history AUTOMATION_IDrun은 즉시 실행을 요청합니다. 지원하는 예약 자동화 등에 사용하며 Webhook처럼 수동 실행을 지원하지 않는 유형은 거절될 수 있습니다. 요청 성공은 작업 완료를 뜻하지 않으므로 이력에서 결과를 확인하세요. Agent 실행에 따른 사용량이 발생할 수 있습니다.
취소하려면 이력의 실행 순번을 지정합니다.
aipctl automation cancel AUTOMATION_ID SEQ
aipctl automation history AUTOMATION_IDSEQ는 이력에 표시되는 정수 순번이며 자동화 ID와 다릅니다. 취소 가능한 상태인지 확인하고 실행하세요. 이미 완료된 실행은 거절될 수 있고, 취소 요청 성공만으로 외부 작업이 모두 종료되었다고 판단하지 않습니다. 최종 상태를 다시 확인합니다.
Webhook 주소 재발급
Webhook을 사용하는 자동화인지 확인한 뒤 실행합니다.
aipctl automation webhook-regen AUTOMATION_ID기본 출력은 주소를 가립니다. 새 주소 원문이 필요한 경우 비공개 터미널에서 다음 옵션을 사용합니다.
aipctl automation webhook-regen AUTOMATION_ID --show-sensitive이 명령을 다시 실행하면 다시 재발급을 요청합니다. 첫 실행의 주소를 조회만 하는 옵션이 아닙니다. 원문이 필요하다면 처음부터 표시 여부를 결정하고 실행하세요. 재발급 후 외부 서비스의 발신 주소 설정을 갱신하고 실제 전달 결과를 확인합니다. 기존 주소의 사용 여부도 확인하며, 주소가 포함된 터미널·로그는 공유하지 않습니다.