본문으로 건너뛰기
FDE 코스

모델 등록과 에이전트 구성

LLM 모델을 등록하고 시스템 지침, 동작 모드를 연결해 에이전트를 구성합니다.

9분

에이전트에 연결할 LLM 모델을 등록한 뒤, 시스템 지침과 동작 모드를 연결해 실제로 사용할 에이전트를 만듭니다.

모델 관리 리스트 및 추가

좌측 사이드바 설정LLM 모델 메뉴에서 사용 가능한 모델 목록을 확인하고, 우측 상단 모델 등록 버튼을 누릅니다.

모델 등록 페이지

모델 기본 정보 입력 (배치 유형 결정)

모델 이름, 별칭, 대상 컬렉션, 설명을 입력합니다.

  • 외부: 외부 AI 서비스 주소나 자체 운영 서버 주소를 기준으로 모델을 등록합니다.
  • 내부: 플랫폼 내부 자원에 AI 모델을 직접 올려 사용합니다. 이미지와 포트 같은 배포 설정을 함께 입력합니다.
  • 주의: 배치 방식 유형은 등록한 뒤에는 변경할 수 없습니다.

모델 기본 정보

제공자 및 모델 식별자 설정

제공자 목록에서 등록된 제공자를 선택한 뒤, API 로 전달할 모델 ID를 입력합니다 (예: claude-opus-4-7, gpt-oss-120b).

제공자 및 모델 ID 설정

접속 주소 및 인증 키 등록

외부 모델은 요청을 보낼 주소와 API 키를 입력한 뒤 저장 버튼을 누릅니다.
내부 모델은 별도의 주소 입력 없이 배포 설정을 바탕으로 접속 경로가 자동 연결됩니다.

엔드포인트 및 API Key 기입

에이전트 생성과 컬렉션 매핑

좌측 사이드바 에이전트 메뉴에서 기존 목록을 확인하고, + 에이전트 만들기 버튼으로 새 에이전트를 생성합니다. 이때 에이전트가 속할 컬렉션 ID를 함께 지정합니다.

에이전트 목록

에이전트 기본 정보

동작 모드와 시스템 지침 연결

에이전트의 구동 형태를 AI 에이전트 모드 또는 워크플로 모드 중 하나로 정합니다. 이어서 에이전트 상세 화면에서 시스템 지침과 방금 등록한 LLM 모델을 연결합니다.

에이전트 모드 선택

지침 및 모델 연결

사용 가능한 도구 지정

에이전트가 실행 중 호출할 도구와 액터를 체크박스 목록에서 선택합니다.

도구 및 액터 지정

이 레슨에서 익혀야 할 것

  • 외부(External) 모델과 내부(Internal) 모델의 배치 방식 차이
  • API 제공자 및 고유 모델 식별자의 개념
  • 외부 모델 등록을 위한 API 키 연동 절차
  • 에이전트 모드와 워크플로 모드의 차이, 시스템 지침과 모델을 연결하는 흐름
  • 에이전트가 호출할 수 있는 도구와 액터를 연결하는 방법

다음 레슨

  • 다음 단계에서는 도구, 커넥터, 지식을 함께 연결합니다.