사용자 리소스 관리

특정 사용자의 챗봇·도구·지식·노트·스킬·워크플로·대화·Agent 세션을 조회하고 삭제하는 방법을 설명합니다.

사용자 상세 페이지

사용자 관리(/admin/users) 목록에서 사용자 이름을 클릭하면 사용자 상세 페이지(/admin/users/:id)로 진입합니다. 여기서 해당 사용자가 보유한 모든 리소스를 조회하고 개별 삭제할 수 있습니다.

현재 앱 화면 · 예시 데이터

리소스 탭

상세 페이지는 8개의 탭으로 구성됩니다.

내용비고
챗봇사용자가 만든 챗봇 목록모델명·설명·생성일 표시
워크플로워크플로 목록상태·설명·생성일 표시
도구OpenAPI/MCP 도구유형(api/mcp)·출처(user/agent) 표시
지식지식 베이스출처·설명·생성일 표시
노트노트 목록경로·출처·수정일 표시
스킬스킬 목록트리거·출처·수정일 표시
대화일반 대화(Conversation)챗봇 ID·생성일 표시, 📜 아이콘으로 메시지 내역 조회 가능
Agent 세션이너릿 세션세션 ID·마지막 메시지 시각 표시, 📜 아이콘으로 대화 로그 조회 가능

각 탭은 무한 스크롤로 페이지네이션되며, 모바일에서는 카드 목록, 데스크톱에서는 표 형태로 표시됩니다.

대화 내역 및 로그 조회

대화 탭과 Agent 세션 탭에서 각 행의 📜 아이콘을 클릭하면 해당 대화의 전체 메시지 내역을 모달로 조회할 수 있습니다. 노트 탭의 📄 아이콘으로는 노트 본문(마크다운 렌더링·태그·이미지)을 확인할 수 있습니다.

  • 일반 대화 메시지 뷰어 — 사용자와 챗봇 간의 전체 대화 내용(role, content, tool_calls, token_usage)을 시간순으로 표시합니다.
  • Agent 세션 로그 뷰어 — 에이전트와 사용자 간의 대화를 segments(텍스트/도구 호출) 단위로 렌더링하며, 각 메시지의 토큰 사용량도 표시합니다.

관리자는 이 기능으로 사용자가 실제로 어떤 대화를 했는지, 에이전트가 어떤 도구를 사용했는지 확인할 수 있습니다.

리소스 삭제

각 행의 휴지통 아이콘을 누르면 삭제 확인 대화상자가 열립니다. 확인을 누르면 해당 리소스가 영구 삭제됩니다.

주의: 삭제는 되돌릴 수 없습니다. 삭제 시 해당 리소스에 종속된 데이터(예: 챗봇의 도구/지식 연결, 지식 베이스의 Weaviate 컬렉션과 업로드 파일)도 함께 정리됩니다.

도메인별 삭제 동작

  • 챗봇 — 챗봇 설정과 도구/지식 연결이 삭제됩니다. 관련 대화는 유지됩니다.
  • 지식 베이스 — 검색 인덱스, 업로드된 파일, DB 행이 모두 정리됩니다.
  • 스킬 — 삭제 처리되며 에이전트 작업 환경에도 동기화됩니다.
  • Agent 세션 — 세션 데이터가 최선책(best-effort)으로 삭제됩니다.

작업 환경 강제 중단

Agent 세션 탭이 활성화된 상태에서 페이지 상단의 "파드 강제 중단" 버튼을 누르면, 사용자의 에이전트 작업 환경을 강제로 중단할 수 있습니다.

  • 작업 파일은 보존되므로 사용자의 워크스페이스(파일, 스킬 등)는 유지됩니다.
  • 런타임 권한은 회수되지 않습니다 — 다음 대화 시 환경이 자동으로 다시 준비됩니다.

권한 회수와의 차이: 권한 회수는 권한 자체를 걷어가 사용자가 에이전트를 아예 쓸 수 없게 합니다(선택에 따라 작업 파일·산출물까지 삭제). 반면 강제 중단은 권한은 그대로 둔 채 환경만 재시작하는 용도입니다. 환경이 멈췄거나 응답하지 않을 때 유용합니다.

사용자 관리 페이지에서의 필터 / 벌크

사용자 관리(/admin/users)의 "전체 사용자" 탭에서도 다음 기능을 쓸 수 있습니다.

필터

상단의 필터 바에서 역할 / 상태 / 그룹 기준으로 사용자 목록을 좁힐 수 있습니다. 필터 변경 시 목록이 자동으로 다시 로드됩니다.

벌크 작업

각 행의 체크박스로 여러 사용자를 선택한 뒤, 상단 툴바에서 일괄 작업을 수행할 수 있습니다.

  • 활성화 — 선택한 사용자를 한 번에 active
  • 비활성화 — 선택한 사용자를 inactive
  • 삭제 — 선택한 사용자를 계정과 모든 생성물과 함께 영구 삭제

벌크 삭제는 되돌릴 수 없습니다. 확인 대화상자에서 최종 승인해야 실행됩니다.

관련 문서