> ## 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.

# 사전 정의 및 사용자 지정 모델

> 에이전트용 LLM 모델을 구성하세요 - 기본 모델을 사용하거나 자체 API 키를 연결하세요

EKB는 최신 및 가장 인기 있는 모델을 제공할 뿐만 아니라, "Bring Your Own Keys"(BYOK) 기능을 통해 사용자 지정 모델에 연결할 수 있게 합니다. 이를 통해 사용자 지정 에이전트를 생성하고 사용 사례에 가장 좋은 결과를 생성하는 LLM을 테스트할 수 있습니다. 이 문서에서는 사용 가능한 다양한 LLM과 사용자 지정 LLM을 에이전트에 연결하는 방법을 알아봅니다.

에이전트는 두 가지 유형의 모델을 사용할 수 있습니다:

<CardGroup cols={2}>
  <Card title="사전 정의 모델" icon="sparkles">
    모든 사용자가 사용할 수 있는 사전 구성된 모델 — API 키 불필요.
  </Card>

  <Card title="사용자 지정 모델 (BYOK)" icon="key">
    자체 API 키로 구성하여 비용 제어와 유연성을 확보하는 모델.
  </Card>
</CardGroup>

## 사전 정의 모델

사전 정의 모델은 기본적으로 사용 가능하며 API 키 구성이 필요하지 않습니다. 이 모델은 EKB에 의해 관리되며 바로 사용할 수 있습니다.

EKB는 OpenAI, Anthropic, Google AI 등 주요 AI 제공업체의 다양한 모델에 대한 접근을 제공합니다. 사용 가능한 모델의 전체 목록은 에이전트를 구성할 때 모델 선택기에 표시됩니다.

### 제공업체별 사용 가능한 모델

에이전트를 구성할 때 모델 선택기 드롭다운에서 모든 사용 가능한 모델을 볼 수 있습니다. 모델은 제공업체별로 정리되어 비용, 기능, 가용성을 표시합니다.

| 모델                        | 제공업체      | 버전                                          | 크레딧 / 1M 입력 | 크레딧 / 1M 출력 | 단종                     |
| ------------------------- | --------- | ------------------------------------------- | ----------- | ----------- | ---------------------- |
| **Haiku 4.5**             | Anthropic | `claude-haiku-4-5-20251001`                 | 100         | 500         | 2026년 10월 15일 이전 단종 없음 |
| **Sonnet 4**              | Anthropic | `claude-sonnet-4-20250514`                  | 300         | 1,500       | 2026년 6월 15일           |
| **Sonnet 4.5**            | Anthropic | `claude-sonnet-4-5-20250929`                | 300         | 1,500       | 2026년 9월 29일 이전 단종 없음  |
| **Sonnet 4.6**            | Anthropic | `claude-sonnet-4-6`                         | 300         | 1,500       | 2027년 2월 17일 이전 단종 없음  |
| **DeepSeek Chat**         | DeepSeek  | `deepseek-chat`                             | 14          | 28          | 2026년 7월 24일           |
| **Gemini 2.5 Flash**      | Google AI | `gemini-2.5-flash`                          | 30          | 250         | 2026년 10월 16일 이전 단종 없음 |
| **Gemini 3.1 Flash-Lite** | Google AI | `gemini-3.1-flash-lite`                     | 25          | 150         | N/A                    |
| **Gemini 3.5 Flash**      | Google AI | `gemini-3.5-flash`                          | 150         | 900         | N/A                    |
| **Llama 4 Scout**         | Groq      | `meta-llama/llama-4-scout-17b-16e-instruct` | 8           | 30          | N/A                    |
| **GPT 4o**                | OpenAI    | `gpt-4o`                                    | 500         | 1,500       | N/A                    |
| **GPT 4o Mini**           | OpenAI    | `gpt-4o-mini`                               | 15          | 60          | N/A                    |
| **GPT 4.1**               | OpenAI    | `gpt-4.1-2025-04-14`                        | 200         | 800         | N/A                    |
| **GPT 4.1 Mini**          | OpenAI    | `gpt-4.1-mini-2025-04-14`                   | 40          | 160         | N/A                    |
| **GPT 4.1 Nano**          | OpenAI    | `gpt-4.1-nano-2025-04-14`                   | 10          | 40          | N/A                    |
| **GPT 5**                 | OpenAI    | `gpt-5`                                     | 125         | 1,000       | N/A                    |
| **GPT 5 Mini**            | OpenAI    | `gpt-5-mini`                                | 25          | 200         | N/A                    |
| **GPT 5 Nano**            | OpenAI    | `gpt-5-nano`                                | 5           | 40          | N/A                    |
| **GPT 5.1**               | OpenAI    | `gpt-5.1`                                   | 100         | 100         | N/A                    |
| **GPT 5.2**               | OpenAI    | `gpt-5.2`                                   | 200         | 1,500       | N/A                    |
| **GPT 5.4**               | OpenAI    | `gpt-5.4-2026-03-05`                        | 250         | 1,500       | N/A                    |
| **GPT 5.4 Mini**          | OpenAI    | `gpt-5.4-mini-2026-03-17`                   | 75          | 450         | N/A                    |
| **GPT 5.4 Nano**          | OpenAI    | `gpt-5.4-nano-2026-03-17`                   | 20          | 125         | N/A                    |
| **GPT 5.5**               | OpenAI    | `gpt-5.5`                                   | 500         | 3,000       | N/A                    |
| **o3 Mini**               | OpenAI    | `o3-mini`                                   | 110         | 440         | N/A                    |

