에이전트 배포
에이전트는 저장만으로 끝나지 않습니다. 배포(Deploy)까지 마쳐야 Assistant 사이드 패널·Chat 페이지·외부 API에서 불러올 수 있습니다.
배포 / 배포 해제
에이전트 목록 행이나 상세 화면의 액션 메뉴에서 다음 작업을 합니다.
- 배포 (Deploy): 저장된 정의를 실행 환경에 올려 호출할 수 있게 만듭니다. 진행 중에는 "배포 중..."이 표시됩니다.
- 중지 (Undeploy): 실행 환경에서 내려 호출을 중단합니다.
- 재배포: 에이전트를 편집한 뒤 변경 사항을 반영하려면 다시 배포해야 합니다.
배포 상태는 목록에서 초안 / 실행 중 / 중지 배지로 표시되며, 같은 값으로 목록을 필터링할 수 있습니다.
배포된 에이전트 확인
- 에이전트 목록:
실행 중상태 필터로 현재 실행 중인 에이전트만 추립니다. - Chat 페이지: 에이전트별 채팅 페이지(
/agents/:agentId/chat)에서 직접 대화합니다. 어떤 에이전트와 대화할지는 URL의 에이전트 ID로 정하고, 대화 세션은 URL 파라미터로 구분합니다. 단, AI 에이전트 모드만 채팅을 지원합니다(아래 참고). - Assistant 사이드 패널 (자동 라우팅): 사이드 패널은 에이전트 선택기 없이 컨텍스트 기반 자동 라우팅으로 동작합니다. 자세한 내용은 AI Assistant — chat-assistant 참고.
워크플로우 에이전트와 채팅
워크플로우 에이전트는 이벤트 실행 전용이라 채팅 화면에 나타나지 않습니다.
- 에이전트 목록에서 워크플로우 에이전트에는 "채팅 테스트" 액션이 표시되지 않습니다.
- 워크플로우 에이전트의 채팅 URL(
/agents/:agentId/chat)로 직접 이동하면 빌더로 자동 리다이렉트되고, "워크플로우 에이전트는 이벤트 실행만 지원합니다. 채팅 대신 워크플로우 런타임 이벤트 API를 사용하세요." 안내가 표시됩니다.
호출 흐름 (요약)
Assistant/Chat UI
→ 포털 API
→ 에이전트 실행 환경
→ (도구 호출 시) 연결된 도구/액터 실행
→ 응답을 UI로 실시간 전달
사람 승인 카드 (HITL)
스크린샷 TODO
채팅 UI에 떠 있는 사람 승인 카드 — "승인이 필요합니다" 제목, 액터 이름, 대기 중 상태 배지, 승인 / 거부 버튼이 보여야 합니다.
에이전트가 확인 정책이 확인(confirm)인 액터를 실행하려 하면, 대화 UI에 승인 요청 카드("승인이 필요합니다")가 뜹니다(확인 정책 설정 참고).
- 카드에는 대상 액터 이름과 대기 중 상태가 표시됩니다.
- 사용자는 승인 또는 거부를 선택합니다. 거부 시 거부 사유를 입력할 수 있습니다.
- 승인 대기 중에는 새 메시지 입력이 차단되며, "대기 중인 승인에 응답한 후 새 메시지를 보낼 수 있습니다"라는 안내가 표시됩니다.
- 승인하면 에이전트가 해당 액터를 실행하고, 거부하면 다른 길(다른 도구 호출이나 설명 응답)을 찾습니다.
- 이 승인 카드는 에이전트의 액터 호출에만 적용됩니다(데이터 파이프라인에는 해당 노드가 없습니다).
실행 관찰
- 채팅(AI 에이전트): 대화 중 도구·액터 호출이 카드로 스트리밍되므로, 호출 이름·입력·출력과 추론 과정을 실시간으로 따라갈 수 있습니다.
- 워크플로우 노드 실행 상태: 워크플로우가 실행되면 각 노드에 실행 상태(대기·진행·완료·오류)가 표시되어, 지금 어느 단계까지 왔는지 한눈에 보입니다.
재배포로 변경 반영
배포된 에이전트는 배포 시점의 저장된 정의로 고정되어 실행됩니다. 그래서 에이전트를 편집한 뒤에는 다시 배포해야 바뀐 내용이 실행에 반영됩니다.