Skip to Content
Skip to Content
Agent 관리

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_ID

Agent 유형에 맞는 설정을 사용하세요. 상세 조회 결과 전체를 그대로 수정 요청에 넣는 방식은 지원하지 않습니다.

사용자 정의 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
instructionAgent의 동작 지침
expectedInstruction현재 지침이 예상한 값과 같을 때만 수정하도록 확인하는 값. 동시 수정으로 충돌하면 최신 내용을 다시 확인합니다.
knowledgeBundleIdList연결할 지식 묶음 ID의 배열. 해당 지식의 접근 권한이 필요합니다.

이 필드는 사용자 정의 Agent용입니다. 기본 제공 Agent에 동일한 설정을 적용한다고 가정하지 마세요.

활성 상태와 공유 설정 확인하기

aipctl agent disable AGENT_ID aipctl agent enable AGENT_ID aipctl admin agent share AGENT_ID aipctl admin agent templates
  • disable·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에 저장하며, 같은 경로에 파일이 있으면 덮어씁니다. 성공 안내의 파일 경로를 확인하세요. 내보낸 설정에는 업무 지침 등이 포함될 수 있으므로 공유 범위를 확인합니다. 내보내기가 거절되면 권한과 해당 서버의 제공 범위를 확인하세요.

Last updated on