### 모델 선택

<Steps>
  <Step title="에이전트로 이동">
    사이드바에서 **에이전트**로 이동합니다.
  </Step>

  <Step title="에이전트 열기">
    새 에이전트를 만들거나 기존 에이전트를 선택합니다.
  </Step>

  <Step title="일반 탭으로 이동">
    에이전트 구성에서 **일반** 탭을 엽니다.
  </Step>

  <Step title="모델 선택">
    에이전트 이름 옆의 **모델** 드롭다운 선택기를 찾아 사전 정의 모델을 드롭다운에서 선택합니다.
  </Step>
</Steps>

### 모델 정보

각 사전 정의 모델은 다음을 표시합니다:

| 필드        | 설명                                                      |
| --------- | ------------------------------------------------------- |
| **모델 이름** | 표시 이름 (예: "GPT 4o")                                     |
| **제공업체**  | API 제공업체 (OpenAI, Anthropic, Google AI, DeepSeek, Groq) |
| **비용**    | 1M 입력 및 출력 토큰당 크레딧                                      |
| **단종**    | 예정된 단종 또는 단종 날짜                                         |

## 사용자 지정 모델 (BYOK)

Bring Your Own Key(BYOK)를 통해 자체 API 키를 사용하여 사용자 지정 모델을 구성할 수 있습니다. 이를 통해:

<CardGroup cols={2}>
  <Card title="비용 제어" icon="circle-dollar-to-slot">
    자체 API 키와 청구를 사용합니다.
  </Card>

  <Card title="모델 유연성" icon="sliders">
    사전 정의 목록에 없는 모델에 접근합니다.
  </Card>

  <Card title="사용자 지정 엔드포인트" icon="link">
    프라이빗 또는 사용자 지정 모델 엔드포인트에 연결합니다.
  </Card>

  <Card title="제공업체 선택" icon="building">
    호환되는 모든 API 제공업체를 사용합니다.
  </Card>
</CardGroup>

### 지원되는 제공업체

