diff --git a/docs/references/http_api_reference.md b/docs/references/http_api_reference.md index 9408972f6b..077f42fc6e 100644 --- a/docs/references/http_api_reference.md +++ b/docs/references/http_api_reference.md @@ -31,26 +31,26 @@ A complete reference for RAGFlow's RESTful API. Before proceeding, please ensure The following v0.24.0 REST API paths are deprecated. They remain available through the backward compatibility layer, but new integrations should use the replacement endpoints. -| Deprecated endpoint | Replacement endpoint | -|---------------------|----------------------| -| **POST** `/api/v1/chats_openai/{chat_id}/chat/completions` | **POST** `/api/v1/openai/{chat_id}/chat/completions` | -| **PUT** `/api/v1/chats/{chat_id}/sessions/{session_id}` | **PATCH** `/api/v1/chats/{chat_id}/sessions/{session_id}` | -| **POST** `/api/v1/chats/{chat_id}/completions` | **POST** `/api/v1/chat/completions` | -| **POST** `/api/v1/sessions/related_questions` | **POST** `/api/v1/chat/recommandation` | +| Deprecated endpoint | Replacement endpoint | +|-----------------------------------------------------------------------------------|-------------------------------------------------------------------------------------| +| **POST** `/api/v1/chats_openai/{chat_id}/chat/completions` | **POST** `/api/v1/openai/{chat_id}/chat/completions` | +| **PUT** `/api/v1/chats/{chat_id}/sessions/{session_id}` | **PATCH** `/api/v1/chats/{chat_id}/sessions/{session_id}` | +| **POST** `/api/v1/chats/{chat_id}/completions` | **POST** `/api/v1/chat/completions` | +| **POST** `/api/v1/sessions/related_questions` | **POST** `/api/v1/chat/recommandation` | | **PUT** `/api/v1/datasets/{dataset_id}/documents/{document_id}/chunks/{chunk_id}` | **PATCH** `/api/v1/datasets/{dataset_id}/documents/{document_id}/chunks/{chunk_id}` | -| **GET** `/v1/system/healthz` | **GET** `/api/v1/system/healthz` | -| **POST** `/v1/document/upload_info` | **POST** `/api/v1/documents/upload` | -| **POST** `/api/v1/file/upload` | **POST** `/api/v1/files` | -| **POST** `/api/v1/file/create` | **POST** `/api/v1/files` | -| **GET** `/api/v1/file/list` | **GET** `/api/v1/files` | -| **GET** `/api/v1/file/root_folder` | **GET** `/api/v1/files` | -| **GET** `/api/v1/file/parent_folder` | **GET** `/api/v1/files/{file_id}/parent` | -| **GET** `/api/v1/file/all_parent_folder` | **GET** `/api/v1/files/{file_id}/ancestors` | -| **POST** `/api/v1/file/rm` | **DELETE** `/api/v1/files` | -| **POST** `/api/v1/file/rename` | **POST** `/api/v1/files/move` | -| **GET** `/api/v1/file/get/{file_id}` | **GET** `/api/v1/files/{file_id}` | -| **POST** `/api/v1/file/mv` | **POST** `/api/v1/files/move` | -| **POST** `/api/v1/file/convert` | **POST** `/api/v1/files/link-to-datasets` | +| **GET** `/v1/system/healthz` | **GET** `/api/v1/system/healthz` | +| **POST** `/v1/document/upload_info` | **POST** `/api/v1/documents/upload` | +| **POST** `/api/v1/file/upload` | **POST** `/api/v1/files` | +| **POST** `/api/v1/file/create` | **POST** `/api/v1/files` | +| **GET** `/api/v1/file/list` | **GET** `/api/v1/files` | +| **GET** `/api/v1/file/root_folder` | **GET** `/api/v1/files` | +| **GET** `/api/v1/file/parent_folder` | **GET** `/api/v1/files/{file_id}/parent` | +| **GET** `/api/v1/file/all_parent_folder` | **GET** `/api/v1/files/{file_id}/ancestors` | +| **POST** `/api/v1/file/rm` | **DELETE** `/api/v1/files` | +| **POST** `/api/v1/file/rename` | **POST** `/api/v1/files/move` | +| **GET** `/api/v1/file/get/{file_id}` | **GET** `/api/v1/files/{file_id}` | +| **POST** `/api/v1/file/mv` | **POST** `/api/v1/files/move` | +| **POST** `/api/v1/file/convert` | **POST** `/api/v1/files/link-to-datasets` | --- @@ -934,7 +934,7 @@ curl --request GET \ Whether to include document parsing status counts in the response. Defaults to `false`. When set to `true`, each dataset object in the response will include the following additional fields: - `unstart_count`: Number of documents not yet started parsing. - `running_count`: Number of documents currently being parsed. - - `cancel_count`: Number of documents whose parsing was cancelled. + - `cancel_count`: Number of documents whose parsing was canceled. - `done_count`: Number of documents that have been successfully parsed. - `fail_count`: Number of documents whose parsing failed. @@ -1791,7 +1791,7 @@ curl --request GET \ - Status mapping: - `0` / `UNSTART`: Document not yet processed - `1` / `RUNNING`: Document is currently being processed - - `2` / `CANCEL`: Document processing was cancelled + - `2` / `CANCEL`: Document processing was canceled - `3` / `DONE`: Document processing completed successfully - `4` / `FAIL`: Document processing failed Defaults to all statuses. @@ -4130,7 +4130,7 @@ Starts a chat completion request. The same endpoint supports three modes: :::tip NOTE -- In streaming mode, not all responses include a reference, as this depends on the system's judgement. +- In streaming mode, not all responses include a reference, as this depends on the system's judgment. - In streaming mode, the last message is an empty message: ```json @@ -6686,7 +6686,7 @@ Failure **GET** `/api/v1/messages?memory_id={memory_id}&agent_id={agent_id}&session_id={session_id}&limit={limit}` -Retrieves the most recent messages from specified memories. Typically accepts a `limit` parameter to control the number of messages returned. +Retrieves the most recent messages from specified memories. Typically, accepts a `limit` parameter to control the number of messages returned. #### Request diff --git a/docs/references/python_api_reference.md b/docs/references/python_api_reference.md index 87031398cb..6ae8c971a8 100644 --- a/docs/references/python_api_reference.md +++ b/docs/references/python_api_reference.md @@ -309,7 +309,7 @@ Whether to include document parsing status counts in each returned `DataSet` obj - `unstart_count`: `int` Number of documents not yet started parsing. - `running_count`: `int` Number of documents currently being parsed. -- `cancel_count`: `int` Number of documents whose parsing was cancelled. +- `cancel_count`: `int` Number of documents whose parsing was canceled. - `done_count`: `int` Number of documents that have been successfully parsed. - `fail_count`: `int` Number of documents whose parsing failed. @@ -758,7 +758,7 @@ DataSet.parse_documents(document_ids: list[str]) -> list[tuple[str, str, int, in *Asynchronously* parses documents in the current dataset. -This method encapsulates `async_parse_documents()`. It awaits the completion of all parsing tasks before returning detailed results, including the parsing status and statistics for each document. If a keyboard interruption occurs (e.g., `Ctrl+C`), all pending parsing tasks will be cancelled gracefully. +This method encapsulates `async_parse_documents()`. It awaits the completion of all parsing tasks before returning detailed results, including the parsing status and statistics for each document. If a keyboard interruption occurs (e.g., `Ctrl+C`), all pending parsing tasks will be canceled gracefully. #### Parameters @@ -1177,7 +1177,7 @@ Base64 encoding of the avatar. Defaults to `""`. ##### dataset_ids: `list[str]` -The IDs of the associated datasets. Defaults to `[]`. When omitted or empty, the SDK creates an empty chat assistant and you can attach datasets later. +The IDs of the associated datasets. Defaults to `[]`. When omitted or empty, the SDK creates an empty chat assistant, and you can attach datasets later. ##### llm_id: `str | None` @@ -1586,7 +1586,7 @@ Session.ask(question: str = "", stream: bool = False, **kwargs) -> Optional[Mess Asks a specified chat assistant a question to start an AI-powered conversation. :::tip NOTE -In streaming mode, not all responses include a reference, as this depends on the system's judgement. +In streaming mode, not all responses include a reference, as this depends on the system's judgment. ::: #### Parameters @@ -1723,7 +1723,7 @@ Session.ask(question: str = "", stream: bool = False, **kwargs) -> Optional[Mess Asks a specified agent through the unified completion endpoint. :::tip NOTE -In streaming mode, not all responses include a reference, as this depends on the system's judgement. +In streaming mode, not all responses include a reference, as this depends on the system's judgment. ::: #### Parameters @@ -2726,7 +2726,7 @@ Ragflow.get_recent_messages( ) -> list[dict] ``` -Retrieves the most recent messages from specified memories. Typically accepts a `limit` parameter to control the number of messages returned. +Retrieves the most recent messages from specified memories. Typically, accepts a `limit` parameter to control the number of messages returned. #### Parameters