만들기

에이전트 목록에서 + 에이전트 만들기를 누릅니다. 생성 창에서 대화형 AI 에이전트와 그래프형 워크플로우 중 실행 모드를 선택합니다.

기존 에이전트 구성을 바탕으로 시작하려면 목록 행의 복제를 사용합니다. 새 시스템 이름과 대상 컬렉션을 지정해 독립된 사본을 만든 뒤 이 빌더에서 구성을 확인하고 별도로 배포합니다. 자세한 절차는 에이전트 개요의 목록 화면에서 확인합니다.

모드는 생성 후 변경할 수 없습니다

에이전트 모드는 만든 뒤 변경할 수 없습니다. 다른 모드가 필요하면 새 에이전트를 만듭니다.

AI 에이전트 모드

AI 언어 모델(LLM)이 요청에 따라 도구를 선택하고 도구 결과를 다음 단계의 입력으로 사용합니다. 이 반복 실행 방식을 ReAct라고 합니다. 모델 설정 화면에서는 ReAct 에이전트로 표시됩니다.

주요 설정

• 모델: 모델 제공자 → 모델 순서로 선택합니다. 조회할 수 있는 등록 모델만 목록에 표시됩니다.
• 시스템 프롬프트 (지침): 에이전트가 어떤 역할을 맡고 어떻게 행동할지를 정합니다. 입력란에 직접 쓰거나 미리 만든 프롬프트 자산을 연결합니다(아래 시스템 프롬프트 (지침) 참고).
• 도구 / 액터 / 에이전트: 에이전트가 불러 쓸 기능, 액터와 위임할 AI 에이전트를 고릅니다.
• 시맨틱 테이블 / 질의 템플릿: 에이전트가 자연어 질문에 활용할 시맨틱 레이어 자산을 등록합니다.
• 최대 반복: 도구 호출을 반복하는 최대 횟수입니다. 기본값은 50이고 1~100으로 설정합니다.
• 최대 입력 토큰: 한 번의 모델 호출에 포함할 대화 기록의 최대 토큰 수입니다. 한도에 도달하면 오래된 대화를 요약합니다. 비워 두면 서비스 기본값을 사용합니다.
• 추론 강도: 낮음 / 중간 / 높음 중 하나를 고릅니다. 추론 강도를 지원하는 모델에서만 표시됩니다. 기술 식별자는 reasoning_effort입니다. 대화 화면에서 기본값을 변경하는 방법은 에이전트 배포하기에서 확인합니다.

모델 선택

모델을 고르는 화면에는 조회할 수 있는 등록 모델이 표시됩니다. 포털에 미리 정해진 제공자 목록은 없습니다.

• 등록된 모델이 없을 때: "등록된 모델 없음"과 모델을 먼저 등록해야 한다는 안내가 표시됩니다. LLM 모델에서 모델을 등록합니다.
• 사용 불가 모델: 예전에 골랐던 제공자·모델이 지금 카탈로그에 더 이상 없으면 라벨에 "(사용 불가)"가 붙고, 저장하기 전에 현재 등록된 모델로 다시 고르라는 경고가 뜹니다.
• 응답 온도·출력 최대 토큰: 에이전트별 입력란에서는 설정하지 않습니다. 선택한 LLM 모델의 기본값을 사용합니다.

컨텍스트와 출력 설정

모델 설정에서 대화 기록의 입력 예산, 출력 형식과 자동 압축 정책을 정합니다. 이 설정은 AI 에이전트 모드에만 적용합니다.

최대 입력 토큰

• 새 에이전트에서 모델을 선택하면 등록된 모델 컨텍스트 윈도우의 약 80%를 최대 입력 토큰에 자동으로 채웁니다.
• 값을 직접 입력한 뒤에는 모델을 바꿔도 자동으로 덮어쓰지 않습니다. 값을 비우면 자동 추적을 다시 시작합니다.
• 입력값은 모델의 전체 컨텍스트 윈도우를 넘을 수 없습니다.
• 모델에 컨텍스트 윈도우 정보가 없으면 값을 비우고 런타임 기본값 65,536토큰을 안내합니다.
• 기존 에이전트의 저장된 값은 모델을 바꾸지 않는 한 자동으로 다시 계산하지 않습니다.

플랫폼 출력 규약 적용