<AccordionGroup>
  <Accordion title="OpenAI">
    표준 OpenAI API 모델, Azure OpenAI 엔드포인트 및 사용자 지정 OpenAI 호환 엔드포인트를 지원합니다.

    | 필드          | 값                                 |
    | ----------- | --------------------------------- |
    | **API 키**   | 귀하의 OpenAI API 키                  |
    | **API URL** | `https://api.openai.com/v1` (기본값) |
    | **모델 이름**   | 예: `gpt-4`, `gpt-3.5-turbo`       |
  </Accordion>

  <Accordion title="Anthropic">
    Anthropic API를 통한 Claude 모델 및 사용자 지정 Anthropic 호환 엔드포인트를 지원합니다.

    | 필드          | 값                                 |
    | ----------- | --------------------------------- |
    | **API 키**   | 귀하의 Anthropic API 키               |
    | **API URL** | `https://api.anthropic.com` (기본값) |
    | **모델 이름**   | 예: `claude-sonnet-4-6`            |
  </Accordion>

  <Accordion title="Google AI">
    Google AI API를 통한 Gemini 모델 및 사용자 지정 Google AI 엔드포인트를 지원합니다.

    | 필드          | 값                                                  |
    | ----------- | -------------------------------------------------- |
    | **API 키**   | 귀하의 Google AI API 키                                |
    | **API URL** | `https://generativelanguage.googleapis.com/` (기본값) |
    | **모델 이름**   | 예: `gemini-2.5-flash`                              |
  </Accordion>

  <Accordion title="OpenRouter">
    통합 API를 통해 여러 모델 제공업체에 대한 접근을 제공합니다.

    | 필드          | 값                         |
    | ----------- | ------------------------- |
    | **API 키**   | 귀하의 OpenRouter API 키      |
    | **API URL** | OpenRouter 엔드포인트          |
    | **모델 이름**   | OpenRouter에서 사용 가능한 모든 모델 |
  </Accordion>

  <Accordion title="AWS Bedrock">
    Amazon Bedrock 모델 및 다양한 기반 모델을 지원합니다.

    | 필드            | 값              |
    | ------------- | -------------- |
    | **AWS 자격 증명** | 별도로 구성         |
    | **API URL**   | Bedrock 엔드포인트  |
    | **모델 이름**     | Bedrock 모델 식별자 |
  </Accordion>

  <Accordion title="사용자 지정 엔드포인트">
    프라이빗 배포 및 자체 호스팅 모델을 포함한 모든 OpenAI 호환 API 엔드포인트를 지원합니다.

    | 필드          | 값                         |
    | ----------- | ------------------------- |
    | **API 키**   | 귀하의 사용자 지정 API 키 (필요한 경우) |
    | **API URL** | 귀하의 사용자 지정 엔드포인트 URL      |
    | **모델 이름**   | 귀하의 모델 식별자                |
  </Accordion>
</AccordionGroup>

## 사용자 지정 모델 추가

<Steps>
  <Step title="에이전트로 이동">
    사이드바에서 **에이전트**로 이동합니다.
  </Step>

  <Step title="에이전트 열기">
    새 에이전트를 만들거나 편집할 기존 에이전트를 선택합니다.
  </Step>

  <Step title="설정 탭으로 이동">
    에이전트 구성에서 **설정** 탭을 엽니다.
  </Step>

  <Step title="사용자 지정 모델 열기">
    **사용자 지정 모델** 섹션으로 스크롤하고 **+모델 추가**를 클릭합니다.
  </Step>

  <Step title="모델 세부 정보 입력">
    모델 구성 모달이 열립니다. 다음을 입력합니다:

    | 필드           | 설명                                                                                      |
    | ------------ | --------------------------------------------------------------------------------------- |
    | **모델 이름**    | API에서 인식하는 정확한 모델 이름 (예: `gpt-4`, `claude-sonnet-4-6`)                                  |
    | **모델 제공업체**  | 드롭다운에서 제공업체 선택 (OpenAI, Anthropic, Azure, Google AI, OpenRouter, AWS Bedrock, 사용자 지정 등) |
    | **API 키**    | 선택한 제공업체의 API 키. 안전하게 저장됩니다.                                                            |
    | **API URL**  | API 엔드포인트 URL                                                                           |
    | **타임아웃**     | API 요청 타임아웃. 기본값은 300초. 장시간 실행되는 추론 모델의 경우 증가시킵니다.                                      |
    | **최대 입력 토큰** | 최대 입력 토큰. 기본값은 3000. 모델의 기능에 따라 조정합니다.                                                  |
    | **최대 응답 토큰** | 최대 응답 토큰. 기본값은 1000. 요구 사항과 모델 제한에 따라 조정합니다.                                            |
  </Step>

  <Step title="모델 생성">
    **생성**을 클릭합니다. EK가 API 연결 및 모델 구성을 검증합니다. 성공하면 모델이 저장되고 에이전트에서 사용할 수 있게 됩니다.
  </Step>
