사용자 리소스 관리

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

사용자 상세 페이지

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

현재 앱 화면 · 예시 데이터

리소스 탭

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

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

모바일에서는 카드 목록, 데스크톱에서는 표로 표시됩니다. 목록 끝으로 내려가면 다음 항목을 자동으로 불러오며, 더 보기 버튼으로도 이어서 조회할 수 있습니다. 처음 표시된 항목이 전체 목록은 아닐 수 있습니다.

대화 / Agent 세션 탭에서는 검색어를 입력하고 검색 버튼이나 Enter를 누르세요. 모바일에서도 검색 버튼으로 조회할 수 있습니다. 탭이나 검색 조건을 바꾸면 해당 조건의 목록을 새로 불러옵니다.

불러오기에 실패하면 오류 안내와 다시 시도 버튼이 표시됩니다. 오류는 검색 결과가 없다는 뜻이 아닙니다. 다음 항목을 불러오다 실패한 경우 이미 읽은 목록은 유지되며, 다시 시도해서 이어 볼 수 있습니다.

대화 내역 및 로그 조회

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

  • 일반 대화 메시지 뷰어 — 대화 내용, 도구 호출, 토큰 사용량과 저장된 검색 근거를 확인합니다.
  • Agent 세션 로그 뷰어 — 대화와 도구 실행 결과, 첨부파일·산출물, 토큰 사용량을 확인합니다.
  • 자율 에이전트의 일반 대화 화면에서 생략되는 완료된 도구 상세는 이 관리자 Agent 세션 로그 뷰어에서 조회합니다. 일반 사용자 대화 화면과 표시 범위가 다릅니다.
  • 도구 상세 — 긴 결과도 전체 결과 보기로 페이지를 넘겨 읽고 복사 / 다운로드할 수 있습니다. 변경 전후 내용이 있는 수정 도구는 변경 내용에서 비교합니다.
  • 응답 상태 — 본문이 없는 메시지도 생성 중·실패·취소 등의 안내와 제공된 오류 내용을 확인할 수 있습니다.
  • 이전 기록 — 로그 목록에서도 더 보기로 다음 기록을 불러옵니다. 조회 실패 시에는 다시 시도를 누르세요.

로그는 읽기 전용입니다. 기록을 열어 보는 것으로 도구가 다시 실행되거나 대화가 재개되지는 않습니다.

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

한글 화면 예시

모바일에서 응답 상태와 오류 내용을 확인하는 관리자 대화 로그

관리자 로그 뷰어에서 제공된 전체 도구 결과를 펼쳐 읽고 복사·다운로드하는 화면

개인정보가 없는 예시 대화로 촬영한 화면입니다.

리소스 삭제

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

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

도메인별 삭제 동작

  • 챗봇 — 챗봇 설정과 도구/지식 연결이 삭제됩니다. 관련 대화는 유지됩니다.
  • 지식 베이스 — 검색 인덱스와 업로드된 파일이 함께 정리됩니다.
  • 스킬 — 삭제 처리되며 에이전트 작업 환경에도 동기화됩니다.
  • Agent 세션 — 선택한 세션의 대화 기록을 삭제합니다.

작업 환경 강제 중단

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

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

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

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

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

필터

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

벌크 작업

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

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

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

관련 문서