공유 가능한 링크

공유 가능한 링크를 사용하면 대화의 읽기 전용 스냅샷을 게시하여 다른 사람들이 생성된 URL이나 QR 코드를 통해 열어볼 수 있습니다. 수신자는 메시지, 모든 브랜치, 생성된 아티팩트를 볼 수 있지만, 답장을 보내거나 내용을 변경할 수는 없습니다.

주요 기능

• 간편한 공유: 몇 번의 클릭만으로 링크를 생성하세요.
• QR codes: 코드를 스캔하여 휴대폰에서 대화를 엽니다.
• 브랜칭(Branching): 공유 링크는 대화의 모든 브랜치를 유지합니다.
• Artifacts: React 컴포넌트, HTML 미리보기 및 Mermaid 다이어그램이 대화형으로 유지됩니다.
• 파일 스냅샷: 공유된 링크를 통해 참조된 대화 파일을 미리 보거나 다운로드할 수 있으며, 이때 수신자에게 소유자의 라이브 파일 ACL에 대한 액세스 권한을 부여하지 않아도 됩니다.
• 수신자 기본 설정: 뷰어는 언어와 테마를 전환할 수 있습니다.
• 링크 관리: 생성한 모든 링크를 검토하거나 취소할 수 있는 단일 대시보드입니다.

대화 공유하기

두 곳에서 공유를 시작할 수 있습니다.

공유 링크 옵션

링크를 생성하면 대화가 수신자에게 어떻게 표시될지 제어할 수 있는 모달이 열립니다.

링크가 생성되면, 모달에서 다음 작업들을 수행할 수 있습니다:

• 새로 고침 링크: 이전 URL을 무효화하고 새로운 URL을 생성합니다.
• QR 코드 생성: 모바일 액세스를 위한 QR 코드를 생성합니다.
• 클립보드에 링크 복사: 공유 가능한 URL을 복사합니다.
• 링크 삭제: 링크를 제거하고 해당 링크를 가진 모든 사용자의 액세스 권한을 취소합니다.

파일 스냅샷이 활성화되면, 사용자는 공유된 대화에서 참조된 파일을 링크에 포함할지 여부를 선택할 수 있습니다. 스냅샷된 파일은 공유 버전에 고정되며 공유 전용 경로를 통해 제공됩니다. 공유 후 원본 파일이 삭제되거나 변경되면, 수신자는 더 이상 해당 파일을 받을 수 없습니다.

QR 코드

공유된 대화에 대한 QR 코드를 생성한 다음, 휴대폰 카메라로 스캔하여 링크를 엽니다. 이 코드는 동일한 공유 URL로 연결됩니다.

QR 코드는 프레젠테이션, 빠른 모바일 액세스, 인쇄물 배포 및 컨퍼런스 데모에 유용합니다.

공유된 대화 보기

누군가 귀하의 링크를 열면, 링크가 게시된 날짜, 전체 메시지 기록, 생성된 모든 아티팩트를 포함하여 대화의 읽기 전용 뷰를 집중적으로 볼 수 있습니다.

브랜칭

공유 링크는 대화의 분기를 보존하므로, 수신자는 대화가 진행된 다양한 경로를 따라갈 수 있습니다. 분기 탐색 화살표를 사용하여 경로 간을 이동하세요.

이는 서로 다른 프롬프트가 어떻게 서로 다른 AI 응답을 이끌어내는지, 또는 하나의 문제를 여러 방식으로 어떻게 접근할 수 있는지 보여주는 데 유용합니다.

Artifacts

대화 중에 생성된 Artifacts는 공유 링크에서도 완전히 정상적으로 작동합니다.

수신자는 다음을 수행할 수 있습니다:

• 대화형 React 컴포넌트를 확인하세요.
• HTML 미리보기를 참조하세요.
• Mermaid 다이어그램을 검토하세요.
• 기본 코드와 해당 코드가 생성된 맥락을 읽어보세요.

수신자 기본 설정

사용자는 본인의 설정을 변경하지 않고도 인터페이스를 원하는 대로 조정할 수 있습니다.

• 테마: 라이트, 다크 또는 시스템.
• 언어: 선호하는 언어로 인터페이스를 확인합니다.

공유 링크 관리하기

Settings → Data Controls 아래의 Shared Links 대시보드를 열어 공유한 모든 대화를 검토하세요.

대시보드에서 다음을 수행할 수 있습니다:

• 모든 링크 보기: 공유한 모든 대화를 확인하세요.
• 검색 및 필터링: 특정 공유 링크를 찾고 해당 콘텐츠를 미리 봅니다.
• 액세스 취소: 링크를 삭제하여 즉시 공유를 중단합니다.

구성

.env 파일에 있는 세 개의 환경 변수가 이 기능을 제어합니다:

• ALLOW_SHARED_LINKS (기본값: true): 공유 링크 기능을 활성화합니다. 사용자가 링크를 생성하지 못하게 하려면 false로 설정하세요.
• ALLOW_SHARED_LINKS_PUBLIC (기본값: false): 인증 없이 링크를 열 수 있는지 여부를 제어합니다. 기본적으로 수신자는 로그인해야 합니다. 공개적이고 인증되지 않은 액세스를 허용하려면 true로 설정하세요.
• SHARED_LINKS_SNAPSHOT_FILES (기본값: true): 공유 링크에 참조된 대화 파일을 포함할 수 있는지 여부를 제어합니다. 이 환경 변수가 설정되면 interface.sharedLinks.snapshotFiles 설정을 재정의합니다.

# Enable shared links (default)
ALLOW_SHARED_LINKS=true

# Require authentication to view shared links (default)
ALLOW_SHARED_LINKS_PUBLIC=false

# Include referenced files in shared-link snapshots (default)
SHARED_LINKS_SNAPSHOT_FILES=true

역할 권한은 어떤 사용자가 링크를 생성하고, 인증된 사용자와 공유하거나, 인스턴스의 모든 사용자에게 공개할 수 있는지 결정합니다:

interface:
  sharedLinks:
    create: true
    share: true
    public: false
    snapshotFiles: true

sharedLinks.public는 사용자가 "모두와 공유"를 토글할 수 있는지 여부를 제어합니다. ALLOW_SHARED_LINKS_PUBLIC은 해당 공개 링크를 로그인 없이 볼 수 있는지 여부를 여전히 결정합니다. sharedLinks.snapshotFiles는 YAML에서 파일 스냅샷 기본 동작을 제어하며, SHARED_LINKS_SNAPSHOT_FILES를 통해 이를 전역적으로 재정의하거나 비활성화할 수 있습니다.

자주 묻는 질문 (FAQ)