CallSohail/openwebu-work: 재사용 가능한 Open WebUI 도구 및 함수 모음
요약
본 문서는 Open WebUI에서 재사용 가능한 도구(Tools)와 함수(Functions) 모음을 소개합니다. 이 컬렉션은 확장 기능을 높은 이식성과 안전성을 유지하며 구조화하는 것을 목표로 합니다. 개발자는 API, 데이터 소스 호출 등 다양한 방식으로 모델에 기능을 추가할 수 있습니다.
핵심 포인트
- Open WebUI의 Tools/Functions를 위한 재사용 가능한 모음집입니다.
- 개발 시 높은 이식성, 문서화, 안전성을 유지해야 합니다.
- Tools는 callable capability를 제공하며, Functions는 요청을 가로채거나 변환합니다.
- 민감 정보(API 키, 비밀번호 등)는 소스 파일에 직접 포함해서는 안 됩니다.
재사용 가능한 Open WebUI 도구(Tools)와 함수(Functions)를 구조화하여 모아 놓은 컬렉션입니다.
목표는 간단합니다. 각 확장 기능이 Open WebUI 서버에 설치되기 전에 이식성이 높고, 문서화되어 있으며, 검토하기 안전하도록 유지하는 것입니다.
| Extension | Type | Version | Status | Purpose |
|---|---|---|---|---|
| Rich Email Composer | Tool | 1.0.0 | Stable | 직접 편집, AI 기반 수정, 컨텍스트 포맷팅, 수신자 검증, 복사, .eml 내보내기 및 메일 클라이언트 핸드오프 기능을 갖춘 인터랙티브한 리치 UI 이메일 초안 작성 |
| ... |
.
├── README.md
├── LICENSE
...
Tool: 모델에 API 또는 데이터 소스와 같은 호출 가능한 기능(callable capability)을 제공합니다.Filter: 요청, 스트림 또는 완료된 응답을 가로채거나 변환합니다.Pipe: 사용자 지정 모델, 프로바이더, 라우터 또는 전체 워크플로우를 노출합니다.Action: 채팅 메시지에 사용자가 트리거하는 작업을 추가합니다.Event: Open WebUI의 라이프사이클 또는 시스템 이벤트에 반응합니다.
각 카테고리에는 의도된 사용법과 디렉토리 규칙이 담긴 README가 있습니다.
각 확장 기능은 자체적인 설정 단계를 포함한 전용 README를 가지고 있습니다. 일반적으로:
- 도구(Tools)는 Workspace > Tools에서 가져옵니다. - 함수(Functions)는 Admin Panel > Functions에서 가져옵니다. - 확장 기능을 활성화하기 전에 소스 코드를 검토하십시오.
- 자격 증명(credentials) 및 배포별 설정은 Valves 또는 환경 기반 구성에 넣고, 절대 소스 파일에 직접 넣지 마십시오.
이 리포지토리는 현재 Open WebUI 플러그인 API를 따릅니다. 개별 확장 기능은 하드 최소 버전이 필요한 경우 자체적인 호환성 요구 사항을 선언합니다.
Rich Email Composer는 공개 Tool 메타데이터에 Open WebUI 0.11.x 버전을 의도적으로 하드 코딩하지 않았습니다. 이는 자체 README에 설명된 Rich UI 임베드/이벤트 기능을 활용하기 때문입니다.
Study Mode와 Quick Actions는 현재 최신 Function 이벤트 API 및 인터랙티브 브라우저 측 UI 기능을 사용하므로 Open WebUI 0.11.1 이상을 선언합니다.
Secure Dynamic Onboarding은 현재의 Event Function 훅, Rich UI 임베드, 효과적인 권한 카탈로그, Notes, Channels, Calendar, Automations, 그리고 최신 채팅 저장소 API를 사용하므로 Open WebUI 0.11.3 이상을 선언합니다.
Open WebUI Tools and Functions는 Open WebUI 서버에서 Python을 실행합니다. 확장 기능은 신뢰할 수 있는 서버 측 코드로 간주하십시오.
이 저장소에는 다음 내용이 포함되어서는 안 됩니다:
- API 키 또는 비밀번호;
- 비공개 엔드포인트 또는 내부 IP 주소;
- 개인 또는 기관 이메일 주소;
- 사용자 데이터 또는 사적 문서;
- 배포별 비밀 정보.
저장소 정책은 SECURITY.md를 참조하십시오.
확장 기능은 시맨틱 버전 관리(semantic versioning)를 사용하여 독립적으로 버전이 지정됩니다.
권장 Git 태그 형식:
<플러그인-이름>-v<버전>
예시:
email-composer-v1.0.0
study-mode-v1.1.0
quick-actions-v3.0.1
...
릴리스 체크리스트, 태그 규칙 및 제안된 GitHub 저장소 주제는 RELEASING.md를 참조하십시오.
확장 기능 구조, 문서화 체크리스트, 보안 기대 사항 및 버전 관리 규칙은 CONTRIBUTING.md를 참조하십시오.
저장소 수준의 변경 사항은 CHANGELOG.md에 추적됩니다.
모든 확장 기능은 구현 옆에 자체적인 변경 로그(changelog)도 유지합니다:
| 확장 기능 | 변경 로그 | 최신 버전 |
|---|---|---|
| Rich Email Composer | tools/email-composer/CHANGELOG.md | email-composer-v1.0.0 |
| ... |
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기