> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 에이전트
> 단일 시스템 전체 뷰에서 모든 팀과 프로젝트의 모든 에이전트를 감사하고 검사합니다.
에이전트 탭은 EK의 모든 에이전트에 대한 **읽기 전용 시스템 전체 감사 서페이스**입니다. 슈퍼 관리자가 에이전트를 인벤토리하고, 전체 구성을 검사하며, 프로젝트 및 팀과 연관시키고, 규정 준수 또는 거버넌스 보고를 위해 결과를 내보낼 수 있게 합니다 — 개별 프로젝트에 탐색하지 않고도 가능합니다.
에이전트 탭은 에이전트를 편집하거나 삭제할 수 없습니다. 에이전트에 대한 변경은 적절한 프로젝트 역할을 가진 사용자가 해당 소유 프로젝트 내에서 수행해야 합니다.
## 전제 조건
슈퍼 관리자로 표시된 사용자만 이 탭에 접근할 수 있습니다. 모든 백엔드 엔드포인트는 독립적으로 관리자 상태를 확인하고 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 사용 | 소스 플래그 |
**JSON / 텍스트 블록** — 원본, 스크롤 가능, 보기 좋게 포맷됨:
* **페르소나** — 전체 시스템 프롬프트(내보내기와 달리 잘리지 않음)
* **첨부된 블록** — 빌딩 블록 구성
* **규칙** — 에이전트 규칙
* **문서 키** — 문서 범위 구성
* **메모리 설정** — 메모리 구성
* **프롬프트 설정** — 프롬프트 라이브러리 구성
비어 있는 값과 null 값은 전체적으로 `—`로 렌더링됩니다.
## 데이터 새로고침
**새로고침 버튼**(원형 화살표, 검색 상자 오른쪽)은 현재 쿼리를 다시 실행합니다 — 동일한 페이지, 검색 및 필터. 검색 상자에 보류 중인 입력이 있을 때 새 검색을 트리거하지 않습니다. 변경될 쿼리의 오래된 결과를 표시하지 않기 위해 디바운스가 안정될 때까지 기다립니다.
테이블 쿼리는 **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`, … |
## 일반 워크플로우
### 프로젝트의 모든 에이전트 찾기
1. **슈퍼 관리자 → 에이전트**를 엽니다.
2. **프로젝트** 필터 드롭다운에서 프로젝트를 선택합니다.
3. 선택적으로 **메모리** 또는 **프롬프트 라이브러리**로 필터링합니다.
4. **내보내기**를 클릭하여 결과를 파일로 저장합니다.
### 작성자별 에이전트 감사
1. **작성자** 필터 드롭다운에서 사용자를 선택합니다.
2. 사용자가 드롭다운에 없으면 이름이나 이메일을 검색 상자에 입력하세요 — 검색은 전체 테이블에 대해 실행됩니다.
### 특정 에이전트의 전체 구성 검사
1. 이름으로 에이전트를 검색하거나 `agent_id`를 검색 상자에 붙여넣습니다.
2. 눈 아이콘을 클릭합니다.
3. 헤더 그리드에서 상위 구성과 JSON 블록에서 페르소나, 규칙, 첨부된 블록 및 설정을 검토합니다.
### 규정 준수 보고서 작성
1. 필터를 적용하여 범위를 정의합니다.
2. **내보내기 → XLSX**(또는 CSV)를 클릭합니다.
3. 파일은 최대 100,000행까지 화면 보기를 정확히 일치시킵니다.
## 문제 해결
백엔드가 2xx 외의 응답을 반환했습니다. 브라우저 DevTools → 네트워크를 열어 상태 코드를 확인하세요; 전체 오류 세부 사항은 백엔드 로그의 `Error fetching agents` 아래에 있습니다.
드롭다운은 1,000개 항목으로 제한됩니다. 드롭다운 아래의 호박색 "처음 1000개 표시…" 힌트를 확인하세요. 대신 검색 상자를 사용하세요 — 전체 테이블을 쿼리합니다.
검색 결과는 응답당 200행으로 제한됩니다. 요약 줄에 실제 일치 수가 표시됩니다. 필터를 추가하거나 쿼리를 좁혀 결과 세트를 200개 이하로 만드세요.
에이전트가 버전 기록이 존재하기 전에 생성되었습니다. 이러한 레거시 에이전트에는 프로젝트 소유자가 의도적인 대체로 사용됩니다.
열은 `NULL`을 끄기로 처리하며 이는 런타임 동작과 일치합니다. 값이 켜져야 하는 경우 데이터베이스에서 직접 `agents.memory_enabled` 또는 `agents.prompt_library_enabled`를 확인하세요.
페르소나는 내보내기에서 의도적으로 500자로 잘립니다. 전체 시스템 프롬프트를 보려면 세부 정보 보기 모달을 여세요.
귀하의 계정이 슈퍼 관리자로 표시되지 않았습니다(`users.is_admin = true`). 시스템 관리자에게 문의하세요.