새 에이전트에서는 플랫폼 출력 규약 적용이 기본으로 켜집니다. 포털 채팅이 차트·표·지도 같은 시각화 결과를 해석하도록 공통 출력 지침을 추가합니다. 외부 API에서 D.Hub 전용 출력 형식을 사용하지 않을 때는 끕니다.

압축 정책 직접 설정

압축 정책 직접 설정을 끄면 서비스 기본 정책을 상속합니다. 화면에 표시되는 서비스 기본은 압축 사용, 트리거 비율 0.8, 목표 비율 0.5입니다.

켜면 에이전트별로 다음 값을 저장합니다.

항목	기본값	범위
압축 사용	켜짐	켜짐 / 꺼짐
트리거 비율	0.8	0.05~0.95
목표 비율	0.5	0.05~0.95이며 트리거보다 작아야 함
요약 최대 토큰	1,024	128~8,192

대화가 트리거 비율과 입력 예산을 곱한 크기를 넘으면 오래된 턴을 요약해 목표 비율 수준으로 줄입니다. 사용자가 채팅에서 누르는 수동 압축과의 차이는 컨텍스트 게이지와 대화 압축에서 확인합니다.

시스템 프롬프트 (지침)

에이전트의 역할·한계·작업 방식은 두 가지 방법으로 정합니다. 두 방법을 함께 사용해도 됩니다.

• 인라인 지시문: 시스템 지시문 입력란에 자연어로 직접 씁니다.
• 프롬프트 참조: 미리 만든 프롬프트 자산을 연결합니다. 미리 만든 프롬프트 추가에서 하나 이상 고릅니다. 같은 컬렉션 또는 전역에 있는 프롬프트만 선택할 수 있습니다. 여러 개를 골랐다면 드래그하여 순서 변경으로 순서를 조정합니다.
• 새 프롬프트: 현재 빌더에서 템플릿 프롬프트를 만들고 만들고 추가를 눌러 바로 연결합니다.

프롬프트를 선택하지 않으면 인라인 지시문만 사용합니다. 하나 이상 선택하면 목록 순서대로 프롬프트를 연결한 뒤 인라인 지시문을 추가합니다. 이때 입력란 이름은 **시스템 지시문 (선택한 프롬프트 뒤에 결합)**으로 바뀝니다.

프롬프트 자산의 변수와 렌더링 결과는 프롬프트에서 설정합니다.

연결한 프롬프트의 편집 버튼에서는 원본을 수정하거나 사본을 만들어 현재 에이전트 참조만 교체할 수 있습니다. 다른 에이전트와 실행 중 배포에 미치는 영향은 빌더에서 프롬프트 편집하기에서 확인합니다.

스크린샷 TODO

영역: 새 프롬프트와 원본 수정·복제 적용 선택지가 표시된 에이전트 빌더의 프롬프트 패널.

기능 구성

빌더의 기능 구성에는 도구 / 액터 / 에이전트 / 시맨틱 테이블 / 질의 템플릿 탭이 있습니다. 각 탭에서 에이전트 컬렉션 범위에 맞는 자산을 검색하고 선택합니다. 변경 내용을 실행 중 에이전트에 반영하려면 저장한 뒤 다시 배포합니다.

자연어로 D.Hub 자산을 만들거나 바꾸는 AI 에이전트를 구성하려면 도구 탭에서 resource_plan_propose를 선택하고 액터 탭에서 resource_plan_apply를 선택합니다. 두 항목은 기본 제공 배지로 표시되며 원본은 읽기 전용입니다. 하나만 연결하면 제안과 승인·적용 흐름이 완성되지 않습니다. 선택한 뒤 에이전트를 저장하고 배포합니다. 이미 실행 중인 에이전트라면 저장 후 재배포 필요를 확인하고 다시 배포해야 새 도구·액터 구성이 채팅에 반영됩니다. 두 항목의 역할과 지원 자산 범위는 기본 제공 자연어 자산 계획에서 확인합니다.

다른 에이전트에 위임하기

에이전트 탭에서 일을 맡길 AI 에이전트를 선택합니다.

• 현재 에이전트 자신은 후보에서 제외됩니다.
• AI 에이전트 모드만 선택할 수 있습니다. 워크플로우 에이전트는 이벤트 실행 전용으로 표시되며 선택할 수 없습니다.
• 후보에는 컬렉션·실행 모드·모델이 표시됩니다.
• 기존 선택이 현재 목록 범위에서 사라지면 목록에 없음으로 남습니다. 연결을 유지할 수 없는 경우 해당 항목을 선택 해제합니다.
• 후보가 없으면 에이전트 만들기로 이동해 새 에이전트를 준비합니다.

