에이전트 배포
에이전트를 저장한 뒤에는 배포(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 에이전트): 대화 중 도구·액터 호출이 카드로 스트리밍되어, 호출 이름·입력·출력과 추론 과정을 실시간으로 확인할 수 있습니다.
- 워크플로우 노드 실행 상태: 워크플로우가 실행되면 각 노드에 실행 상태(대기·진행·완료·오류)가 표시되어, 어느 단계까지 진행됐는지 확인할 수 있습니다.
재배포로 변경 반영
배포된 에이전트는 저장된 정의로 고정 실행됩니다. 에이전트를 편집한 뒤에는 다시 배포해야 변경 사항이 실행에 반영됩니다.