Agent 관리
설치된 Agent를 조회하고 활성 상태를 바꿀 수 있습니다. AI Operator는 Agent 생성·설정 수정·삭제도 수행할 수 있습니다. 대화·내보내기는 버전과 서버에서 허용하는 경우에 사용할 수 있습니다.
목록과 상세 확인하기
aipctl agent list
aipctl agent get AGENT_ID
aipctl agent get AGENT_ID --json목록에서 ID를 선택하고 이름·설명·필요한 연동 정보를 확인합니다. 이 명령은 설정 조회용입니다. Agent에게 질문을 보내는 기능과는 다릅니다.
새 Agent 만들기
다음 내용을 agent.json 파일로 저장합니다. 아래 예시는 이름과 설명을 가진 사용자 정의 Agent를 만드는 기본 설정입니다.
{
"agentType": "CUSTOM",
"custom": {
"displayName": "주간 보고서 도우미",
"shortDescription": "주간 업무 보고서를 정리합니다."
}
}aipctl admin agent create ./agent.json
aipctl agent list반환된 ID로 Agent를 확인하고 사용할 모델·지침 등 필요한 설정을 완료하세요. 생성만으로 모든 설정과 활성화가 완료되지는 않습니다.
설정 수정하기
사용자 정의 Agent의 이름과 설명을 변경하는 예시입니다. 다음 내용을 agent-update.json으로 저장합니다.
{
"agentType": "CUSTOM",
"custom": {
"displayName": "팀 주간 보고서 도우미",
"shortDescription": "팀의 주간 업무를 정리합니다."
}
}aipctl admin agent update AGENT_ID ./agent-update.json
aipctl agent get AGENT_IDAgent 유형에 맞는 설정을 사용하세요. 상세 조회 결과 전체를 그대로 수정 요청에 넣는 방식은 지원하지 않습니다.
사용자 정의 Agent의 모델과 지침도 수정할 수 있습니다. 사용할 모델 ID를 aipctl model list에서 확인한 뒤 다음 설정을 작성합니다.
{
"agentType": "CUSTOM",
"custom": {
"modelName": "MODEL_ID",
"instruction": "주간 업무를 완료한 일, 진행 중인 일, 다음 계획으로 나누어 정리하세요."
}
}MODEL_ID는 해당 조직에서 사용할 수 있는 실제 모델 ID로 바꿉니다. 위 내용을 별도 JSON 파일로 저장해 같은 admin agent update 명령으로 적용하고 상세 정보를 다시 확인하세요. 모델·지침 변경은 이후 Agent의 응답에 영향을 줍니다.
사용자 정의 Agent의 주요 수정 필드는 다음과 같습니다.
| 필드 | 용도 |
|---|---|
displayName | 표시 이름 |
shortDescription, description | 짧은 설명과 상세 설명 |
modelName | 사용할 모델 ID |
instruction | Agent의 동작 지침 |
expectedInstruction | 현재 지침이 예상한 값과 같을 때만 수정하도록 확인하는 값. 동시 수정으로 충돌하면 최신 내용을 다시 확인합니다. |
knowledgeBundleIdList | 연결할 지식 묶음 ID의 배열. 해당 지식의 접근 권한이 필요합니다. |
이 필드는 사용자 정의 Agent용입니다. 기본 제공 Agent에 동일한 설정을 적용한다고 가정하지 마세요.
활성 상태와 공유 설정 확인하기
aipctl agent disable AGENT_ID
aipctl agent enable AGENT_ID
aipctl admin agent share AGENT_ID
aipctl admin agent templatesdisable·enable: 활성 상태를 변경합니다. 조직의 활성화 정책과 권한이 적용됩니다.share: 현재 공유 설정을 조회합니다. 공유 대상을 변경하는 명령이 아닙니다.templates: 생성에 참고할 템플릿 목록을 확인합니다.
삭제하기
aipctl agent get AGENT_ID
aipctl agent disable AGENT_ID
aipctl admin agent delete AGENT_ID --force자동화 등 다른 작업에서 사용하는 Agent인지 확인하고 삭제하세요. 서버에서 사용 중이라는 안내가 나오면 연결된 작업을 먼저 정리합니다.
Agent와 대화하기
사용할 Agent의 ID와 실행 권한이 필요합니다. 대화 실행이 제한된 환경에서는 웹을 사용하세요.
새 대화에는 설치된 Agent ID를 지정합니다.
aipctl agent chat --agentId AGENT_ID --message "이번 주 업무를 정리해 주세요." --json--message는 -m으로도 입력할 수 있습니다. JSON 결과의 conversationId를 저장하면 같은 대화를 이어갈 수 있습니다.
aipctl agent chat --conversation-id CONVERSATION_ID -m "우선순위도 정해 주세요." --json파일의 텍스트를 표준 입력으로 전달하는 예시입니다.
aipctl agent chat --agentId AGENT_ID --json < ./question.txt--message를 지정하면 표준 입력보다 우선합니다. 요청을 보내면 Agent가 실행되고 사용량이 발생할 수 있습니다. 시간 초과·연결 중단 시 같은 질문을 바로 재전송하지 말고 웹이나 대화 조회로 처리 결과를 확인하세요. 명령이 없거나 실행이 거절되면 웹에서 대화합니다.
YAML로 내보내기
내보내기 권한을 확인한 뒤 실행하세요.
aipctl admin agent export AGENT_ID --output ./exports/agent.yaml--output은 -o로도 입력합니다. 생략하면 현재 폴더의 AGENT_ID.yaml에 저장하며, 같은 경로에 파일이 있으면 덮어씁니다. 성공 안내의 파일 경로를 확인하세요. 내보낸 설정에는 업무 지침 등이 포함될 수 있으므로 공유 범위를 확인합니다. 내보내기가 거절되면 권한과 해당 서버의 제공 범위를 확인하세요.