에이전트 배포
에이전트를 저장한 뒤에는 **배포(Deploy)**를 수행해야 Assistant 사이드 패널·Chat 페이지·외부 API에서 호출 가능한 상태가 됩니다.
배포 / 배포 해제
에이전트 목록 행 또는 상세 화면의 액션 메뉴에서 다음을 수행합니다.
- 배포(Deploy): 저장된 정의를 런타임으로 올려 실행 가능한 상태로 만듭니다.
- 배포 해제(Undeploy): 런타임에서 제거하여 호출을 중단합니다.
- 재배포: 에이전트를 편집한 뒤 변경 사항을 반영하려면 다시 배포해야 합니다.
배포 상태는 **대기(Idle) / 배포 중(Deploying) / 실행 중(Running) / 오류(Error)**로 배지에 표시되며, 오류 상태에서는 원인 메시지가 툴팁 또는 상세 패널에 제공됩니다.
배포된 에이전트 확인
- 에이전트 목록:
Running상태 필터로 현재 실행 중인 에이전트만 추립니다. - Chat 페이지: 에이전트별 채팅 페이지(
/agents/:agentId/chat)에서 직접 대화합니다. 마지막에 선택한 에이전트는localStorage에 보존되어 다음 방문에 자동 복원됩니다. - Assistant 사이드 패널 (자동 라우팅): 사이드 패널은 AgentSelector 없이 컨텍스트 기반 자동 라우팅으로 동작합니다(ADR-0050). 자세한 내용은 AI Assistant — chat-assistant 참고.
호출 흐름 (요약)
Assistant/Chat UI
→ 포털 API (REST)
→ 에이전트 런타임
→ (도구 호출 시) 연결된 Tool/Actor 실행
→ 스트리밍 응답을 UI로 전달
HITL 승인 카드
스크린샷 TODO
채팅 UI에 떠 있는 HITL 승인 카드 — 도구 이름, 입력 파라미터, 호출 근거, 승인 / 거부 / 입력 수정 액션 버튼이 보여야 합니다.
도구가 승인 필요로 설정된 경우, 에이전트가 해당 도구를 호출할 때 대화 UI에 승인 요청 카드가 나타납니다(ADR-0035).
- 요청 카드에는 도구 이름, 입력 파라미터, 호출 근거가 함께 표시됩니다.
- 사용자는 승인 / 거부 / 입력 수정 중 하나를 선택합니다.
- 승인되면 에이전트가 실제 도구를 호출하고, 거부되면 대체 경로(다른 도구 호출 또는 설명 응답)를 탐색합니다.
- 같은 HITL 메커니즘이 파이프라인의 HITL 노드와 통합되어, 채팅 표면이 워크플로우의 사람 게이트 역할을 합니다.
로그·모니터링
- 실행 로그: 에이전트 상세 화면의 실행 이력 탭에서 과거 호출 기록과 단계별 입력/출력을 확인합니다.
- 오류 처리: 도구 호출 실패, 타임아웃, 승인 거부 등 유형별 이벤트가 타임라인에 기록됩니다.
버전과 재현성
- 각 배포는 특정 저장 버전을 기반으로 합니다. 이후 에이전트를 편집해도, 해당 배포가 유지되는 한 동일한 정의로 실행됩니다.
- 롤백이 필요하면 이전 버전을 다시 배포하면 됩니다.