배포

에이전트를 저장하고 배포해야 채팅이나 외부 API에서 사용할 수 있습니다. 에이전트 목록에서 배포 상태를 확인하고 변경 사항이 있으면 다시 배포합니다.

배포 / 배포 해제

에이전트 목록의 각 행이나 상세 화면의 작업 메뉴에서 다음 작업을 합니다.

• 배포: 저장한 에이전트를 사용 가능한 상태로 바꿉니다. 진행하는 동안 "배포 중..."이 표시됩니다.
• 중지: 배포를 해제해 더 이상 불러 쓰지 못하게 합니다.
• 재배포: 에이전트를 고친 뒤 그 내용을 반영하려면 다시 배포합니다.

목록에서 여러 에이전트 작업하기

목록의 체크박스로 여러 행을 선택하면 에이전트 일괄 작업 표시줄이 나타납니다. 에이전트 N개 전체 선택은 현재 페이지만이 아니라 검색어·상태 필터와 컬렉션 범위에 맞는 전체 결과를 선택합니다. 검색·상태·컬렉션 범위를 바꾸면 선택이 초기화됩니다.

스크린샷 TODO

영역: 여러 행을 선택한 뒤 모델 변경·배포·중지·삭제가 표시된 에이전트 일괄 작업 표시줄.

작업	적용 범위와 결과
배포	실행 중이거나 배포 중이 아닌 항목을 한 건씩 배포합니다. 시작·종료 검증에 실패한 워크플로우 에이전트는 건너뜁니다.
중지	현재 실행 중인 항목만 한 건씩 중지합니다.
모델 변경	배포 중이 아닌 AI 에이전트에만 적용합니다. 워크플로우 에이전트는 건너뜁니다.
삭제	편집 가능한 항목을 한 건씩 삭제합니다. 기본 제공 에이전트는 매니저가 다시 시작될 때 생성될 수 있다는 경고를 확인합니다.

각 작업은 일부 대상이 실패해도 나머지를 계속 처리하고 성공·실패 개수를 표시합니다. 비관리자는 읽기 전용 기본 제공 에이전트를 선택할 수 없습니다.

모델만 저장할지 재배포할지 선택하기

모델 변경에서 등록된 제공자와 모델을 고릅니다. 배포 서비스를 사용할 수 있으면 저장 후 재배포가 기본으로 선택됩니다.

• 저장 후 재배포: 새 모델을 저장하고 에이전트를 한 건씩 다시 배포합니다.
• 저장만: 저장된 정의만 바뀝니다. 실행 중인 배포는 다음 재배포 전까지 이전 모델을 계속 사용합니다.

결과에서 저장 실패와 재배포 실패를 따로 확인합니다. 재배포만 실패했다면 새 모델이 저장됐어도 실행 중 런타임에는 아직 적용되지 않았을 수 있습니다.

배포 상태는 목록에서 초안 / 실행 중 / 중지 배지로 표시됩니다. 같은 값으로 목록을 걸러 표시합니다.

배포된 에이전트 확인

• 에이전트 목록의 채팅: 각 행에서 채팅을 선택해 실제 채팅에 들어갑니다. 배포 전에는 눌리지 않으며 "배포 후 사용 가능" 안내가 뜹니다.
• 에이전트 채팅: 에이전트별 채팅 화면에서 직접 대화합니다. 채팅은 AI 에이전트 모드에서만 표시됩니다.

노트

D.Hub 어시스턴트 사이드 패널에는 에이전트를 수동으로 선택하거나 연결하는 설정이 없습니다. 패널이 지원 시나리오 도메인을 확인하면 같은 도메인 태그가 있는 실행 중 AI 에이전트로 자동 라우팅하고, 일치하는 에이전트가 없으면 전용 어시스턴트로 연결합니다. 에이전트 목록의 채팅은 선택한 에이전트와 직접 대화하는 별도 진입점입니다.

미리보기와 채팅 (저장 경계)

