writinwaters
commited on
Commit
·
995e253
1
Parent(s):
8259c8d
Added a list of supported models (#3214)
Browse files### What problem does this PR solve?
_Briefly describe what this PR aims to solve. Include background context
that will help reviewers understand the purpose of the PR._
### Type of change
- [x] Documentation Update
- docker/README.md +48 -56
- docs/references/http_api_reference.md +11 -10
- docs/references/python_api_reference.md +19 -18
- docs/references/supported_models.mdx +66 -0
docker/README.md
CHANGED
|
@@ -1,81 +1,73 @@
|
|
|
|
|
| 1 |
|
| 2 |
-
# Docker Environment Variable
|
| 3 |
-
|
| 4 |
-
Look into [.env](./.env), there're some important variables.
|
| 5 |
-
|
| 6 |
-
## MYSQL_PASSWORD
|
| 7 |
-
|
| 8 |
-
The mysql password could be changed by this variable. But you need to change *mysql.password* in [service_conf.yaml](./service_conf.yaml) at the same time.
|
| 9 |
|
| 10 |
|
| 11 |
-
##
|
| 12 |
-
It refers to exported port number of mysql docker container, it's useful if you want to access the database outside the docker containers.
|
| 13 |
|
| 14 |
-
|
| 15 |
-
It refers to user name of [Mino](https://github.com/minio/minio). The modification should be synchronous updating at minio.user of [service_conf.yaml](./service_conf.yaml).
|
| 16 |
-
|
| 17 |
-
## MINIO_PASSWORD
|
| 18 |
-
It refers to user password of [Mino](https://github.com/minio/minio). The modification should be synchronous updating at minio.password of [service_conf.yaml](./service_conf.yaml).
|
| 19 |
-
|
| 20 |
-
|
| 21 |
-
## SVR_HTTP_PORT
|
| 22 |
-
It refers to The API server serving port.
|
| 23 |
|
|
|
|
|
|
|
| 24 |
|
| 25 |
-
|
| 26 |
-
|
| 27 |
|
| 28 |
-
|
|
|
|
| 29 |
|
| 30 |
-
|
| 31 |
-
The
|
| 32 |
|
| 33 |
-
|
| 34 |
-
The
|
| 35 |
|
| 36 |
-
|
|
|
|
| 37 |
|
| 38 |
-
|
| 39 |
-
The
|
| 40 |
|
| 41 |
-
### user
|
| 42 |
-
The database user name.
|
| 43 |
|
| 44 |
-
### password
|
| 45 |
-
The database password. The modification should be synchronous updating at *MYSQL_PASSWORD* in [.env](./.env).
|
| 46 |
|
| 47 |
-
|
| 48 |
-
The
|
| 49 |
|
| 50 |
-
|
| 51 |
-
The
|
|
|
|
|
|
|
| 52 |
|
| 53 |
-
|
| 54 |
-
The
|
| 55 |
|
| 56 |
-
## minio
|
| 57 |
|
| 58 |
-
|
| 59 |
-
The username of minio. The modification should be synchronous updating at *MINIO_USER* in [.env](./.env).
|
| 60 |
|
| 61 |
-
|
| 62 |
-
The password of minio. The modification should be synchronous updating at *MINIO_PASSWORD* in [.env](./.env).
|
| 63 |
|
| 64 |
-
|
| 65 |
-
The
|
|
|
|
| 66 |
|
| 67 |
-
|
| 68 |
-
|
| 69 |
-
|
| 70 |
-
|
| 71 |
-
The
|
|
|
|
|
|
|
| 72 |
|
| 73 |
-
|
| 74 |
-
The
|
|
|
|
|
|
|
| 75 |
|
| 76 |
-
|
| 77 |
-
|
|
|
|
|
|
|
| 78 |
|
| 79 |
-
|
| 80 |
-
|
|
|
|
| 81 |
|
|
|
|
| 1 |
+
# README
|
| 2 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 3 |
|
| 4 |
|
| 5 |
+
## Docker environment variables
|
|
|
|
| 6 |
|
| 7 |
+
Look into [.env](./.env), there're some important variables.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 8 |
|
| 9 |
+
- `STACK_VERSION`
|
| 10 |
+
The Elasticsearch version. Defaults to `8.11.3`
|
| 11 |
|
| 12 |
+
- `ES_PORT`
|
| 13 |
+
Port to expose Elasticsearch HTTP API to the host. Defaults to `1200`.
|
| 14 |
|
| 15 |
+
- `ELASTIC_PASSWORD`
|
| 16 |
+
The Elasticsearch password.
|
| 17 |
|
| 18 |
+
- `MYSQL_PASSWORD`
|
| 19 |
+
The MySQL password. When updated, you must also revise the `mysql.password` entry in [service_conf.yaml](./service_conf.yaml) accordingly.
|
| 20 |
|
| 21 |
+
- `MYSQL_PORT`
|
| 22 |
+
The exported port number of MySQL Docker container, needed when you access the database from outside the docker containers.
|
| 23 |
|
| 24 |
+
- `MINIO_USER`
|
| 25 |
+
The MinIO username. When updated, you must also revise the `minio.user` entry in [service_conf.yaml](./service_conf.yaml) accordingly.
|
| 26 |
|
| 27 |
+
- `MINIO_PASSWORD`
|
| 28 |
+
The MinIO password. When updated, you must also revise the `minio.password` entry in [service_conf.yaml](./service_conf.yaml) accordingly.
|
| 29 |
|
|
|
|
|
|
|
| 30 |
|
|
|
|
|
|
|
| 31 |
|
| 32 |
+
- `SVR_HTTP_PORT`
|
| 33 |
+
The port number on which RAGFlow's backend API server listens.
|
| 34 |
|
| 35 |
+
- `RAGFLOW-IMAGE`
|
| 36 |
+
The Docker image edition. Available options:
|
| 37 |
+
- `infiniflow/ragflow:dev-slim` (default): The RAGFlow Docker image without embedding models
|
| 38 |
+
- `infiniflow/ragflow:dev`: The RAGFlow Docker image with embedding models. See the
|
| 39 |
|
| 40 |
+
- `TIMEZONE`
|
| 41 |
+
The local time zone.
|
| 42 |
|
|
|
|
| 43 |
|
| 44 |
+
## Service Configuration
|
|
|
|
| 45 |
|
| 46 |
+
[service_conf.yaml](./service_conf.yaml) defines the system-level configuration for RAGFlow and is used by RAGFlow's *API server* and *task executor*.
|
|
|
|
| 47 |
|
| 48 |
+
- `ragflow`
|
| 49 |
+
- `host`: The IP address of the API server.
|
| 50 |
+
- `port`: The serving port of API server.
|
| 51 |
|
| 52 |
+
- `mysql`
|
| 53 |
+
- `name`: The database name in MySQL used by RAGFlow.
|
| 54 |
+
- `user`: The database name in MySQL used by RAGFlow.
|
| 55 |
+
- `password`: The database password. When updated, you must also revise the `MYSQL_PASSWORD` variable in [.env](./.env) accordingly.
|
| 56 |
+
- `port`: The serving port of MySQL inside the container. When updated, you must also revise the `MYSQL_PORT` variable in [.env](./.env) accordingly.
|
| 57 |
+
- `max_connections`: The maximum database connection.
|
| 58 |
+
- `stale_timeout`: The timeout duration in seconds.
|
| 59 |
|
| 60 |
+
- `minio`
|
| 61 |
+
- `user`: The MinIO username. When updated, you must also revise the `MINIO_USER` variable in [.env](./.env) accordingly.
|
| 62 |
+
- `password`: The MinIO password. When updated, you must also revise the `MINIO_PASSWORD` variable in [.env](./.env) accordingly.
|
| 63 |
+
- `host`: The serving IP and port inside the docker container. This is not updating until changing the minio part in [docker-compose.yml](./docker-compose.yml)
|
| 64 |
|
| 65 |
+
- `user_default_llm`
|
| 66 |
+
Newly signed-up users use LLM configured by this part; otherwise, you need to configure your own LLM on the *Settings* page.
|
| 67 |
+
- `factory`: The LLM suppliers. "OpenAI", "Tongyi-Qianwen", "ZHIPU-AI", "Moonshot", "DeepSeek", "Baichuan", and "VolcEngine" are supported.
|
| 68 |
+
- `api_key`: The API key for the specified LLM.
|
| 69 |
|
| 70 |
+
- `oauth`
|
| 71 |
+
The OAuth configuration for signing up or signing in to RAGFlow using a third-party account.
|
| 72 |
+
- `github`: Go to [Github](https://github.com/settings/developers), register a new application, the *client_id* and *secret_key* will be given.
|
| 73 |
|
docs/references/http_api_reference.md
CHANGED
|
@@ -1,6 +1,5 @@
|
|
| 1 |
---
|
| 2 |
-
sidebar_position:
|
| 3 |
-
|
| 4 |
slug: /http_api_reference
|
| 5 |
---
|
| 6 |
|
|
@@ -93,7 +92,7 @@ curl --request POST \
|
|
| 93 |
- `"picture"`: Picture
|
| 94 |
- `"one"`: One
|
| 95 |
- `"knowledge_graph"`: Knowledge Graph
|
| 96 |
-
Ensure your LLM is properly configured on the **Settings** page before selecting this. Please note that Knowledge Graph consumes a large number of Tokens!
|
| 97 |
- `"email"`: Email
|
| 98 |
|
| 99 |
- `"parser_config"`: (*Body parameter*), `object`
|
|
@@ -269,7 +268,9 @@ curl --request PUT \
|
|
| 269 |
- `"presentation"`: Presentation
|
| 270 |
- `"picture"`: Picture
|
| 271 |
- `"one"`:One
|
| 272 |
-
- `"
|
|
|
|
|
|
|
| 273 |
|
| 274 |
### Response
|
| 275 |
|
|
@@ -318,7 +319,7 @@ curl --request GET \
|
|
| 318 |
- `page`: (*Filter parameter*)
|
| 319 |
Specifies the page on which the datasets will be displayed. Defaults to `1`.
|
| 320 |
- `page_size`: (*Filter parameter*)
|
| 321 |
-
The number of datasets on each page. Defaults to `
|
| 322 |
- `orderby`: (*Filter parameter*)
|
| 323 |
The field by which datasets should be sorted. Available options:
|
| 324 |
- `create_time` (default)
|
|
@@ -524,7 +525,7 @@ curl --request PUT \
|
|
| 524 |
- `"picture"`: Picture
|
| 525 |
- `"one"`: One
|
| 526 |
- `"knowledge_graph"`: Knowledge Graph
|
| 527 |
-
Ensure your LLM is properly configured on the **Settings** page before selecting this. Please note that Knowledge Graph consumes a large number of Tokens!
|
| 528 |
- `"email"`: Email
|
| 529 |
- `"parser_config"`: (*Body parameter*), `object`
|
| 530 |
The configuration settings for the dataset parser. The attributes in this JSON object vary with the selected `"chunk_method"`:
|
|
@@ -645,7 +646,7 @@ curl --request GET \
|
|
| 645 |
- `page`: (*Filter parameter*), `integer`
|
| 646 |
Specifies the page on which the documents will be displayed. Defaults to `1`.
|
| 647 |
- `page_size`: (*Filter parameter*), `integer`
|
| 648 |
-
The maximum number of documents on each page. Defaults to `
|
| 649 |
- `orderby`: (*Filter parameter*), `string`
|
| 650 |
The field by which documents should be sorted. Available options:
|
| 651 |
- `create_time` (default)
|
|
@@ -1245,7 +1246,7 @@ curl --request POST \
|
|
| 1245 |
- `"page"`: (*Body parameter*), `integer`
|
| 1246 |
Specifies the page on which the chunks will be displayed. Defaults to `1`.
|
| 1247 |
- `"page_size"`: (*Body parameter*)
|
| 1248 |
-
The maximum number of chunks on each page. Defaults to `
|
| 1249 |
- `"similarity_threshold"`: (*Body parameter*)
|
| 1250 |
The minimum similarity score. Defaults to `0.2`.
|
| 1251 |
- `"vector_similarity_weight"`: (*Body parameter*), `float`
|
|
@@ -1628,7 +1629,7 @@ curl --request GET \
|
|
| 1628 |
- `page`: (*Filter parameter*), `integer`
|
| 1629 |
Specifies the page on which the chat assistants will be displayed. Defaults to `1`.
|
| 1630 |
- `page_size`: (*Filter parameter*), `integer`
|
| 1631 |
-
The number of chat assistants on each page. Defaults to `
|
| 1632 |
- `orderby`: (*Filter parameter*), `string`
|
| 1633 |
The attribute by which the results are sorted. Available options:
|
| 1634 |
- `create_time` (default)
|
|
@@ -1860,7 +1861,7 @@ curl --request GET \
|
|
| 1860 |
- `page`: (*Filter parameter*), `integer`
|
| 1861 |
Specifies the page on which the sessions will be displayed. Defaults to `1`.
|
| 1862 |
- `page_size`: (*Filter parameter*), `integer`
|
| 1863 |
-
The number of sessions on each page. Defaults to `
|
| 1864 |
- `orderby`: (*Filter parameter*), `string`
|
| 1865 |
The field by which sessions should be sorted. Available options:
|
| 1866 |
- `create_time` (default)
|
|
|
|
| 1 |
---
|
| 2 |
+
sidebar_position: 1
|
|
|
|
| 3 |
slug: /http_api_reference
|
| 4 |
---
|
| 5 |
|
|
|
|
| 92 |
- `"picture"`: Picture
|
| 93 |
- `"one"`: One
|
| 94 |
- `"knowledge_graph"`: Knowledge Graph
|
| 95 |
+
Ensure your LLM is properly configured on the **Settings** page before selecting this. Please also note that Knowledge Graph consumes a large number of Tokens!
|
| 96 |
- `"email"`: Email
|
| 97 |
|
| 98 |
- `"parser_config"`: (*Body parameter*), `object`
|
|
|
|
| 268 |
- `"presentation"`: Presentation
|
| 269 |
- `"picture"`: Picture
|
| 270 |
- `"one"`:One
|
| 271 |
+
- `"email"`: Email
|
| 272 |
+
- `"knowledge_graph"`: Knowledge Graph
|
| 273 |
+
Ensure your LLM is properly configured on the **Settings** page before selecting this. Please also note that Knowledge Graph consumes a large number of Tokens!
|
| 274 |
|
| 275 |
### Response
|
| 276 |
|
|
|
|
| 319 |
- `page`: (*Filter parameter*)
|
| 320 |
Specifies the page on which the datasets will be displayed. Defaults to `1`.
|
| 321 |
- `page_size`: (*Filter parameter*)
|
| 322 |
+
The number of datasets on each page. Defaults to `30`.
|
| 323 |
- `orderby`: (*Filter parameter*)
|
| 324 |
The field by which datasets should be sorted. Available options:
|
| 325 |
- `create_time` (default)
|
|
|
|
| 525 |
- `"picture"`: Picture
|
| 526 |
- `"one"`: One
|
| 527 |
- `"knowledge_graph"`: Knowledge Graph
|
| 528 |
+
Ensure your LLM is properly configured on the **Settings** page before selecting this. Please also note that Knowledge Graph consumes a large number of Tokens!
|
| 529 |
- `"email"`: Email
|
| 530 |
- `"parser_config"`: (*Body parameter*), `object`
|
| 531 |
The configuration settings for the dataset parser. The attributes in this JSON object vary with the selected `"chunk_method"`:
|
|
|
|
| 646 |
- `page`: (*Filter parameter*), `integer`
|
| 647 |
Specifies the page on which the documents will be displayed. Defaults to `1`.
|
| 648 |
- `page_size`: (*Filter parameter*), `integer`
|
| 649 |
+
The maximum number of documents on each page. Defaults to `30`.
|
| 650 |
- `orderby`: (*Filter parameter*), `string`
|
| 651 |
The field by which documents should be sorted. Available options:
|
| 652 |
- `create_time` (default)
|
|
|
|
| 1246 |
- `"page"`: (*Body parameter*), `integer`
|
| 1247 |
Specifies the page on which the chunks will be displayed. Defaults to `1`.
|
| 1248 |
- `"page_size"`: (*Body parameter*)
|
| 1249 |
+
The maximum number of chunks on each page. Defaults to `30`.
|
| 1250 |
- `"similarity_threshold"`: (*Body parameter*)
|
| 1251 |
The minimum similarity score. Defaults to `0.2`.
|
| 1252 |
- `"vector_similarity_weight"`: (*Body parameter*), `float`
|
|
|
|
| 1629 |
- `page`: (*Filter parameter*), `integer`
|
| 1630 |
Specifies the page on which the chat assistants will be displayed. Defaults to `1`.
|
| 1631 |
- `page_size`: (*Filter parameter*), `integer`
|
| 1632 |
+
The number of chat assistants on each page. Defaults to `30`.
|
| 1633 |
- `orderby`: (*Filter parameter*), `string`
|
| 1634 |
The attribute by which the results are sorted. Available options:
|
| 1635 |
- `create_time` (default)
|
|
|
|
| 1861 |
- `page`: (*Filter parameter*), `integer`
|
| 1862 |
Specifies the page on which the sessions will be displayed. Defaults to `1`.
|
| 1863 |
- `page_size`: (*Filter parameter*), `integer`
|
| 1864 |
+
The number of sessions on each page. Defaults to `30`.
|
| 1865 |
- `orderby`: (*Filter parameter*), `string`
|
| 1866 |
The field by which sessions should be sorted. Available options:
|
| 1867 |
- `create_time` (default)
|
docs/references/python_api_reference.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
| 1 |
-
|
| 2 |
-
|
| 3 |
slug: /python_api_reference
|
| 4 |
---
|
| 5 |
|
|
@@ -58,7 +58,7 @@ A brief description of the dataset to create. Defaults to `""`.
|
|
| 58 |
|
| 59 |
The language setting of the dataset to create. Available options:
|
| 60 |
|
| 61 |
-
- `"English"` (
|
| 62 |
- `"Chinese"`
|
| 63 |
|
| 64 |
#### permission
|
|
@@ -80,7 +80,7 @@ The chunking method of the dataset to create. Available options:
|
|
| 80 |
- `"picture"`: Picture
|
| 81 |
- `"one"`: One
|
| 82 |
- `"knowledge_graph"`: Knowledge Graph
|
| 83 |
-
Ensure your LLM is properly configured on the **Settings** page before selecting this. Please note that Knowledge Graph consumes a large number of Tokens!
|
| 84 |
- `"email"`: Email
|
| 85 |
|
| 86 |
#### parser_config
|
|
@@ -160,7 +160,7 @@ rag_object.delete_datasets(ids=["id_1","id_2"])
|
|
| 160 |
```python
|
| 161 |
RAGFlow.list_datasets(
|
| 162 |
page: int = 1,
|
| 163 |
-
page_size: int =
|
| 164 |
orderby: str = "create_time",
|
| 165 |
desc: bool = True,
|
| 166 |
id: str = None,
|
|
@@ -178,7 +178,7 @@ Specifies the page on which the datasets will be displayed. Defaults to `1`.
|
|
| 178 |
|
| 179 |
#### page_size: `int`
|
| 180 |
|
| 181 |
-
The number of datasets on each page. Defaults to `
|
| 182 |
|
| 183 |
#### orderby: `str`
|
| 184 |
|
|
@@ -250,8 +250,9 @@ A dictionary representing the attributes to update, with the following keys:
|
|
| 250 |
- `"presentation"`: Presentation
|
| 251 |
- `"picture"`: Picture
|
| 252 |
- `"one"`: One
|
|
|
|
| 253 |
- `"knowledge_graph"`: Knowledge Graph
|
| 254 |
-
Ensure your LLM is properly configured on the **Settings** page before selecting this. Please note that Knowledge Graph consumes a large number of Tokens!
|
| 255 |
|
| 256 |
### Returns
|
| 257 |
|
|
@@ -334,7 +335,7 @@ A dictionary representing the attributes to update, with the following keys:
|
|
| 334 |
- `"picture"`: Picture
|
| 335 |
- `"one"`: One
|
| 336 |
- `"knowledge_graph"`: Knowledge Graph
|
| 337 |
-
Ensure your LLM is properly configured on the **Settings** page before selecting this. Please note that Knowledge Graph consumes a large number of Tokens!
|
| 338 |
- `"email"`: Email
|
| 339 |
- `"parser_config"`: `dict[str, Any]` The parsing configuration for the document. Its attributes vary based on the selected `"chunk_method"`:
|
| 340 |
- `"chunk_method"`=`"naive"`:
|
|
@@ -413,7 +414,7 @@ print(doc)
|
|
| 413 |
## List documents
|
| 414 |
|
| 415 |
```python
|
| 416 |
-
Dataset.list_documents(id:str =None, keywords: str=None, page: int=1, page_size:int =
|
| 417 |
```
|
| 418 |
|
| 419 |
Lists documents in the current dataset.
|
|
@@ -434,7 +435,7 @@ Specifies the page on which the documents will be displayed. Defaults to `1`.
|
|
| 434 |
|
| 435 |
#### page_size: `int`
|
| 436 |
|
| 437 |
-
The maximum number of documents on each page. Defaults to `
|
| 438 |
|
| 439 |
#### orderby: `str`
|
| 440 |
|
|
@@ -689,7 +690,7 @@ chunk = doc.add_chunk(content="xxxxxxx")
|
|
| 689 |
## List chunks
|
| 690 |
|
| 691 |
```python
|
| 692 |
-
Document.list_chunks(keywords: str = None, page: int = 1, page_size: int =
|
| 693 |
```
|
| 694 |
|
| 695 |
Lists chunks in the current document.
|
|
@@ -706,7 +707,7 @@ Specifies the page on which the chunks will be displayed. Defaults to `1`.
|
|
| 706 |
|
| 707 |
#### page_size: `int`
|
| 708 |
|
| 709 |
-
The maximum number of chunks on each page. Defaults to `
|
| 710 |
|
| 711 |
#### id: `str`
|
| 712 |
|
|
@@ -811,7 +812,7 @@ chunk.update({"content":"sdfx..."})
|
|
| 811 |
## Retrieve chunks
|
| 812 |
|
| 813 |
```python
|
| 814 |
-
RAGFlow.retrieve(question:str="", dataset_ids:list[str]=None, document_ids=list[str]=None, page:int=1, page_size:int=
|
| 815 |
```
|
| 816 |
|
| 817 |
Retrieves chunks from specified datasets.
|
|
@@ -836,7 +837,7 @@ The starting index for the documents to retrieve. Defaults to `1`.
|
|
| 836 |
|
| 837 |
#### page_size: `int`
|
| 838 |
|
| 839 |
-
The maximum number of chunks to retrieve. Defaults to `
|
| 840 |
|
| 841 |
#### Similarity_threshold: `float`
|
| 842 |
|
|
@@ -1078,7 +1079,7 @@ rag_object.delete_chats(ids=["id_1","id_2"])
|
|
| 1078 |
```python
|
| 1079 |
RAGFlow.list_chats(
|
| 1080 |
page: int = 1,
|
| 1081 |
-
page_size: int =
|
| 1082 |
orderby: str = "create_time",
|
| 1083 |
desc: bool = True,
|
| 1084 |
id: str = None,
|
|
@@ -1096,7 +1097,7 @@ Specifies the page on which the chat assistants will be displayed. Defaults to `
|
|
| 1096 |
|
| 1097 |
#### page_size: `int`
|
| 1098 |
|
| 1099 |
-
The number of chat assistants on each page. Defaults to `
|
| 1100 |
|
| 1101 |
#### orderby: `str`
|
| 1102 |
|
|
@@ -1216,7 +1217,7 @@ session.update({"name": "updated_name"})
|
|
| 1216 |
```python
|
| 1217 |
Chat.list_sessions(
|
| 1218 |
page: int = 1,
|
| 1219 |
-
page_size: int =
|
| 1220 |
orderby: str = "create_time",
|
| 1221 |
desc: bool = True,
|
| 1222 |
id: str = None,
|
|
@@ -1234,7 +1235,7 @@ Specifies the page on which the sessions will be displayed. Defaults to `1`.
|
|
| 1234 |
|
| 1235 |
#### page_size: `int`
|
| 1236 |
|
| 1237 |
-
The number of sessions on each page. Defaults to `
|
| 1238 |
|
| 1239 |
#### orderby: `str`
|
| 1240 |
|
|
|
|
| 1 |
+
---
|
| 2 |
+
sidebar_position: 2
|
| 3 |
slug: /python_api_reference
|
| 4 |
---
|
| 5 |
|
|
|
|
| 58 |
|
| 59 |
The language setting of the dataset to create. Available options:
|
| 60 |
|
| 61 |
+
- `"English"` (default)
|
| 62 |
- `"Chinese"`
|
| 63 |
|
| 64 |
#### permission
|
|
|
|
| 80 |
- `"picture"`: Picture
|
| 81 |
- `"one"`: One
|
| 82 |
- `"knowledge_graph"`: Knowledge Graph
|
| 83 |
+
Ensure your LLM is properly configured on the **Settings** page before selecting this. Please also note that Knowledge Graph consumes a large number of Tokens!
|
| 84 |
- `"email"`: Email
|
| 85 |
|
| 86 |
#### parser_config
|
|
|
|
| 160 |
```python
|
| 161 |
RAGFlow.list_datasets(
|
| 162 |
page: int = 1,
|
| 163 |
+
page_size: int = 30,
|
| 164 |
orderby: str = "create_time",
|
| 165 |
desc: bool = True,
|
| 166 |
id: str = None,
|
|
|
|
| 178 |
|
| 179 |
#### page_size: `int`
|
| 180 |
|
| 181 |
+
The number of datasets on each page. Defaults to `30`.
|
| 182 |
|
| 183 |
#### orderby: `str`
|
| 184 |
|
|
|
|
| 250 |
- `"presentation"`: Presentation
|
| 251 |
- `"picture"`: Picture
|
| 252 |
- `"one"`: One
|
| 253 |
+
- `"email"`: Email
|
| 254 |
- `"knowledge_graph"`: Knowledge Graph
|
| 255 |
+
Ensure your LLM is properly configured on the **Settings** page before selecting this. Please also note that Knowledge Graph consumes a large number of Tokens!
|
| 256 |
|
| 257 |
### Returns
|
| 258 |
|
|
|
|
| 335 |
- `"picture"`: Picture
|
| 336 |
- `"one"`: One
|
| 337 |
- `"knowledge_graph"`: Knowledge Graph
|
| 338 |
+
Ensure your LLM is properly configured on the **Settings** page before selecting this. Please also note that Knowledge Graph consumes a large number of Tokens!
|
| 339 |
- `"email"`: Email
|
| 340 |
- `"parser_config"`: `dict[str, Any]` The parsing configuration for the document. Its attributes vary based on the selected `"chunk_method"`:
|
| 341 |
- `"chunk_method"`=`"naive"`:
|
|
|
|
| 414 |
## List documents
|
| 415 |
|
| 416 |
```python
|
| 417 |
+
Dataset.list_documents(id:str =None, keywords: str=None, page: int=1, page_size:int = 30, order_by:str = "create_time", desc: bool = True) -> list[Document]
|
| 418 |
```
|
| 419 |
|
| 420 |
Lists documents in the current dataset.
|
|
|
|
| 435 |
|
| 436 |
#### page_size: `int`
|
| 437 |
|
| 438 |
+
The maximum number of documents on each page. Defaults to `30`.
|
| 439 |
|
| 440 |
#### orderby: `str`
|
| 441 |
|
|
|
|
| 690 |
## List chunks
|
| 691 |
|
| 692 |
```python
|
| 693 |
+
Document.list_chunks(keywords: str = None, page: int = 1, page_size: int = 30, id : str = None) -> list[Chunk]
|
| 694 |
```
|
| 695 |
|
| 696 |
Lists chunks in the current document.
|
|
|
|
| 707 |
|
| 708 |
#### page_size: `int`
|
| 709 |
|
| 710 |
+
The maximum number of chunks on each page. Defaults to `30`.
|
| 711 |
|
| 712 |
#### id: `str`
|
| 713 |
|
|
|
|
| 812 |
## Retrieve chunks
|
| 813 |
|
| 814 |
```python
|
| 815 |
+
RAGFlow.retrieve(question:str="", dataset_ids:list[str]=None, document_ids=list[str]=None, page:int=1, page_size:int=30, similarity_threshold:float=0.2, vector_similarity_weight:float=0.3, top_k:int=1024,rerank_id:str=None,keyword:bool=False,higlight:bool=False) -> list[Chunk]
|
| 816 |
```
|
| 817 |
|
| 818 |
Retrieves chunks from specified datasets.
|
|
|
|
| 837 |
|
| 838 |
#### page_size: `int`
|
| 839 |
|
| 840 |
+
The maximum number of chunks to retrieve. Defaults to `30`.
|
| 841 |
|
| 842 |
#### Similarity_threshold: `float`
|
| 843 |
|
|
|
|
| 1079 |
```python
|
| 1080 |
RAGFlow.list_chats(
|
| 1081 |
page: int = 1,
|
| 1082 |
+
page_size: int = 30,
|
| 1083 |
orderby: str = "create_time",
|
| 1084 |
desc: bool = True,
|
| 1085 |
id: str = None,
|
|
|
|
| 1097 |
|
| 1098 |
#### page_size: `int`
|
| 1099 |
|
| 1100 |
+
The number of chat assistants on each page. Defaults to `30`.
|
| 1101 |
|
| 1102 |
#### orderby: `str`
|
| 1103 |
|
|
|
|
| 1217 |
```python
|
| 1218 |
Chat.list_sessions(
|
| 1219 |
page: int = 1,
|
| 1220 |
+
page_size: int = 30,
|
| 1221 |
orderby: str = "create_time",
|
| 1222 |
desc: bool = True,
|
| 1223 |
id: str = None,
|
|
|
|
| 1235 |
|
| 1236 |
#### page_size: `int`
|
| 1237 |
|
| 1238 |
+
The number of sessions on each page. Defaults to `30`.
|
| 1239 |
|
| 1240 |
#### orderby: `str`
|
| 1241 |
|
docs/references/supported_models.mdx
ADDED
|
@@ -0,0 +1,66 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
sidebar_position: 0
|
| 3 |
+
slug: /supported_models
|
| 4 |
+
---
|
| 5 |
+
|
| 6 |
+
# Supported models
|
| 7 |
+
import APITable from '../../src/components/APITable';
|
| 8 |
+
|
| 9 |
+
A complete list of models supported by RAGFlow, which will continue to expand.
|
| 10 |
+
|
| 11 |
+
```mdx-code-block
|
| 12 |
+
<APITable>
|
| 13 |
+
```
|
| 14 |
+
|
| 15 |
+
| Provider | Chat | Embedding | Rerank | Multi-modal | ASR/STT | TTS |
|
| 16 |
+
| --------------------- | ------------------ | ------------------ | ------------------ | ------------------ | ------------------ | ------------------ |
|
| 17 |
+
| Anthropic | :heavy_check_mark: | | | | | |
|
| 18 |
+
| Azure-OpenAI | :heavy_check_mark: | :heavy_check_mark: | | :heavy_check_mark: | :heavy_check_mark: | |
|
| 19 |
+
| BAAI | | :heavy_check_mark: | :heavy_check_mark: | | | |
|
| 20 |
+
| BaiChuan | :heavy_check_mark: | :heavy_check_mark: | | | | |
|
| 21 |
+
| BaiduYiyan | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | |
|
| 22 |
+
| Bedrock | :heavy_check_mark: | :heavy_check_mark: | | | | |
|
| 23 |
+
| cohere | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | |
|
| 24 |
+
| DeepSeek | :heavy_check_mark: | | | | | |
|
| 25 |
+
| FastEmbed | | :heavy_check_mark: | | | | |
|
| 26 |
+
| Fish Audio | | | | | | :heavy_check_mark: |
|
| 27 |
+
| Gemini | :heavy_check_mark: | :heavy_check_mark: | | :heavy_check_mark: | | |
|
| 28 |
+
| Google Cloud | :heavy_check_mark: | | | | | |
|
| 29 |
+
| Groq | :heavy_check_mark: | | | | | |
|
| 30 |
+
| HuggingFace | :heavy_check_mark: | :heavy_check_mark: | | | | |
|
| 31 |
+
| Jina | | :heavy_check_mark: | :heavy_check_mark: | | | |
|
| 32 |
+
| LeptonAI | :heavy_check_mark: | | | | | |
|
| 33 |
+
| LocalAI | :heavy_check_mark: | :heavy_check_mark: | | :heavy_check_mark: | | |
|
| 34 |
+
| LM-Studio | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | |
|
| 35 |
+
| MiniMax | :heavy_check_mark: | | | | | |
|
| 36 |
+
| Mistral | :heavy_check_mark: | :heavy_check_mark: | | | | |
|
| 37 |
+
| Moonshot | :heavy_check_mark: | | | :heavy_check_mark: | | |
|
| 38 |
+
| novita.ai | :heavy_check_mark: | | | | | |
|
| 39 |
+
| NVIDIA | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | |
|
| 40 |
+
| Ollama | :heavy_check_mark: | :heavy_check_mark: | | :heavy_check_mark: | | |
|
| 41 |
+
| OpenAI | :heavy_check_mark: | :heavy_check_mark: | | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
|
| 42 |
+
| OpenAI-API-Compatible | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | |
|
| 43 |
+
| OpenRouter | :heavy_check_mark: | | | :heavy_check_mark: | | |
|
| 44 |
+
| PerfXCloud | :heavy_check_mark: | :heavy_check_mark: | | | | |
|
| 45 |
+
| Replicate | :heavy_check_mark: | :heavy_check_mark: | | | | |
|
| 46 |
+
| SILICONFLOW | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | |
|
| 47 |
+
| StepFun | :heavy_check_mark: | | | | | |
|
| 48 |
+
| Tencent Hunyuan | :heavy_check_mark: | | | | | |
|
| 49 |
+
| Tencent Cloud | | | | | :heavy_check_mark: | |
|
| 50 |
+
| TogetherAI | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | |
|
| 51 |
+
| Tongyi-Qianwen | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
|
| 52 |
+
| Upstage | :heavy_check_mark: | :heavy_check_mark: | | | | |
|
| 53 |
+
| VolcEngine | :heavy_check_mark: | | | | | |
|
| 54 |
+
| Voyage AI | | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | |
|
| 55 |
+
| Xinference | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
|
| 56 |
+
| XunFei Spark | :heavy_check_mark: | | | | | :heavy_check_mark: |
|
| 57 |
+
| Youdao | | :heavy_check_mark: | :heavy_check_mark: | | | |
|
| 58 |
+
| ZHIPU-AI | :heavy_check_mark: | :heavy_check_mark: | | :heavy_check_mark: | | |
|
| 59 |
+
| 01.AI | :heavy_check_mark: | | | | | |
|
| 60 |
+
|
| 61 |
+
```mdx-code-block
|
| 62 |
+
</APITable>
|
| 63 |
+
```
|
| 64 |
+
|
| 65 |
+
|
| 66 |
+
|