사전 정의 및 사용자 지정 모델 - Automation Anywhere EKB Docs

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

사전 정의 모델

모든 사용자가 사용할 수 있는 사전 구성된 모델 — API 키 불필요.

사용자 지정 모델 (BYOK)

자체 API 키로 구성하여 비용 제어와 유연성을 확보하는 모델.

사전 정의 모델

사전 정의 모델은 기본적으로 사용 가능하며 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

모델 선택

에이전트로 이동

사이드바에서 에이전트로 이동합니다.

에이전트 열기

새 에이전트를 만들거나 기존 에이전트를 선택합니다.

일반 탭으로 이동

에이전트 구성에서 일반 탭을 엽니다.

모델 선택

에이전트 이름 옆의 모델 드롭다운 선택기를 찾아 사전 정의 모델을 드롭다운에서 선택합니다.

모델 정보

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

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

사용자 지정 모델 (BYOK)

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

비용 제어

자체 API 키와 청구를 사용합니다.

모델 유연성

사전 정의 목록에 없는 모델에 접근합니다.

사용자 지정 엔드포인트

프라이빗 또는 사용자 지정 모델 엔드포인트에 연결합니다.

제공업체 선택

호환되는 모든 API 제공업체를 사용합니다.

지원되는 제공업체

OpenAI

표준 OpenAI API 모델, Azure OpenAI 엔드포인트 및 사용자 지정 OpenAI 호환 엔드포인트를 지원합니다.

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

Anthropic

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

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

Google AI

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

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

OpenRouter

통합 API를 통해 여러 모델 제공업체에 대한 접근을 제공합니다.

필드	값
API 키	귀하의 OpenRouter API 키
API URL	OpenRouter 엔드포인트
모델 이름	OpenRouter에서 사용 가능한 모든 모델

AWS Bedrock

Amazon Bedrock 모델 및 다양한 기반 모델을 지원합니다.

필드	값
AWS 자격 증명	별도로 구성
API URL	Bedrock 엔드포인트
모델 이름	Bedrock 모델 식별자

사용자 지정 엔드포인트

프라이빗 배포 및 자체 호스팅 모델을 포함한 모든 OpenAI 호환 API 엔드포인트를 지원합니다.

필드	값
API 키	귀하의 사용자 지정 API 키 (필요한 경우)
API URL	귀하의 사용자 지정 엔드포인트 URL
모델 이름	귀하의 모델 식별자

사용자 지정 모델 추가

에이전트로 이동

사이드바에서 에이전트로 이동합니다.

에이전트 열기

새 에이전트를 만들거나 편집할 기존 에이전트를 선택합니다.

설정 탭으로 이동

에이전트 구성에서 설정 탭을 엽니다.

사용자 지정 모델 열기

사용자 지정 모델 섹션으로 스크롤하고 +모델 추가를 클릭합니다.

모델 세부 정보 입력

모델 구성 모달이 열립니다. 다음을 입력합니다:

필드	설명
모델 이름	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. 요구 사항과 모델 제한에 따라 조정합니다.

모델 생성

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

사용자 지정 모델 사용

사용자 지정 모델 선택

일반 탭 열기

에이전트 편집기에서 일반 탭으로 이동하여 모델 섹션을 찾습니다.

사용자 지정 모델 선택

드롭다운에 사전 정의 및 사용자 지정 모델이 모두 표시됩니다. 사용자 지정 모델은 별도의 섹션에 표시됩니다. 사용자 지정 모델을 선택합니다.

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

사용자 지정 모델 관리

사용자 지정 모델 보기

에이전트 → 에이전트 편집 → 일반 탭으로 이동합니다.
AI 모델 섹션에서 사용자 지정 탭을 클릭합니다.
모든 사용자 지정 모델이 목록에 표시됩니다.

사용자 지정 모델 편집

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

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

사용자 지정 모델 삭제

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

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

모델 구성 예시

{
  "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
}

모범 사례

API 키 보안

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

모델 선택

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

구성

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

비용 관리

사용량을 추적하세요 - API 사용량 및 비용을 모니터링하세요
예산을 설정하세요 - 사용 가능한 경우 지출 제한을 구성하세요
토큰을 최적화하세요 - 적절한 토큰 제한을 사용하세요
정기적으로 검토하세요 - 주기적으로 모델 사용량을 감사하세요

문제 해결

모델을 사용할 수 없음 — 사용자 지정 모델이 드롭다운에 표시되지 않음

가능한 원인:

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

솔루션:

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

API 키 오류 — 유효하지 않은 API 키 또는 인증 오류

가능한 원인:

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

솔루션:

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

연결 실패 — 모델 엔드포인트에 연결할 수 없음

가능한 원인:

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

솔루션:

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

토큰 제한 오류 — 토큰 제한 초과

가능한 원인:

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

솔루션:

입력 길이 줄이기
최대 응답 토큰 줄이기
모델의 실제 제한 확인
큰 입력 분할

모델 호환성

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

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

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

API 키 관리

API 키 가져오기

OpenAI

OpenAI Platform으로 이동합니다.
API Keys로 이동합니다.
새 시크릿 키를 생성합니다.
키를 복사합니다 (sk-로 시작).

Anthropic

Anthropic Console로 이동합니다.
API Keys로 이동합니다.
새 키를 생성합니다.
키를 복사합니다 (sk-ant-로 시작).

Google AI

Google AI Studio로 이동합니다.
새 API 키를 생성합니다.
키를 복사합니다.

OpenRouter

OpenRouter로 이동합니다.
Keys로 이동합니다.
새 키를 생성합니다.
키를 복사합니다.

키 보안

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

비용 고려 사항

사전 정의 모델

비용은 EKB에서 관리
EKB 구독을 통해 청구
크레딧 기반 가격
투명한 가격 모델

사용자 지정 모델 (BYOK)

제공업체에 직접 지불
추가 EKB 비용 없음
비용에 대한 완전한 제어
제공업체의 직접 청구

비용 최적화 팁:

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

사전 정의 모델

사용자 지정 모델 (BYOK)

​사전 정의 모델

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

​모델 선택

​모델 정보

​사용자 지정 모델 (BYOK)

비용 제어

모델 유연성

사용자 지정 엔드포인트

제공업체 선택

​지원되는 제공업체

​사용자 지정 모델 추가

​사용자 지정 모델 사용

​사용자 지정 모델 선택

​사용자 지정 모델 관리

​모델 구성 예시

​모범 사례

​문제 해결

​모델 호환성

​API 키 관리

​API 키 가져오기

​키 보안

​비용 고려 사항

사전 정의 모델

사용자 지정 모델 (BYOK)

사전 정의 모델

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

모델 선택

모델 정보

사용자 지정 모델 (BYOK)

지원되는 제공업체

사용자 지정 모델 추가

사용자 지정 모델 사용

사용자 지정 모델 선택

사용자 지정 모델 관리

모델 구성 예시

모범 사례

문제 해결

모델 호환성

API 키 관리

API 키 가져오기

키 보안

비용 고려 사항