배포된 에이전트와 대화하는 방식은 대화 저장 여부에 따라 둘로 나뉩니다. 헤더의 배지로 두 방식을 구분합니다.

표면	진입점	저장 여부	헤더 배지
미리보기	빌더 우측 패널	저장 안 됨(임시)	임시 · 저장 안 됨
채팅	목록의 채팅 · 에이전트 채팅 화면	세션으로 저장	저장됨 · 세션 기록

• 미리보기는 편집 중인 에이전트의 동작을 확인하는 임시 대화입니다. 미리보기 새 창으로 분리해도 대화는 저장되지 않습니다.
• 미리보기에서 채팅에서 열기를 누르면 저장되는 실제 채팅이 새 대화로 열립니다.
• 실제 채팅은 첫 메시지를 보내기 전까지 작성 중 · 전송 시 저장 상태입니다. 메시지를 보내는 순간 세션으로 저장됩니다.

워크플로우 에이전트와 채팅

워크플로우 에이전트는 이벤트로만 실행되기 때문에 채팅 화면에는 나타나지 않습니다.

• 에이전트 목록에서 워크플로우 에이전트에는 채팅 작업이 보이지 않습니다.
• 워크플로우 에이전트에서 채팅 화면을 열면 빌더로 이동합니다. 이벤트 실행만 지원한다는 안내도 표시됩니다.

사람 승인 카드 (HITL)

에이전트가 확인 정책이 confirm으로 설정된 액터를 실행하려고 하면 대화 화면에 승인 요청 카드가 나타납니다. 카드 제목은 "승인이 필요합니다"입니다. 설정 방법은 확인 정책에서 확인합니다.

• 카드에는 대상 액터 이름과 대기 중 상태가 표시됩니다.
• 사용자는 승인 또는 거부를 고릅니다. 거부할 때는 거부 사유를 적을 수 있습니다.
• 승인을 기다리는 동안에는 새 메시지를 입력할 수 없습니다. "대기 중인 승인에 응답한 후 새 메시지를 보낼 수 있습니다"라는 안내가 나옵니다.
• 승인하면 해당 액터를 실행합니다. 거부하면 해당 액터를 실행하지 않습니다. 이후 응답은 에이전트 구성과 모델에 따라 달라집니다.
• 이 승인 카드는 에이전트가 액터를 호출할 때에만 나타납니다(데이터 파이프라인에는 이런 노드가 없습니다).

자산 계획 승인 흐름: resource_plan_propose 도구와 resource_plan_apply 액터를 함께 배포한 AI 에이전트에 자연어로 자산 생성·변경·삭제를 요청하면 먼저 읽기 전용 제안됨 카드가 나타납니다. 자산 종류, 작업, 대상 컬렉션, 의존 관계, 가정과 경고를 확인합니다. 이어지는 승인 카드에서 승인하면 계획을 적용하고 거부하면 아무것도 바꾸지 않습니다. 결과 카드에는 각 항목의 생성됨 / 변경됨 / 삭제됨 / 실패 / 건너뜀 상태가 표시됩니다. 일부 항목이 적용된 뒤 실패해도 이미 적용된 항목은 자동으로 되돌리지 않으며, 실패한 항목에 의존하는 뒤 항목은 건너뜁니다. 지원 자산 13종과 계획당 최대 24개 제한은 기본 제공 자연어 자산 계획에서 확인합니다.

실행 관찰

• 채팅(AI 에이전트): 도구·액터를 호출하면 카드에 이름과 입력·출력이 표시됩니다.

채팅 입력에서는 Enter로 보내고 Shift+Enter로 줄을 바꿉니다. 한글 입력처럼 글자를 조합 중인 Enter는 조합만 확정합니다. 생성 중에는 Esc를 눌러 중지합니다. 사용자·에이전트 메시지에는 복사가 있고, 코드 블록에는 언어 이름과 별도 코드 복사가 표시됩니다. 저장된 시각이 있는 메시지는 작성 시각도 표시합니다. 이전 메시지를 읽으려고 위로 이동하면 자동 스크롤을 멈추고 새 메시지 알림을 표시하며, 누르면 최신 내용으로 이동합니다.