</Steps>

## 사용자 지정 모델 사용

### 사용자 지정 모델 선택

<Steps>
  <Step title="일반 탭 열기">
    에이전트 편집기에서 **일반** 탭으로 이동하여 **모델** 섹션을 찾습니다.
  </Step>

  <Step title="사용자 지정 모델 선택">
    드롭다운에 사전 정의 및 사용자 지정 모델이 모두 표시됩니다. 사용자 지정 모델은 별도의 섹션에 표시됩니다. 사용자 지정 모델을 선택합니다.
  </Step>
</Steps>

<Note>
  사용자 지정 모델은 **프로젝트별**입니다. 프로젝트의 모든 에이전트에서 사용할 수 있으며, 각 프로젝트는 고유한 사용자 지정 모델 세트를 가질 수 있습니다.
</Note>

## 사용자 지정 모델 관리

<AccordionGroup>
  <Accordion title="사용자 지정 모델 보기">
    1. **에이전트** → **에이전트 편집** → **일반** 탭으로 이동합니다.
    2. AI 모델 섹션에서 **사용자 지정** 탭을 클릭합니다.
    3. 모든 사용자 지정 모델이 목록에 표시됩니다.
  </Accordion>

  <Accordion title="사용자 지정 모델 편집">
    1. 사용자 지정 모델 목록에서 모델을 찾습니다.
    2. **편집** 아이콘(세로 점 3개 메뉴)을 클릭합니다.
    3. 구성을 수정합니다.
    4. **저장**을 클릭하여 업데이트합니다.

    <Warning>
      API 키를 편집하면 기존 키가 대체됩니다. 저장하기 전에 올바른 키가 있는지 확인하세요.
    </Warning>
  </Accordion>

  <Accordion title="사용자 지정 모델 삭제">
    1. 사용자 지정 모델 목록에서 모델을 찾습니다.
    2. **삭제** 아이콘(세로 점 3개 메뉴)을 클릭합니다.
    3. 삭제를 확인합니다.
    4. 모델이 프로젝트에서 제거됩니다.

    <Warning>
      사용자 지정 모델을 삭제하면 해당 모델을 사용하는 모든 에이전트에 영향을 미칩니다. 먼저 해당 에이전트를 업데이트하세요.
    </Warning>
  </Accordion>
</AccordionGroup>

## 모델 구성 예시

