> ## Documentation Index
> Fetch the complete documentation index at: https://manual.seahorse.dnotitia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> Agent 생성 — 7 개 탭 (Basic Settings · Users · Endpoints · Tables · Tools · Slack · Rules) 으로 구성된 AI 에이전트 생성 폼

# Agent create

# Agent 생성

**경로**: Console → **Agent Ops** → **Agent** → 우측 상단 **Create Agent**

<img src="https://mintcdn.com/dnotitia-328335e7/pi5a4xJA1fTcDZ9m/.gitbook/assets/admin__AgentOpsCreate1.png?fit=max&auto=format&n=pi5a4xJA1fTcDZ9m&q=85&s=1f337fec4aeab4a7035add03f2573f40" alt="Create Agent 화면" width="982" height="804" data-path=".gitbook/assets/admin__AgentOpsCreate1.png" />

에이전트 생성은 **7 개 탭** 으로 구성됩니다. 필수 탭은 **Basic Settings** 하나이며, 나머지는 에이전트 기능·공개 범위에 따라 선택적으로 구성합니다. 우측 하단 **Save** 버튼으로 저장.

| 탭                           | 필수 | 용도                       |
| --------------------------- | -- | ------------------------ |
| **Basic Settings** ⚙        | ✓  | 이름·설명·API 권한·서브도메인       |
| **Users** 👤                |    | 접근 제어 — 인증 요구 여부, 허용 사용자 |
| **Endpoints** ⚡             |    | LLM 추론 엔드포인트 선택          |
| **Tables** ▦                |    | 에이전트가 검색할 벡터 Table       |
| **Tools** 🧰                |    | MCP 도구 · RDB 연결          |
| **Slack** 💬                |    | Slack 리스너 토큰 · 기본 LLM    |
| **Rules** 🛡 *(On-prem 전용)* |    | 응답 규칙 — Cloud 에서 비활성     |

## 1. Basic Settings 탭 (필수)

### Basic Information

| 필드                         | 설명                                   | 검증 |
| -------------------------- | ------------------------------------ | -- |
| **Name** `*`               | 에이전트 이름 (예: `my-agent`)              | 필수 |
| **Description**            | 에이전트 용도·목적 (멀티라인)                    | 선택 |
| **API Key Permission** `*` | 발급될 API 키 권한 — `READ` / `WRITE` 드롭다운 | 필수 |

**API Key Permission 값**

| 값         | 허용 동작                             |
| --------- | --------------------------------- |
| **READ**  | 에이전트 조회·질의 전용 — 외부 RAG, 읽기 전용 챗봇  |
| **WRITE** | 조회 + 에이전트 구성·리소스 변경 가능 — 관리자 스크립트 |

<Info>
  권장은 **READ**. Write 권한은 구성 자동화가 꼭 필요한 관리자 키에만 부여하세요. 자세한 가이드: [API Keys](/console/management/api-keys)
</Info>

### Subdomain

`Set a custom subdomain for this agent. Once set, you can access the agent via this subdomain.`

| 요소                        | 설명                                                                |
| ------------------------- | ----------------------------------------------------------------- |
| **서브도메인 입력**              | 예: `my-chatbot` — 배포 URL `{subdomain}.agent.seahorse.dnotitia.ai` |
| **Check Availability** 버튼 | 서브도메인 중복 여부 확인                                                    |
| 규칙 안내                     | `Only lowercase letters, numbers, and hyphens (-) are allowed`    |

<Warning>
  서브도메인은 배포 URL 에 박히며, 이후 변경 시 기존 URL 이 404 가 됩니다. 외부 서비스·Slack 봇에 URL 이 박혀 있다면 신중히 선택하세요.
</Warning>

## 2. Users 탭 — Access Control

`Configure who can access this agent`

### Require Authentication (토글)

| 상태          | 의미                                                                      |
| ----------- | ----------------------------------------------------------------------- |
| **ON** (기본) | `Any user who is logged in can access this agent.` — 테넌트 로그인 사용자 누구나 접근 |
| **OFF**     | 인증 없이 공개 접근 허용 (예: 공개 챗봇)                                               |

### 특정 사용자 선택

`Select specific users below, or leave empty to allow all authenticated users.`

* **Search by email…** — 테넌트 사용자 검색
* 체크박스로 개별 선택 (예: `admin@dnotitia.com` `OWNER` 뱃지)
* 하단 `N / M` 은 **선택 / 전체** 카운트

### External Users

`Add emails of external users who are not registered in the tenant.`

* **Enter external user email…** → **+ Add** — 테넌트 외부 사용자 이메일을 추가 가능
* 외부 사용자는 해당 에이전트에만 접근 가능

<Info>
  선택 사용자 0 명이면 **모든 인증된 사용자** 가 접근 가능합니다. 민감 데이터를 다루는 에이전트는 반드시 **특정 사용자** 를 지정하세요.
</Info>

## 3. Endpoints 탭 — Inference Endpoint Selection

`Select inference endpoints for text generation`

<Warning>
  **Only tool call enabled inference endpoints can be selected.** Tool 호출을 지원하는 LLM 엔드포인트만 에이전트에 연결할 수 있습니다.
</Warning>

### 목록 표시