생성 상태는 대화 스크롤 영역 밖의 입력창 바로 위에 고정됩니다. 현재 생각·도구 호출·응답 생성 단계, 실행 중인 도구 이름과 경과 시간을 표시합니다. 모델 스트림이 사용량을 제공하면 직전 완료 모델 호출까지의 누적 토큰 수도 표시하며, 다음 호출이 끝날 때까지 값이 그대로일 수 있습니다. 사용량이 없으면 추정값을 표시하지 않습니다.

도구 과정을 켜면 각 답변 안에 실행 타임라인이 나타납니다. 실행 중에는 현재 도구 이름을, 끝나면 도구 N개 실행과 실패 수를 표시합니다. 타임라인은 기본으로 접혀 있으며 펼친 뒤 각 단계를 다시 열어 실행 중·성공·실패·중지 상태, 경과 시간, 입력 인자와 오류를 확인합니다. 도구 과정 표시 여부는 이 브라우저에 유지됩니다. 같은 브라우저에서 세션을 다시 열면 저장된 단계가 복원되고, 닫힐 때 실행 중이던 과거 단계는 계속 실행 중인 것처럼 보이지 않도록 중지됨으로 표시됩니다. 이 타임라인은 입력창 위에 표시되는 현재 생성 상태와 별도입니다.

완료된 답변이 있는 대화에서 보고서 생성을 요청하면 가장 최근 완료 답변까지를 근거로 이 대화로 보고서 생성 승인 카드가 나타납니다. 카드의 제목·목적·형식·슬라이드 수·언어는 변경할 수 없습니다. 승인하면 서버가 대화·턴·근거를 고정해 실행하고, 거부하면 만들지 않습니다. 승인 대기 중에는 새 메시지를 보낼 수 없습니다. 결과 카드는 약 3초마다 대기 중 → 생성 중 → 완료 또는 실패 상태를 갱신하고, 완료되면 최대 64장 미리보기와 실제 제공된 PPTX·PDF 다운로드를 표시합니다. 저장된 세션을 다시 열어도 카드가 복원됩니다. 이 기능을 포함해 배포한 에이전트에서는 배포 뒤 생성한 턴부터 보고서 흐름을 사용하므로, 기능 추가 전에 만든 턴에 카드가 없으면 에이전트를 저장·재배포한 뒤 새 답변을 만듭니다.

대화별 추론 강도

추론을 지원하는 모델을 쓰는 채팅에서는 입력창 옆에 추론 강도가 나타납니다. 빌더에서 정한 에이전트 기본값을 그대로 쓰거나(기본값), 이 대화에 한해서만 낮음/중간/높음으로 바꿀 수 있습니다. 지원하지 않는 모델에서는 이 항목이 보이지 않습니다.

컨텍스트 게이지와 대화 압축

배포된 에이전트와의 채팅 헤더에는 컨텍스트 사용량 게이지가 있어, 지금 대화가 컨텍스트 예산 가운데 얼마를 쓰고 있는지 토큰 단위로 표시합니다.

• 자동 요약: 대화 기록이 최대 입력 토큰에 도달하면 오래된 메시지를 요약합니다. 한도는 에이전트 만들기 — 최대 입력 토큰에서 정합니다.
• 대화 압축: 게이지 옆의 대화 압축을 누르면 오래된 메시지를 요약합니다. 요약할 내용이 없으면 "압축할 내용이 없습니다"가 표시됩니다.

자동 압축의 트리거·목표 비율과 요약 크기는 압축 정책 직접 설정에서 정합니다. 수동 대화 압축은 사용자가 지금 요약을 요청하는 작업이며 자동 트리거를 기다리지 않습니다.

실행 기록

채팅 화면 위쪽에서 대화와 실행 기록 보기를 오갈 수 있습니다. 실행 기록은 이 대화의 턴 목록과, 그중 고른 턴이 거친 단계별 실행을 표시합니다.

