워크플로 웹 앱 게시는 어떻게 하나요?
워크플로 웹 앱 게시를 위해 AI Flowi Workflow에서 저장된 워크스페이스 워크플로를 선택하고 채팅, 폼, 대시보드, 포털, 사용자 지정의 다섯 가지 앱 유형 중 하나를 선택합니다. 주소, 접근 권한, 브랜딩을 설정한 다음 검토하고 게시합니다. 주소를 공유하기 전에 워크플로와 방문자 페이지를 테스트하세요.
작성: Ai Flowi · 기술 검토: Janice Lee, Ai Flowi 기술 지원.
게시일 · 수정일
게시 기능과 접근 방식은 다음 페이지를 참고하세요: 게시 기능 페이지.
제품: Ai Flowi의 AI Flowi Workflow · 작업: 설정된 워크플로 게시 · 컴포넌트: 기존 워크플로 사용, 별도 게시 컴포넌트 없음
사용 시점
웹 주소를 통해 워크플로를 실행해야 할 때 게시 기능을 사용합니다. 사용할 수 있는 앱 유형은 채팅, 폼, 대시보드, 포털, 사용자 지정입니다. 방문자 요청을 중계하는 기능은 텍스트 입력을 받아 채팅 또는 텍스트 출력을 반환하며, 앱 유형에 따라 이 입출력 규칙이 바뀌지는 않습니다.
시작하기 전
- 앱이 속할 워크스페이스에서 워크플로를 저장하고 테스트하세요.
- 워크스페이스에서 게시 기능을 사용할 수 있고 계정에 게시된 앱을 관리할 권한이 있는지 확인하세요.
- 워크스페이스의 게시된 앱 할당량을 확인하세요.
- 브랜드 이름과 제목을 준비하세요. 로고, 파비콘, 추천 프롬프트를 사용할 경우 함께 준비하세요.
- 공개, 로그인 필요, 비공개 링크 중 접근 방식을 선택하세요. 로그인이 필요한 경우 사용자는 앱의 워크스페이스에서 게시 항목을 볼 권한이 있어야 합니다.
- 사용자 지정 도메인을 사용할 경우 도메인 관리자에게 제공된 DNS 증명 정보를 설정하고 TLS가 배포되어 있는지 확인하도록 하세요.
단계
워크플로와 앱 유형 추가
추가: 워크플로의 웹 게시 작업에서 게시 마법사를 열거나 게시된 앱 목록에서 새 앱을 만듭니다.
설정: 저장된 워크플로를 선택하고 채팅, 폼, 대시보드, 포털, 사용자 지정 중 하나를 선택합니다.
연결: 앱은 선택한 워크스페이스 워크플로에 연결됩니다. 이 단계에서는 컴포넌트 포트를 추가하거나 변경하지 않습니다.
테스트: 선택한 워크플로가 테스트한 워크플로인지 확인합니다.
예상 결과: 마법사는 선택한 워크플로와 앱 유형을 주소 설정 단계로 전달합니다. 앱 초안이 생성되면 워크플로와 앱 유형은 변경할 수 없습니다.
주소 및 방문자 접근 권한 설정
추가: 제공된 앱 주소 또는 사용자 지정 도메인을 선택합니다.
설정: 주소 이름과 페이지 제목을 입력합니다. 공개, 로그인 필요, 비공개 링크 중 접근 방식을 선택하고 접근 범위를 넓히는 변경을 요청한 경우 확인합니다.
연결: 사용자 지정 도메인에는 제공된 CNAME 대상과 TXT 확인 토큰을 사용합니다. CNAME은 제공된 대상을 직접 가리켜야 합니다. 게시하기 전에 도메인 관리자에게 레코드를 설정하고 DNS 확인을 완료하도록 하세요.
테스트: 저장된 주소, 접근 방식, 도메인 확인 결과를 검토합니다. 새로 발급된 비공개 링크는 한 번만 표시되므로 안전하게 보관하세요.
예상 결과: 초안에 주소와 접근 설정이 저장됩니다. 사용자 지정 도메인은 확인을 완료해야 게시 검증을 통과할 수 있습니다.
브랜딩 추가 및 미리보기 검토
추가: 필요하면 로고와 파비콘을 업로드합니다.
설정: 브랜드 이름, 제목, 소개, 색상, 추천 프롬프트를 입력합니다. 브랜드 이름과 제목은 필수입니다.
연결: 앱 초안에 브랜딩을 저장합니다.
테스트: 미리보기를 검토하고 검증 오류를 수정합니다.
예상 결과: 검토 단계에는 앱 유형, 주소, 접근 방식, 브랜딩이 표시됩니다. 검증 오류가 남아 있으면 게시할 수 없습니다.
게시 및 방문자 페이지 테스트
추가: 저장된 앱을 검토하고 웹 게시를 선택합니다.
설정: 주소를 공유할 때 의도한 접근 방식을 유지합니다.
연결: 방문자로서 게시된 주소를 엽니다. 로그인이 필요한 접근 방식에서는 허용된 워크스페이스 계정으로 로그인하고, 비공개 링크 접근 방식에서는 발급된 링크를 사용합니다.
테스트: 워크플로가 응답하도록 설계된 무해한 텍스트 입력을 보냅니다. 응답을 확인하고 필요한 접근 권한이 없는 사용자가 보호된 앱을 실행할 수 없는지 검증합니다.
예상 결과: 앱이 게시됨으로 표시되고 연결된 워크플로의 텍스트 응답을 반환합니다.
흔히 하는 실수
- 방문자 화면을 테스트하기 전에 주소를 공유하는 실수입니다.
- 사용자 지정 도메인을 확인하지 않은 상태로 두는 실수입니다.
- 확인 내용을 검토하지 않고 보호된 앱을 공개로 변경하는 실수입니다.
- 대시보드, 포털, 사용자 지정 앱이 텍스트 입출력 제한을 우회한다고 여기는 실수입니다.
- 다시 게시하지 않아도 설정 수정으로 게시된 버전이 교체될 것으로 기대하는 실수입니다.
문제 해결
아래는 서비스 오류 코드입니다. 배포된 인터페이스에서는 해당 코드에 대응하는 메시지가 표시될 수 있습니다.
| 코드 | 원인 / 다음 확인 사항 |
|---|---|
invalid_field | 지정된 필드가 허용하는 형식을 확인하세요. |
slug_already_used / address_already_used | 사용되지 않은 주소 이름 또는 도메인을 선택하세요. |
confirm_public_required / confirm_private_required | 요청한 접근 권한 변경을 검토하고 확인하세요. |
custom_domain_used | 해당 도메인은 이미 다른 앱에 등록되어 있습니다. 선택하기 전에 소유권을 확인하세요. |
publish_not_ready | 검증 오류를 확인하세요. 브랜드 이름과 제목을 설정하고 사용자 지정 도메인을 사용하는 경우 확인을 완료하세요. |
published_app_limit | 워크스페이스의 게시된 앱 할당량을 확인하세요. |
publish_quota_unavailable | 할당량 확인을 완료하지 못했습니다. 서비스가 복구되면 다시 시도하세요. |
page_bundle_missing | 관리자에게 게시된 페이지 번들을 배포하도록 요청하세요. |
publish_busy / publish_state_changed | 잠시 기다린 다음 저장된 앱 설정을 다시 불러오고 검토를 다시 시도하세요. |
web_server_reload_failed | 관리자에게 웹 서버 재로드 상태를 확인하도록 요청하세요. |
too_many_runs | 앱이 현재 혼잡합니다. 잠시 기다린 후 다시 시도하세요. |
flow_not_ready | 연결된 워크플로를 확인하고 테스트하세요. |
input_too_large | 방문자 입력을 줄이세요. |
flow_run_timeout / flow_run_failed | 다시 시도하기 전에 연결된 워크플로와 해당 서비스를 확인하세요. |
insufficient_balance | 워크플로가 실행 비용을 충당할 수 없어 앱을 일시적으로 사용할 수 없습니다. 앱 소유자에게 잔액 확인을 요청하세요. |