| 요소                                  | 설명          |
| ----------------------------------- | ----------- |
| 이름 (예: `anthropic/claude-opus-4.5`) | 모델 식별자      |
| `ACTIVE` 뱃지                         | 현재 사용 가능    |
| UUID 칩 (예: `6f0f0101`)              | 엔드포인트 고유 ID |
| 부제                                  | 원본 모델명      |

### 동작

* **Search by name…** — 이름 필터
* 체크박스로 **다중 선택** 가능
* 하단 `0 / 7` — 선택 / 전체 카운트
* 우측 상단 **None selected** 뱃지 — 현재 선택 수

선택 가능한 엔드포인트는 운영자가 [Inference Endpoints](/internal/system-admin/settings/inference-endpoints) 에서 등록한 목록입니다.

## 4. Tables 탭 — Table Selection

`Select tables for this agent to use.` · `Connected storage will be automatically included.`

<Info>
  **Only tables created from storage can be selected.** — Storage 에서 생성된 Table 만 검색 대상으로 선택 가능합니다. [수동 생성 Table](/console/database/tables/table-create) 은 에이전트 검색에 연결되지 않습니다.
</Info>

### 목록 표시

| 요소                                       | 설명                 |
| ---------------------------------------- | ------------------ |
| Table 이름 (예: `bjhan-storage`, `jh-7994`) | 연결된 Storage 이름과 동일 |
| `success` 뱃지                             | 스토리지 상태            |
| UUID 칩 (예: `ebcf5f75`)                   | Table 고유 ID        |

### 동작

* **Search by name…** — 이름 필터
* 체크박스 다중 선택
* 하단 `0 / 17` — 선택 / 전체
* 선택된 Table 의 연결 Storage 는 **자동 포함**

## 5. Tools 탭 — Tool Selection

`Select tools for this agent to use`

* 등록된 MCP 도구·Built-in 도구 목록에서 다중 선택
* 비어 있으면 **No tools available** + 렌치 아이콘 — 먼저 [Tool Management](/console/agent-ops/agent-tool) 에서 도구 등록 필요
* 우측 상단 **None selected** 뱃지

<Info>
  GitHub·PostgreSQL·Slack·Atlassian 등 표준 도구는 **템플릿 기반** 으로 1 분 내 등록 가능합니다. [Tool 템플릿](/console/agent-ops/agent-tool/templates)
</Info>

## 6. Slack 탭 — Slack Configuration

`Configure Slack integration tokens to enable Slack listener for this agent.`

에이전트가 Slack 워크스페이스의 멘션을 **양방향으로 받고 답변** 하도록 Slack App 토큰을 등록합니다.

| 필드                       | 형식                 | 설명                                                                                                                               |
| ------------------------ | ------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| **Slack Bot Token**      | `xoxb-…`           | `Slack Bot User OAuth Token (xoxb-...) for Slack MCP server and listener`                                                        |
| **Slack App Token**      | `xapp-…`           | `Slack App-Level Token (xapp-...) for Socket Mode event listener`                                                                |
| **Slack Signing Secret** | (문자열)              | `Slack Signing Secret for request verification`                                                                                  |
| **Selected Tools**       | 쉼표 구분 (예: `slack`) | `Comma-separated MCP server names for Slack listener tools (e.g., slack, github)`                                                |
| **Default LLM**          | 드롭다운               | `LLM endpoint for Slack listener responses (only endpoints connected to this agent are available)` — **Endpoints 탭에서 선택된 것만 표시** |
| **Response in Thread**   | 토글                 | `When enabled, the agent replies in a thread instead of the main channel` — ON 이면 스레드 답변                                         |

<Info>
  Slack 양방향 Q\&A 구성 전체 레시피: [Slack 으로 문서 받아보기](/agent-chat/recipes/slack-document-delivery)
</Info>

## 7. Rules 탭 *(On-prem 전용)*

<Warning>
  **Rules 탭은 Cloud 에서 비활성화** 되어 있습니다. 응답 규칙·금칙어 룰셋은 On-prem 환경에서만 제공되며, 도입을 원하시면 **별도 상담** 이 필요합니다. Cloud 에서는 [System Prompt](/console/agent-ops/system-prompts) 로 대체하세요.
</Warning>

## 저장

우측 하단 **Save** 버튼 클릭. 유효성 검사 통과 후 에이전트가 `Deploying` 상태로 생성되며, 배포가 완료되면 `Ready` 로 전환되고 **Agent URL** (`{subdomain}.agent.seahorse.dnotitia.ai`) 로 접근 가능합니다.

<Warning>
  * **Subdomain** 은 생성 후 변경이 어렵고, 변경 시 기존 URL 이 404 가 됩니다. 외부 연동 전에 확정하세요.
  * **Deploying** 이 5 분 이상 지속되면 [Agent 상세 → 로그](/console/agent-ops/agent/agent-detail) 에서 원인을 확인하세요.
</Warning>

## 관련 문서

* [Agent 목록](/console/agent-ops/agent/agent-list)
* [Agent 상세](/console/agent-ops/agent/agent-detail) · [Agent 수정](/console/agent-ops/agent/agent-update) · [Agent 삭제](/console/agent-ops/agent/agent-delete)
* [Inference Endpoints](/internal/system-admin/settings/inference-endpoints) — 선택 가능 모델 목록
* [Tool Management](/console/agent-ops/agent-tool) — 도구 등록
* [System Prompt](/console/agent-ops/system-prompts) — 에이전트 행동 가이드
* [활용 가이드](/console/guides) — 7 개 E2E 시나리오