🔄 밸브

밸브

밸브와 사용자 밸브는 사용자가 API 키나 구성 옵션과 같은 동적 세부 정보를 제공할 수 있도록 사용됩니다. 이는 GUI 메뉴에서 지정된 기능에 대해 작성 가능한 필드 또는 bool 스위치를 생성합니다. 이들은 항상 선택 사항이지만 매우 권장됩니다.

따라서 밸브와 사용자 밸브 클래스는 Pipe, Pipeline, Filter 또는 Tools 클래스 중 하나에 정의될 수 있습니다.

밸브는 관리자만 Tools 또는 Functions 메뉴를 통해 구성할 수 있습니다. 반면 사용자 밸브는 모든 사용자가 채팅 세션에서 직접 구성할 수 있습니다.

댓글이 달린 예제

from pydantic import BaseModel, Field
from typing import Literal

# 밸브와 정의
class Filter:
   # 현재 들여쓰기에 주의하십시오: 밸브와 사용자 밸브는 반드시 Tools, Filter 또는 Pipe 클래스의
   # 속성으로 선언되어야 합니다. 여기서는 Filter의 예를 참조합니다.
    class Valves(BaseModel):
       # 밸브와 사용자 밸브는 pydantic의 BaseModel을 상속받습니다. 이는
       # 모델 검증자와 같이 복잡한 사용 사례를 가능하게 합니다.
       test_valve: int = Field(  # 형식 힌트에 주의하세요: 이는 사용자가 볼 수 있는 UI 요소의 종류를
           # 선택할 때 사용됩니다 (버튼, 텍스트 등).
           default=4,
           description="숫자 값을 조절하는 밸브"
           # required=False,  # 필드를 강제할 경우 True를 사용할 수 있습니다.
       )
       # 사용자가 여러 문자열 중에서 선택할 수 있도록 한 경우, typing의 Literal을 사용할 수 있습니다:
       choice_option: Literal["choiceA", "choiceB"] = Field(
           default="choiceA",
           description="다중 선택 밸브의 예",
       )
       priority: int = Field(
           default=0,
           description="필터 작업의 우선 순위 수준. 낮은 값이 먼저 처리됩니다."
       )
       # priority 필드는 선택 사항이지만, 포함된 경우 필터의 순서를 결정하는 데 사용됩니다.
       pass
       # 'pass'는 파싱을 돕고 사용을 권장합니다.

   # 사용자 밸브는 동일한 방식으로 정의됩니다.
    class UserValves(BaseModel):
        test_user_valve: bool = Field(
            default=False, description="True/False (켜짐/꺼짐) 스위치를 조절하는 사용자 밸브"
       )
       pass

   def __init__(self):
       self.valves = self.Valves()
       # 관리자가 설정하기 때문에 코드 실행 시 바로 접근할 수 있습니다.
       pass

   # inlet 메서드는 필터에만 사용되지만 __user__ 처리 방식은 동일합니다.
   def inlet(self, body: dict, __user__: dict):
       # 사용자 밸브는 사용자별로 정의되기 때문에 사용 시에만 제공됩니다.
       # __user__는 dict이지만, __user__["valves"]는 UserValves 객체입니다.
       # 따라서 값을 다음과 같이 접근할 수 있습니다:
       test_user_valve = __user__["valves"].test_user_valve
       # 또는:
       test_user_valve = dict(__user__["valves"])["test_user_valve"]
       # 그러나 이는 실제 값 대신 기본값을 반환합니다:
       # test_user_valve = __user__["valves"]["test_user_valve"]  # 이렇게 하면 안 됩니다!