AI/ragflow
1
0
Fork 0
mirror of https://git.mirrors.martin98.com/https://github.com/infiniflow/ragflow.git synced 2025-08-12 16:28:59 +08:00
Code Issues Packages Projects Releases Wiki Activity

Updated HTTP API reference and Python API reference based on test results (#3090)

Browse Source 
### What problem does this PR solve?



### Type of change


- [x] Documentation Update
This commit is contained in:
writinwaters 2024-10-29 19:56:46 +08:00 committed by GitHub
parent d868c283c4
commit f4cb939317
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 13 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
api/http_api_reference.md
View File

@ -94,8 +94,10 @@ curl --request POST \
The configuration settings for the dataset parser, a JSON object containing the following attributes: The configuration settings for the dataset parser, a JSON object containing the following attributes:
- `"chunk_token_count"`: Defaults to `128`. - `"chunk_token_count"`: Defaults to `128`.
- `"layout_recognize"`: Defaults to `true`. - `"layout_recognize"`: Defaults to `true`.
- `"html4excel"`: Indicates whether to convert Excel documents into HTML format. Defaults to `false`.
- `"delimiter"`: Defaults to `"\n!?。；！？"`. - `"delimiter"`: Defaults to `"\n!?。；！？"`.
- `"task_page_size"`: Defaults to `12`. - `"task_page_size"`: Defaults to `12`. For PDF only.
- `"raptor"`: Raptor-specific settings. Defaults to: `{"use_raptor": false}`.
### Response ### Response
@ -515,7 +517,7 @@ curl --request PUT \
- `"chunk_token_count"`: Defaults to `128`. - `"chunk_token_count"`: Defaults to `128`.
- `"layout_recognize"`: Defaults to `true`. - `"layout_recognize"`: Defaults to `true`.
- `"delimiter"`: Defaults to `"\n!?。；！？"`. - `"delimiter"`: Defaults to `"\n!?。；！？"`.
- `"task_page_size"`: Defaults to `12`. - `"task_page_size"`: Defaults to `12`. For PDF only.
### Response ### Response
@ -1169,7 +1171,7 @@ Failure:
## Retrieve chunks ## Retrieve chunks
**GET** `/api/v1/retrieval` **POST** `/api/v1/retrieval`
Retrieves chunks from specified datasets. Retrieves chunks from specified datasets.

7
api/python_api_reference.md
View File

@ -1253,7 +1253,7 @@ Asks a question to start an AI-powered conversation.
#### question: `str` *Required* #### question: `str` *Required*
The question to start an AI chat. The question to start an AI-powered conversation.
#### stream: `bool` #### stream: `bool`
@ -1286,7 +1286,7 @@ A list of `Chunk` objects representing references to the message, each containin
- `content` `str` - `content` `str`
The content of the chunk. The content of the chunk.
- `image_id` `str` - `image_id` `str`
The ID of the snapshot of the chunk. The ID of the snapshot of the chunk. Applicable only when the source of the chunk is an image, PPT, PPTX, or PDF file.
- `document_id` `str` - `document_id` `str`
The ID of the referenced document. The ID of the referenced document.
- `document_name` `str` - `document_name` `str`
@ -1296,13 +1296,12 @@ A list of `Chunk` objects representing references to the message, each containin
- `dataset_id` `str` - `dataset_id` `str`
The ID of the dataset to which the referenced document belongs. The ID of the dataset to which the referenced document belongs.
- `similarity` `float` - `similarity` `float`
A composite similarity score of the chunk ranging from `0` to `1`, with a higher value indicating greater similarity. A composite similarity score of the chunk ranging from `0` to `1`, with a higher value indicating greater similarity. It is the weighted sum of `vector_similarity` and `term_similarity`.
- `vector_similarity` `float` - `vector_similarity` `float`
A vector similarity score of the chunk ranging from `0` to `1`, with a higher value indicating greater similarity between vector embeddings. A vector similarity score of the chunk ranging from `0` to `1`, with a higher value indicating greater similarity between vector embeddings.
- `term_similarity` `float` - `term_similarity` `float`
A keyword similarity score of the chunk ranging from `0` to `1`, with a higher value indicating greater similarity between keywords. A keyword similarity score of the chunk ranging from `0` to `1`, with a higher value indicating greater similarity between keywords.
### Examples ### Examples
```python ```python