• 내보내기: 이 대화의 전체 실행 기록(모든 턴)을 Markdown(.md) 또는 JSON(.json) 파일로 저장합니다.

실행 단계 상세 보기

턴을 하나 고르면 그 턴이 거친 실행 단계가 순서대로 펼쳐집니다. 각 단계에는 다음 항목이 표시됩니다.

항목	표시 내용
단계 유형	llm, tool, actor 등의 기술 식별자
상태	단계의 실행 상태
처리 시간	단계를 실행하는 데 걸린 시간
토큰	단계에서 사용한 토큰 수
TTFT	첫 토큰이 나올 때까지 걸린 시간(지원하는 경우)
TPOT	출력 토큰 하나를 생성하는 데 걸린 시간(지원하는 경우)

• 실제로 응답한 모델 이름을 표시합니다. 설정한 이름과 다르면 두 이름을 함께 표시합니다.
• 모델의 추론 정보(reasoning)와 도구 호출 요청(tool_calls)이 있으면 표시됩니다.
• 입력·프롬프트·출력을 표시합니다. JSON은 자동으로 정렬되며 각 블록에 복사 버튼이 표시됩니다.

AI로 실행 분석하기

선택한 턴의 실행 상세 상단에서 AI로 분석을 누르면 실행 기록 옆에 AI 분석 패널이 열립니다. 별도 에이전트 채팅 창에서도 같은 기능을 사용합니다.

• 이 실행: 선택한 한 실행의 입력·출력과 단계별 상태·지연·토큰·오류를 분석합니다. 기본 범위입니다.
• 세션 전체: 전체 세션의 Markdown 실행 기록을 분석 문맥에 포함합니다.
• 빠른 분석: 실패 원인 / 지연·토큰 / 요약 중에서 선택합니다. 오류 실행은 실패 원인, 성공 실행은 요약을 처음 한 번 자동으로 실행합니다.
• 후속 질문·중지: 분석 결과에 이어 질문하거나 진행 중인 분석을 중지합니다. 이 실행 / 세션 전체 범위를 바꾸거나 다른 턴을 선택하면 분석 대화가 초기화됩니다.

분석은 에이전트 실행에 사용한 모델이 아니라 현재 활성 어시스턴트 모델을 사용합니다. 활성 모델이나 어시스턴트 생성 서비스가 없으면 버튼이 나타나지 않거나 분석을 보낼 수 없습니다.

분석 문맥에는 선택 범위의 실행 트레이스와 현재 저장된 에이전트 정의가 포함됩니다. 현재 정의는 실제 배포 시점과 다를 수 있습니다. 긴 필드는 상한에 맞춰 잘리며 이때 트레이스 일부가 잘렸습니다가 표시됩니다. 분석 대화는 실행 기록이나 세션에 저장되지 않고 패널을 닫거나 다른 실행을 고르면 유지되지 않습니다. AI 분석은 제공된 기록을 해석하며 인프라 상태를 직접 조회하지 않습니다.

재배포로 변경 반영

배포된 에이전트는 배포한 시점의 저장된 정의로 고정되어 실행됩니다. 그래서 에이전트를 고친 뒤에는 다시 배포해야 바뀐 내용이 실행에 반영됩니다.

프롬프트 원본, 도구·액터 구성, 위임 에이전트, 모델·컨텍스트 정책을 바꾼 경우에도 부모 에이전트를 저장하고 다시 배포합니다. 이름과 별칭처럼 실행 정의에 포함되지 않는 표시 정보는 재배포하지 않아도 목록과 채팅에 반영됩니다.

기능 구성에서 직접 고르는 위임 대상과 별도 에이전트 유형 도구의 차이는 다른 에이전트에 위임하기에서 확인합니다.

다음 단계

• 에이전트 만들기 — 실행 모드와 모델·기능을 구성합니다.
• 에이전트 도구와 액터 — 에이전트가 실행할 작업과 승인 정책을 정합니다.