mirror of
https://github.com/infiniflow/ragflow.git
synced 2025-12-08 20:42:30 +08:00
Added an FAQ (#5092)
### What problem does this PR solve? ### Type of change - [x] Documentation Update
This commit is contained in:
@ -22,6 +22,35 @@ The "garbage in garbage out" status quo remains unchanged despite the fact that
|
||||
|
||||
---
|
||||
|
||||
### Where to find the version of RAGFlow? How to interprete it?
|
||||
|
||||
You can find the RAGFlow version number on the **System** page of the UI:
|
||||
|
||||

|
||||
|
||||
If you build RAGFlow from source, the version number is also in the system log:
|
||||
|
||||
```
|
||||
____ ___ ______ ______ __
|
||||
/ __ \ / | / ____// ____// /____ _ __
|
||||
/ /_/ // /| | / / __ / /_ / // __ \| | /| / /
|
||||
/ _, _// ___ |/ /_/ // __/ / // /_/ /| |/ |/ /
|
||||
/_/ |_|/_/ |_|\____//_/ /_/ \____/ |__/|__/
|
||||
|
||||
2025-02-18 10:10:43,835 INFO 1445658 RAGFlow version: v0.16.0-50-g6daae7f2 full
|
||||
```
|
||||
|
||||
Where:
|
||||
|
||||
- `v0.16.0`: The officially published release.
|
||||
- `50`: The number of git commits since the official release.
|
||||
- `g6daae7f2`: `g` is the prefix, and `6daae7f2` is the first seven characters of the current commit ID.
|
||||
- `full`/`slim`: The RAGFlow edition.
|
||||
- `full`: The full RAGFlow edition.
|
||||
- `slim`: The RAGFlow edition without embedding models and Python packages.
|
||||
|
||||
---
|
||||
|
||||
### Why does it take longer for RAGFlow to parse a document than LangChain?
|
||||
|
||||
We put painstaking effort into document pre-processing tasks like layout analysis, table structure recognition, and OCR (Optical Character Recognition) using our vision models. This contributes to the additional time required.
|
||||
|
||||
@ -2178,10 +2178,12 @@ Creates a session with an agent.
|
||||
- Body:
|
||||
- the required parameters:`str`
|
||||
- other parameters:
|
||||
The parameters in the begin component.
|
||||
The parameters set in the **Begin** component.
|
||||
|
||||
##### Request example
|
||||
If `begin` component in the agent doesn't have required parameters:
|
||||
|
||||
If the **Begin** component in your agent does not have required parameters:
|
||||
|
||||
```bash
|
||||
curl --request POST \
|
||||
--url http://{address}/api/v1/agents/{agent_id}/sessions \
|
||||
@ -2190,7 +2192,9 @@ curl --request POST \
|
||||
--data '{
|
||||
}'
|
||||
```
|
||||
If `begin` component in the agent has required parameters:
|
||||
|
||||
If the **Begin** component in your agent has required parameters:
|
||||
|
||||
```bash
|
||||
curl --request POST \
|
||||
--url http://{address}/api/v1/agents/{agent_id}/sessions \
|
||||
@ -2201,7 +2205,9 @@ curl --request POST \
|
||||
"file":"Who are you"
|
||||
}'
|
||||
```
|
||||
If `begin` component in the agent has required file parameters:
|
||||
|
||||
If the **Begin** component in your agent has required file parameters:
|
||||
|
||||
```bash
|
||||
curl --request POST \
|
||||
--url http://{address}/api/v1/agents/{agent_id}/sessions?user_id={user_id} \
|
||||
@ -2215,7 +2221,7 @@ curl --request POST \
|
||||
- `agent_id`: (*Path parameter*)
|
||||
The ID of the associated agent.
|
||||
- `user_id`: (*Filter parameter*), string
|
||||
The optional user-defined ID for parsing docs(especially images) when creating session while uploading files.
|
||||
The optional user-defined ID for parsing docs (especially images) when creating a session while uploading files.
|
||||
|
||||
#### Response
|
||||
|
||||
@ -2367,7 +2373,7 @@ Asks a specified agent a question to start an AI-powered conversation.
|
||||
- `"user_id"`: `string`(optional)
|
||||
- other parameters: `string`
|
||||
##### Request example
|
||||
If the `begin` component doesn't have parameters, the following code will create a session.
|
||||
Ifthe **Begin** component doesn't have parameters, the following code will create a session.
|
||||
```bash
|
||||
curl --request POST \
|
||||
--url http://{address}/api/v1/agents/{agent_id}/completions \
|
||||
@ -2377,7 +2383,7 @@ curl --request POST \
|
||||
{
|
||||
}'
|
||||
```
|
||||
If the `begin` component have parameters, the following code will create a session.
|
||||
Ifthe **Begin** component have parameters, the following code will create a session.
|
||||
```bash
|
||||
curl --request POST \
|
||||
--url http://{address}/api/v1/agents/{agent_id}/completions \
|
||||
@ -2403,7 +2409,6 @@ curl --request POST \
|
||||
}'
|
||||
```
|
||||
|
||||
|
||||
##### Request Parameters
|
||||
|
||||
- `agent_id`: (*Path parameter*), `string`
|
||||
@ -2419,9 +2424,10 @@ curl --request POST \
|
||||
- `"user_id"`: (*Body parameter*), `string`
|
||||
The optional user-defined ID. Valid *only* when no `session_id` is provided.
|
||||
- Other parameters: (*Body Parameter*)
|
||||
The parameters in the begin component.
|
||||
Parameters specified in the **Begin** component.
|
||||
|
||||
#### Response
|
||||
success without `session_id` provided and with no parameters in the `begin` component:
|
||||
success without `session_id` provided and with no parameters inthe **Begin** component:
|
||||
```json
|
||||
data:{
|
||||
"code": 0,
|
||||
@ -2439,7 +2445,7 @@ data:{
|
||||
"data": true
|
||||
}
|
||||
```
|
||||
Success without `session_id` provided and with parameters in the `begin` component:
|
||||
Success without `session_id` provided and with parameters inthe **Begin** component:
|
||||
|
||||
```json
|
||||
data:{
|
||||
@ -2475,7 +2481,7 @@ data:{
|
||||
}
|
||||
data:
|
||||
```
|
||||
Success with parameters in the `begin` component:
|
||||
Success with parameters inthe **Begin** component:
|
||||
```json
|
||||
data:{
|
||||
"code": 0,
|
||||
|
||||
@ -1461,7 +1461,7 @@ In streaming mode, not all responses include a reference, as this depends on the
|
||||
|
||||
##### question: `str`
|
||||
|
||||
The question to start an AI-powered conversation. If the `begin` component takes parameters, a question is not required.
|
||||
The question to start an AI-powered conversation. Ifthe **Begin** component takes parameters, a question is not required.
|
||||
|
||||
##### stream: `bool`
|
||||
|
||||
|
||||
Reference in New Issue
Block a user