<CodeGroup>
  ```json OpenAI 사용자 지정 모델 theme={null}
  {
    "model_name": "My GPT-4",
    "version": "gpt-4",
    "api_provider": "openai",
    "api_type": "openai",
    "api_key": "sk-...",
    "api_url": "https://api.openai.com/v1",
    "max_input_tokens": 60000,
    "max_response_tokens": 4096
  }
  ```

  ```json Azure OpenAI theme={null}
  {
    "model_name": "Azure GPT-4",
    "version": "gpt-4",
    "api_provider": "openai",
    "api_type": "azure",
    "api_key": "your-azure-key",
    "api_url": "https://your-resource.openai.azure.com",
    "api_version": "2024-12-01-preview",
    "max_input_tokens": 60000,
    "max_response_tokens": 4096
  }
  ```

  ```json Anthropic Claude theme={null}
  {
    "model_name": "Company Claude",
    "version": "claude-sonnet-4-6",
    "api_provider": "anthropic",
    "api_type": "anthropic",
    "api_key": "sk-ant-...",
    "api_url": "https://api.anthropic.com",
    "max_input_tokens": 60000,
    "max_response_tokens": 4000
  }
  ```

  ```json 사용자 지정 엔드포인트 theme={null}
  {
    "model_name": "Private Model",
    "version": "custom-model-v1",
    "api_provider": "custom",
    "api_type": "custom",
    "api_key": "your-custom-key",
    "api_url": "https://your-custom-endpoint.com/v1",
    "max_input_tokens": 100000,
    "max_response_tokens": 8000,
    "auth_header_template": "{\"Authorization\": \"Bearer <API_KEY>\"}"
  }
  ```
</CodeGroup>

## 모범 사례

<AccordionGroup>
  <Accordion title="API 키 보안">
    * **키를 절대 공유하지 마세요** - API 키를 기밀로 유지하세요
    * **환경 변수를 사용하세요** - 개발 시 안전한 저장소를 사용하세요
    * **정기적으로 키를 교체하세요** - 주기적으로 키를 업데이트하세요
    * **사용량을 모니터링하세요** - API 사용량을 추적하여 문제를 감지하세요
  </Accordion>

  <Accordion title="모델 선택">
    * **사용 사례에 맞추세요** - 태스크에 적합한 모델을 선택하세요
    * **비용을 고려하세요** - 성능과 비용의 균형을 맞추세요
    * **성능을 테스트하세요** - 요구 사항에 대한 모델 품질을 평가하세요
    * **제한을 모니터링하세요** - 토큰 제한과 할당량을 확인하세요
  </Accordion>

  <Accordion title="구성">
    * **정확한 모델 이름** - 정확한 모델 식별자를 사용하세요
    * **올바른 URL** - API 엔드포인트 URL을 확인하세요
    * **적절한 제한** - 현실적인 토큰 제한을 설정하세요
    * **연결을 테스트하세요** - 모델 연결 가능성을 확인하세요
  </Accordion>

  <Accordion title="비용 관리">
    * **사용량을 추적하세요** - API 사용량 및 비용을 모니터링하세요
    * **예산을 설정하세요** - 사용 가능한 경우 지출 제한을 구성하세요
    * **토큰을 최적화하세요** - 적절한 토큰 제한을 사용하세요
    * **정기적으로 검토하세요** - 주기적으로 모델 사용량을 감사하세요
  </Accordion>
</AccordionGroup>

## 문제 해결

<AccordionGroup>
  <Accordion title="모델을 사용할 수 없음 — 사용자 지정 모델이 드롭다운에 표시되지 않음">
    **가능한 원인:**

    * 모델이 올바르게 저장되지 않음
    * API 키가 유효하지 않음
    * 모델 구성 오류

    **솔루션:**

    * 모델이 성공적으로 저장되었는지 확인
    * API 키가 올바른지 확인
    * 모델 구성을 검토
    * 페이지 새로고침
  </Accordion>

  <Accordion title="API 키 오류 — 유효하지 않은 API 키 또는 인증 오류">
    **가능한 원인:**

    * 잘못된 API 키
    * 만료된 API 키
    * 잘못된 API 제공업체 선택
    * 키에 필요한 권한이 없음

    **솔루션:**

    * API 키가 올바른지 확인
    * 키가 만료되지 않았는지 확인
    * 올바른 제공업체가 선택되었는지 확인
    * 키에 필요한 권한이 있는지 확인
  </Accordion>

  <Accordion title="연결 실패 — 모델 엔드포인트에 연결할 수 없음">
    **가능한 원인:**

    * 잘못된 API URL
    * 네트워크 연결 문제
    * 엔드포인트에 접근할 수 없음
    * 방화벽이 연결을 차단

    **솔루션:**

    * API URL이 올바른지 확인
    * 네트워크 연결 확인
    * 엔드포인트에 접근할 수 있는지 확인
    * 방화벽 규칙 검토
  </Accordion>

  <Accordion title="토큰 제한 오류 — 토큰 제한 초과">
    **가능한 원인:**

    * 입력이 너무 긺
    * 응답 제한이 너무 높음
    * 모델 제한 초과

    **솔루션:**

    * 입력 길이 줄이기
    * 최대 응답 토큰 줄이기
    * 모델의 실제 제한 확인
    * 큰 입력 분할
  </Accordion>