이 연결은 별도의 에이전트 유형 도구를 만드는 방식과 다릅니다. 위임 대상으로 참조되는 에이전트는 삭제하거나 이름·컬렉션을 변경할 수 없습니다. 먼저 부모 에이전트에서 연결을 해제합니다.

빌더 화면

ReAct 빌더에서는 모델·지침·도구/액터 설정을 탭으로 나눠 편집합니다. 빌더 위쪽에서 저장하거나 배포합니다. 오른쪽 미리보기 패널에서는 응답과 도구 실행 결과를 임시 대화로 확인합니다.

워크플로우 모드

분기·조건·반복이 얽힌 복잡한 에이전트를 그림(그래프)으로 설계합니다. 노드 하나하나는 AI 언어 모델 호출, 도구 호출, 액터 위임, 조건 판단처럼 한 가지 역할만 맡고, 노드를 잇는 연결선은 데이터가 흐르는 길과 실행 순서를 나타냅니다.

빌더 화면의 네 영역

워크플로우 빌더는 다음 영역으로 구성됩니다.

영역	위치	역할
도구 모음	상단	에이전트명, 저장 상태, 실행 취소/다시 실행, 자동 정렬, 저장, 배포
노드 팔레트	좌측	6개 카테고리의 노드를 캔버스에 끌어다 놓음
캔버스	중앙	노드 배치·연결·편집
노드 설정(속성 패널)	우측	선택한 노드의 상세 설정 패널

노드 유형

카테고리	노드
흐름	시작, 종료
AI	에이전트, LLM
데이터	코드, 템플릿, 변수
통합	도구 호출, 액터 호출
제어	조건 분기, 반복, 병렬 실행
고급	사용자 입력, 오류 처리

속성 패널

노드를 선택하면 오른쪽 속성 패널에 그 노드의 입력·출력·옵션이 나타납니다. 도구 호출 노드에는 도구의 입력 형식에 맞는 편집기가 표시됩니다. 액터 호출 노드에서는 연결할 액터와 입력 매핑을 설정합니다. 확인 정책은 auto, confirm, deny 중에서 선택합니다. confirm을 선택하면 액터를 실행하기 전에 사용자에게 승인을 요청합니다.

노드별 설정과 연결 제약, 시작·종료 배포 검증은 워크플로우 에이전트에서 확인합니다.

공통 메타데이터

• 이름 / 별칭 / 설명 / 태그: 검색하고 정렬하는 데 쓰이는 정보입니다.
• 소유자: 에이전트를 만든 사용자가 소유자가 됩니다.
• 컬렉션: 에이전트를 저장할 컬렉션을 선택합니다.

AI 자동 생성 (별칭·설명·태그)

입력란 오른쪽의 반짝임(✨) 아이콘을 누르면 이름·별칭과 현재 구성을 바탕으로 별칭·설명·태그를 제안합니다.

• 위치: 입력란의 오른쪽 끝에 표시됩니다.
• 생성 취소: 생성하는 동안 버튼이 정지 아이콘으로 바뀝니다. 이 버튼을 다시 누르거나 Esc를 눌러 취소합니다.
• 생성 완료 표시: AI가 값을 채우면 해당 입력란이 포인트 색으로 약 2초간 강조된 뒤 원래 색으로 돌아옵니다.
• 도구와 액터 편집 화면에서도 같은 위치의 AI 생성 버튼을 사용합니다.

저장

저장을 누르면 변경 내용이 저장됩니다. 실행 중인 에이전트에 구성을 반영하려면 저장한 뒤 다시 배포합니다. 이름과 별칭 변경은 다시 배포하지 않아도 목록과 채팅에 반영됩니다.

모델·컨텍스트·출력 규약·압축 정책, 프롬프트, 도구·액터·위임 에이전트와 시맨틱 자산 변경은 실행 구성에 포함됩니다. 저장 후 재배포 필요가 표시되면 다시 배포합니다.

다음 단계

• 에이전트 도구와 액터 — 에이전트가 호출할 기능을 준비합니다.
• 워크플로우 에이전트 — 그래프 노드와 연결을 구성합니다.
• 에이전트 배포 — 저장한 에이전트를 실행 가능한 상태로 전환합니다.