mirror of
https://github.com/langbot-app/LangBot.git
synced 2026-10-29 20:05:25 +08:00
632c23e841
* docs: update wiki for RAG engine plugin architecture Replace KnowledgeRetriever component docs with RAGEngine across all three languages (zh/en/ja). Key changes: - Add new rag-engine.mdx component docs covering RAGEngine base class, creation_schema/retrieval_schema, capability declarations, lifecycle hooks, host RAG APIs, and complete code examples - Update knowledge base usage docs to reflect unified KB model (remove internal/external distinction, add RAG engine selection flow) - Update component list (add.mdx) and plugin intro to reference RAGEngine - Add RAG API section to plugin common APIs (invoke_embedding, vector_upsert/search/delete, get_rag_file_stream) - Update docs.json navigation to point to rag-engine pages Companion to LangBot PR #1995 and SDK PR #34. Co-Authored-By: Claude Opus 4.6 <[email protected]> * fix: sync with sdk * docs: update vector API docs with metadata filters, search_type, and documents support - Replace Warning tags about unimplemented filters with Info tags documenting canonical filter format (Chroma-style where syntax) and supported operators - Document search_type/query_text params for full-text and hybrid search - Document documents param for vector_upsert - Update RetrievalContext.filters description from reserved to active - Add filter usage examples (en/zh/ja) Co-Authored-By: Claude Opus 4.6 <[email protected]> * docs: enhance RAG Engine documentation across multiple languages - Expanded the description of the RAG Engine component to include bridging capabilities with advanced knowledge base services like Dify, RAGFlow, and FastGPT. - Clarified the `DOC_INGESTION` capability description, specifying conditions under which the declaration can be omitted. - Updated documentation in English, Japanese, and Chinese to ensure consistency and clarity. * docs: add instructions for show_if conditional rendering * docs: add Parser component documentation (zh/en/ja) Add Parser as a new component type in plugin docs. Parser extracts structured text from binary files (PDF, Word, etc.) before RAG engine ingestion. Includes manifest format, parse method API, data models (ParseContext/ParseResult/TextSection), RAGEngine integration via parsed_content, and cross-plugin invoke_parser API. Also add DOC_PARSING capability to RAG engine docs and parsed_content field to IngestionContext. Companion to SDK PR langbot-app/langbot-plugin-sdk#37 and LangBot PR langbot-app/LangBot#2000. Co-Authored-By: Claude Opus 4.6 <[email protected]> * docs: rename RAGEngine components to KnowledgeEngine * refactor: change rag engine to knowledge engine --------- Co-authored-by: Claude Opus 4.6 <[email protected]> Co-authored-by: Junyan Qin <[email protected]>
77 lines
2.7 KiB
Plaintext
77 lines
2.7 KiB
Plaintext
---
|
|
title: "コンポーネントの追加"
|
|
---
|
|
|
|
プラグインは、LangBotにさまざまな機能を提供する1つ以上のコンポーネントで構成されています。現在サポートされているコンポーネントタイプには次のものがあります:
|
|
|
|
- イベントリスナー(EventListener): パイプライン実行中のイベントをリッスンし、コンテキストやパイプラインを変更します。
|
|
- コマンド(Command): `!`(または他の設定されたプレフィックス)で始まるユーザーコマンドメッセージによってトリガーされます。
|
|
- ツール(Tool): LangBotの組み込みLocal Agentの実行中にLLMによって呼び出されます。
|
|
- RAGエンジン(KnowledgeEngine): LangBotにナレッジベースのインデックス作成と検索機能を提供し、ドキュメントの取り込み、検索、削除を管理します。
|
|
- パーサー(Parser): ドキュメント取り込みの前にPDF、Wordなどのバイナリファイルを構造化テキストに解析し、RAGエンジンで使用できるようにします。
|
|
|
|
## コンポーネントの追加
|
|
|
|
プラグインディレクトリでコマンドを実行します:
|
|
|
|
```bash
|
|
lbp comp <component_type>
|
|
```
|
|
|
|
例えば、イベントリスナーを追加する場合:
|
|
|
|
```bash
|
|
lbp comp EventListener
|
|
```
|
|
|
|
プロンプトに従って、コンポーネント設定(ある場合)を入力します。
|
|
|
|
```bash
|
|
➜ HelloPlugin > lbp comp EventListener
|
|
Generating component EventListener...
|
|
Component EventListener generated successfully.
|
|
組件 EventListener 生成成功。
|
|
➜ HelloPlugin >
|
|
```
|
|
|
|
<Info title="CLIはプラグインディレクトリに`components`ディレクトリを生成し、その中に対応するコンポーネントディレクトリを作成します。">
|
|
|
|
```
|
|
.
|
|
├── assets
|
|
│ └── icon.svg
|
|
├── components
|
|
│ ├── __init__.py
|
|
│ └── event_listener
|
|
│ ├── __init__.py
|
|
│ ├── default.py
|
|
│ └── default.yaml
|
|
├── main.py
|
|
├── manifest.yaml
|
|
├── README.md
|
|
└── requirements.txt
|
|
```
|
|
|
|
同時に、プラグインの`manifest.yaml`にコンポーネント検出設定が追加されます:
|
|
|
|
```yaml
|
|
...
|
|
components:
|
|
EventListener:
|
|
fromDirs:
|
|
- path: components/event_listener/
|
|
...
|
|
```
|
|
コンポーネントを削除するには、対応する情報を手動で削除できます。
|
|
</Info>
|
|
|
|
## コンポーネントタイプ
|
|
|
|
各コンポーネントの詳細な使用方法については、次を参照してください:
|
|
|
|
- [EventListener](./event-listener)
|
|
- [Command](./command)
|
|
- [Tool](./tool)
|
|
- [KnowledgeEngine](./knowledge-engine)
|
|
- [Parser](./parser)
|