🔗 URL 매개변수

Open WebUI에서 채팅 세션은 다양한 URL 매개변수를 통해 사용자 정의할 수 있습니다. 이러한 매개변수는 특정 설정을 지정하고, 기능을 활성화하고, 채팅별로 모델 설정을 정의할 수 있게 해줍니다. 이 접근 방식은 URL을 통해 개별 채팅 세션에 대한 유연성과 제어를 제공합니다.

URL 매개변수 개요

다음 표는 사용 가능한 URL 매개변수, 그 기능 및 사용 예시를 나열한 것입니다.

매개변수	설명	예시
models	사용될 모델을 쉼표로 구분된 목록으로 지정합니다.	/?models=model1,model2
model	채팅 세션에 사용할 단일 모델을 지정합니다.	/?model=model1
youtube	채팅에서 기록될 YouTube 비디오 ID를 지정합니다.	/?youtube=VIDEO_ID
web-search	true로 설정하면 웹 검색 기능을 활성화합니다.	/?web-search=true
tools 또는 tool-ids	채팅에서 활성화할 도구 ID를 쉼표로 구분된 목록으로 지정합니다.	/?tools=tool1,tool2
call	true로 설정하면 통화 오버레이를 활성화합니다.	/?call=true
q	채팅을 위한 초기 문의 또는 프롬프트를 설정합니다.	/?q=Hello%20there
temporary-chat	true로 설정하면 채팅을 일회용 세션으로 표시합니다.	/?temporary-chat=true

1. 모델 및 모델 선택

• 설명: models 및 model 매개변수를 사용하여 특정 채팅 세션에 사용할 언어 모델을 지정할 수 있습니다.
• 설정 방법: 여러 모델에는 models를, 단일 모델에는 model을 사용하세요.
• 예시:
  • /?models=model1,model2 – model1과 model2로 채팅을 초기화합니다.
  • /?model=model1 – 채팅에 model1만 사용됩니다.

2. YouTube 기록

• 설명: youtube 매개변수는 YouTube 비디오 ID를 받아 지정된 비디오를 채팅에서 기록할 수 있게 합니다.
• 설정 방법: 이 매개변수에 YouTube 비디오 ID를 값으로 사용하세요.
• 예시: /?youtube=VIDEO_ID
• 작동 방식: 제공된 YouTube 비디오에 대한 기록 기능이 채팅에서 실행됩니다.

3. 웹 검색

• 설명: web-search를 활성화하면 채팅 세션이 웹 검색 기능에 액세스할 수 있습니다.
• 설정 방법: 이 매개변수를 true로 설정하면 웹 검색이 활성화됩니다.
• 예시: /?web-search=true
• 작동 방식: 활성화되면 채팅에서 웹 검색 결과를 응답의 일부로 가져올 수 있습니다.

4. 도구 선택

• 설명: tools 또는 tool-ids 매개변수를 사용하여 채팅 내에서 활성화할 도구를 지정할 수 있습니다.
• 설정 방법: 매개변수 값으로 쉼표로 구분된 도구 ID 목록을 제공하세요.
• 예시: /?tools=tool1,tool2 또는 /?tool-ids=tool1,tool2
• 작동 방식: 각 도구 ID가 일치하며 사용자와 상호 작용할 수 있도록 세션 내에서 활성화됩니다.

5. 통화 오버레이

• 설명: call 매개변수는 채팅 인터페이스에 비디오 또는 통화 오버레이를 활성화합니다.
• 설정 방법: 매개변수를 true로 설정하여 통화 오버레이를 활성화합니다.
• 예시: /?call=true
• 작동 방식: 라이브 기록 및 비디오 입력과 같은 기능을 제공하는 통화 인터페이스 오버레이가 활성화됩니다.

6. 초기 문의 프롬프트

• 설명: q 매개변수는 채팅을 위한 초기 문의 또는 프롬프트를 설정합니다.
• 설정 방법: 매개변수 값으로 문의 또는 프롬프트 텍스트를 지정하세요.
• 예시: /?q=Hello%20there
• 작동 방식: 지정된 프롬프트로 채팅이 시작되며, 이를 최초 메시지로 자동 제출합니다.

7. 일회용 채팅 세션

• 설명: temporary-chat 매개변수는 채팅을 임시 세션으로 표시합니다. 이는 채팅 기록 저장 또는 지속적인 설정 적용과 같은 기능을 제한할 수 있습니다.
• 설정 방법: 일회용 채팅 세션을 위해 이 매개변수를 true로 설정하세요.
• 예시: /?temporary-chat=true
• 작동 방식: 채팅 기록을 저장하거나 고급 구성을 적용하지 않는 일회용 채팅 세션이 시작됩니다.

예시 사용 사례

일회용 채팅 세션

사용자가 기록을 저장하지 않고 빠른 채팅 세션을 시작하고 싶다면, URL에 temporary-chat=true를 설정하면 됩니다. 이는 일회성 상호작용에 이상적인 일회용 채팅 환경을 제공합니다.

여러 매개변수를 함께 사용하기

이 URL 매개변수들을 조합하여 고도로 맞춤화된 채팅 세션을 생성할 수 있습니다. 예를 들어:

/?models=model1,model2&youtube=VIDEO_ID&web-search=true&tools=tool1,tool2&call=true&q=Hello%20there&temporary-chat=true

이 URL은:

• model1과 model2로 채팅을 초기화합니다.
• YouTube 자막 작성, 웹 검색, 지정된 도구를 활성화합니다.
• 통화 오버레이를 표시합니다.
• "Hello there."라는 초기 프롬프트를 설정합니다.
• 채팅을 임시 채팅으로 표시하여 기록 저장을 방지합니다.