</AccordionGroup>

## 모델 호환성

<Warning>
  Knowledge Base v2를 사용할 때는 **OpenAI** (openai, azure) 및 **Anthropic** 모델만 지원됩니다. 다른 제공업체는 Knowledge Base v2와 호환되지 않습니다.
</Warning>

다양한 모델이 서로 다른 기능을 지원합니다:

| 기능         | 지원되는 모델                                   |
| ---------- | ----------------------------------------- |
| **스트리밍**   | 대부분의 모델                                   |
| **함수 호출**  | OpenAI 및 Anthropic 모델                     |
| **비전**     | GPT-4o, Claude 4 Sonnet, Gemini 2.5 Flash |
| **긴 컨텍스트** | Claude Sonnet 4.6, GPT 4.1                |

## API 키 관리

### API 키 가져오기

<AccordionGroup>
  <Accordion title="OpenAI">
    1. [OpenAI Platform](https://platform.openai.com)으로 이동합니다.
    2. **API Keys**로 이동합니다.
    3. 새 시크릿 키를 생성합니다.
    4. 키를 복사합니다 (`sk-`로 시작).
  </Accordion>

  <Accordion title="Anthropic">
    1. [Anthropic Console](https://console.anthropic.com)로 이동합니다.
    2. **API Keys**로 이동합니다.
    3. 새 키를 생성합니다.
    4. 키를 복사합니다 (`sk-ant-`로 시작).
  </Accordion>

  <Accordion title="Google AI">
    1. [Google AI Studio](https://makersuite.google.com/app/apikey)로 이동합니다.
    2. 새 API 키를 생성합니다.
    3. 키를 복사합니다.
  </Accordion>

  <Accordion title="OpenRouter">
    1. [OpenRouter](https://openrouter.ai)로 이동합니다.
    2. **Keys**로 이동합니다.
    3. 새 키를 생성합니다.
    4. 키를 복사합니다.
  </Accordion>
</AccordionGroup>

### 키 보안

* **안전하게 저장하세요** - 키는 데이터베이스에서 암호화됩니다
* **공유하지 마세요** - API 키를 절대 공유하지 마세요
* **정기적으로 교체하세요** - 주기적으로 키를 업데이트하세요
* **사용량을 모니터링하세요** - 무단 사용을 주시하세요

## 비용 고려 사항

<CardGroup cols={2}>
  <Card title="사전 정의 모델" icon="sparkles">
    * 비용은 EKB에서 관리
    * EKB 구독을 통해 청구
    * 크레딧 기반 가격
    * 투명한 가격 모델
  </Card>

  <Card title="사용자 지정 모델 (BYOK)" icon="key">
    * 제공업체에 직접 지불
    * 추가 EKB 비용 없음
    * 비용에 대한 완전한 제어
    * 제공업체의 직접 청구
  </Card>
</CardGroup>

**비용 최적화 팁:**

* **올바른 모델을 선택하세요** - 태스크에 적합한 모델을 사용하세요.
* **프롬프트를 최적화하세요** - 가능한 경우 토큰 사용량을 줄이세요.
* **제한을 설정하세요** - 적절한 최대 토큰을 구성하세요.
* **사용량을 모니터링하세요** - 정기적으로 API 사용량을 추적하세요.