에이전트 탭은 에이전트를 편집하거나 삭제할 수 없습니다. 에이전트에 대한 변경은 적절한 프로젝트 역할을 가진 사용자가 해당 소유 프로젝트 내에서 수행해야 합니다.
전제 조건
슈퍼 관리자로 표시된 사용자만 이 탭에 접근할 수 있습니다. 모든 백엔드 엔드포인트는 독립적으로 관리자 상태를 확인하고 UI 외부에서 이루어진 직접 API 호출을 포함한 모든 다른 사용자에 대해403 Unauthorized를 반환합니다.
찾는 위치
슈퍼 관리자 → 사용자 및 워크스페이스 → 에이전트로 이동합니다. 이 탭은 대시보드의 메인 콘텐츠 영역에서 앱 라이선스, 프로젝트, 팀, Teams 봇 및 사용자 옆에 렌더링됩니다.에이전트 테이블
테이블은 기본적으로 **최종 수정(내림차순)**순으로 정렬됩니다. 이 정렬은 페이지 넘김 전반에 걸쳐 안정적입니다 — 앞뒤로 페이지를 넘겨도 세션 중간에 행이 셔플되지 않습니다.| 열 | 설명 |
|---|---|
| 에이전트 | 에이전트의 이름. 비어 있으면 “제목 없음”으로 대체됩니다. |
| 에이전트 ID | 채팅 및 프로젝트 라우팅에서 사용되는 공개 에이전트 식별자. 고정폭으로 잘려서 표시됩니다 — 전체 값을 보려면 호버하세요. |
| 프로젝트 | 소유 프로젝트의 이름과 두 번째 줄에 프로젝트 ID가 있습니다. |
| 팀 | 프로젝트를 소유한 팀. |
| 작성자 | 에이전트의 첫 번째 버전을 만든 사용자. 버전 기록 이전의 레거시 에이전트의 경우 프로젝트 소유자로 대체됩니다. 이름과 그 아래에 이메일로 표시됩니다. |
| 생성일 | 로컬 시간대에서의 에이전트 생성 시간. |
| 수정일 | 최종 수정 시간. 기본 정렬 열. |
| 메모리 | 켜기/끄기 배지. NULL은 끄기로 처리됩니다. |
| 프롬프트 라이브러리 | 프롬프트 라이브러리 기능의 켜기/끄기 배지. NULL은 끄기로 처리됩니다. |
| 빌딩 블록 | 에이전트에 첨부된 빌딩 블록 수. |
| 작업 | 눈 아이콘 — [세부 정보 보기 모달](#세부-정보-보기-모달]을 엽니다. |
값이
NULL이거나 비어 있으면 타임스탬프를 포함하여 대시(—)가 나타납니다.검색 대 목록 모드
탭은 검색 상자가 활성화되어 있는지 여부에 따라 두 가지 모드로 작동합니다.목록 모드(기본값)
- 검색 상자가 비어 있을 때 활성화
- 테이블은 페이지당 12행으로 페이지 처리
- 페이지 처리 컨트롤은
X페이지/Y페이지를 표시 - 필터가 일반적으로 적용됨; 필터가 변경되면 페이지가 1로 재설정
검색 모드
- 검색 상자에 입력하면 즉시 활성화(400ms 디바운스)
- 페이지 처리가 숨겨짐; 백엔드가 단일 응답에서 최대 200개의 일치 행을 반환
- 실제 일치 수가 200개를 초과하면 요약 줄에
4815건 일치 (처음 200건 표시 — 더 보려면 검색을 좁히세요)가 나타납니다 - 검색은 에이전트 이름, 에이전트 ID, 프로젝트 이름 및 작성자 이름/이메일에서 동시에 대소문자 구분 없는 부분 일치입니다
_또는%문자가 포함된 UUID를 붙여넣어도 안전합니다 — 해당 문자는 와일드카드로 처리되지 않습니다- 최대 쿼리 길이: 100자
필터
검색창 아래에 네 가지 필터가 나타납니다. 필터를 변경하면 페이지가 1로 재설정됩니다.| 필터 | 동작 |
|---|---|
| 프로젝트 | 에이전트가 하나 이상 있는 모든 프로젝트의 드롭다운, 이름순으로 정렬. |
| 작성자 | 모든 고유 작성자의 드롭다운. 이름(이메일)로 표시됩니다. |
| 메모리 | 3가지 상태: 모두 / 활성화 / 비활성화. 비활성화에는 FALSE와 NULL이 모두 포함됩니다. |
| 프롬프트 라이브러리 | 메모리와 동일한 3가지 상태 의미. |
프로젝트 및 작성자 드롭다운은 최대 1,000개 항목으로 제한됩니다. 한도에 도달하면 드롭다운 아래에 호박색 힌트가 나타납니다. 목록에 표시되지 않는 프로젝트나 작성자를 찾으려면 검색 상자를 사용하세요 — 검색은 전체 테이블에 대해 실행됩니다.
세부 정보 보기 모달
모든 행의 눈 아이콘을 클릭하면 해당 에이전트의 전체 구성이 열립니다. 모달은 열릴 때 항상 실시간 데이터를 다시 가져옵니다. 헤더 그리드 — 한눈에 보는 핵심 구성 필드:| 필드 | 설명 |
|---|---|
| 에이전트 이름 / 에이전트 ID | 식별자 |
| 프로젝트(이름 + ID) | 소유 프로젝트 |
| 팀(이름 + ID) | 소유 팀 |
| 작성자(이름 + 이메일 + 사용자 ID) | 첫 번째 버전 저자, 프로젝트 소유자 대체 |
| 온도 | 소수점 이하 2자리로 포맷 |
| 생성일 / 최종 수정일 | 타임스탬프 |
| 빌딩 블록 | 첨부된 블록 수 |
| 메모리 활성화 / 프롬프트 라이브러리 | 기능 플래그 |
| URL 마스킹 / 소스 보강 / 인라인 인용 / 링크 필터 | 응답 동작 플래그 |
| Google 사용 / KB 사용 | 소스 플래그 |
- 페르소나 — 전체 시스템 프롬프트(내보내기와 달리 잘리지 않음)
- 첨부된 블록 — 빌딩 블록 구성
- 규칙 — 에이전트 규칙
- 문서 키 — 문서 범위 구성
- 메모리 설정 — 메모리 구성
- 프롬프트 설정 — 프롬프트 라이브러리 구성
—로 렌더링됩니다.
데이터 새로고침
새로고침 버튼(원형 화살표, 검색 상자 오른쪽)은 현재 쿼리를 다시 실행합니다 — 동일한 페이지, 검색 및 필터. 검색 상자에 보류 중인 입력이 있을 때 새 검색을 트리거하지 않습니다. 변경될 쿼리의 오래된 결과를 표시하지 않기 위해 디바운스가 안정될 때까지 기다립니다. 테이블 쿼리는 30초 동안 캐시되므로 이미 방문한 페이지 또는 필터 상태 간에 탐색하면 즉시 수행됩니다.내보내기
내보내기 드롭다운(오른쪽 상단)은 현재 보기를 다운로드 가능한 파일로 스트리밍합니다 — 모든 활성 검색어와 필터를 포함합니다.| 설정 | 세부 사항 |
|---|---|
| 형식 | CSV 및 XLSX |
| 파일 이름 | agents-<타임스탬프>.csv 또는 agents-<타임스탬프>.xlsx |
| 행 한도 | 100,000행. 이 수를 초과하면 필터를 좁히거나 검색하세요. |
| 타임스탬프 | 브라우저의 로컬 시간대로 포맷 |
| 페르소나 열 | 500자로 잘리고 끝에 ...가 있음 — 전체 프롬프트는 세부 정보 보기에서 열기 |
| 열 순서 | 안정적: name, agent_id, id, project_name, project_id, team_name, team_id, creator_name, creator_email, creator_user_id, … |
일반 워크플로우
프로젝트의 모든 에이전트 찾기
- 슈퍼 관리자 → 에이전트를 엽니다.
- 프로젝트 필터 드롭다운에서 프로젝트를 선택합니다.
- 선택적으로 메모리 또는 프롬프트 라이브러리로 필터링합니다.
- 내보내기를 클릭하여 결과를 파일로 저장합니다.
작성자별 에이전트 감사
- 작성자 필터 드롭다운에서 사용자를 선택합니다.
- 사용자가 드롭다운에 없으면 이름이나 이메일을 검색 상자에 입력하세요 — 검색은 전체 테이블에 대해 실행됩니다.
특정 에이전트의 전체 구성 검사
- 이름으로 에이전트를 검색하거나
agent_id를 검색 상자에 붙여넣습니다. - 눈 아이콘을 클릭합니다.
- 헤더 그리드에서 상위 구성과 JSON 블록에서 페르소나, 규칙, 첨부된 블록 및 설정을 검토합니다.
규정 준수 보고서 작성
- 필터를 적용하여 범위를 정의합니다.
- 내보내기 → XLSX(또는 CSV)를 클릭합니다.
- 파일은 최대 100,000행까지 화면 보기를 정확히 일치시킵니다.
문제 해결
에이전트를 로드하지 못함
에이전트를 로드하지 못함
백엔드가 2xx 외의 응답을 반환했습니다. 브라우저 DevTools → 네트워크를 열어 상태 코드를 확인하세요; 전체 오류 세부 사항은 백엔드 로그의
Error fetching agents 아래에 있습니다.필터 드롭다운에 프로젝트 또는 작성자가 없음
필터 드롭다운에 프로젝트 또는 작성자가 없음
드롭다운은 1,000개 항목으로 제한됩니다. 드롭다운 아래의 호박색 “처음 1000개 표시…” 힌트를 확인하세요. 대신 검색 상자를 사용하세요 — 전체 테이블을 쿼리합니다.
검색에 예상보다 적은 행이 표시됨
검색에 예상보다 적은 행이 표시됨
검색 결과는 응답당 200행으로 제한됩니다. 요약 줄에 실제 일치 수가 표시됩니다. 필터를 추가하거나 쿼리를 좁혀 결과 세트를 200개 이하로 만드세요.
작성자 열에 실제 저자가 아닌 프로젝트 소유자가 표시됨
작성자 열에 실제 저자가 아닌 프로젝트 소유자가 표시됨
에이전트가 버전 기록이 존재하기 전에 생성되었습니다. 이러한 레거시 에이전트에는 프로젝트 소유자가 의도적인 대체로 사용됩니다.
메모리 또는 프롬프트 라이브러리가 꺼짐으로 표시되지만 기능이 구성된 것으로 보임
메모리 또는 프롬프트 라이브러리가 꺼짐으로 표시되지만 기능이 구성된 것으로 보임
열은
NULL을 끄기로 처리하며 이는 런타임 동작과 일치합니다. 값이 켜져야 하는 경우 데이터베이스에서 직접 agents.memory_enabled 또는 agents.prompt_library_enabled를 확인하세요.내보내기 파일에 ~500자 이후의 페르소나 텍스트 누락
내보내기 파일에 ~500자 이후의 페르소나 텍스트 누락
페르소나는 내보내기에서 의도적으로 500자로 잘립니다. 전체 시스템 프롬프트를 보려면 세부 정보 보기 모달을 여세요.
모든 요청에 403 Unauthorized
모든 요청에 403 Unauthorized