From 3c85136279aff0c8fa18c4cd97a24b67c020b345 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Fri, 1 Nov 2024 17:17:27 +0800 Subject: [PATCH 01/73] refactor(tools): Avoid warnings. (#10161) --- api/core/tools/provider/builtin/chart/chart.py | 9 +++++---- .../podcast_generator/tools/podcast_audio_generator.py | 5 ++++- 2 files changed, 9 insertions(+), 5 deletions(-) diff --git a/api/core/tools/provider/builtin/chart/chart.py b/api/core/tools/provider/builtin/chart/chart.py index 209d6ecba4..dfa3fbea6a 100644 --- a/api/core/tools/provider/builtin/chart/chart.py +++ b/api/core/tools/provider/builtin/chart/chart.py @@ -1,5 +1,5 @@ import matplotlib.pyplot as plt -from matplotlib.font_manager import FontProperties +from matplotlib.font_manager import FontProperties, fontManager from core.tools.provider.builtin_tool_provider import BuiltinToolProviderController @@ -17,9 +17,10 @@ def set_chinese_font(): ] for font in font_list: - chinese_font = FontProperties(font) - if chinese_font.get_name() == font: - return chinese_font + if font in fontManager.ttflist: + chinese_font = FontProperties(font) + if chinese_font.get_name() == font: + return chinese_font return FontProperties() diff --git a/api/core/tools/provider/builtin/podcast_generator/tools/podcast_audio_generator.py b/api/core/tools/provider/builtin/podcast_generator/tools/podcast_audio_generator.py index 8c8dd9bf68..2300b69e49 100644 --- a/api/core/tools/provider/builtin/podcast_generator/tools/podcast_audio_generator.py +++ b/api/core/tools/provider/builtin/podcast_generator/tools/podcast_audio_generator.py @@ -2,14 +2,17 @@ import concurrent.futures import io import random from typing import Any, Literal, Optional, Union +from warnings import catch_warnings import openai -from pydub import AudioSegment from core.tools.entities.tool_entities import ToolInvokeMessage from core.tools.errors import ToolParameterValidationError, ToolProviderCredentialValidationError from core.tools.tool.builtin_tool import BuiltinTool +with catch_warnings(action="ignore", category=RuntimeWarning): + from pydub import AudioSegment + class PodcastAudioGeneratorTool(BuiltinTool): @staticmethod From 76b0328eb1f292fdeca697afefb9cb6892f22711 Mon Sep 17 00:00:00 2001 From: Lawrence Li Date: Fri, 1 Nov 2024 17:23:30 +0800 Subject: [PATCH 02/73] feat: add gpustack model provider (#10158) --- .../gpustack/_assets/icon_l_en.png | Bin 0 -> 283620 bytes .../gpustack/_assets/icon_l_en.svg | 15 ++ .../gpustack/_assets/icon_s_en.png | Bin 0 -> 57988 bytes .../gpustack/_assets/icon_s_en.svg | 11 ++ .../model_providers/gpustack/gpustack.py | 10 ++ .../model_providers/gpustack/gpustack.yaml | 120 +++++++++++++ .../model_providers/gpustack/llm/__init__.py | 0 .../model_providers/gpustack/llm/llm.py | 45 +++++ .../gpustack/rerank/__init__.py | 0 .../model_providers/gpustack/rerank/rerank.py | 146 ++++++++++++++++ .../gpustack/text_embedding/__init__.py | 0 .../gpustack/text_embedding/text_embedding.py | 35 ++++ api/tests/integration_tests/.env.example | 6 +- .../model_runtime/gpustack/__init__.py | 0 .../model_runtime/gpustack/test_embedding.py | 49 ++++++ .../model_runtime/gpustack/test_llm.py | 162 ++++++++++++++++++ .../model_runtime/gpustack/test_rerank.py | 107 ++++++++++++ 17 files changed, 705 insertions(+), 1 deletion(-) create mode 100644 api/core/model_runtime/model_providers/gpustack/_assets/icon_l_en.png create mode 100644 api/core/model_runtime/model_providers/gpustack/_assets/icon_l_en.svg create mode 100644 api/core/model_runtime/model_providers/gpustack/_assets/icon_s_en.png create mode 100644 api/core/model_runtime/model_providers/gpustack/_assets/icon_s_en.svg create mode 100644 api/core/model_runtime/model_providers/gpustack/gpustack.py create mode 100644 api/core/model_runtime/model_providers/gpustack/gpustack.yaml create mode 100644 api/core/model_runtime/model_providers/gpustack/llm/__init__.py create mode 100644 api/core/model_runtime/model_providers/gpustack/llm/llm.py create mode 100644 api/core/model_runtime/model_providers/gpustack/rerank/__init__.py create mode 100644 api/core/model_runtime/model_providers/gpustack/rerank/rerank.py create mode 100644 api/core/model_runtime/model_providers/gpustack/text_embedding/__init__.py create mode 100644 api/core/model_runtime/model_providers/gpustack/text_embedding/text_embedding.py create mode 100644 api/tests/integration_tests/model_runtime/gpustack/__init__.py create mode 100644 api/tests/integration_tests/model_runtime/gpustack/test_embedding.py create mode 100644 api/tests/integration_tests/model_runtime/gpustack/test_llm.py create mode 100644 api/tests/integration_tests/model_runtime/gpustack/test_rerank.py diff --git a/api/core/model_runtime/model_providers/gpustack/_assets/icon_l_en.png b/api/core/model_runtime/model_providers/gpustack/_assets/icon_l_en.png new file mode 100644 index 0000000000000000000000000000000000000000..dfe8e78049c4dec13e8516565780f2ec9e239f91 GIT binary patch literal 283620 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

<3pdY}>J6xUIJV2DT)eP6Scl1PG_} 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 z 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 + + + + + + + + + + + + + + diff --git a/api/core/model_runtime/model_providers/gpustack/_assets/icon_s_en.png b/api/core/model_runtime/model_providers/gpustack/_assets/icon_s_en.png new file mode 100644 index 0000000000000000000000000000000000000000..b154821db91ab02007d7c48700dea34d57871ec6 GIT binary patch literal 57988 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

edBnRuu(@m|j_~Qk1q_=Uy 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 WV5hA3PnA6Y0000 + + + + + + + + + + diff --git a/api/core/model_runtime/model_providers/gpustack/gpustack.py b/api/core/model_runtime/model_providers/gpustack/gpustack.py new file mode 100644 index 0000000000..321100167e --- /dev/null +++ b/api/core/model_runtime/model_providers/gpustack/gpustack.py @@ -0,0 +1,10 @@ +import logging + +from core.model_runtime.model_providers.__base.model_provider import ModelProvider + +logger = logging.getLogger(__name__) + + +class GPUStackProvider(ModelProvider): + def validate_provider_credentials(self, credentials: dict) -> None: + pass diff --git a/api/core/model_runtime/model_providers/gpustack/gpustack.yaml b/api/core/model_runtime/model_providers/gpustack/gpustack.yaml new file mode 100644 index 0000000000..ee4a3c159a --- /dev/null +++ b/api/core/model_runtime/model_providers/gpustack/gpustack.yaml @@ -0,0 +1,120 @@ +provider: gpustack +label: + en_US: GPUStack +icon_small: + en_US: icon_s_en.png +icon_large: + en_US: icon_l_en.png +supported_model_types: + - llm + - text-embedding + - rerank +configurate_methods: + - customizable-model +model_credential_schema: + model: + label: + en_US: Model Name + zh_Hans: 模型名称 + placeholder: + en_US: Enter your model name + zh_Hans: 输入模型名称 + credential_form_schemas: + - variable: endpoint_url + label: + zh_Hans: 服务器地址 + en_US: Server URL + type: text-input + required: true + placeholder: + zh_Hans: 输入 GPUStack 的服务器地址，如 http://192.168.1.100 + en_US: Enter the GPUStack server URL, e.g. http://192.168.1.100 + - variable: api_key + label: + en_US: API Key + type: secret-input + required: true + placeholder: + zh_Hans: 输入您的 API Key + en_US: Enter your API Key + - variable: mode + show_on: + - variable: __model_type + value: llm + label: + en_US: Completion mode + type: select + required: false + default: chat + placeholder: + zh_Hans: 选择补全类型 + en_US: Select completion type + options: + - value: completion + label: + en_US: Completion + zh_Hans: 补全 + - value: chat + label: + en_US: Chat + zh_Hans: 对话 + - variable: context_size + label: + zh_Hans: 模型上下文长度 + en_US: Model context size + required: true + type: text-input + default: "8192" + placeholder: + zh_Hans: 输入您的模型上下文长度 + en_US: Enter your Model context size + - variable: max_tokens_to_sample + label: + zh_Hans: 最大 token 上限 + en_US: Upper bound for max tokens + show_on: + - variable: __model_type + value: llm + default: "8192" + type: text-input + - variable: function_calling_type + show_on: + - variable: __model_type + value: llm + label: + en_US: Function calling + type: select + required: false + default: no_call + options: + - value: function_call + label: + en_US: Function Call + zh_Hans: Function Call + - value: tool_call + label: + en_US: Tool Call + zh_Hans: Tool Call + - value: no_call + label: + en_US: Not Support + zh_Hans: 不支持 + - variable: vision_support + show_on: + - variable: __model_type + value: llm + label: + zh_Hans: Vision 支持 + en_US: Vision Support + type: select + required: false + default: no_support + options: + - value: support + label: + en_US: Support + zh_Hans: 支持 + - value: no_support + label: + en_US: Not Support + zh_Hans: 不支持 diff --git a/api/core/model_runtime/model_providers/gpustack/llm/__init__.py b/api/core/model_runtime/model_providers/gpustack/llm/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/api/core/model_runtime/model_providers/gpustack/llm/llm.py b/api/core/model_runtime/model_providers/gpustack/llm/llm.py new file mode 100644 index 0000000000..ce6780b6a7 --- /dev/null +++ b/api/core/model_runtime/model_providers/gpustack/llm/llm.py @@ -0,0 +1,45 @@ +from collections.abc import Generator + +from yarl import URL + +from core.model_runtime.entities.llm_entities import LLMResult +from core.model_runtime.entities.message_entities import ( + PromptMessage, + PromptMessageTool, +) +from core.model_runtime.model_providers.openai_api_compatible.llm.llm import ( + OAIAPICompatLargeLanguageModel, +) + + +class GPUStackLanguageModel(OAIAPICompatLargeLanguageModel): + def _invoke( + self, + model: str, + credentials: dict, + prompt_messages: list[PromptMessage], + model_parameters: dict, + tools: list[PromptMessageTool] | None = None, + stop: list[str] | None = None, + stream: bool = True, + user: str | None = None, + ) -> LLMResult | Generator: + return super()._invoke( + model, + credentials, + prompt_messages, + model_parameters, + tools, + stop, + stream, + user, + ) + + def validate_credentials(self, model: str, credentials: dict) -> None: + self._add_custom_parameters(credentials) + super().validate_credentials(model, credentials) + + @staticmethod + def _add_custom_parameters(credentials: dict) -> None: + credentials["endpoint_url"] = str(URL(credentials["endpoint_url"]) / "v1-openai") + credentials["mode"] = "chat" diff --git a/api/core/model_runtime/model_providers/gpustack/rerank/__init__.py b/api/core/model_runtime/model_providers/gpustack/rerank/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/api/core/model_runtime/model_providers/gpustack/rerank/rerank.py b/api/core/model_runtime/model_providers/gpustack/rerank/rerank.py new file mode 100644 index 0000000000..5ea7532564 --- /dev/null +++ b/api/core/model_runtime/model_providers/gpustack/rerank/rerank.py @@ -0,0 +1,146 @@ +from json import dumps +from typing import Optional + +import httpx +from requests import post +from yarl import URL + +from core.model_runtime.entities.common_entities import I18nObject +from core.model_runtime.entities.model_entities import ( + AIModelEntity, + FetchFrom, + ModelPropertyKey, + ModelType, +) +from core.model_runtime.entities.rerank_entities import RerankDocument, RerankResult +from core.model_runtime.errors.invoke import ( + InvokeAuthorizationError, + InvokeBadRequestError, + InvokeConnectionError, + InvokeError, + InvokeRateLimitError, + InvokeServerUnavailableError, +) +from core.model_runtime.errors.validate import CredentialsValidateFailedError +from core.model_runtime.model_providers.__base.rerank_model import RerankModel + + +class GPUStackRerankModel(RerankModel): + """ + Model class for GPUStack rerank model. + """ + + def _invoke( + self, + model: str, + credentials: dict, + query: str, + docs: list[str], + score_threshold: Optional[float] = None, + top_n: Optional[int] = None, + user: Optional[str] = None, + ) -> RerankResult: + """ + Invoke rerank model + + :param model: model name + :param credentials: model credentials + :param query: search query + :param docs: docs for reranking + :param score_threshold: score threshold + :param top_n: top n documents to return + :param user: unique user id + :return: rerank result + """ + if len(docs) == 0: + return RerankResult(model=model, docs=[]) + + endpoint_url = credentials["endpoint_url"] + headers = { + "Authorization": f"Bearer {credentials.get('api_key')}", + "Content-Type": "application/json", + } + + data = {"model": model, "query": query, "documents": docs, "top_n": top_n} + + try: + response = post( + str(URL(endpoint_url) / "v1" / "rerank"), + headers=headers, + data=dumps(data), + timeout=10, + ) + response.raise_for_status() + results = response.json() + + rerank_documents = [] + for result in results["results"]: + index = result["index"] + if "document" in result: + text = result["document"]["text"] + else: + text = docs[index] + + rerank_document = RerankDocument( + index=index, + text=text, + score=result["relevance_score"], + ) + + if score_threshold is None or result["relevance_score"] >= score_threshold: + rerank_documents.append(rerank_document) + + return RerankResult(model=model, docs=rerank_documents) + except httpx.HTTPStatusError as e: + raise InvokeServerUnavailableError(str(e)) + + def validate_credentials(self, model: str, credentials: dict) -> None: + """ + Validate model credentials + + :param model: model name + :param credentials: model credentials + :return: + """ + try: + self._invoke( + model=model, + credentials=credentials, + query="What is the capital of the United States?", + docs=[ + "Carson City is the capital city of the American state of Nevada. At the 2010 United States " + "Census, Carson City had a population of 55,274.", + "The Commonwealth of the Northern Mariana Islands is a group of islands in the Pacific Ocean that " + "are a political division controlled by the United States. Its capital is Saipan.", + ], + score_threshold=0.8, + ) + except Exception as ex: + raise CredentialsValidateFailedError(str(ex)) + + @property + def _invoke_error_mapping(self) -> dict[type[InvokeError], list[type[Exception]]]: + """ + Map model invoke error to unified error + """ + return { + InvokeConnectionError: [httpx.ConnectError], + InvokeServerUnavailableError: [httpx.RemoteProtocolError], + InvokeRateLimitError: [], + InvokeAuthorizationError: [httpx.HTTPStatusError], + InvokeBadRequestError: [httpx.RequestError], + } + + def get_customizable_model_schema(self, model: str, credentials: dict) -> AIModelEntity: + """ + generate custom model entities from credentials + """ + entity = AIModelEntity( + model=model, + label=I18nObject(en_US=model), + model_type=ModelType.RERANK, + fetch_from=FetchFrom.CUSTOMIZABLE_MODEL, + model_properties={ModelPropertyKey.CONTEXT_SIZE: int(credentials.get("context_size"))}, + ) + + return entity diff --git a/api/core/model_runtime/model_providers/gpustack/text_embedding/__init__.py b/api/core/model_runtime/model_providers/gpustack/text_embedding/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/api/core/model_runtime/model_providers/gpustack/text_embedding/text_embedding.py b/api/core/model_runtime/model_providers/gpustack/text_embedding/text_embedding.py new file mode 100644 index 0000000000..eb324491a2 --- /dev/null +++ b/api/core/model_runtime/model_providers/gpustack/text_embedding/text_embedding.py @@ -0,0 +1,35 @@ +from typing import Optional + +from yarl import URL + +from core.entities.embedding_type import EmbeddingInputType +from core.model_runtime.entities.text_embedding_entities import ( + TextEmbeddingResult, +) +from core.model_runtime.model_providers.openai_api_compatible.text_embedding.text_embedding import ( + OAICompatEmbeddingModel, +) + + +class GPUStackTextEmbeddingModel(OAICompatEmbeddingModel): + """ + Model class for GPUStack text embedding model. + """ + + def _invoke( + self, + model: str, + credentials: dict, + texts: list[str], + user: Optional[str] = None, + input_type: EmbeddingInputType = EmbeddingInputType.DOCUMENT, + ) -> TextEmbeddingResult: + return super()._invoke(model, credentials, texts, user, input_type) + + def validate_credentials(self, model: str, credentials: dict) -> None: + self._add_custom_parameters(credentials) + super().validate_credentials(model, credentials) + + @staticmethod + def _add_custom_parameters(credentials: dict) -> None: + credentials["endpoint_url"] = str(URL(credentials["endpoint_url"]) / "v1-openai") diff --git a/api/tests/integration_tests/.env.example b/api/tests/integration_tests/.env.example index f95d5c2ca1..99728a8271 100644 --- a/api/tests/integration_tests/.env.example +++ b/api/tests/integration_tests/.env.example @@ -89,5 +89,9 @@ VESSL_AI_MODEL_NAME= VESSL_AI_API_KEY= VESSL_AI_ENDPOINT_URL= +# GPUStack Credentials +GPUSTACK_SERVER_URL= +GPUSTACK_API_KEY= + # Gitee AI Credentials -GITEE_AI_API_KEY= \ No newline at end of file +GITEE_AI_API_KEY= diff --git a/api/tests/integration_tests/model_runtime/gpustack/__init__.py b/api/tests/integration_tests/model_runtime/gpustack/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/api/tests/integration_tests/model_runtime/gpustack/test_embedding.py b/api/tests/integration_tests/model_runtime/gpustack/test_embedding.py new file mode 100644 index 0000000000..f56ad0dadc --- /dev/null +++ b/api/tests/integration_tests/model_runtime/gpustack/test_embedding.py @@ -0,0 +1,49 @@ +import os + +import pytest + +from core.model_runtime.entities.text_embedding_entities import TextEmbeddingResult +from core.model_runtime.errors.validate import CredentialsValidateFailedError +from core.model_runtime.model_providers.gpustack.text_embedding.text_embedding import ( + GPUStackTextEmbeddingModel, +) + + +def test_validate_credentials(): + model = GPUStackTextEmbeddingModel() + + with pytest.raises(CredentialsValidateFailedError): + model.validate_credentials( + model="bge-m3", + credentials={ + "endpoint_url": "invalid_url", + "api_key": "invalid_api_key", + }, + ) + + model.validate_credentials( + model="bge-m3", + credentials={ + "endpoint_url": os.environ.get("GPUSTACK_SERVER_URL"), + "api_key": os.environ.get("GPUSTACK_API_KEY"), + }, + ) + + +def test_invoke_model(): + model = GPUStackTextEmbeddingModel() + + result = model.invoke( + model="bge-m3", + credentials={ + "endpoint_url": os.environ.get("GPUSTACK_SERVER_URL"), + "api_key": os.environ.get("GPUSTACK_API_KEY"), + "context_size": 8192, + }, + texts=["hello", "world"], + user="abc-123", + ) + + assert isinstance(result, TextEmbeddingResult) + assert len(result.embeddings) == 2 + assert result.usage.total_tokens == 7 diff --git a/api/tests/integration_tests/model_runtime/gpustack/test_llm.py b/api/tests/integration_tests/model_runtime/gpustack/test_llm.py new file mode 100644 index 0000000000..326b7b16f0 --- /dev/null +++ b/api/tests/integration_tests/model_runtime/gpustack/test_llm.py @@ -0,0 +1,162 @@ +import os +from collections.abc import Generator + +import pytest + +from core.model_runtime.entities.llm_entities import ( + LLMResult, + LLMResultChunk, + LLMResultChunkDelta, +) +from core.model_runtime.entities.message_entities import ( + AssistantPromptMessage, + PromptMessageTool, + SystemPromptMessage, + UserPromptMessage, +) +from core.model_runtime.errors.validate import CredentialsValidateFailedError +from core.model_runtime.model_providers.gpustack.llm.llm import GPUStackLanguageModel + + +def test_validate_credentials_for_chat_model(): + model = GPUStackLanguageModel() + + with pytest.raises(CredentialsValidateFailedError): + model.validate_credentials( + model="llama-3.2-1b-instruct", + credentials={ + "endpoint_url": "invalid_url", + "api_key": "invalid_api_key", + "mode": "chat", + }, + ) + + model.validate_credentials( + model="llama-3.2-1b-instruct", + credentials={ + "endpoint_url": os.environ.get("GPUSTACK_SERVER_URL"), + "api_key": os.environ.get("GPUSTACK_API_KEY"), + "mode": "chat", + }, + ) + + +def test_invoke_completion_model(): + model = GPUStackLanguageModel() + + response = model.invoke( + model="llama-3.2-1b-instruct", + credentials={ + "endpoint_url": os.environ.get("GPUSTACK_SERVER_URL"), + "api_key": os.environ.get("GPUSTACK_API_KEY"), + "mode": "completion", + }, + prompt_messages=[UserPromptMessage(content="ping")], + model_parameters={"temperature": 0.7, "top_p": 1.0, "max_tokens": 10}, + stop=[], + user="abc-123", + stream=False, + ) + + assert isinstance(response, LLMResult) + assert len(response.message.content) > 0 + assert response.usage.total_tokens > 0 + + +def test_invoke_chat_model(): + model = GPUStackLanguageModel() + + response = model.invoke( + model="llama-3.2-1b-instruct", + credentials={ + "endpoint_url": os.environ.get("GPUSTACK_SERVER_URL"), + "api_key": os.environ.get("GPUSTACK_API_KEY"), + "mode": "chat", + }, + prompt_messages=[UserPromptMessage(content="ping")], + model_parameters={"temperature": 0.7, "top_p": 1.0, "max_tokens": 10}, + stop=[], + user="abc-123", + stream=False, + ) + + assert isinstance(response, LLMResult) + assert len(response.message.content) > 0 + assert response.usage.total_tokens > 0 + + +def test_invoke_stream_chat_model(): + model = GPUStackLanguageModel() + + response = model.invoke( + model="llama-3.2-1b-instruct", + credentials={ + "endpoint_url": os.environ.get("GPUSTACK_SERVER_URL"), + "api_key": os.environ.get("GPUSTACK_API_KEY"), + "mode": "chat", + }, + prompt_messages=[UserPromptMessage(content="Hello World!")], + model_parameters={"temperature": 0.7, "top_p": 1.0, "max_tokens": 10}, + stop=["you"], + stream=True, + user="abc-123", + ) + + assert isinstance(response, Generator) + for chunk in response: + assert isinstance(chunk, LLMResultChunk) + assert isinstance(chunk.delta, LLMResultChunkDelta) + assert isinstance(chunk.delta.message, AssistantPromptMessage) + assert len(chunk.delta.message.content) > 0 if chunk.delta.finish_reason is None else True + + +def test_get_num_tokens(): + model = GPUStackLanguageModel() + + num_tokens = model.get_num_tokens( + model="????", + credentials={ + "endpoint_url": os.environ.get("GPUSTACK_SERVER_URL"), + "api_key": os.environ.get("GPUSTACK_API_KEY"), + "mode": "chat", + }, + prompt_messages=[ + SystemPromptMessage( + content="You are a helpful AI assistant.", + ), + UserPromptMessage(content="Hello World!"), + ], + tools=[ + PromptMessageTool( + name="get_current_weather", + description="Get the current weather in a given location", + parameters={ + "type": "object", + "properties": { + "location": { + "type": "string", + "description": "The city and state e.g. San Francisco, CA", + }, + "unit": {"type": "string", "enum": ["c", "f"]}, + }, + "required": ["location"], + }, + ) + ], + ) + + assert isinstance(num_tokens, int) + assert num_tokens == 80 + + num_tokens = model.get_num_tokens( + model="????", + credentials={ + "endpoint_url": os.environ.get("GPUSTACK_SERVER_URL"), + "api_key": os.environ.get("GPUSTACK_API_KEY"), + "mode": "chat", + }, + prompt_messages=[UserPromptMessage(content="Hello World!")], + ) + + assert isinstance(num_tokens, int) + assert num_tokens == 10 diff --git a/api/tests/integration_tests/model_runtime/gpustack/test_rerank.py b/api/tests/integration_tests/model_runtime/gpustack/test_rerank.py new file mode 100644 index 0000000000..f5c2d2d21c --- /dev/null +++ b/api/tests/integration_tests/model_runtime/gpustack/test_rerank.py @@ -0,0 +1,107 @@ +import os + +import pytest + +from core.model_runtime.entities.rerank_entities import RerankDocument, RerankResult +from core.model_runtime.errors.validate import CredentialsValidateFailedError +from core.model_runtime.model_providers.gpustack.rerank.rerank import ( + GPUStackRerankModel, +) + + +def test_validate_credentials_for_rerank_model(): + model = GPUStackRerankModel() + + with pytest.raises(CredentialsValidateFailedError): + model.validate_credentials( + model="bge-reranker-v2-m3", + credentials={ + "endpoint_url": "invalid_url", + "api_key": "invalid_api_key", + }, + ) + + model.validate_credentials( + model="bge-reranker-v2-m3", + credentials={ + "endpoint_url": os.environ.get("GPUSTACK_SERVER_URL"), + "api_key": os.environ.get("GPUSTACK_API_KEY"), + }, + ) + + +def test_invoke_rerank_model(): + model = GPUStackRerankModel() + + response = model.invoke( + model="bge-reranker-v2-m3", + credentials={ + "endpoint_url": os.environ.get("GPUSTACK_SERVER_URL"), + "api_key": os.environ.get("GPUSTACK_API_KEY"), + }, + query="Organic skincare products for sensitive skin", + docs=[ + "Eco-friendly kitchenware for modern homes", + "Biodegradable cleaning supplies for eco-conscious consumers", + "Organic cotton baby clothes for sensitive skin", + "Natural organic skincare range for sensitive skin", + "Tech gadgets for smart homes: 2024 edition", + "Sustainable gardening tools and compost solutions", + "Sensitive skin-friendly facial cleansers and toners", + "Organic food wraps and storage solutions", + "Yoga mats made from recycled materials", + ], + top_n=3, + score_threshold=-0.75, + user="abc-123", + ) + + assert isinstance(response, RerankResult) + assert len(response.docs) == 3 + + +def test__invoke(): + model = GPUStackRerankModel() + + # Test case 1: Empty docs + result = model._invoke( + model="bge-reranker-v2-m3", + credentials={ + "endpoint_url": os.environ.get("GPUSTACK_SERVER_URL"), + "api_key": os.environ.get("GPUSTACK_API_KEY"), + }, + query="Organic skincare products for sensitive skin", + docs=[], + top_n=3, + score_threshold=0.75, + user="abc-123", + ) + assert isinstance(result, RerankResult) + assert len(result.docs) == 0 + + # Test case 2: Expected docs + result = model._invoke( + model="bge-reranker-v2-m3", + credentials={ + "endpoint_url": os.environ.get("GPUSTACK_SERVER_URL"), + "api_key": os.environ.get("GPUSTACK_API_KEY"), + }, + query="Organic skincare products for sensitive skin", + docs=[ + "Eco-friendly kitchenware for modern homes", + "Biodegradable cleaning supplies for eco-conscious consumers", + "Organic cotton baby clothes for sensitive skin", + "Natural organic skincare range for sensitive skin", + "Tech gadgets for smart homes: 2024 edition", + "Sustainable gardening tools and compost solutions", + "Sensitive skin-friendly facial cleansers and toners", + "Organic food wraps and storage solutions", + "Yoga mats made from recycled materials", + ], + top_n=3, + score_threshold=-0.75, + user="abc-123", + ) + assert isinstance(result, RerankResult) + assert len(result.docs) == 3 + assert all(isinstance(doc, RerankDocument) for doc in result.docs) From 07ad362854eb7854634847a924d4069ff90cf5c0 Mon Sep 17 00:00:00 2001 From: jiangbo721 <365065261@qq.com> Date: Fri, 1 Nov 2024 17:25:31 +0800 Subject: [PATCH 03/73] fix: Cannot find declaration to go to CLEAN_DAY_SETTING (#10157) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: 刘江波 --- api/schedule/clean_embedding_cache_task.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/schedule/clean_embedding_cache_task.py b/api/schedule/clean_embedding_cache_task.py index 67d0706828..9efe120b7a 100644 --- a/api/schedule/clean_embedding_cache_task.py +++ b/api/schedule/clean_embedding_cache_task.py @@ -14,7 +14,7 @@ from models.dataset import Embedding @app.celery.task(queue="dataset") def clean_embedding_cache_task(): click.echo(click.style("Start clean embedding cache.", fg="green")) - clean_days = int(dify_config.CLEAN_DAY_SETTING) + clean_days = int(dify_config.PLAN_SANDBOX_CLEAN_DAY_SETTING) start_at = time.perf_counter() thirty_days_ago = datetime.datetime.now() - datetime.timedelta(days=clean_days) while True: From 6a2a9460e909060c342d08ce4e96fd4a1a03ac24 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Fri, 1 Nov 2024 18:58:54 +0800 Subject: [PATCH 04/73] fix(workflow model): ensure consistent timestamp updating (#10172) --- api/models/workflow.py | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/api/models/workflow.py b/api/models/workflow.py index 24dd10fbc5..4f0e9a5e03 100644 --- a/api/models/workflow.py +++ b/api/models/workflow.py @@ -1,6 +1,6 @@ import json from collections.abc import Mapping, Sequence -from datetime import datetime +from datetime import datetime, timezone from enum import Enum from typing import Any, Optional, Union @@ -107,7 +107,9 @@ class Workflow(db.Model): db.DateTime, nullable=False, server_default=db.text("CURRENT_TIMESTAMP(0)") ) updated_by: Mapped[Optional[str]] = mapped_column(StringUUID) - updated_at: Mapped[datetime] = mapped_column(db.DateTime, nullable=False) + updated_at: Mapped[datetime] = mapped_column( + sa.DateTime, nullable=False, default=datetime.now(tz=timezone.utc), server_onupdate=func.current_timestamp() + ) _environment_variables: Mapped[str] = mapped_column( "environment_variables", db.Text, nullable=False, server_default="{}" ) From ab127ba92e298827e0ae84c04a7a7acade29fdbd Mon Sep 17 00:00:00 2001 From: Cling_o3 <45124798+ProseGuys@users.noreply.github.com> Date: Fri, 1 Nov 2024 18:59:15 +0800 Subject: [PATCH 05/73] [fix] fix the bug that modify document name not effective (#10154) --- api/services/dataset_service.py | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/api/services/dataset_service.py b/api/services/dataset_service.py index ac05cbc4f5..50da547fd8 100644 --- a/api/services/dataset_service.py +++ b/api/services/dataset_service.py @@ -986,9 +986,6 @@ class DocumentService: raise NotFound("Document not found") if document.display_status != "available": raise ValueError("Document is not available") - # update document name - if document_data.get("name"): - document.name = document_data["name"] # save process rule if document_data.get("process_rule"): process_rule = document_data["process_rule"] @@ -1065,6 +1062,10 @@ class DocumentService: document.data_source_type = document_data["data_source"]["type"] document.data_source_info = json.dumps(data_source_info) document.name = file_name + + # update document name + if document_data.get("name"): + document.name = document_data["name"] # update document to be waiting document.indexing_status = "waiting" document.completed_at = None From 86739bea8b293719e17eca6737e28dd447beb4c4 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Fri, 1 Nov 2024 20:59:40 +0800 Subject: [PATCH 06/73] fix(tools): suppress RuntimeWarnings in podcast audio generator (#10182) --- .../podcast_generator/tools/podcast_audio_generator.py | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/api/core/tools/provider/builtin/podcast_generator/tools/podcast_audio_generator.py b/api/core/tools/provider/builtin/podcast_generator/tools/podcast_audio_generator.py index 2300b69e49..476e2d01e1 100644 --- a/api/core/tools/provider/builtin/podcast_generator/tools/podcast_audio_generator.py +++ b/api/core/tools/provider/builtin/podcast_generator/tools/podcast_audio_generator.py @@ -1,8 +1,8 @@ import concurrent.futures import io import random +import warnings from typing import Any, Literal, Optional, Union -from warnings import catch_warnings import openai @@ -10,7 +10,8 @@ from core.tools.entities.tool_entities import ToolInvokeMessage from core.tools.errors import ToolParameterValidationError, ToolProviderCredentialValidationError from core.tools.tool.builtin_tool import BuiltinTool -with catch_warnings(action="ignore", category=RuntimeWarning): +with warnings.catch_warnings(): + warnings.simplefilter("ignore") from pydub import AudioSegment From 53a7cb0e9ddb5a5b04d8c4f48033c67edae32be8 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Fri, 1 Nov 2024 23:19:11 +0800 Subject: [PATCH 07/73] feat(document_extractor): integrate unstructured API for PPTX extraction (#10180) --- api/core/workflow/nodes/document_extractor/node.py | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/api/core/workflow/nodes/document_extractor/node.py b/api/core/workflow/nodes/document_extractor/node.py index c2f51ad1e5..aacee94095 100644 --- a/api/core/workflow/nodes/document_extractor/node.py +++ b/api/core/workflow/nodes/document_extractor/node.py @@ -6,12 +6,14 @@ import docx import pandas as pd import pypdfium2 import yaml +from unstructured.partition.api import partition_via_api from unstructured.partition.email import partition_email from unstructured.partition.epub import partition_epub from unstructured.partition.msg import partition_msg from unstructured.partition.ppt import partition_ppt from unstructured.partition.pptx import partition_pptx +from configs import dify_config from core.file import File, FileTransferMethod, file_manager from core.helper import ssrf_proxy from core.variables import ArrayFileSegment @@ -263,7 +265,14 @@ def _extract_text_from_ppt(file_content: bytes) -> str: def _extract_text_from_pptx(file_content: bytes) -> str: try: with io.BytesIO(file_content) as file: - elements = partition_pptx(file=file) + if dify_config.UNSTRUCTURED_API_URL and dify_config.UNSTRUCTURED_API_KEY: + elements = partition_via_api( + file=file, + api_url=dify_config.UNSTRUCTURED_API_URL, + api_key=dify_config.UNSTRUCTURED_API_KEY, + ) + else: + elements = partition_pptx(file=file) return "\n".join([getattr(element, "text", "") for element in elements]) except Exception as e: raise TextExtractionError(f"Failed to extract text from PPTX: {str(e)}") from e From 0066531266f93082493c1a96dce880e0ab1a1fa9 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Sat, 2 Nov 2024 17:03:00 +0800 Subject: [PATCH 08/73] fix(api): replace current_user with end_user in file upload (#10194) --- api/controllers/web/remote_files.py | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/api/controllers/web/remote_files.py b/api/controllers/web/remote_files.py index cb529340af..0b8a586d0c 100644 --- a/api/controllers/web/remote_files.py +++ b/api/controllers/web/remote_files.py @@ -1,6 +1,5 @@ import urllib.parse -from flask_login import current_user from flask_restful import marshal_with, reqparse from controllers.common import helpers @@ -27,7 +26,7 @@ class RemoteFileInfoApi(WebApiResource): class RemoteFileUploadApi(WebApiResource): @marshal_with(file_fields_with_signed_url) - def post(self): + def post(self, app_model, end_user): # Add app_model and end_user parameters parser = reqparse.RequestParser() parser.add_argument("url", type=str, required=True, help="URL is required") args = parser.parse_args() @@ -51,7 +50,7 @@ class RemoteFileUploadApi(WebApiResource): filename=file_info.filename, content=content, mimetype=file_info.mimetype, - user=current_user, + user=end_user, # Use end_user instead of current_user source_url=url, ) except Exception as e: From dfa3ef05649e4bb781fea42998db4b83cd53d4ba Mon Sep 17 00:00:00 2001 From: zxhlyh Date: Sat, 2 Nov 2024 17:03:14 +0800 Subject: [PATCH 09/73] fix: webapp upload file (#10195) --- web/app/components/base/file-uploader/hooks.ts | 2 +- web/service/common.ts | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/web/app/components/base/file-uploader/hooks.ts b/web/app/components/base/file-uploader/hooks.ts index a78c414913..088160691b 100644 --- a/web/app/components/base/file-uploader/hooks.ts +++ b/web/app/components/base/file-uploader/hooks.ts @@ -216,7 +216,7 @@ export const useFile = (fileConfig: FileUpload) => { handleAddFile(uploadingFile) startProgressTimer(uploadingFile.id) - uploadRemoteFileInfo(url).then((res) => { + uploadRemoteFileInfo(url, !!params.token).then((res) => { const newFile = { ...uploadingFile, type: res.mime_type, diff --git a/web/service/common.ts b/web/service/common.ts index 4ea2d9fd27..81b96aa97c 100644 --- a/web/service/common.ts +++ b/web/service/common.ts @@ -324,8 +324,8 @@ export const verifyForgotPasswordToken: Fetcher = ({ url, body }) => post(url, { body }) -export const uploadRemoteFileInfo = (url: string) => { - return post<{ id: string; name: string; size: number; mime_type: string; url: string }>('/remote-files/upload', { body: { url } }) +export const uploadRemoteFileInfo = (url: string, isPublic?: boolean) => { + return post<{ id: string; name: string; size: number; mime_type: string; url: string }>('/remote-files/upload', { body: { url } }, { isPublicAPI: isPublic }) } export const sendEMailLoginCode = (email: string, language = 'en-US') => From a0af7a51edc31f5038a3c1612b9f5ad2556dc587 Mon Sep 17 00:00:00 2001 From: Kota-Yamaguchi <50980947+Kota-Yamaguchi@users.noreply.github.com> Date: Sat, 2 Nov 2024 20:45:07 +0900 Subject: [PATCH 10/73] chore : code generator preview hint (#10188) --- .../config/code-generator/get-code-generator-res.tsx | 10 ++++++++++ web/i18n/en-US/app-debug.ts | 2 ++ web/i18n/ja-JP/app-debug.ts | 2 ++ web/i18n/zh-Hans/app-debug.ts | 2 ++ 4 files changed, 16 insertions(+) diff --git a/web/app/components/app/configuration/config/code-generator/get-code-generator-res.tsx b/web/app/components/app/configuration/config/code-generator/get-code-generator-res.tsx index b63e3e2693..85c522ca0f 100644 --- a/web/app/components/app/configuration/config/code-generator/get-code-generator-res.tsx +++ b/web/app/components/app/configuration/config/code-generator/get-code-generator-res.tsx @@ -105,6 +105,15 @@ export const GetCodeGeneratorResModal: FC = (

{t('appDebug.codegen.loading')}
) + const renderNoData = ( +
+ +
+
{t('appDebug.codegen.noDataLine1')}
+
{t('appDebug.codegen.noDataLine2')}
+
+
+ ) return ( = ( {isLoading && renderLoading} + {!isLoading && !res && renderNoData} {(!isLoading && res) && (
{t('appDebug.codegen.resTitle')}
diff --git a/web/i18n/en-US/app-debug.ts b/web/i18n/en-US/app-debug.ts index b2144262f6..e17afc38bf 100644 --- a/web/i18n/en-US/app-debug.ts +++ b/web/i18n/en-US/app-debug.ts @@ -224,6 +224,8 @@ const translation = { description: 'The Code Generator uses configured models to generate high-quality code based on your instructions. Please provide clear and detailed instructions.', instruction: 'Instructions', instructionPlaceholder: 'Enter detailed description of the code you want to generate.', + noDataLine1: 'Describe your use case on the left,', + noDataLine2: 'the code preview will show here.', generate: 'Generate', generatedCodeTitle: 'Generated Code', loading: 'Generating code...', diff --git a/web/i18n/ja-JP/app-debug.ts b/web/i18n/ja-JP/app-debug.ts index 620d9b2f55..05e81a2ae2 100644 --- a/web/i18n/ja-JP/app-debug.ts +++ b/web/i18n/ja-JP/app-debug.ts @@ -224,6 +224,8 @@ const translation = { description: 'コードジェネレーターは、設定されたモデルを使用して指示に基づいて高品質なコードを生成します。明確で詳細な指示を提供してください。', instruction: '指示', instructionPlaceholder: '生成したいコードの詳細な説明を入力してください。', + noDataLine1: '左側に使用例を記入してください,', + noDataLine2: 'コードのプレビューがこちらに表示されます。', generate: '生成', generatedCodeTitle: '生成されたコード', loading: 'コードを生成中...', diff --git a/web/i18n/zh-Hans/app-debug.ts b/web/i18n/zh-Hans/app-debug.ts index 3e801bcf62..9e21945755 100644 --- a/web/i18n/zh-Hans/app-debug.ts +++ b/web/i18n/zh-Hans/app-debug.ts @@ -224,6 +224,8 @@ const translation = { description: '代码生成器使用配置的模型根据您的指令生成高质量的代码。请提供清晰详细的说明。', instruction: '指令', instructionPlaceholder: '请输入您想要生成的代码的详细描述。', + noDataLine1: '在左侧描述您的用例，', + noDataLine2: '代码预览将在此处显示。', generate: '生成', generatedCodeTitle: '生成的代码', loading: '正在生成代码...', From b28cf68097058a52b58e23406b2bd8bfa4e44c3e Mon Sep 17 00:00:00 2001 From: Xiao Ley Date: Sat, 2 Nov 2024 19:45:20 +0800 Subject: [PATCH 11/73] chore: enable vision support for models in OpenRouter that should have supported vision (#10191) --- .../openrouter/llm/llama-3.2-11b-vision-instruct.yaml | 1 + .../openrouter/llm/llama-3.2-90b-vision-instruct.yaml | 1 + 2 files changed, 2 insertions(+) diff --git a/api/core/model_runtime/model_providers/openrouter/llm/llama-3.2-11b-vision-instruct.yaml b/api/core/model_runtime/model_providers/openrouter/llm/llama-3.2-11b-vision-instruct.yaml index 235156997f..6ad2c26cc8 100644 --- a/api/core/model_runtime/model_providers/openrouter/llm/llama-3.2-11b-vision-instruct.yaml +++ b/api/core/model_runtime/model_providers/openrouter/llm/llama-3.2-11b-vision-instruct.yaml @@ -5,6 +5,7 @@ label: model_type: llm features: - agent-thought + - vision model_properties: mode: chat context_size: 131072 diff --git a/api/core/model_runtime/model_providers/openrouter/llm/llama-3.2-90b-vision-instruct.yaml b/api/core/model_runtime/model_providers/openrouter/llm/llama-3.2-90b-vision-instruct.yaml index 5d597f00a2..c264db0f20 100644 --- a/api/core/model_runtime/model_providers/openrouter/llm/llama-3.2-90b-vision-instruct.yaml +++ b/api/core/model_runtime/model_providers/openrouter/llm/llama-3.2-90b-vision-instruct.yaml @@ -5,6 +5,7 @@ label: model_type: llm features: - agent-thought + - vision model_properties: mode: chat context_size: 131072 From bf371a6e5d734055c081f965722e1408251c6103 Mon Sep 17 00:00:00 2001 From: Kota-Yamaguchi <50980947+Kota-Yamaguchi@users.noreply.github.com> Date: Sat, 2 Nov 2024 20:46:28 +0900 Subject: [PATCH 12/73] Feat : add LLM model indicator in prompt generator (#10187) --- .../config/automatic/get-automatic-res.tsx | 22 ++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/web/app/components/app/configuration/config/automatic/get-automatic-res.tsx b/web/app/components/app/configuration/config/automatic/get-automatic-res.tsx index 05339c7216..0a20f4b376 100644 --- a/web/app/components/app/configuration/config/automatic/get-automatic-res.tsx +++ b/web/app/components/app/configuration/config/automatic/get-automatic-res.tsx @@ -33,6 +33,10 @@ import { LoveMessage } from '@/app/components/base/icons/src/vender/features' // type import type { AutomaticRes } from '@/service/debug' import { Generator } from '@/app/components/base/icons/src/vender/other' +import ModelIcon from '@/app/components/header/account-setting/model-provider-page/model-icon' +import ModelName from '@/app/components/header/account-setting/model-provider-page/model-name' +import { ModelTypeEnum } from '@/app/components/header/account-setting/model-provider-page/declarations' +import { useModelListAndDefaultModelAndCurrentProviderAndModel } from '@/app/components/header/account-setting/model-provider-page/hooks' export type IGetAutomaticResProps = { mode: AppType @@ -68,7 +72,10 @@ const GetAutomaticRes: FC = ({ onFinished, }) => { const { t } = useTranslation() - + const { + currentProvider, + currentModel, + } = useModelListAndDefaultModelAndCurrentProviderAndModel(ModelTypeEnum.textGeneration) const tryList = [ { icon: RiTerminalBoxLine, @@ -191,6 +198,19 @@ const GetAutomaticRes: FC = ({
{t('appDebug.generate.title')}
{t('appDebug.generate.description')}
+
+ + +
{t('appDebug.generate.tryIt')}
From ec6a03afdd9c169d19c941892319408143525991 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Sun, 3 Nov 2024 11:55:07 +0800 Subject: [PATCH 13/73] fix(document_extractor): update base exception class (#10208) --- api/core/workflow/nodes/document_extractor/exc.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/core/workflow/nodes/document_extractor/exc.py b/api/core/workflow/nodes/document_extractor/exc.py index c9d4bb8ef6..5caf00ebc5 100644 --- a/api/core/workflow/nodes/document_extractor/exc.py +++ b/api/core/workflow/nodes/document_extractor/exc.py @@ -1,4 +1,4 @@ -class DocumentExtractorError(Exception): +class DocumentExtractorError(ValueError): """Base exception for errors related to the DocumentExtractorNode.""" From 1432c268a8ab97129d8a2452ab00413b889c281d Mon Sep 17 00:00:00 2001 From: -LAN- Date: Sun, 3 Nov 2024 11:55:19 +0800 Subject: [PATCH 14/73] chore(list_operator): refine exception handling for error specificity (#10206) --- api/core/workflow/nodes/list_operator/exc.py | 16 ++ api/core/workflow/nodes/list_operator/node.py | 153 +++++++++++------- 2 files changed, 112 insertions(+), 57 deletions(-) create mode 100644 api/core/workflow/nodes/list_operator/exc.py diff --git a/api/core/workflow/nodes/list_operator/exc.py b/api/core/workflow/nodes/list_operator/exc.py new file mode 100644 index 0000000000..f88aa0be29 --- /dev/null +++ b/api/core/workflow/nodes/list_operator/exc.py @@ -0,0 +1,16 @@ +class ListOperatorError(ValueError): + """Base class for all ListOperator errors.""" + + pass + + +class InvalidFilterValueError(ListOperatorError): + pass + + +class InvalidKeyError(ListOperatorError): + pass + + +class InvalidConditionError(ListOperatorError): + pass diff --git a/api/core/workflow/nodes/list_operator/node.py b/api/core/workflow/nodes/list_operator/node.py index d7e4c64313..6053a15d96 100644 --- a/api/core/workflow/nodes/list_operator/node.py +++ b/api/core/workflow/nodes/list_operator/node.py @@ -1,5 +1,5 @@ from collections.abc import Callable, Sequence -from typing import Literal +from typing import Literal, Union from core.file import File from core.variables import ArrayFileSegment, ArrayNumberSegment, ArrayStringSegment @@ -9,6 +9,7 @@ from core.workflow.nodes.enums import NodeType from models.workflow import WorkflowNodeExecutionStatus from .entities import ListOperatorNodeData +from .exc import InvalidConditionError, InvalidFilterValueError, InvalidKeyError, ListOperatorError class ListOperatorNode(BaseNode[ListOperatorNodeData]): @@ -26,7 +27,17 @@ class ListOperatorNode(BaseNode[ListOperatorNodeData]): return NodeRunResult( status=WorkflowNodeExecutionStatus.FAILED, error=error_message, inputs=inputs, outputs=outputs ) - if variable.value and not isinstance(variable, ArrayFileSegment | ArrayNumberSegment | ArrayStringSegment): + if not variable.value: + inputs = {"variable": []} + process_data = {"variable": []} + outputs = {"result": [], "first_record": None, "last_record": None} + return NodeRunResult( + status=WorkflowNodeExecutionStatus.SUCCEEDED, + inputs=inputs, + process_data=process_data, + outputs=outputs, + ) + if not isinstance(variable, ArrayFileSegment | ArrayNumberSegment | ArrayStringSegment): error_message = ( f"Variable {self.node_data.variable} is not an ArrayFileSegment, ArrayNumberSegment " "or ArrayStringSegment" @@ -36,70 +47,98 @@ class ListOperatorNode(BaseNode[ListOperatorNodeData]): ) if isinstance(variable, ArrayFileSegment): + inputs = {"variable": [item.to_dict() for item in variable.value]} process_data["variable"] = [item.to_dict() for item in variable.value] else: + inputs = {"variable": variable.value} process_data["variable"] = variable.value - # Filter - if self.node_data.filter_by.enabled: - for condition in self.node_data.filter_by.conditions: - if isinstance(variable, ArrayStringSegment): - if not isinstance(condition.value, str): - raise ValueError(f"Invalid filter value: {condition.value}") - value = self.graph_runtime_state.variable_pool.convert_template(condition.value).text - filter_func = _get_string_filter_func(condition=condition.comparison_operator, value=value) - result = list(filter(filter_func, variable.value)) - variable = variable.model_copy(update={"value": result}) - elif isinstance(variable, ArrayNumberSegment): - if not isinstance(condition.value, str): - raise ValueError(f"Invalid filter value: {condition.value}") - value = self.graph_runtime_state.variable_pool.convert_template(condition.value).text - filter_func = _get_number_filter_func(condition=condition.comparison_operator, value=float(value)) - result = list(filter(filter_func, variable.value)) - variable = variable.model_copy(update={"value": result}) - elif isinstance(variable, ArrayFileSegment): - if isinstance(condition.value, str): - value = self.graph_runtime_state.variable_pool.convert_template(condition.value).text - else: - value = condition.value - filter_func = _get_file_filter_func( - key=condition.key, - condition=condition.comparison_operator, - value=value, - ) - result = list(filter(filter_func, variable.value)) - variable = variable.model_copy(update={"value": result}) + try: + # Filter + if self.node_data.filter_by.enabled: + variable = self._apply_filter(variable) - # Order - if self.node_data.order_by.enabled: + # Order + if self.node_data.order_by.enabled: + variable = self._apply_order(variable) + + # Slice + if self.node_data.limit.enabled: + variable = self._apply_slice(variable) + + outputs = { + "result": variable.value, + "first_record": variable.value[0] if variable.value else None, + "last_record": variable.value[-1] if variable.value else None, + } + return NodeRunResult( + status=WorkflowNodeExecutionStatus.SUCCEEDED, + inputs=inputs, + process_data=process_data, + outputs=outputs, + ) + except ListOperatorError as e: + return NodeRunResult( + status=WorkflowNodeExecutionStatus.FAILED, + error=str(e), + inputs=inputs, + process_data=process_data, + outputs=outputs, + ) + + def _apply_filter( + self, variable: Union[ArrayFileSegment, ArrayNumberSegment, ArrayStringSegment] + ) -> Union[ArrayFileSegment, ArrayNumberSegment, ArrayStringSegment]: + for condition in self.node_data.filter_by.conditions: if isinstance(variable, ArrayStringSegment): - result = _order_string(order=self.node_data.order_by.value, array=variable.value) + if not isinstance(condition.value, str): + raise InvalidFilterValueError(f"Invalid filter value: {condition.value}") + value = self.graph_runtime_state.variable_pool.convert_template(condition.value).text + filter_func = _get_string_filter_func(condition=condition.comparison_operator, value=value) + result = list(filter(filter_func, variable.value)) variable = variable.model_copy(update={"value": result}) elif isinstance(variable, ArrayNumberSegment): - result = _order_number(order=self.node_data.order_by.value, array=variable.value) + if not isinstance(condition.value, str): + raise InvalidFilterValueError(f"Invalid filter value: {condition.value}") + value = self.graph_runtime_state.variable_pool.convert_template(condition.value).text + filter_func = _get_number_filter_func(condition=condition.comparison_operator, value=float(value)) + result = list(filter(filter_func, variable.value)) variable = variable.model_copy(update={"value": result}) elif isinstance(variable, ArrayFileSegment): - result = _order_file( - order=self.node_data.order_by.value, order_by=self.node_data.order_by.key, array=variable.value + if isinstance(condition.value, str): + value = self.graph_runtime_state.variable_pool.convert_template(condition.value).text + else: + value = condition.value + filter_func = _get_file_filter_func( + key=condition.key, + condition=condition.comparison_operator, + value=value, ) + result = list(filter(filter_func, variable.value)) variable = variable.model_copy(update={"value": result}) + return variable - # Slice - if self.node_data.limit.enabled: - result = variable.value[: self.node_data.limit.size] + def _apply_order( + self, variable: Union[ArrayFileSegment, ArrayNumberSegment, ArrayStringSegment] + ) -> Union[ArrayFileSegment, ArrayNumberSegment, ArrayStringSegment]: + if isinstance(variable, ArrayStringSegment): + result = _order_string(order=self.node_data.order_by.value, array=variable.value) variable = variable.model_copy(update={"value": result}) + elif isinstance(variable, ArrayNumberSegment): + result = _order_number(order=self.node_data.order_by.value, array=variable.value) + variable = variable.model_copy(update={"value": result}) + elif isinstance(variable, ArrayFileSegment): + result = _order_file( + order=self.node_data.order_by.value, order_by=self.node_data.order_by.key, array=variable.value + ) + variable = variable.model_copy(update={"value": result}) + return variable - outputs = { - "result": variable.value, - "first_record": variable.value[0] if variable.value else None, - "last_record": variable.value[-1] if variable.value else None, - } - return NodeRunResult( - status=WorkflowNodeExecutionStatus.SUCCEEDED, - inputs=inputs, - process_data=process_data, - outputs=outputs, - ) + def _apply_slice( + self, variable: Union[ArrayFileSegment, ArrayNumberSegment, ArrayStringSegment] + ) -> Union[ArrayFileSegment, ArrayNumberSegment, ArrayStringSegment]: + result = variable.value[: self.node_data.limit.size] + return variable.model_copy(update={"value": result}) def _get_file_extract_number_func(*, key: str) -> Callable[[File], int]: @@ -107,7 +146,7 @@ def _get_file_extract_number_func(*, key: str) -> Callable[[File], int]: case "size": return lambda x: x.size case _: - raise ValueError(f"Invalid key: {key}") + raise InvalidKeyError(f"Invalid key: {key}") def _get_file_extract_string_func(*, key: str) -> Callable[[File], str]: @@ -125,7 +164,7 @@ def _get_file_extract_string_func(*, key: str) -> Callable[[File], str]: case "url": return lambda x: x.remote_url or "" case _: - raise ValueError(f"Invalid key: {key}") + raise InvalidKeyError(f"Invalid key: {key}") def _get_string_filter_func(*, condition: str, value: str) -> Callable[[str], bool]: @@ -151,7 +190,7 @@ def _get_string_filter_func(*, condition: str, value: str) -> Callable[[str], bo case "not empty": return lambda x: x != "" case _: - raise ValueError(f"Invalid condition: {condition}") + raise InvalidConditionError(f"Invalid condition: {condition}") def _get_sequence_filter_func(*, condition: str, value: Sequence[str]) -> Callable[[str], bool]: @@ -161,7 +200,7 @@ def _get_sequence_filter_func(*, condition: str, value: Sequence[str]) -> Callab case "not in": return lambda x: not _in(value)(x) case _: - raise ValueError(f"Invalid condition: {condition}") + raise InvalidConditionError(f"Invalid condition: {condition}") def _get_number_filter_func(*, condition: str, value: int | float) -> Callable[[int | float], bool]: @@ -179,7 +218,7 @@ def _get_number_filter_func(*, condition: str, value: int | float) -> Callable[[ case "≥": return _ge(value) case _: - raise ValueError(f"Invalid condition: {condition}") + raise InvalidConditionError(f"Invalid condition: {condition}") def _get_file_filter_func(*, key: str, condition: str, value: str | Sequence[str]) -> Callable[[File], bool]: @@ -193,7 +232,7 @@ def _get_file_filter_func(*, key: str, condition: str, value: str | Sequence[str extract_func = _get_file_extract_number_func(key=key) return lambda x: _get_number_filter_func(condition=condition, value=float(value))(extract_func(x)) else: - raise ValueError(f"Invalid key: {key}") + raise InvalidKeyError(f"Invalid key: {key}") def _contains(value: str): From 61da0f08dde96ac0074b1a987e008e3aa2319bfd Mon Sep 17 00:00:00 2001 From: -LAN- Date: Sun, 3 Nov 2024 11:55:46 +0800 Subject: [PATCH 15/73] refactor(validation): improve input validation logic (#10175) --- api/core/app/apps/base_app_generator.py | 45 ++++++++++++++----------- 1 file changed, 26 insertions(+), 19 deletions(-) diff --git a/api/core/app/apps/base_app_generator.py b/api/core/app/apps/base_app_generator.py index 2707ada6cb..7daff83533 100644 --- a/api/core/app/apps/base_app_generator.py +++ b/api/core/app/apps/base_app_generator.py @@ -76,6 +76,7 @@ class BaseAppGenerator: def _validate_input(self, *, inputs: Mapping[str, Any], var: "VariableEntity"): user_input_value = inputs.get(var.variable) + if not user_input_value: if var.required: raise ValueError(f"{var.variable} is required in input form") @@ -88,6 +89,7 @@ class BaseAppGenerator: VariableEntityType.PARAGRAPH, } and not isinstance(user_input_value, str): raise ValueError(f"(type '{var.type}') {var.variable} in input form must be a string") + if var.type == VariableEntityType.NUMBER and isinstance(user_input_value, str): # may raise ValueError if user_input_value is not a valid number try: @@ -97,25 +99,30 @@ class BaseAppGenerator: return int(user_input_value) except ValueError: raise ValueError(f"{var.variable} in input form must be a valid number") - if var.type == VariableEntityType.SELECT: - options = var.options - if user_input_value not in options: - raise ValueError(f"{var.variable} in input form must be one of the following: {options}") - elif var.type in {VariableEntityType.TEXT_INPUT, VariableEntityType.PARAGRAPH}: - if var.max_length and len(user_input_value) > var.max_length: - raise ValueError(f"{var.variable} in input form must be less than {var.max_length} characters") - elif var.type == VariableEntityType.FILE: - if not isinstance(user_input_value, dict) and not isinstance(user_input_value, File): - raise ValueError(f"{var.variable} in input form must be a file") - elif var.type == VariableEntityType.FILE_LIST: - if not ( - isinstance(user_input_value, list) - and ( - all(isinstance(item, dict) for item in user_input_value) - or all(isinstance(item, File) for item in user_input_value) - ) - ): - raise ValueError(f"{var.variable} in input form must be a list of files") + + match var.type: + case VariableEntityType.SELECT: + if user_input_value not in var.options: + raise ValueError(f"{var.variable} in input form must be one of the following: {var.options}") + case VariableEntityType.TEXT_INPUT | VariableEntityType.PARAGRAPH: + if var.max_length and len(user_input_value) > var.max_length: + raise ValueError(f"{var.variable} in input form must be less than {var.max_length} characters") + case VariableEntityType.FILE: + if not isinstance(user_input_value, dict) and not isinstance(user_input_value, File): + raise ValueError(f"{var.variable} in input form must be a file") + case VariableEntityType.FILE_LIST: + # if number of files exceeds the limit, raise ValueError + if not ( + isinstance(user_input_value, list) + and ( + all(isinstance(item, dict) for item in user_input_value) + or all(isinstance(item, File) for item in user_input_value) + ) + ): + raise ValueError(f"{var.variable} in input form must be a list of files") + + if var.max_length and len(user_input_value) > var.max_length: + raise ValueError(f"{var.variable} in input form must be less than {var.max_length} files") return user_input_value From 2ed6bb86c1339021e5f3850f6edbb7ee35a0621a Mon Sep 17 00:00:00 2001 From: crazywoola <100913391+crazywoola@users.noreply.github.com> Date: Sun, 3 Nov 2024 12:53:49 +0800 Subject: [PATCH 16/73] Fix/10199 application error a client side exception has occurred see the browser console for more information (#10211) --- .../nodes/_base/hooks/use-one-step-run.ts | 31 +++++++++---------- 1 file changed, 14 insertions(+), 17 deletions(-) diff --git a/web/app/components/workflow/nodes/_base/hooks/use-one-step-run.ts b/web/app/components/workflow/nodes/_base/hooks/use-one-step-run.ts index 59ebb72b72..c500f0c8cf 100644 --- a/web/app/components/workflow/nodes/_base/hooks/use-one-step-run.ts +++ b/web/app/components/workflow/nodes/_base/hooks/use-one-step-run.ts @@ -105,32 +105,29 @@ const useOneStepRun = ({ const availableNodesIncludeParent = getBeforeNodesInSameBranchIncludeParent(id) const allOutputVars = toNodeOutputVars(availableNodes, isChatMode, undefined, undefined, conversationVariables) const getVar = (valueSelector: ValueSelector): Var | undefined => { - let res: Var | undefined const isSystem = valueSelector[0] === 'sys' - const targetVar = isSystem ? allOutputVars.find(item => !!item.isStartNode) : allOutputVars.find(v => v.nodeId === valueSelector[0]) + const targetVar = allOutputVars.find(item => isSystem ? !!item.isStartNode : item.nodeId === valueSelector[0]) if (!targetVar) return undefined + if (isSystem) return targetVar.vars.find(item => item.variable.split('.')[1] === valueSelector[1]) let curr: any = targetVar.vars - if (!curr) - return + for (let i = 1; i < valueSelector.length; i++) { + const key = valueSelector[i] + const isLast = i === valueSelector.length - 1 - valueSelector.slice(1).forEach((key, i) => { - const isLast = i === valueSelector.length - 2 - // conversation variable is start with 'conversation.' - curr = curr?.find((v: any) => v.variable.replace('conversation.', '') === key) - if (isLast) { - res = curr - } - else { - if (curr?.type === VarType.object || curr?.type === VarType.file) - curr = curr.children - } - }) + if (Array.isArray(curr)) + curr = curr.find((v: any) => v.variable.replace('conversation.', '') === key) - return res + if (isLast) + return curr + else if (curr?.type === VarType.object || curr?.type === VarType.file) + curr = curr.children + } + + return undefined } const checkValid = checkValidFns[data.type] From 0c9e79cd67948a802fb2eea82fea61e6d09008e8 Mon Sep 17 00:00:00 2001 From: Jiang <65766008+AlwaysBluer@users.noreply.github.com> Date: Mon, 4 Nov 2024 09:10:26 +0800 Subject: [PATCH 17/73] Add Lindorm as a VDB choice (#10202) Co-authored-by: jiangzhijie --- api/.env.example | 9 +- api/configs/middleware/__init__.py | 2 + api/configs/middleware/vdb/lindorm_config.py | 23 + api/controllers/console/datasets/datasets.py | 5 +- .../rag/datasource/vdb/lindorm/__init__.py | 0 .../datasource/vdb/lindorm/lindorm_vector.py | 498 ++++++++++++++++++ api/core/rag/datasource/vdb/vector_factory.py | 4 + api/core/rag/datasource/vdb/vector_type.py | 1 + .../integration_tests/vdb/lindorm/__init__.py | 0 .../vdb/lindorm/test_lindorm.py | 35 ++ docker/.env.example | 8 +- docker/docker-compose.yaml | 3 + 12 files changed, 584 insertions(+), 4 deletions(-) create mode 100644 api/configs/middleware/vdb/lindorm_config.py create mode 100644 api/core/rag/datasource/vdb/lindorm/__init__.py create mode 100644 api/core/rag/datasource/vdb/lindorm/lindorm_vector.py create mode 100644 api/tests/integration_tests/vdb/lindorm/__init__.py create mode 100644 api/tests/integration_tests/vdb/lindorm/test_lindorm.py diff --git a/api/.env.example b/api/.env.example index 79d6ffdf6a..c07c292369 100644 --- a/api/.env.example +++ b/api/.env.example @@ -120,7 +120,8 @@ SUPABASE_URL=your-server-url WEB_API_CORS_ALLOW_ORIGINS=http://127.0.0.1:3000,* CONSOLE_CORS_ALLOW_ORIGINS=http://127.0.0.1:3000,* -# Vector database configuration, support: weaviate, qdrant, milvus, myscale, relyt, pgvecto_rs, pgvector, pgvector, chroma, opensearch, tidb_vector, couchbase, vikingdb, upstash + +# Vector database configuration, support: weaviate, qdrant, milvus, myscale, relyt, pgvecto_rs, pgvector, pgvector, chroma, opensearch, tidb_vector, couchbase, vikingdb, upstash, lindorm VECTOR_STORE=weaviate # Weaviate configuration @@ -263,6 +264,11 @@ VIKINGDB_SCHEMA=http VIKINGDB_CONNECTION_TIMEOUT=30 VIKINGDB_SOCKET_TIMEOUT=30 +# Lindorm configuration +LINDORM_URL=http://ld-*******************-proxy-search-pub.lindorm.aliyuncs.com:30070 +LINDORM_USERNAME=admin +LINDORM_PASSWORD=admin + # OceanBase Vector configuration OCEANBASE_VECTOR_HOST=127.0.0.1 OCEANBASE_VECTOR_PORT=2881 @@ -271,6 +277,7 @@ OCEANBASE_VECTOR_PASSWORD= OCEANBASE_VECTOR_DATABASE=test OCEANBASE_MEMORY_LIMIT=6G + # Upload configuration UPLOAD_FILE_SIZE_LIMIT=15 UPLOAD_FILE_BATCH_LIMIT=5 diff --git a/api/configs/middleware/__init__.py b/api/configs/middleware/__init__.py index 4be761747d..57cc805ebf 100644 --- a/api/configs/middleware/__init__.py +++ b/api/configs/middleware/__init__.py @@ -20,6 +20,7 @@ from configs.middleware.vdb.baidu_vector_config import BaiduVectorDBConfig from configs.middleware.vdb.chroma_config import ChromaConfig from configs.middleware.vdb.couchbase_config import CouchbaseConfig from configs.middleware.vdb.elasticsearch_config import ElasticsearchConfig +from configs.middleware.vdb.lindorm_config import LindormConfig from configs.middleware.vdb.milvus_config import MilvusConfig from configs.middleware.vdb.myscale_config import MyScaleConfig from configs.middleware.vdb.oceanbase_config import OceanBaseVectorConfig @@ -259,6 +260,7 @@ class MiddlewareConfig( VikingDBConfig, UpstashConfig, TidbOnQdrantConfig, + LindormConfig, OceanBaseVectorConfig, BaiduVectorDBConfig, ): diff --git a/api/configs/middleware/vdb/lindorm_config.py b/api/configs/middleware/vdb/lindorm_config.py new file mode 100644 index 0000000000..0f6c652806 --- /dev/null +++ b/api/configs/middleware/vdb/lindorm_config.py @@ -0,0 +1,23 @@ +from typing import Optional + +from pydantic import Field +from pydantic_settings import BaseSettings + + +class LindormConfig(BaseSettings): + """ + Lindorm configs + """ + + LINDORM_URL: Optional[str] = Field( + description="Lindorm url", + default=None, + ) + LINDORM_USERNAME: Optional[str] = Field( + description="Lindorm user", + default=None, + ) + LINDORM_PASSWORD: Optional[str] = Field( + description="Lindorm password", + default=None, + ) diff --git a/api/controllers/console/datasets/datasets.py b/api/controllers/console/datasets/datasets.py index 07ef0ce3e5..82163a32ee 100644 --- a/api/controllers/console/datasets/datasets.py +++ b/api/controllers/console/datasets/datasets.py @@ -456,7 +456,7 @@ class DatasetIndexingEstimateApi(Resource): ) except LLMBadRequestError: raise ProviderNotInitializeError( - "No Embedding Model available. Please configure a valid provider in the Settings -> Model Provider." + "No Embedding Model available. Please configure a valid provider " "in the Settings -> Model Provider." ) except ProviderTokenNotInitError as ex: raise ProviderNotInitializeError(ex.description) @@ -620,6 +620,7 @@ class DatasetRetrievalSettingApi(Resource): case ( VectorType.MILVUS | VectorType.RELYT + | VectorType.PGVECTOR | VectorType.TIDB_VECTOR | VectorType.CHROMA | VectorType.TENCENT @@ -640,6 +641,7 @@ class DatasetRetrievalSettingApi(Resource): | VectorType.ELASTICSEARCH | VectorType.PGVECTOR | VectorType.TIDB_ON_QDRANT + | VectorType.LINDORM | VectorType.COUCHBASE ): return { @@ -682,6 +684,7 @@ class DatasetRetrievalSettingMockApi(Resource): | VectorType.ELASTICSEARCH | VectorType.COUCHBASE | VectorType.PGVECTOR + | VectorType.LINDORM ): return { "retrieval_method": [ diff --git a/api/core/rag/datasource/vdb/lindorm/__init__.py b/api/core/rag/datasource/vdb/lindorm/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/api/core/rag/datasource/vdb/lindorm/lindorm_vector.py b/api/core/rag/datasource/vdb/lindorm/lindorm_vector.py new file mode 100644 index 0000000000..abd8261a69 --- /dev/null +++ b/api/core/rag/datasource/vdb/lindorm/lindorm_vector.py @@ -0,0 +1,498 @@ +import copy +import json +import logging +from collections.abc import Iterable +from typing import Any, Optional + +from opensearchpy import OpenSearch +from opensearchpy.helpers import bulk +from pydantic import BaseModel, model_validator +from tenacity import retry, stop_after_attempt, wait_fixed + +from configs import dify_config +from core.rag.datasource.vdb.field import Field +from core.rag.datasource.vdb.vector_base import BaseVector +from core.rag.datasource.vdb.vector_factory import AbstractVectorFactory +from core.rag.datasource.vdb.vector_type import VectorType +from core.rag.embedding.embedding_base import Embeddings +from core.rag.models.document import Document +from extensions.ext_redis import redis_client +from models.dataset import Dataset + +logger = logging.getLogger(__name__) +logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s") +logging.getLogger("lindorm").setLevel(logging.WARN) + + +class LindormVectorStoreConfig(BaseModel): + hosts: str + username: Optional[str] = None + password: Optional[str] = None + + @model_validator(mode="before") + @classmethod + def validate_config(cls, values: dict) -> dict: + if not values["hosts"]: + raise ValueError("config URL is required") + if not values["username"]: + raise ValueError("config USERNAME is required") + if not values["password"]: + raise ValueError("config PASSWORD is required") + return values + + def to_opensearch_params(self) -> dict[str, Any]: + params = { + "hosts": self.hosts, + } + if self.username and self.password: + params["http_auth"] = (self.username, self.password) + return params + + +class LindormVectorStore(BaseVector): + def __init__(self, collection_name: str, config: LindormVectorStoreConfig, **kwargs): + super().__init__(collection_name.lower()) + self._client_config = config + self._client = OpenSearch(**config.to_opensearch_params()) + self.kwargs = kwargs + + def get_type(self) -> str: + return VectorType.LINDORM + + def create(self, texts: list[Document], embeddings: list[list[float]], **kwargs): + self.create_collection(len(embeddings[0]), **kwargs) + self.add_texts(texts, embeddings) + + def refresh(self): + self._client.indices.refresh(index=self._collection_name) + + def __filter_existed_ids( + self, + texts: list[str], + metadatas: list[dict], + ids: list[str], + bulk_size: int = 1024, + ) -> tuple[Iterable[str], Optional[list[dict]], Optional[list[str]]]: + @retry(stop=stop_after_attempt(3), wait=wait_fixed(60)) + def __fetch_existing_ids(batch_ids: list[str]) -> set[str]: + try: + existing_docs = self._client.mget(index=self._collection_name, body={"ids": batch_ids}, _source=False) + return {doc["_id"] for doc in existing_docs["docs"] if doc["found"]} + except Exception as e: + logger.error(f"Error fetching batch {batch_ids}: {e}") + return set() + + @retry(stop=stop_after_attempt(3), wait=wait_fixed(60)) + def __fetch_existing_routing_ids(batch_ids: list[str], route_ids: list[str]) -> set[str]: + try: + existing_docs = self._client.mget( + body={ + "docs": [ + {"_index": self._collection_name, "_id": id, "routing": routing} + for id, routing in zip(batch_ids, route_ids) + ] + }, + _source=False, + ) + return {doc["_id"] for doc in existing_docs["docs"] if doc["found"]} + except Exception as e: + logger.error(f"Error fetching batch {batch_ids}: {e}") + return set() + + if ids is None: + return texts, metadatas, ids + + if len(texts) != len(ids): + raise RuntimeError(f"texts {len(texts)} != {ids}") + + filtered_texts = [] + filtered_metadatas = [] + filtered_ids = [] + + def batch(iterable, n): + length = len(iterable) + for idx in range(0, length, n): + yield iterable[idx : min(idx + n, length)] + + for ids_batch, texts_batch, metadatas_batch in zip( + batch(ids, bulk_size), + batch(texts, bulk_size), + batch(metadatas, bulk_size) if metadatas is not None else batch([None] * len(ids), bulk_size), + ): + existing_ids_set = __fetch_existing_ids(ids_batch) + for text, metadata, doc_id in zip(texts_batch, metadatas_batch, ids_batch): + if doc_id not in existing_ids_set: + filtered_texts.append(text) + filtered_ids.append(doc_id) + if metadatas is not None: + filtered_metadatas.append(metadata) + + return filtered_texts, metadatas if metadatas is None else filtered_metadatas, filtered_ids + + def add_texts(self, documents: list[Document], embeddings: list[list[float]], **kwargs): + actions = [] + uuids = self._get_uuids(documents) + for i in range(len(documents)): + action = { + "_op_type": "index", + "_index": self._collection_name.lower(), + "_id": uuids[i], + "_source": { + Field.CONTENT_KEY.value: documents[i].page_content, + Field.VECTOR.value: embeddings[i], # Make sure you pass an array here + Field.METADATA_KEY.value: documents[i].metadata, + }, + } + actions.append(action) + bulk(self._client, actions) + self.refresh() + + def get_ids_by_metadata_field(self, key: str, value: str): + query = {"query": {"term": {f"{Field.METADATA_KEY.value}.{key}.keyword": value}}} + response = self._client.search(index=self._collection_name, body=query) + if response["hits"]["hits"]: + return [hit["_id"] for hit in response["hits"]["hits"]] + else: + return None + + def delete_by_metadata_field(self, key: str, value: str): + query_str = {"query": {"match": {f"metadata.{key}": f"{value}"}}} + results = self._client.search(index=self._collection_name, body=query_str) + ids = [hit["_id"] for hit in results["hits"]["hits"]] + if ids: + self.delete_by_ids(ids) + + def delete_by_ids(self, ids: list[str]) -> None: + for id in ids: + if self._client.exists(index=self._collection_name, id=id): + self._client.delete(index=self._collection_name, id=id) + else: + logger.warning(f"DELETE BY ID: ID {id} does not exist in the index.") + + def delete(self) -> None: + try: + if self._client.indices.exists(index=self._collection_name): + self._client.indices.delete(index=self._collection_name, params={"timeout": 60}) + logger.info("Delete index success") + else: + logger.warning(f"Index '{self._collection_name}' does not exist. No deletion performed.") + except Exception as e: + logger.error(f"Error occurred while deleting the index: {e}") + raise e + + def text_exists(self, id: str) -> bool: + try: + self._client.get(index=self._collection_name, id=id) + return True + except: + return False + + def search_by_vector(self, query_vector: list[float], **kwargs: Any) -> list[Document]: + # Make sure query_vector is a list + if not isinstance(query_vector, list): + raise ValueError("query_vector should be a list of floats") + + # Check whether query_vector is a floating-point number list + if not all(isinstance(x, float) for x in query_vector): + raise ValueError("All elements in query_vector should be floats") + + top_k = kwargs.get("top_k", 10) + query = default_vector_search_query(query_vector=query_vector, k=top_k, **kwargs) + try: + response = self._client.search(index=self._collection_name, body=query) + except Exception as e: + logger.error(f"Error executing search: {e}") + raise + + docs_and_scores = [] + for hit in response["hits"]["hits"]: + docs_and_scores.append( + ( + Document( + page_content=hit["_source"][Field.CONTENT_KEY.value], + vector=hit["_source"][Field.VECTOR.value], + metadata=hit["_source"][Field.METADATA_KEY.value], + ), + hit["_score"], + ) + ) + docs = [] + for doc, score in docs_and_scores: + score_threshold = kwargs.get("score_threshold", 0.0) or 0.0 + if score > score_threshold: + doc.metadata["score"] = score + docs.append(doc) + + return docs + + def search_by_full_text(self, query: str, **kwargs: Any) -> list[Document]: + must = kwargs.get("must") + must_not = kwargs.get("must_not") + should = kwargs.get("should") + minimum_should_match = kwargs.get("minimum_should_match", 0) + top_k = kwargs.get("top_k", 10) + filters = kwargs.get("filter") + routing = kwargs.get("routing") + full_text_query = default_text_search_query( + query_text=query, + k=top_k, + text_field=Field.CONTENT_KEY.value, + must=must, + must_not=must_not, + should=should, + minimum_should_match=minimum_should_match, + filters=filters, + routing=routing, + ) + response = self._client.search(index=self._collection_name, body=full_text_query) + docs = [] + for hit in response["hits"]["hits"]: + docs.append( + Document( + page_content=hit["_source"][Field.CONTENT_KEY.value], + vector=hit["_source"][Field.VECTOR.value], + metadata=hit["_source"][Field.METADATA_KEY.value], + ) + ) + + return docs + + def create_collection(self, dimension: int, **kwargs): + lock_name = f"vector_indexing_lock_{self._collection_name}" + with redis_client.lock(lock_name, timeout=20): + collection_exist_cache_key = f"vector_indexing_{self._collection_name}" + if redis_client.get(collection_exist_cache_key): + logger.info(f"Collection {self._collection_name} already exists.") + return + if self._client.indices.exists(index=self._collection_name): + logger.info("{self._collection_name.lower()} already exists.") + return + if len(self.kwargs) == 0 and len(kwargs) != 0: + self.kwargs = copy.deepcopy(kwargs) + vector_field = kwargs.pop("vector_field", Field.VECTOR.value) + shards = kwargs.pop("shards", 2) + + engine = kwargs.pop("engine", "lvector") + method_name = kwargs.pop("method_name", "hnsw") + data_type = kwargs.pop("data_type", "float") + space_type = kwargs.pop("space_type", "cosinesimil") + + hnsw_m = kwargs.pop("hnsw_m", 24) + hnsw_ef_construction = kwargs.pop("hnsw_ef_construction", 500) + ivfpq_m = kwargs.pop("ivfpq_m", dimension) + nlist = kwargs.pop("nlist", 1000) + centroids_use_hnsw = kwargs.pop("centroids_use_hnsw", True if nlist >= 5000 else False) + centroids_hnsw_m = kwargs.pop("centroids_hnsw_m", 24) + centroids_hnsw_ef_construct = kwargs.pop("centroids_hnsw_ef_construct", 500) + centroids_hnsw_ef_search = kwargs.pop("centroids_hnsw_ef_search", 100) + mapping = default_text_mapping( + dimension, + method_name, + shards=shards, + engine=engine, + data_type=data_type, + space_type=space_type, + vector_field=vector_field, + hnsw_m=hnsw_m, + hnsw_ef_construction=hnsw_ef_construction, + nlist=nlist, + ivfpq_m=ivfpq_m, + centroids_use_hnsw=centroids_use_hnsw, + centroids_hnsw_m=centroids_hnsw_m, + centroids_hnsw_ef_construct=centroids_hnsw_ef_construct, + centroids_hnsw_ef_search=centroids_hnsw_ef_search, + **kwargs, + ) + self._client.indices.create(index=self._collection_name.lower(), body=mapping) + redis_client.set(collection_exist_cache_key, 1, ex=3600) + # logger.info(f"create index success: {self._collection_name}") + + +def default_text_mapping(dimension: int, method_name: str, **kwargs: Any) -> dict: + routing_field = kwargs.get("routing_field") + excludes_from_source = kwargs.get("excludes_from_source") + analyzer = kwargs.get("analyzer", "ik_max_word") + text_field = kwargs.get("text_field", Field.CONTENT_KEY.value) + engine = kwargs["engine"] + shard = kwargs["shards"] + space_type = kwargs["space_type"] + data_type = kwargs["data_type"] + vector_field = kwargs.get("vector_field", Field.VECTOR.value) + + if method_name == "ivfpq": + ivfpq_m = kwargs["ivfpq_m"] + nlist = kwargs["nlist"] + centroids_use_hnsw = True if nlist > 10000 else False + centroids_hnsw_m = 24 + centroids_hnsw_ef_construct = 500 + centroids_hnsw_ef_search = 100 + parameters = { + "m": ivfpq_m, + "nlist": nlist, + "centroids_use_hnsw": centroids_use_hnsw, + "centroids_hnsw_m": centroids_hnsw_m, + "centroids_hnsw_ef_construct": centroids_hnsw_ef_construct, + "centroids_hnsw_ef_search": centroids_hnsw_ef_search, + } + elif method_name == "hnsw": + neighbor = kwargs["hnsw_m"] + ef_construction = kwargs["hnsw_ef_construction"] + parameters = {"m": neighbor, "ef_construction": ef_construction} + elif method_name == "flat": + parameters = {} + else: + raise RuntimeError(f"unexpected method_name: {method_name}") + + mapping = { + "settings": {"index": {"number_of_shards": shard, "knn": True}}, + "mappings": { + "properties": { + vector_field: { + "type": "knn_vector", + "dimension": dimension, + "data_type": data_type, + "method": { + "engine": engine, + "name": method_name, + "space_type": space_type, + "parameters": parameters, + }, + }, + text_field: {"type": "text", "analyzer": analyzer}, + } + }, + } + + if excludes_from_source: + mapping["mappings"]["_source"] = {"excludes": excludes_from_source} # e.g. {"excludes": ["vector_field"]} + + if method_name == "ivfpq" and routing_field is not None: + mapping["settings"]["index"]["knn_routing"] = True + mapping["settings"]["index"]["knn.offline.construction"] = True + + if method_name == "flat" and routing_field is not None: + mapping["settings"]["index"]["knn_routing"] = True + + return mapping + + +def default_text_search_query( + query_text: str, + k: int = 4, + text_field: str = Field.CONTENT_KEY.value, + must: Optional[list[dict]] = None, + must_not: Optional[list[dict]] = None, + should: Optional[list[dict]] = None, + minimum_should_match: int = 0, + filters: Optional[list[dict]] = None, + routing: Optional[str] = None, + **kwargs, +) -> dict: + if routing is not None: + routing_field = kwargs.get("routing_field", "routing_field") + query_clause = { + "bool": { + "must": [{"match": {text_field: query_text}}, {"term": {f"metadata.{routing_field}.keyword": routing}}] + } + } + else: + query_clause = {"match": {text_field: query_text}} + # build the simplest search_query when only query_text is specified + if not must and not must_not and not should and not filters: + search_query = {"size": k, "query": query_clause} + return search_query + + # build complex search_query when either of must/must_not/should/filter is specified + if must: + if not isinstance(must, list): + raise RuntimeError(f"unexpected [must] clause with {type(filters)}") + if query_clause not in must: + must.append(query_clause) + else: + must = [query_clause] + + boolean_query = {"must": must} + + if must_not: + if not isinstance(must_not, list): + raise RuntimeError(f"unexpected [must_not] clause with {type(filters)}") + boolean_query["must_not"] = must_not + + if should: + if not isinstance(should, list): + raise RuntimeError(f"unexpected [should] clause with {type(filters)}") + boolean_query["should"] = should + if minimum_should_match != 0: + boolean_query["minimum_should_match"] = minimum_should_match + + if filters: + if not isinstance(filters, list): + raise RuntimeError(f"unexpected [filter] clause with {type(filters)}") + boolean_query["filter"] = filters + + search_query = {"size": k, "query": {"bool": boolean_query}} + return search_query + + +def default_vector_search_query( + query_vector: list[float], + k: int = 4, + min_score: str = "0.0", + ef_search: Optional[str] = None, # only for hnsw + nprobe: Optional[str] = None, # "2000" + reorder_factor: Optional[str] = None, # "20" + client_refactor: Optional[str] = None, # "true" + vector_field: str = Field.VECTOR.value, + filters: Optional[list[dict]] = None, + filter_type: Optional[str] = None, + **kwargs, +) -> dict: + if filters is not None: + filter_type = "post_filter" if filter_type is None else filter_type + if not isinstance(filter, list): + raise RuntimeError(f"unexpected filter with {type(filters)}") + final_ext = {"lvector": {}} + if min_score != "0.0": + final_ext["lvector"]["min_score"] = min_score + if ef_search: + final_ext["lvector"]["ef_search"] = ef_search + if nprobe: + final_ext["lvector"]["nprobe"] = nprobe + if reorder_factor: + final_ext["lvector"]["reorder_factor"] = reorder_factor + if client_refactor: + final_ext["lvector"]["client_refactor"] = client_refactor + + search_query = { + "size": k, + "_source": True, # force return '_source' + "query": {"knn": {vector_field: {"vector": query_vector, "k": k}}}, + } + + if filters is not None: + # when using filter, transform filter from List[Dict] to Dict as valid format + filters = {"bool": {"must": filters}} if len(filters) > 1 else filters[0] + search_query["query"]["knn"][vector_field]["filter"] = filters # filter should be Dict + if filter_type: + final_ext["lvector"]["filter_type"] = filter_type + + if final_ext != {"lvector": {}}: + search_query["ext"] = final_ext + return search_query + + +class LindormVectorStoreFactory(AbstractVectorFactory): + def init_vector(self, dataset: Dataset, attributes: list, embeddings: Embeddings) -> LindormVectorStore: + if dataset.index_struct_dict: + class_prefix: str = dataset.index_struct_dict["vector_store"]["class_prefix"] + collection_name = class_prefix + else: + dataset_id = dataset.id + collection_name = Dataset.gen_collection_name_by_id(dataset_id) + dataset.index_struct = json.dumps(self.gen_index_struct_dict(VectorType.LINDORM, collection_name)) + lindorm_config = LindormVectorStoreConfig( + hosts=dify_config.LINDORM_URL, + username=dify_config.LINDORM_USERNAME, + password=dify_config.LINDORM_PASSWORD, + ) + return LindormVectorStore(collection_name, lindorm_config) diff --git a/api/core/rag/datasource/vdb/vector_factory.py b/api/core/rag/datasource/vdb/vector_factory.py index c8cb007ae8..6d2e04fc02 100644 --- a/api/core/rag/datasource/vdb/vector_factory.py +++ b/api/core/rag/datasource/vdb/vector_factory.py @@ -134,6 +134,10 @@ class Vector: from core.rag.datasource.vdb.tidb_on_qdrant.tidb_on_qdrant_vector import TidbOnQdrantVectorFactory return TidbOnQdrantVectorFactory + case VectorType.LINDORM: + from core.rag.datasource.vdb.lindorm.lindorm_vector import LindormVectorStoreFactory + + return LindormVectorStoreFactory case VectorType.OCEANBASE: from core.rag.datasource.vdb.oceanbase.oceanbase_vector import OceanBaseVectorFactory diff --git a/api/core/rag/datasource/vdb/vector_type.py b/api/core/rag/datasource/vdb/vector_type.py index e3b37ece88..8e53e3ae84 100644 --- a/api/core/rag/datasource/vdb/vector_type.py +++ b/api/core/rag/datasource/vdb/vector_type.py @@ -16,6 +16,7 @@ class VectorType(str, Enum): TENCENT = "tencent" ORACLE = "oracle" ELASTICSEARCH = "elasticsearch" + LINDORM = "lindorm" COUCHBASE = "couchbase" BAIDU = "baidu" VIKINGDB = "vikingdb" diff --git a/api/tests/integration_tests/vdb/lindorm/__init__.py b/api/tests/integration_tests/vdb/lindorm/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/api/tests/integration_tests/vdb/lindorm/test_lindorm.py b/api/tests/integration_tests/vdb/lindorm/test_lindorm.py new file mode 100644 index 0000000000..f8f43ba6ef --- /dev/null +++ b/api/tests/integration_tests/vdb/lindorm/test_lindorm.py @@ -0,0 +1,35 @@ +import environs + +from core.rag.datasource.vdb.lindorm.lindorm_vector import LindormVectorStore, LindormVectorStoreConfig +from tests.integration_tests.vdb.test_vector_store import AbstractVectorTest, setup_mock_redis + +env = environs.Env() + + +class Config: + SEARCH_ENDPOINT = env.str("SEARCH_ENDPOINT", "http://ld-*************-proxy-search-pub.lindorm.aliyuncs.com:30070") + SEARCH_USERNAME = env.str("SEARCH_USERNAME", "ADMIN") + SEARCH_PWD = env.str("SEARCH_PWD", "PWD") + + +class TestLindormVectorStore(AbstractVectorTest): + def __init__(self): + super().__init__() + self.vector = LindormVectorStore( + collection_name=self.collection_name, + config=LindormVectorStoreConfig( + hosts=Config.SEARCH_ENDPOINT, + username=Config.SEARCH_USERNAME, + password=Config.SEARCH_PWD, + ), + ) + + def get_ids_by_metadata_field(self): + ids = self.vector.get_ids_by_metadata_field(key="doc_id", value=self.example_doc_id) + assert ids is not None + assert len(ids) == 1 + assert ids[0] == self.example_doc_id + + +def test_lindorm_vector(setup_mock_redis): + TestLindormVectorStore().run_all_tests() diff --git a/docker/.env.example b/docker/.env.example index 34b2136302..5b82d62d7b 100644 --- a/docker/.env.example +++ b/docker/.env.example @@ -222,7 +222,6 @@ REDIS_PORT=6379 REDIS_USERNAME= REDIS_PASSWORD=difyai123456 REDIS_USE_SSL=false -REDIS_DB=0 # Whether to use Redis Sentinel mode. # If set to true, the application will automatically discover and connect to the master node through Sentinel. @@ -531,6 +530,12 @@ VIKINGDB_SCHEMA=http VIKINGDB_CONNECTION_TIMEOUT=30 VIKINGDB_SOCKET_TIMEOUT=30 + +# Lindorm configuration, only available when VECTOR_STORE is `lindorm` +LINDORM_URL=http://ld-***************-proxy-search-pub.lindorm.aliyuncs.com:30070 +LINDORM_USERNAME=username +LINDORM_PASSWORD=password + # OceanBase Vector configuration, only available when VECTOR_STORE is `oceanbase` OCEANBASE_VECTOR_HOST=oceanbase-vector OCEANBASE_VECTOR_PORT=2881 @@ -645,7 +650,6 @@ MAIL_DEFAULT_SEND_FROM= # API-Key for the Resend email provider, used when MAIL_TYPE is `resend`. RESEND_API_KEY=your-resend-api-key -RESEND_API_URL=https://api.resend.com # SMTP server configuration, used when MAIL_TYPE is `smtp` SMTP_SERVER= diff --git a/docker/docker-compose.yaml b/docker/docker-compose.yaml index 112e9a2702..12cdf25e70 100644 --- a/docker/docker-compose.yaml +++ b/docker/docker-compose.yaml @@ -167,6 +167,9 @@ x-shared-env: &shared-api-worker-env ELASTICSEARCH_PORT: ${ELASTICSEARCH_PORT:-9200} ELASTICSEARCH_USERNAME: ${ELASTICSEARCH_USERNAME:-elastic} ELASTICSEARCH_PASSWORD: ${ELASTICSEARCH_PASSWORD:-elastic} + LINDORM_URL: ${LINDORM_URL:-http://lindorm:30070} + LINDORM_USERNAME: ${LINDORM_USERNAME:-lindorm} + LINDORM_PASSWORD: ${LINDORM_USERNAME:-lindorm } KIBANA_PORT: ${KIBANA_PORT:-5601} # AnalyticDB configuration ANALYTICDB_KEY_ID: ${ANALYTICDB_KEY_ID:-} From 8ab05d4c36b4720dc3f1f654564745f47c5034cd Mon Sep 17 00:00:00 2001 From: Hanqing Zhao Date: Mon, 4 Nov 2024 09:11:15 +0800 Subject: [PATCH 18/73] Modify translation (#10213) --- web/i18n/ja-JP/app.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/web/i18n/ja-JP/app.ts b/web/i18n/ja-JP/app.ts index 76c7d1c4f4..48a35c61af 100644 --- a/web/i18n/ja-JP/app.ts +++ b/web/i18n/ja-JP/app.ts @@ -39,10 +39,10 @@ const translation = { workflowWarning: '現在ベータ版です', chatbotType: 'チャットボットのオーケストレーション方法', basic: '基本', - basicTip: '初心者向け。後で Chatflow に切り替えることができます', + basicTip: '初心者向け。後で「チャットフロー」に切り替えることができます', basicFor: '初心者向け', basicDescription: '基本オーケストレートは、組み込みのプロンプトを変更する機能がなく、簡単な設定を使用してチャットボット アプリをオーケストレートします。初心者向けです。', - advanced: 'Chatflow', + advanced: 'チャットフロー', advancedFor: '上級ユーザー向け', advancedDescription: 'ワークフロー オーケストレートは、ワークフロー形式でチャットボットをオーケストレートし、組み込みのプロンプトを編集する機能を含む高度なカスタマイズを提供します。経験豊富なユーザー向けです。', captionName: 'アプリのアイコンと名前', From 1024fc623efd19389742c5c1afa49ebf0a35a342 Mon Sep 17 00:00:00 2001 From: Jyong <76649700+JohnJyong@users.noreply.github.com> Date: Mon, 4 Nov 2024 15:22:07 +0800 Subject: [PATCH 19/73] fix the ssrf of docx file extractor external images (#10237) --- api/core/rag/extractor/word_extractor.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/api/core/rag/extractor/word_extractor.py b/api/core/rag/extractor/word_extractor.py index ae3c25125c..d4434ea28f 100644 --- a/api/core/rag/extractor/word_extractor.py +++ b/api/core/rag/extractor/word_extractor.py @@ -14,6 +14,7 @@ import requests from docx import Document as DocxDocument from configs import dify_config +from core.helper import ssrf_proxy from core.rag.extractor.extractor_base import BaseExtractor from core.rag.models.document import Document from extensions.ext_database import db @@ -86,7 +87,7 @@ class WordExtractor(BaseExtractor): image_count += 1 if rel.is_external: url = rel.reltype - response = requests.get(url, stream=True) + response = ssrf_proxy.get(url, stream=True) if response.status_code == 200: image_ext = mimetypes.guess_extension(response.headers["Content-Type"]) file_uuid = str(uuid.uuid4()) From 8b5ea399168e957e737dd62375d592de34dbf3df Mon Sep 17 00:00:00 2001 From: -LAN- Date: Mon, 4 Nov 2024 15:22:31 +0800 Subject: [PATCH 20/73] chore(llm_node): remove unnecessary type ignore for context assignment (#10216) --- api/core/workflow/nodes/llm/node.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/core/workflow/nodes/llm/node.py b/api/core/workflow/nodes/llm/node.py index b4728e6abf..bb9290ddc2 100644 --- a/api/core/workflow/nodes/llm/node.py +++ b/api/core/workflow/nodes/llm/node.py @@ -103,7 +103,7 @@ class LLMNode(BaseNode[LLMNodeData]): yield event if context: - node_inputs["#context#"] = context # type: ignore + node_inputs["#context#"] = context # fetch model config model_instance, model_config = self._fetch_model_config(self.node_data.model) From be96f6e62db1152ca14cd2ab70bd9327907cd9bc Mon Sep 17 00:00:00 2001 From: -LAN- Date: Mon, 4 Nov 2024 15:22:41 +0800 Subject: [PATCH 21/73] refactor(workflow): introduce specific exceptions for code validation (#10218) --- api/core/workflow/nodes/code/code_node.py | 46 +++++++++++++---------- api/core/workflow/nodes/code/exc.py | 16 ++++++++ 2 files changed, 42 insertions(+), 20 deletions(-) create mode 100644 api/core/workflow/nodes/code/exc.py diff --git a/api/core/workflow/nodes/code/code_node.py b/api/core/workflow/nodes/code/code_node.py index 9d7d9027c3..de70af58dd 100644 --- a/api/core/workflow/nodes/code/code_node.py +++ b/api/core/workflow/nodes/code/code_node.py @@ -12,6 +12,12 @@ from core.workflow.nodes.code.entities import CodeNodeData from core.workflow.nodes.enums import NodeType from models.workflow import WorkflowNodeExecutionStatus +from .exc import ( + CodeNodeError, + DepthLimitError, + OutputValidationError, +) + class CodeNode(BaseNode[CodeNodeData]): _node_data_cls = CodeNodeData @@ -60,7 +66,7 @@ class CodeNode(BaseNode[CodeNodeData]): # Transform result result = self._transform_result(result, self.node_data.outputs) - except (CodeExecutionError, ValueError) as e: + except (CodeExecutionError, CodeNodeError) as e: return NodeRunResult(status=WorkflowNodeExecutionStatus.FAILED, inputs=variables, error=str(e)) return NodeRunResult(status=WorkflowNodeExecutionStatus.SUCCEEDED, inputs=variables, outputs=result) @@ -76,10 +82,10 @@ class CodeNode(BaseNode[CodeNodeData]): if value is None: return None else: - raise ValueError(f"Output variable `{variable}` must be a string") + raise OutputValidationError(f"Output variable `{variable}` must be a string") if len(value) > dify_config.CODE_MAX_STRING_LENGTH: - raise ValueError( + raise OutputValidationError( f"The length of output variable `{variable}` must be" f" less than {dify_config.CODE_MAX_STRING_LENGTH} characters" ) @@ -97,10 +103,10 @@ class CodeNode(BaseNode[CodeNodeData]): if value is None: return None else: - raise ValueError(f"Output variable `{variable}` must be a number") + raise OutputValidationError(f"Output variable `{variable}` must be a number") if value > dify_config.CODE_MAX_NUMBER or value < dify_config.CODE_MIN_NUMBER: - raise ValueError( + raise OutputValidationError( f"Output variable `{variable}` is out of range," f" it must be between {dify_config.CODE_MIN_NUMBER} and {dify_config.CODE_MAX_NUMBER}." ) @@ -108,7 +114,7 @@ class CodeNode(BaseNode[CodeNodeData]): if isinstance(value, float): # raise error if precision is too high if len(str(value).split(".")[1]) > dify_config.CODE_MAX_PRECISION: - raise ValueError( + raise OutputValidationError( f"Output variable `{variable}` has too high precision," f" it must be less than {dify_config.CODE_MAX_PRECISION} digits." ) @@ -125,7 +131,7 @@ class CodeNode(BaseNode[CodeNodeData]): :return: """ if depth > dify_config.CODE_MAX_DEPTH: - raise ValueError(f"Depth limit ${dify_config.CODE_MAX_DEPTH} reached, object too deep.") + raise DepthLimitError(f"Depth limit ${dify_config.CODE_MAX_DEPTH} reached, object too deep.") transformed_result = {} if output_schema is None: @@ -177,14 +183,14 @@ class CodeNode(BaseNode[CodeNodeData]): depth=depth + 1, ) else: - raise ValueError( + raise OutputValidationError( f"Output {prefix}.{output_name} is not a valid array." f" make sure all elements are of the same type." ) elif output_value is None: pass else: - raise ValueError(f"Output {prefix}.{output_name} is not a valid type.") + raise OutputValidationError(f"Output {prefix}.{output_name} is not a valid type.") return result @@ -192,7 +198,7 @@ class CodeNode(BaseNode[CodeNodeData]): for output_name, output_config in output_schema.items(): dot = "." if prefix else "" if output_name not in result: - raise ValueError(f"Output {prefix}{dot}{output_name} is missing.") + raise OutputValidationError(f"Output {prefix}{dot}{output_name} is missing.") if output_config.type == "object": # check if output is object @@ -200,7 +206,7 @@ class CodeNode(BaseNode[CodeNodeData]): if isinstance(result.get(output_name), type(None)): transformed_result[output_name] = None else: - raise ValueError( + raise OutputValidationError( f"Output {prefix}{dot}{output_name} is not an object," f" got {type(result.get(output_name))} instead." ) @@ -228,13 +234,13 @@ class CodeNode(BaseNode[CodeNodeData]): if isinstance(result[output_name], type(None)): transformed_result[output_name] = None else: - raise ValueError( + raise OutputValidationError( f"Output {prefix}{dot}{output_name} is not an array," f" got {type(result.get(output_name))} instead." ) else: if len(result[output_name]) > dify_config.CODE_MAX_NUMBER_ARRAY_LENGTH: - raise ValueError( + raise OutputValidationError( f"The length of output variable `{prefix}{dot}{output_name}` must be" f" less than {dify_config.CODE_MAX_NUMBER_ARRAY_LENGTH} elements." ) @@ -249,13 +255,13 @@ class CodeNode(BaseNode[CodeNodeData]): if isinstance(result[output_name], type(None)): transformed_result[output_name] = None else: - raise ValueError( + raise OutputValidationError( f"Output {prefix}{dot}{output_name} is not an array," f" got {type(result.get(output_name))} instead." ) else: if len(result[output_name]) > dify_config.CODE_MAX_STRING_ARRAY_LENGTH: - raise ValueError( + raise OutputValidationError( f"The length of output variable `{prefix}{dot}{output_name}` must be" f" less than {dify_config.CODE_MAX_STRING_ARRAY_LENGTH} elements." ) @@ -270,13 +276,13 @@ class CodeNode(BaseNode[CodeNodeData]): if isinstance(result[output_name], type(None)): transformed_result[output_name] = None else: - raise ValueError( + raise OutputValidationError( f"Output {prefix}{dot}{output_name} is not an array," f" got {type(result.get(output_name))} instead." ) else: if len(result[output_name]) > dify_config.CODE_MAX_OBJECT_ARRAY_LENGTH: - raise ValueError( + raise OutputValidationError( f"The length of output variable `{prefix}{dot}{output_name}` must be" f" less than {dify_config.CODE_MAX_OBJECT_ARRAY_LENGTH} elements." ) @@ -286,7 +292,7 @@ class CodeNode(BaseNode[CodeNodeData]): if value is None: pass else: - raise ValueError( + raise OutputValidationError( f"Output {prefix}{dot}{output_name}[{i}] is not an object," f" got {type(value)} instead at index {i}." ) @@ -303,13 +309,13 @@ class CodeNode(BaseNode[CodeNodeData]): for i, value in enumerate(result[output_name]) ] else: - raise ValueError(f"Output type {output_config.type} is not supported.") + raise OutputValidationError(f"Output type {output_config.type} is not supported.") parameters_validated[output_name] = True # check if all output parameters are validated if len(parameters_validated) != len(result): - raise ValueError("Not all output parameters are validated.") + raise CodeNodeError("Not all output parameters are validated.") return transformed_result diff --git a/api/core/workflow/nodes/code/exc.py b/api/core/workflow/nodes/code/exc.py new file mode 100644 index 0000000000..d6334fd554 --- /dev/null +++ b/api/core/workflow/nodes/code/exc.py @@ -0,0 +1,16 @@ +class CodeNodeError(ValueError): + """Base class for code node errors.""" + + pass + + +class OutputValidationError(CodeNodeError): + """Raised when there is an output validation error.""" + + pass + + +class DepthLimitError(CodeNodeError): + """Raised when the depth limit is reached.""" + + pass From 2adab7f71a9052b153f338ce7b921ac2ec1aa41e Mon Sep 17 00:00:00 2001 From: -LAN- Date: Mon, 4 Nov 2024 15:22:50 +0800 Subject: [PATCH 22/73] refactor(http_request): add custom exception handling for HTTP request nodes (#10219) --- api/core/workflow/nodes/http_request/exc.py | 18 +++++++++++++++++ .../workflow/nodes/http_request/executor.py | 20 ++++++++++++------- api/core/workflow/nodes/http_request/node.py | 3 ++- 3 files changed, 33 insertions(+), 8 deletions(-) create mode 100644 api/core/workflow/nodes/http_request/exc.py diff --git a/api/core/workflow/nodes/http_request/exc.py b/api/core/workflow/nodes/http_request/exc.py new file mode 100644 index 0000000000..7a5ab7dbc1 --- /dev/null +++ b/api/core/workflow/nodes/http_request/exc.py @@ -0,0 +1,18 @@ +class HttpRequestNodeError(ValueError): + """Custom error for HTTP request node.""" + + +class AuthorizationConfigError(HttpRequestNodeError): + """Raised when authorization config is missing or invalid.""" + + +class FileFetchError(HttpRequestNodeError): + """Raised when a file cannot be fetched.""" + + +class InvalidHttpMethodError(HttpRequestNodeError): + """Raised when an invalid HTTP method is used.""" + + +class ResponseSizeError(HttpRequestNodeError): + """Raised when the response size exceeds the allowed threshold.""" diff --git a/api/core/workflow/nodes/http_request/executor.py b/api/core/workflow/nodes/http_request/executor.py index 6872478299..6204fc2644 100644 --- a/api/core/workflow/nodes/http_request/executor.py +++ b/api/core/workflow/nodes/http_request/executor.py @@ -18,6 +18,12 @@ from .entities import ( HttpRequestNodeTimeout, Response, ) +from .exc import ( + AuthorizationConfigError, + FileFetchError, + InvalidHttpMethodError, + ResponseSizeError, +) BODY_TYPE_TO_CONTENT_TYPE = { "json": "application/json", @@ -51,7 +57,7 @@ class Executor: # If authorization API key is present, convert the API key using the variable pool if node_data.authorization.type == "api-key": if node_data.authorization.config is None: - raise ValueError("authorization config is required") + raise AuthorizationConfigError("authorization config is required") node_data.authorization.config.api_key = variable_pool.convert_template( node_data.authorization.config.api_key ).text @@ -116,7 +122,7 @@ class Executor: file_selector = data[0].file file_variable = self.variable_pool.get_file(file_selector) if file_variable is None: - raise ValueError(f"cannot fetch file with selector {file_selector}") + raise FileFetchError(f"cannot fetch file with selector {file_selector}") file = file_variable.value self.content = file_manager.download(file) case "x-www-form-urlencoded": @@ -155,12 +161,12 @@ class Executor: headers = deepcopy(self.headers) or {} if self.auth.type == "api-key": if self.auth.config is None: - raise ValueError("self.authorization config is required") + raise AuthorizationConfigError("self.authorization config is required") if authorization.config is None: - raise ValueError("authorization config is required") + raise AuthorizationConfigError("authorization config is required") if self.auth.config.api_key is None: - raise ValueError("api_key is required") + raise AuthorizationConfigError("api_key is required") if not authorization.config.header: authorization.config.header = "Authorization" @@ -183,7 +189,7 @@ class Executor: else dify_config.HTTP_REQUEST_NODE_MAX_TEXT_SIZE ) if executor_response.size > threshold_size: - raise ValueError( + raise ResponseSizeError( f'{"File" if executor_response.is_file else "Text"} size is too large,' f' max size is {threshold_size / 1024 / 1024:.2f} MB,' f' but current size is {executor_response.readable_size}.' @@ -196,7 +202,7 @@ class Executor: do http request depending on api bundle """ if self.method not in {"get", "head", "post", "put", "delete", "patch"}: - raise ValueError(f"Invalid http method {self.method}") + raise InvalidHttpMethodError(f"Invalid http method {self.method}") request_args = { "url": self.url, diff --git a/api/core/workflow/nodes/http_request/node.py b/api/core/workflow/nodes/http_request/node.py index a037bee665..61c661e587 100644 --- a/api/core/workflow/nodes/http_request/node.py +++ b/api/core/workflow/nodes/http_request/node.py @@ -20,6 +20,7 @@ from .entities import ( HttpRequestNodeTimeout, Response, ) +from .exc import HttpRequestNodeError HTTP_REQUEST_DEFAULT_TIMEOUT = HttpRequestNodeTimeout( connect=dify_config.HTTP_REQUEST_MAX_CONNECT_TIMEOUT, @@ -77,7 +78,7 @@ class HttpRequestNode(BaseNode[HttpRequestNodeData]): "request": http_executor.to_log(), }, ) - except Exception as e: + except HttpRequestNodeError as e: logger.warning(f"http request node {self.node_id} failed to run: {e}") return NodeRunResult( status=WorkflowNodeExecutionStatus.FAILED, From 38bca6731c64dfea33fba62a5e71a70504479d8c Mon Sep 17 00:00:00 2001 From: -LAN- Date: Mon, 4 Nov 2024 15:22:58 +0800 Subject: [PATCH 23/73] refactor(workflow): introduce specific error handling for LLM nodes (#10221) --- api/core/workflow/nodes/llm/exc.py | 26 +++++++++++++++++++++++ api/core/workflow/nodes/llm/node.py | 33 ++++++++++++++++++----------- 2 files changed, 47 insertions(+), 12 deletions(-) create mode 100644 api/core/workflow/nodes/llm/exc.py diff --git a/api/core/workflow/nodes/llm/exc.py b/api/core/workflow/nodes/llm/exc.py new file mode 100644 index 0000000000..f858be2515 --- /dev/null +++ b/api/core/workflow/nodes/llm/exc.py @@ -0,0 +1,26 @@ +class LLMNodeError(ValueError): + """Base class for LLM Node errors.""" + + +class VariableNotFoundError(LLMNodeError): + """Raised when a required variable is not found.""" + + +class InvalidContextStructureError(LLMNodeError): + """Raised when the context structure is invalid.""" + + +class InvalidVariableTypeError(LLMNodeError): + """Raised when the variable type is invalid.""" + + +class ModelNotExistError(LLMNodeError): + """Raised when the specified model does not exist.""" + + +class LLMModeRequiredError(LLMNodeError): + """Raised when LLM mode is required but not provided.""" + + +class NoPromptFoundError(LLMNodeError): + """Raised when no prompt is found in the LLM configuration.""" diff --git a/api/core/workflow/nodes/llm/node.py b/api/core/workflow/nodes/llm/node.py index bb9290ddc2..47b0e25d9c 100644 --- a/api/core/workflow/nodes/llm/node.py +++ b/api/core/workflow/nodes/llm/node.py @@ -56,6 +56,15 @@ from .entities import ( LLMNodeData, ModelConfig, ) +from .exc import ( + InvalidContextStructureError, + InvalidVariableTypeError, + LLMModeRequiredError, + LLMNodeError, + ModelNotExistError, + NoPromptFoundError, + VariableNotFoundError, +) if TYPE_CHECKING: from core.file.models import File @@ -115,7 +124,7 @@ class LLMNode(BaseNode[LLMNodeData]): if self.node_data.memory: query = self.graph_runtime_state.variable_pool.get((SYSTEM_VARIABLE_NODE_ID, SystemVariableKey.QUERY)) if not query: - raise ValueError("Query not found") + raise VariableNotFoundError("Query not found") query = query.text else: query = None @@ -161,7 +170,7 @@ class LLMNode(BaseNode[LLMNodeData]): usage = event.usage finish_reason = event.finish_reason break - except Exception as e: + except LLMNodeError as e: yield RunCompletedEvent( run_result=NodeRunResult( status=WorkflowNodeExecutionStatus.FAILED, @@ -275,7 +284,7 @@ class LLMNode(BaseNode[LLMNodeData]): variable_name = variable_selector.variable variable = self.graph_runtime_state.variable_pool.get(variable_selector.value_selector) if variable is None: - raise ValueError(f"Variable {variable_selector.variable} not found") + raise VariableNotFoundError(f"Variable {variable_selector.variable} not found") def parse_dict(input_dict: Mapping[str, Any]) -> str: """ @@ -325,7 +334,7 @@ class LLMNode(BaseNode[LLMNodeData]): for variable_selector in variable_selectors: variable = self.graph_runtime_state.variable_pool.get(variable_selector.value_selector) if variable is None: - raise ValueError(f"Variable {variable_selector.variable} not found") + raise VariableNotFoundError(f"Variable {variable_selector.variable} not found") if isinstance(variable, NoneSegment): inputs[variable_selector.variable] = "" inputs[variable_selector.variable] = variable.to_object() @@ -338,7 +347,7 @@ class LLMNode(BaseNode[LLMNodeData]): for variable_selector in query_variable_selectors: variable = self.graph_runtime_state.variable_pool.get(variable_selector.value_selector) if variable is None: - raise ValueError(f"Variable {variable_selector.variable} not found") + raise VariableNotFoundError(f"Variable {variable_selector.variable} not found") if isinstance(variable, NoneSegment): continue inputs[variable_selector.variable] = variable.to_object() @@ -355,7 +364,7 @@ class LLMNode(BaseNode[LLMNodeData]): return variable.value elif isinstance(variable, NoneSegment | ArrayAnySegment): return [] - raise ValueError(f"Invalid variable type: {type(variable)}") + raise InvalidVariableTypeError(f"Invalid variable type: {type(variable)}") def _fetch_context(self, node_data: LLMNodeData): if not node_data.context.enabled: @@ -376,7 +385,7 @@ class LLMNode(BaseNode[LLMNodeData]): context_str += item + "\n" else: if "content" not in item: - raise ValueError(f"Invalid context structure: {item}") + raise InvalidContextStructureError(f"Invalid context structure: {item}") context_str += item["content"] + "\n" @@ -441,7 +450,7 @@ class LLMNode(BaseNode[LLMNodeData]): ) if provider_model is None: - raise ValueError(f"Model {model_name} not exist.") + raise ModelNotExistError(f"Model {model_name} not exist.") if provider_model.status == ModelStatus.NO_CONFIGURE: raise ProviderTokenNotInitError(f"Model {model_name} credentials is not initialized.") @@ -460,12 +469,12 @@ class LLMNode(BaseNode[LLMNodeData]): # get model mode model_mode = node_data_model.mode if not model_mode: - raise ValueError("LLM mode is required.") + raise LLMModeRequiredError("LLM mode is required.") model_schema = model_type_instance.get_model_schema(model_name, model_credentials) if not model_schema: - raise ValueError(f"Model {model_name} not exist.") + raise ModelNotExistError(f"Model {model_name} not exist.") return model_instance, ModelConfigWithCredentialsEntity( provider=provider_name, @@ -564,7 +573,7 @@ class LLMNode(BaseNode[LLMNodeData]): filtered_prompt_messages.append(prompt_message) if not filtered_prompt_messages: - raise ValueError( + raise NoPromptFoundError( "No prompt found in the LLM configuration. " "Please ensure a prompt is properly configured before proceeding." ) @@ -636,7 +645,7 @@ class LLMNode(BaseNode[LLMNodeData]): variable_template_parser = VariableTemplateParser(template=prompt_template.text) variable_selectors = variable_template_parser.extract_variable_selectors() else: - raise ValueError(f"Invalid prompt template type: {type(prompt_template)}") + raise InvalidVariableTypeError(f"Invalid prompt template type: {type(prompt_template)}") variable_mapping = {} for variable_selector in variable_selectors: From 9369cc44e615506f3b8ce6a22a7784671a7d2667 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Mon, 4 Nov 2024 15:23:08 +0800 Subject: [PATCH 24/73] refactor(list_operator): replace ValueError with InvalidKeyError (#10222) --- api/core/workflow/nodes/list_operator/node.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/core/workflow/nodes/list_operator/node.py b/api/core/workflow/nodes/list_operator/node.py index 6053a15d96..0406b97eb8 100644 --- a/api/core/workflow/nodes/list_operator/node.py +++ b/api/core/workflow/nodes/list_operator/node.py @@ -295,4 +295,4 @@ def _order_file(*, order: Literal["asc", "desc"], order_by: str = "", array: Seq extract_func = _get_file_extract_number_func(key=order_by) return sorted(array, key=lambda x: extract_func(x), reverse=order == "desc") else: - raise ValueError(f"Invalid order key: {order_by}") + raise InvalidKeyError(f"Invalid order key: {order_by}") From da204c131d39bfb2c5a8b68be06c1ec84c304268 Mon Sep 17 00:00:00 2001 From: shisaru292 <87224749+shisaru292@users.noreply.github.com> Date: Mon, 4 Nov 2024 15:23:18 +0800 Subject: [PATCH 25/73] fix: missing working directory parameter in script (#10226) --- dev/reformat | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/dev/reformat b/dev/reformat index ad83e897d9..94a7f3e6fe 100755 --- a/dev/reformat +++ b/dev/reformat @@ -9,10 +9,10 @@ if ! command -v ruff &> /dev/null || ! command -v dotenv-linter &> /dev/null; th fi # run ruff linter -ruff check --fix ./api +poetry run -C api ruff check --fix ./api # run ruff formatter -ruff format ./api +poetry run -C api ruff format ./api # run dotenv-linter linter -dotenv-linter ./api/.env.example ./web/.env.example +poetry run -C api dotenv-linter ./api/.env.example ./web/.env.example From 64523422228db11b035f207c805e94345c63c288 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Mon, 4 Nov 2024 15:55:34 +0800 Subject: [PATCH 26/73] feat(workflow): add configurable workflow file upload limit (#10176) Co-authored-by: JzoNg --- api/.env.example | 3 + api/configs/feature/__init__.py | 5 ++ api/controllers/common/fields.py | 24 ++++++ api/controllers/common/helpers.py | 39 +++++++++ api/controllers/console/explore/parameter.py | 81 +++---------------- api/controllers/console/files/__init__.py | 1 + api/controllers/service_api/app/app.py | 78 +++--------------- api/controllers/web/app.py | 78 +++--------------- .../features/file_upload/manager.py | 5 +- api/fields/file_fields.py | 1 + api/models/__init__.py | 2 - api/models/model.py | 13 +-- docker/.env.example | 1 + docker/docker-compose.yaml | 1 + .../base/file-uploader/constants.ts | 1 + .../components/base/file-uploader/hooks.ts | 3 + .../_base/components/file-upload-setting.tsx | 10 ++- web/models/common.ts | 2 +- 18 files changed, 125 insertions(+), 223 deletions(-) create mode 100644 api/controllers/common/fields.py diff --git a/api/.env.example b/api/.env.example index c07c292369..f7bcab6d6d 100644 --- a/api/.env.example +++ b/api/.env.example @@ -327,6 +327,9 @@ SSRF_DEFAULT_MAX_RETRIES=3 BATCH_UPLOAD_LIMIT=10 KEYWORD_DATA_SOURCE_TYPE=database +# Workflow file upload limit +WORKFLOW_FILE_UPLOAD_LIMIT=10 + # CODE EXECUTION CONFIGURATION CODE_EXECUTION_ENDPOINT=http://127.0.0.1:8194 CODE_EXECUTION_API_KEY=dify-sandbox diff --git a/api/configs/feature/__init__.py b/api/configs/feature/__init__.py index 0fa926038d..533a24dcbd 100644 --- a/api/configs/feature/__init__.py +++ b/api/configs/feature/__init__.py @@ -216,6 +216,11 @@ class FileUploadConfig(BaseSettings): default=20, ) + WORKFLOW_FILE_UPLOAD_LIMIT: PositiveInt = Field( + description="Maximum number of files allowed in a workflow upload operation", + default=10, + ) + class HttpConfig(BaseSettings): """ diff --git a/api/controllers/common/fields.py b/api/controllers/common/fields.py new file mode 100644 index 0000000000..79869916ed --- /dev/null +++ b/api/controllers/common/fields.py @@ -0,0 +1,24 @@ +from flask_restful import fields + +parameters__system_parameters = { + "image_file_size_limit": fields.Integer, + "video_file_size_limit": fields.Integer, + "audio_file_size_limit": fields.Integer, + "file_size_limit": fields.Integer, + "workflow_file_upload_limit": fields.Integer, +} + +parameters_fields = { + "opening_statement": fields.String, + "suggested_questions": fields.Raw, + "suggested_questions_after_answer": fields.Raw, + "speech_to_text": fields.Raw, + "text_to_speech": fields.Raw, + "retriever_resource": fields.Raw, + "annotation_reply": fields.Raw, + "more_like_this": fields.Raw, + "user_input_form": fields.Raw, + "sensitive_word_avoidance": fields.Raw, + "file_upload": fields.Raw, + "system_parameters": fields.Nested(parameters__system_parameters), +} diff --git a/api/controllers/common/helpers.py b/api/controllers/common/helpers.py index ed24b265ef..2bae203712 100644 --- a/api/controllers/common/helpers.py +++ b/api/controllers/common/helpers.py @@ -2,11 +2,15 @@ import mimetypes import os import re import urllib.parse +from collections.abc import Mapping +from typing import Any from uuid import uuid4 import httpx from pydantic import BaseModel +from configs import dify_config + class FileInfo(BaseModel): filename: str @@ -56,3 +60,38 @@ def guess_file_info_from_response(response: httpx.Response): mimetype=mimetype, size=int(response.headers.get("Content-Length", -1)), ) + + +def get_parameters_from_feature_dict(*, features_dict: Mapping[str, Any], user_input_form: list[dict[str, Any]]): + return { + "opening_statement": features_dict.get("opening_statement"), + "suggested_questions": features_dict.get("suggested_questions", []), + "suggested_questions_after_answer": features_dict.get("suggested_questions_after_answer", {"enabled": False}), + "speech_to_text": features_dict.get("speech_to_text", {"enabled": False}), + "text_to_speech": features_dict.get("text_to_speech", {"enabled": False}), + "retriever_resource": features_dict.get("retriever_resource", {"enabled": False}), + "annotation_reply": features_dict.get("annotation_reply", {"enabled": False}), + "more_like_this": features_dict.get("more_like_this", {"enabled": False}), + "user_input_form": user_input_form, + "sensitive_word_avoidance": features_dict.get( + "sensitive_word_avoidance", {"enabled": False, "type": "", "configs": []} + ), + "file_upload": features_dict.get( + "file_upload", + { + "image": { + "enabled": False, + "number_limits": 3, + "detail": "high", + "transfer_methods": ["remote_url", "local_file"], + } + }, + ), + "system_parameters": { + "image_file_size_limit": dify_config.UPLOAD_IMAGE_FILE_SIZE_LIMIT, + "video_file_size_limit": dify_config.UPLOAD_VIDEO_FILE_SIZE_LIMIT, + "audio_file_size_limit": dify_config.UPLOAD_AUDIO_FILE_SIZE_LIMIT, + "file_size_limit": dify_config.UPLOAD_FILE_SIZE_LIMIT, + "workflow_file_upload_limit": dify_config.WORKFLOW_FILE_UPLOAD_LIMIT, + }, + } diff --git a/api/controllers/console/explore/parameter.py b/api/controllers/console/explore/parameter.py index 7c7580e3c6..fee52248a6 100644 --- a/api/controllers/console/explore/parameter.py +++ b/api/controllers/console/explore/parameter.py @@ -1,6 +1,7 @@ -from flask_restful import fields, marshal_with +from flask_restful import marshal_with -from configs import dify_config +from controllers.common import fields +from controllers.common import helpers as controller_helpers from controllers.console import api from controllers.console.app.error import AppUnavailableError from controllers.console.explore.wraps import InstalledAppResource @@ -11,43 +12,14 @@ from services.app_service import AppService class AppParameterApi(InstalledAppResource): """Resource for app variables.""" - variable_fields = { - "key": fields.String, - "name": fields.String, - "description": fields.String, - "type": fields.String, - "default": fields.String, - "max_length": fields.Integer, - "options": fields.List(fields.String), - } - - system_parameters_fields = { - "image_file_size_limit": fields.Integer, - "video_file_size_limit": fields.Integer, - "audio_file_size_limit": fields.Integer, - "file_size_limit": fields.Integer, - } - - parameters_fields = { - "opening_statement": fields.String, - "suggested_questions": fields.Raw, - "suggested_questions_after_answer": fields.Raw, - "speech_to_text": fields.Raw, - "text_to_speech": fields.Raw, - "retriever_resource": fields.Raw, - "annotation_reply": fields.Raw, - "more_like_this": fields.Raw, - "user_input_form": fields.Raw, - "sensitive_word_avoidance": fields.Raw, - "file_upload": fields.Raw, - "system_parameters": fields.Nested(system_parameters_fields), - } - - @marshal_with(parameters_fields) + @marshal_with(fields.parameters_fields) def get(self, installed_app: InstalledApp): """Retrieve app parameters.""" app_model = installed_app.app + if app_model is None: + raise AppUnavailableError() + if app_model.mode in {AppMode.ADVANCED_CHAT.value, AppMode.WORKFLOW.value}: workflow = app_model.workflow if workflow is None: @@ -57,43 +29,16 @@ class AppParameterApi(InstalledAppResource): user_input_form = workflow.user_input_form(to_old_structure=True) else: app_model_config = app_model.app_model_config + if app_model_config is None: + raise AppUnavailableError() + features_dict = app_model_config.to_dict() user_input_form = features_dict.get("user_input_form", []) - return { - "opening_statement": features_dict.get("opening_statement"), - "suggested_questions": features_dict.get("suggested_questions", []), - "suggested_questions_after_answer": features_dict.get( - "suggested_questions_after_answer", {"enabled": False} - ), - "speech_to_text": features_dict.get("speech_to_text", {"enabled": False}), - "text_to_speech": features_dict.get("text_to_speech", {"enabled": False}), - "retriever_resource": features_dict.get("retriever_resource", {"enabled": False}), - "annotation_reply": features_dict.get("annotation_reply", {"enabled": False}), - "more_like_this": features_dict.get("more_like_this", {"enabled": False}), - "user_input_form": user_input_form, - "sensitive_word_avoidance": features_dict.get( - "sensitive_word_avoidance", {"enabled": False, "type": "", "configs": []} - ), - "file_upload": features_dict.get( - "file_upload", - { - "image": { - "enabled": False, - "number_limits": 3, - "detail": "high", - "transfer_methods": ["remote_url", "local_file"], - } - }, - ), - "system_parameters": { - "image_file_size_limit": dify_config.UPLOAD_IMAGE_FILE_SIZE_LIMIT, - "video_file_size_limit": dify_config.UPLOAD_VIDEO_FILE_SIZE_LIMIT, - "audio_file_size_limit": dify_config.UPLOAD_AUDIO_FILE_SIZE_LIMIT, - "file_size_limit": dify_config.UPLOAD_FILE_SIZE_LIMIT, - }, - } + return controller_helpers.get_parameters_from_feature_dict( + features_dict=features_dict, user_input_form=user_input_form + ) class ExploreAppMetaApi(InstalledAppResource): diff --git a/api/controllers/console/files/__init__.py b/api/controllers/console/files/__init__.py index 69ee7eaabd..6c7bd8acfd 100644 --- a/api/controllers/console/files/__init__.py +++ b/api/controllers/console/files/__init__.py @@ -37,6 +37,7 @@ class FileApi(Resource): "image_file_size_limit": dify_config.UPLOAD_IMAGE_FILE_SIZE_LIMIT, "video_file_size_limit": dify_config.UPLOAD_VIDEO_FILE_SIZE_LIMIT, "audio_file_size_limit": dify_config.UPLOAD_AUDIO_FILE_SIZE_LIMIT, + "workflow_file_upload_limit": dify_config.WORKFLOW_FILE_UPLOAD_LIMIT, }, 200 @setup_required diff --git a/api/controllers/service_api/app/app.py b/api/controllers/service_api/app/app.py index 9a4cdc26cd..88b13faa52 100644 --- a/api/controllers/service_api/app/app.py +++ b/api/controllers/service_api/app/app.py @@ -1,6 +1,7 @@ -from flask_restful import Resource, fields, marshal_with +from flask_restful import Resource, marshal_with -from configs import dify_config +from controllers.common import fields +from controllers.common import helpers as controller_helpers from controllers.service_api import api from controllers.service_api.app.error import AppUnavailableError from controllers.service_api.wraps import validate_app_token @@ -11,40 +12,8 @@ from services.app_service import AppService class AppParameterApi(Resource): """Resource for app variables.""" - variable_fields = { - "key": fields.String, - "name": fields.String, - "description": fields.String, - "type": fields.String, - "default": fields.String, - "max_length": fields.Integer, - "options": fields.List(fields.String), - } - - system_parameters_fields = { - "image_file_size_limit": fields.Integer, - "video_file_size_limit": fields.Integer, - "audio_file_size_limit": fields.Integer, - "file_size_limit": fields.Integer, - } - - parameters_fields = { - "opening_statement": fields.String, - "suggested_questions": fields.Raw, - "suggested_questions_after_answer": fields.Raw, - "speech_to_text": fields.Raw, - "text_to_speech": fields.Raw, - "retriever_resource": fields.Raw, - "annotation_reply": fields.Raw, - "more_like_this": fields.Raw, - "user_input_form": fields.Raw, - "sensitive_word_avoidance": fields.Raw, - "file_upload": fields.Raw, - "system_parameters": fields.Nested(system_parameters_fields), - } - @validate_app_token - @marshal_with(parameters_fields) + @marshal_with(fields.parameters_fields) def get(self, app_model: App): """Retrieve app parameters.""" if app_model.mode in {AppMode.ADVANCED_CHAT.value, AppMode.WORKFLOW.value}: @@ -56,43 +25,16 @@ class AppParameterApi(Resource): user_input_form = workflow.user_input_form(to_old_structure=True) else: app_model_config = app_model.app_model_config + if app_model_config is None: + raise AppUnavailableError() + features_dict = app_model_config.to_dict() user_input_form = features_dict.get("user_input_form", []) - return { - "opening_statement": features_dict.get("opening_statement"), - "suggested_questions": features_dict.get("suggested_questions", []), - "suggested_questions_after_answer": features_dict.get( - "suggested_questions_after_answer", {"enabled": False} - ), - "speech_to_text": features_dict.get("speech_to_text", {"enabled": False}), - "text_to_speech": features_dict.get("text_to_speech", {"enabled": False}), - "retriever_resource": features_dict.get("retriever_resource", {"enabled": False}), - "annotation_reply": features_dict.get("annotation_reply", {"enabled": False}), - "more_like_this": features_dict.get("more_like_this", {"enabled": False}), - "user_input_form": user_input_form, - "sensitive_word_avoidance": features_dict.get( - "sensitive_word_avoidance", {"enabled": False, "type": "", "configs": []} - ), - "file_upload": features_dict.get( - "file_upload", - { - "image": { - "enabled": False, - "number_limits": 3, - "detail": "high", - "transfer_methods": ["remote_url", "local_file"], - } - }, - ), - "system_parameters": { - "image_file_size_limit": dify_config.UPLOAD_IMAGE_FILE_SIZE_LIMIT, - "video_file_size_limit": dify_config.UPLOAD_VIDEO_FILE_SIZE_LIMIT, - "audio_file_size_limit": dify_config.UPLOAD_AUDIO_FILE_SIZE_LIMIT, - "file_size_limit": dify_config.UPLOAD_FILE_SIZE_LIMIT, - }, - } + return controller_helpers.get_parameters_from_feature_dict( + features_dict=features_dict, user_input_form=user_input_form + ) class AppMetaApi(Resource): diff --git a/api/controllers/web/app.py b/api/controllers/web/app.py index 974d2cff94..cc8255ccf4 100644 --- a/api/controllers/web/app.py +++ b/api/controllers/web/app.py @@ -1,6 +1,7 @@ -from flask_restful import fields, marshal_with +from flask_restful import marshal_with -from configs import dify_config +from controllers.common import fields +from controllers.common import helpers as controller_helpers from controllers.web import api from controllers.web.error import AppUnavailableError from controllers.web.wraps import WebApiResource @@ -11,39 +12,7 @@ from services.app_service import AppService class AppParameterApi(WebApiResource): """Resource for app variables.""" - variable_fields = { - "key": fields.String, - "name": fields.String, - "description": fields.String, - "type": fields.String, - "default": fields.String, - "max_length": fields.Integer, - "options": fields.List(fields.String), - } - - system_parameters_fields = { - "image_file_size_limit": fields.Integer, - "video_file_size_limit": fields.Integer, - "audio_file_size_limit": fields.Integer, - "file_size_limit": fields.Integer, - } - - parameters_fields = { - "opening_statement": fields.String, - "suggested_questions": fields.Raw, - "suggested_questions_after_answer": fields.Raw, - "speech_to_text": fields.Raw, - "text_to_speech": fields.Raw, - "retriever_resource": fields.Raw, - "annotation_reply": fields.Raw, - "more_like_this": fields.Raw, - "user_input_form": fields.Raw, - "sensitive_word_avoidance": fields.Raw, - "file_upload": fields.Raw, - "system_parameters": fields.Nested(system_parameters_fields), - } - - @marshal_with(parameters_fields) + @marshal_with(fields.parameters_fields) def get(self, app_model: App, end_user): """Retrieve app parameters.""" if app_model.mode in {AppMode.ADVANCED_CHAT.value, AppMode.WORKFLOW.value}: @@ -55,43 +24,16 @@ class AppParameterApi(WebApiResource): user_input_form = workflow.user_input_form(to_old_structure=True) else: app_model_config = app_model.app_model_config + if app_model_config is None: + raise AppUnavailableError() + features_dict = app_model_config.to_dict() user_input_form = features_dict.get("user_input_form", []) - return { - "opening_statement": features_dict.get("opening_statement"), - "suggested_questions": features_dict.get("suggested_questions", []), - "suggested_questions_after_answer": features_dict.get( - "suggested_questions_after_answer", {"enabled": False} - ), - "speech_to_text": features_dict.get("speech_to_text", {"enabled": False}), - "text_to_speech": features_dict.get("text_to_speech", {"enabled": False}), - "retriever_resource": features_dict.get("retriever_resource", {"enabled": False}), - "annotation_reply": features_dict.get("annotation_reply", {"enabled": False}), - "more_like_this": features_dict.get("more_like_this", {"enabled": False}), - "user_input_form": user_input_form, - "sensitive_word_avoidance": features_dict.get( - "sensitive_word_avoidance", {"enabled": False, "type": "", "configs": []} - ), - "file_upload": features_dict.get( - "file_upload", - { - "image": { - "enabled": False, - "number_limits": 3, - "detail": "high", - "transfer_methods": ["remote_url", "local_file"], - } - }, - ), - "system_parameters": { - "image_file_size_limit": dify_config.UPLOAD_IMAGE_FILE_SIZE_LIMIT, - "video_file_size_limit": dify_config.UPLOAD_VIDEO_FILE_SIZE_LIMIT, - "audio_file_size_limit": dify_config.UPLOAD_AUDIO_FILE_SIZE_LIMIT, - "file_size_limit": dify_config.UPLOAD_FILE_SIZE_LIMIT, - }, - } + return controller_helpers.get_parameters_from_feature_dict( + features_dict=features_dict, user_input_form=user_input_form + ) class AppMeta(WebApiResource): diff --git a/api/core/app/app_config/features/file_upload/manager.py b/api/core/app/app_config/features/file_upload/manager.py index 42beec2535..d0f75d0b75 100644 --- a/api/core/app/app_config/features/file_upload/manager.py +++ b/api/core/app/app_config/features/file_upload/manager.py @@ -1,8 +1,7 @@ from collections.abc import Mapping from typing import Any -from core.file.models import FileExtraConfig -from models import FileUploadConfig +from core.file import FileExtraConfig class FileUploadConfigManager: @@ -43,6 +42,6 @@ class FileUploadConfigManager: if not config.get("file_upload"): config["file_upload"] = {} else: - FileUploadConfig.model_validate(config["file_upload"]) + FileExtraConfig.model_validate(config["file_upload"]) return config, ["file_upload"] diff --git a/api/fields/file_fields.py b/api/fields/file_fields.py index 1cddc24b2c..afaacc0568 100644 --- a/api/fields/file_fields.py +++ b/api/fields/file_fields.py @@ -8,6 +8,7 @@ upload_config_fields = { "image_file_size_limit": fields.Integer, "video_file_size_limit": fields.Integer, "audio_file_size_limit": fields.Integer, + "workflow_file_upload_limit": fields.Integer, } file_fields = { diff --git a/api/models/__init__.py b/api/models/__init__.py index 1d8bae6cfa..cd6c7674da 100644 --- a/api/models/__init__.py +++ b/api/models/__init__.py @@ -6,7 +6,6 @@ from .model import ( AppMode, Conversation, EndUser, - FileUploadConfig, InstalledApp, Message, MessageAnnotation, @@ -50,6 +49,5 @@ __all__ = [ "Tenant", "Conversation", "MessageAnnotation", - "FileUploadConfig", "ToolFile", ] diff --git a/api/models/model.py b/api/models/model.py index e9c6b6732f..bd124cce8e 100644 --- a/api/models/model.py +++ b/api/models/model.py @@ -1,7 +1,7 @@ import json import re import uuid -from collections.abc import Mapping, Sequence +from collections.abc import Mapping from datetime import datetime from enum import Enum from typing import Any, Literal, Optional @@ -9,7 +9,6 @@ from typing import Any, Literal, Optional import sqlalchemy as sa from flask import request from flask_login import UserMixin -from pydantic import BaseModel, Field from sqlalchemy import Float, func, text from sqlalchemy.orm import Mapped, mapped_column @@ -25,14 +24,6 @@ from .account import Account, Tenant from .types import StringUUID -class FileUploadConfig(BaseModel): - enabled: bool = Field(default=False) - allowed_file_types: Sequence[FileType] = Field(default_factory=list) - allowed_extensions: Sequence[str] = Field(default_factory=list) - allowed_upload_methods: Sequence[FileTransferMethod] = Field(default_factory=list) - number_limits: int = Field(default=0, gt=0, le=10) - - class DifySetup(db.Model): __tablename__ = "dify_setups" __table_args__ = (db.PrimaryKeyConstraint("version", name="dify_setup_pkey"),) @@ -115,7 +106,7 @@ class App(db.Model): return site @property - def app_model_config(self) -> Optional["AppModelConfig"]: + def app_model_config(self): if self.app_model_config_id: return db.session.query(AppModelConfig).filter(AppModelConfig.id == self.app_model_config_id).first() diff --git a/docker/.env.example b/docker/.env.example index 5b82d62d7b..aa5e102bd0 100644 --- a/docker/.env.example +++ b/docker/.env.example @@ -690,6 +690,7 @@ WORKFLOW_MAX_EXECUTION_STEPS=500 WORKFLOW_MAX_EXECUTION_TIME=1200 WORKFLOW_CALL_MAX_DEPTH=5 MAX_VARIABLE_SIZE=204800 +WORKFLOW_FILE_UPLOAD_LIMIT=10 # HTTP request node in workflow configuration HTTP_REQUEST_NODE_MAX_BINARY_SIZE=10485760 diff --git a/docker/docker-compose.yaml b/docker/docker-compose.yaml index 12cdf25e70..a26838af10 100644 --- a/docker/docker-compose.yaml +++ b/docker/docker-compose.yaml @@ -1,4 +1,5 @@ x-shared-env: &shared-api-worker-env + WORKFLOW_FILE_UPLOAD_LIMIT: ${WORKFLOW_FILE_UPLOAD_LIMIT:-10} LOG_LEVEL: ${LOG_LEVEL:-INFO} LOG_FILE: ${LOG_FILE:-} LOG_FILE_MAX_SIZE: ${LOG_FILE_MAX_SIZE:-20} diff --git a/web/app/components/base/file-uploader/constants.ts b/web/app/components/base/file-uploader/constants.ts index 629fe2566b..a749d73c74 100644 --- a/web/app/components/base/file-uploader/constants.ts +++ b/web/app/components/base/file-uploader/constants.ts @@ -3,5 +3,6 @@ export const IMG_SIZE_LIMIT = 10 * 1024 * 1024 export const FILE_SIZE_LIMIT = 15 * 1024 * 1024 export const AUDIO_SIZE_LIMIT = 50 * 1024 * 1024 export const VIDEO_SIZE_LIMIT = 100 * 1024 * 1024 +export const MAX_FILE_UPLOAD_LIMIT = 10 export const FILE_URL_REGEX = /^(https?|ftp):\/\// diff --git a/web/app/components/base/file-uploader/hooks.ts b/web/app/components/base/file-uploader/hooks.ts index 088160691b..c735754ffe 100644 --- a/web/app/components/base/file-uploader/hooks.ts +++ b/web/app/components/base/file-uploader/hooks.ts @@ -18,6 +18,7 @@ import { AUDIO_SIZE_LIMIT, FILE_SIZE_LIMIT, IMG_SIZE_LIMIT, + MAX_FILE_UPLOAD_LIMIT, VIDEO_SIZE_LIMIT, } from '@/app/components/base/file-uploader/constants' import { useToastContext } from '@/app/components/base/toast' @@ -33,12 +34,14 @@ export const useFileSizeLimit = (fileUploadConfig?: FileUploadConfigResponse) => const docSizeLimit = Number(fileUploadConfig?.file_size_limit) * 1024 * 1024 || FILE_SIZE_LIMIT const audioSizeLimit = Number(fileUploadConfig?.audio_file_size_limit) * 1024 * 1024 || AUDIO_SIZE_LIMIT const videoSizeLimit = Number(fileUploadConfig?.video_file_size_limit) * 1024 * 1024 || VIDEO_SIZE_LIMIT + const maxFileUploadLimit = Number(fileUploadConfig?.workflow_file_upload_limit) || MAX_FILE_UPLOAD_LIMIT return { imgSizeLimit, docSizeLimit, audioSizeLimit, videoSizeLimit, + maxFileUploadLimit, } } diff --git a/web/app/components/workflow/nodes/_base/components/file-upload-setting.tsx b/web/app/components/workflow/nodes/_base/components/file-upload-setting.tsx index 82a3a906cf..42a7213f80 100644 --- a/web/app/components/workflow/nodes/_base/components/file-upload-setting.tsx +++ b/web/app/components/workflow/nodes/_base/components/file-upload-setting.tsx @@ -39,7 +39,13 @@ const FileUploadSetting: FC = ({ allowed_file_extensions, } = payload const { data: fileUploadConfigResponse } = useSWR({ url: '/files/upload' }, fetchFileUploadConfig) - const { imgSizeLimit, docSizeLimit, audioSizeLimit, videoSizeLimit } = useFileSizeLimit(fileUploadConfigResponse) + const { + imgSizeLimit, + docSizeLimit, + audioSizeLimit, + videoSizeLimit, + maxFileUploadLimit, + } = useFileSizeLimit(fileUploadConfigResponse) const handleSupportFileTypeChange = useCallback((type: SupportUploadFileTypes) => { const newPayload = produce(payload, (draft) => { @@ -156,7 +162,7 @@ const FileUploadSetting: FC = ({
diff --git a/web/models/common.ts b/web/models/common.ts index 9ab27a6018..dc2b1120b9 100644 --- a/web/models/common.ts +++ b/web/models/common.ts @@ -216,7 +216,7 @@ export type FileUploadConfigResponse = { file_size_limit: number // default is 15MB audio_file_size_limit?: number // default is 50MB video_file_size_limit?: number // default is 100MB - + workflow_file_upload_limit?: number // default is 10 } export type InvitationResult = { From 2aa171c348dbaeacf6e9604c976fec772bd1df5f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=96=B9=E7=A8=8B?= Date: Mon, 4 Nov 2024 17:22:02 +0800 Subject: [PATCH 27/73] Using a dedicated interface to obtain the token credential for the gitee.ai provider (#10243) --- .../model_providers/gitee_ai/gitee_ai.py | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/api/core/model_runtime/model_providers/gitee_ai/gitee_ai.py b/api/core/model_runtime/model_providers/gitee_ai/gitee_ai.py index ca67594ce4..14aa811905 100644 --- a/api/core/model_runtime/model_providers/gitee_ai/gitee_ai.py +++ b/api/core/model_runtime/model_providers/gitee_ai/gitee_ai.py @@ -1,6 +1,7 @@ import logging -from core.model_runtime.entities.model_entities import ModelType +import requests + from core.model_runtime.errors.validate import CredentialsValidateFailedError from core.model_runtime.model_providers.__base.model_provider import ModelProvider @@ -16,8 +17,18 @@ class GiteeAIProvider(ModelProvider): :param credentials: provider credentials, credentials form defined in `provider_credential_schema`. """ try: - model_instance = self.get_model_instance(ModelType.LLM) - model_instance.validate_credentials(model="Qwen2-7B-Instruct", credentials=credentials) + api_key = credentials.get("api_key") + if not api_key: + raise CredentialsValidateFailedError("Credentials validation failed: api_key not given") + + # send a get request to validate the credentials + headers = {"Authorization": f"Bearer {api_key}"} + response = requests.get("https://ai.gitee.com/api/base/account/me", headers=headers, timeout=(10, 300)) + + if response.status_code != 200: + raise CredentialsValidateFailedError( + f"Credentials validation failed with status code {response.status_code}" + ) except CredentialsValidateFailedError as ex: raise ex except Exception as ex: From 87c1de66f21547eb5a0df939dda5210352659f5e Mon Sep 17 00:00:00 2001 From: -LAN- Date: Mon, 4 Nov 2024 17:48:10 +0800 Subject: [PATCH 28/73] chore(Dockerfile): upgrade zlib arm64 (#10244) --- api/Dockerfile | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/api/Dockerfile b/api/Dockerfile index 1f84fab657..eb37303182 100644 --- a/api/Dockerfile +++ b/api/Dockerfile @@ -55,12 +55,7 @@ RUN apt-get update \ && echo "deb http://deb.debian.org/debian testing main" > /etc/apt/sources.list \ && apt-get update \ # For Security - && apt-get install -y --no-install-recommends expat=2.6.3-2 libldap-2.5-0=2.5.18+dfsg-3+b1 perl=5.40.0-6 libsqlite3-0=3.46.1-1 \ - && if [ "$(dpkg --print-architecture)" = "amd64" ]; then \ - apt-get install -y --no-install-recommends zlib1g=1:1.3.dfsg+really1.3.1-1+b1; \ - else \ - apt-get install -y --no-install-recommends zlib1g=1:1.3.dfsg+really1.3.1-1; \ - fi \ + && apt-get install -y --no-install-recommends expat=2.6.3-2 libldap-2.5-0=2.5.18+dfsg-3+b1 perl=5.40.0-6 libsqlite3-0=3.46.1-1 zlib1g=1:1.3.dfsg+really1.3.1-1+b1 \ # install a chinese font to support the use of tools like matplotlib && apt-get install -y fonts-noto-cjk \ && apt-get autoremove -y \ From 6b0de08157c5475ef9e1006f9bfe09bba85216c0 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Mon, 4 Nov 2024 18:34:55 +0800 Subject: [PATCH 29/73] fix(validation): allow to use 0 in the inputs form (#10255) --- api/core/app/apps/base_app_generator.py | 78 +++++++++++-------- .../core/app/apps/test_base_app_generator.py | 52 +++++++++++++ 2 files changed, 97 insertions(+), 33 deletions(-) create mode 100644 api/tests/unit_tests/core/app/apps/test_base_app_generator.py diff --git a/api/core/app/apps/base_app_generator.py b/api/core/app/apps/base_app_generator.py index 7daff83533..d8e38476c7 100644 --- a/api/core/app/apps/base_app_generator.py +++ b/api/core/app/apps/base_app_generator.py @@ -22,7 +22,10 @@ class BaseAppGenerator: user_inputs = user_inputs or {} # Filter input variables from form configuration, handle required fields, default values, and option values variables = app_config.variables - user_inputs = {var.variable: self._validate_input(inputs=user_inputs, var=var) for var in variables} + user_inputs = { + var.variable: self._validate_inputs(value=user_inputs.get(var.variable), variable_entity=var) + for var in variables + } user_inputs = {k: self._sanitize_value(v) for k, v in user_inputs.items()} # Convert files in inputs to File entity_dictionary = {item.variable: item for item in app_config.variables} @@ -74,57 +77,66 @@ class BaseAppGenerator: return user_inputs - def _validate_input(self, *, inputs: Mapping[str, Any], var: "VariableEntity"): - user_input_value = inputs.get(var.variable) + def _validate_inputs( + self, + *, + variable_entity: "VariableEntity", + value: Any, + ): + if value is None: + if variable_entity.required: + raise ValueError(f"{variable_entity.variable} is required in input form") + return value - if not user_input_value: - if var.required: - raise ValueError(f"{var.variable} is required in input form") - else: - return None - - if var.type in { + if variable_entity.type in { VariableEntityType.TEXT_INPUT, VariableEntityType.SELECT, VariableEntityType.PARAGRAPH, - } and not isinstance(user_input_value, str): - raise ValueError(f"(type '{var.type}') {var.variable} in input form must be a string") + } and not isinstance(value, str): + raise ValueError( + f"(type '{variable_entity.type}') {variable_entity.variable} in input form must be a string" + ) - if var.type == VariableEntityType.NUMBER and isinstance(user_input_value, str): + if variable_entity.type == VariableEntityType.NUMBER and isinstance(value, str): # may raise ValueError if user_input_value is not a valid number try: - if "." in user_input_value: - return float(user_input_value) + if "." in value: + return float(value) else: - return int(user_input_value) + return int(value) except ValueError: - raise ValueError(f"{var.variable} in input form must be a valid number") + raise ValueError(f"{variable_entity.variable} in input form must be a valid number") - match var.type: + match variable_entity.type: case VariableEntityType.SELECT: - if user_input_value not in var.options: - raise ValueError(f"{var.variable} in input form must be one of the following: {var.options}") + if value not in variable_entity.options: + raise ValueError( + f"{variable_entity.variable} in input form must be one of the following: " + f"{variable_entity.options}" + ) case VariableEntityType.TEXT_INPUT | VariableEntityType.PARAGRAPH: - if var.max_length and len(user_input_value) > var.max_length: - raise ValueError(f"{var.variable} in input form must be less than {var.max_length} characters") + if variable_entity.max_length and len(value) > variable_entity.max_length: + raise ValueError( + f"{variable_entity.variable} in input form must be less than {variable_entity.max_length} " + "characters" + ) case VariableEntityType.FILE: - if not isinstance(user_input_value, dict) and not isinstance(user_input_value, File): - raise ValueError(f"{var.variable} in input form must be a file") + if not isinstance(value, dict) and not isinstance(value, File): + raise ValueError(f"{variable_entity.variable} in input form must be a file") case VariableEntityType.FILE_LIST: # if number of files exceeds the limit, raise ValueError if not ( - isinstance(user_input_value, list) - and ( - all(isinstance(item, dict) for item in user_input_value) - or all(isinstance(item, File) for item in user_input_value) - ) + isinstance(value, list) + and (all(isinstance(item, dict) for item in value) or all(isinstance(item, File) for item in value)) ): - raise ValueError(f"{var.variable} in input form must be a list of files") + raise ValueError(f"{variable_entity.variable} in input form must be a list of files") - if var.max_length and len(user_input_value) > var.max_length: - raise ValueError(f"{var.variable} in input form must be less than {var.max_length} files") + if variable_entity.max_length and len(value) > variable_entity.max_length: + raise ValueError( + f"{variable_entity.variable} in input form must be less than {variable_entity.max_length} files" + ) - return user_input_value + return value def _sanitize_value(self, value: Any) -> Any: if isinstance(value, str): diff --git a/api/tests/unit_tests/core/app/apps/test_base_app_generator.py b/api/tests/unit_tests/core/app/apps/test_base_app_generator.py new file mode 100644 index 0000000000..a6bf43ab0c --- /dev/null +++ b/api/tests/unit_tests/core/app/apps/test_base_app_generator.py @@ -0,0 +1,52 @@ +import pytest + +from core.app.app_config.entities import VariableEntity, VariableEntityType +from core.app.apps.base_app_generator import BaseAppGenerator + + +def test_validate_inputs_with_zero(): + base_app_generator = BaseAppGenerator() + + var = VariableEntity( + variable="test_var", + label="test_var", + type=VariableEntityType.NUMBER, + required=True, + ) + + # Test with input 0 + result = base_app_generator._validate_inputs( + variable_entity=var, + value=0, + ) + + assert result == 0 + + # Test with input "0" (string) + result = base_app_generator._validate_inputs( + variable_entity=var, + value="0", + ) + + assert result == 0 + + +def test_validate_input_with_none_for_required_variable(): + base_app_generator = BaseAppGenerator() + + for var_type in VariableEntityType: + var = VariableEntity( + variable="test_var", + label="test_var", + type=var_type, + required=True, + ) + + # Test with input None + with pytest.raises(ValueError) as exc_info: + base_app_generator._validate_inputs( + variable_entity=var, + value=None, + ) + + assert str(exc_info.value) == "test_var is required in input form" From 971defbbbd71cf1f63344619044069b37a87ec75 Mon Sep 17 00:00:00 2001 From: guogeer <1500065870@qq.com> Date: Mon, 4 Nov 2024 18:46:39 +0800 Subject: [PATCH 30/73] fix: buitin tool aippt (#10234) Co-authored-by: jinqi.guo --- .../provider/builtin/aippt/tools/aippt.py | 78 ++++++++++++------- api/core/workflow/nodes/tool/tool_node.py | 2 +- 2 files changed, 50 insertions(+), 30 deletions(-) diff --git a/api/core/tools/provider/builtin/aippt/tools/aippt.py b/api/core/tools/provider/builtin/aippt/tools/aippt.py index dd9371f70d..38123f125a 100644 --- a/api/core/tools/provider/builtin/aippt/tools/aippt.py +++ b/api/core/tools/provider/builtin/aippt/tools/aippt.py @@ -4,7 +4,7 @@ from hmac import new as hmac_new from json import loads as json_loads from threading import Lock from time import sleep, time -from typing import Any, Optional +from typing import Any from httpx import get, post from requests import get as requests_get @@ -15,27 +15,27 @@ from core.tools.entities.tool_entities import ToolInvokeMessage, ToolParameter, from core.tools.tool.builtin_tool import BuiltinTool -class AIPPTGenerateTool(BuiltinTool): +class AIPPTGenerateToolAdapter: """ A tool for generating a ppt """ _api_base_url = URL("https://co.aippt.cn/api") _api_token_cache = {} - _api_token_cache_lock: Optional[Lock] = None _style_cache = {} - _style_cache_lock: Optional[Lock] = None + + _api_token_cache_lock = Lock() + _style_cache_lock = Lock() _task = {} _task_type_map = { "auto": 1, "markdown": 7, } + _tool: BuiltinTool - def __init__(self, **kwargs: Any): - super().__init__(**kwargs) - self._api_token_cache_lock = Lock() - self._style_cache_lock = Lock() + def __init__(self, tool: BuiltinTool = None): + self._tool = tool def _invoke(self, user_id: str, tool_parameters: dict[str, Any]) -> ToolInvokeMessage | list[ToolInvokeMessage]: """ @@ -51,11 +51,11 @@ class AIPPTGenerateTool(BuiltinTool): """ title = tool_parameters.get("title", "") if not title: - return self.create_text_message("Please provide a title for the ppt") + return self._tool.create_text_message("Please provide a title for the ppt") model = tool_parameters.get("model", "aippt") if not model: - return self.create_text_message("Please provide a model for the ppt") + return self._tool.create_text_message("Please provide a model for the ppt") outline = tool_parameters.get("outline", "") @@ -68,8 +68,8 @@ class AIPPTGenerateTool(BuiltinTool): ) # get suit - color = tool_parameters.get("color") - style = tool_parameters.get("style") + color: str = tool_parameters.get("color") + style: str = tool_parameters.get("style") if color == "__default__": color_id = "" @@ -93,9 +93,9 @@ class AIPPTGenerateTool(BuiltinTool): # generate ppt _, ppt_url = self._generate_ppt(task_id=task_id, suit_id=suit_id, user_id=user_id) - return self.create_text_message( + return self._tool.create_text_message( """the ppt has been created successfully,""" - f"""the ppt url is {ppt_url}""" + f"""the ppt url is {ppt_url} .""" """please give the ppt url to user and direct user to download it.""" ) @@ -111,8 +111,8 @@ class AIPPTGenerateTool(BuiltinTool): """ headers = { "x-channel": "", - "x-api-key": self.runtime.credentials["aippt_access_key"], - "x-token": self._get_api_token(credentials=self.runtime.credentials, user_id=user_id), + "x-api-key": self._tool.runtime.credentials["aippt_access_key"], + "x-token": self._get_api_token(credentials=self._tool.runtime.credentials, user_id=user_id), } response = post( str(self._api_base_url / "ai" / "chat" / "v2" / "task"), @@ -139,8 +139,8 @@ class AIPPTGenerateTool(BuiltinTool): headers = { "x-channel": "", - "x-api-key": self.runtime.credentials["aippt_access_key"], - "x-token": self._get_api_token(credentials=self.runtime.credentials, user_id=user_id), + "x-api-key": self._tool.runtime.credentials["aippt_access_key"], + "x-token": self._get_api_token(credentials=self._tool.runtime.credentials, user_id=user_id), } response = requests_get(url=api_url, headers=headers, stream=True, timeout=(10, 60)) @@ -183,8 +183,8 @@ class AIPPTGenerateTool(BuiltinTool): headers = { "x-channel": "", - "x-api-key": self.runtime.credentials["aippt_access_key"], - "x-token": self._get_api_token(credentials=self.runtime.credentials, user_id=user_id), + "x-api-key": self._tool.runtime.credentials["aippt_access_key"], + "x-token": self._get_api_token(credentials=self._tool.runtime.credentials, user_id=user_id), } response = requests_get(url=api_url, headers=headers, stream=True, timeout=(10, 60)) @@ -236,14 +236,15 @@ class AIPPTGenerateTool(BuiltinTool): """ headers = { "x-channel": "", - "x-api-key": self.runtime.credentials["aippt_access_key"], - "x-token": self._get_api_token(credentials=self.runtime.credentials, user_id=user_id), + "x-api-key": self._tool.runtime.credentials["aippt_access_key"], + "x-token": self._get_api_token(credentials=self._tool.runtime.credentials, user_id=user_id), } response = post( str(self._api_base_url / "design" / "v2" / "save"), headers=headers, data={"task_id": task_id, "template_id": suit_id}, + timeout=(10, 60), ) if response.status_code != 200: @@ -350,11 +351,13 @@ class AIPPTGenerateTool(BuiltinTool): return token - @classmethod - def _calculate_sign(cls, access_key: str, secret_key: str, timestamp: int) -> str: + @staticmethod + def _calculate_sign(access_key: str, secret_key: str, timestamp: int) -> str: return b64encode( hmac_new( - key=secret_key.encode("utf-8"), msg=f"GET@/api/grant/token/@{timestamp}".encode(), digestmod=sha1 + key=secret_key.encode("utf-8"), + msg=f"GET@/api/grant/token/@{timestamp}".encode(), + digestmod=sha1, ).digest() ).decode("utf-8") @@ -419,10 +422,12 @@ class AIPPTGenerateTool(BuiltinTool): :param credentials: the credentials :return: Tuple[list[dict[id, color]], list[dict[id, style]] """ - if not self.runtime.credentials.get("aippt_access_key") or not self.runtime.credentials.get("aippt_secret_key"): + if not self._tool.runtime.credentials.get("aippt_access_key") or not self._tool.runtime.credentials.get( + "aippt_secret_key" + ): raise Exception("Please provide aippt credentials") - return self._get_styles(credentials=self.runtime.credentials, user_id=user_id) + return self._get_styles(credentials=self._tool.runtime.credentials, user_id=user_id) def _get_suit(self, style_id: int, colour_id: int) -> int: """ @@ -430,8 +435,8 @@ class AIPPTGenerateTool(BuiltinTool): """ headers = { "x-channel": "", - "x-api-key": self.runtime.credentials["aippt_access_key"], - "x-token": self._get_api_token(credentials=self.runtime.credentials, user_id="__dify_system__"), + "x-api-key": self._tool.runtime.credentials["aippt_access_key"], + "x-token": self._get_api_token(credentials=self._tool.runtime.credentials, user_id="__dify_system__"), } response = get( str(self._api_base_url / "template_component" / "suit" / "search"), @@ -496,3 +501,18 @@ class AIPPTGenerateTool(BuiltinTool): ], ), ] + + +class AIPPTGenerateTool(BuiltinTool): + def __init__(self, **kwargs: Any): + super().__init__(**kwargs) + + def _invoke(self, user_id: str, tool_parameters: dict[str, Any]) -> ToolInvokeMessage | list[ToolInvokeMessage]: + return AIPPTGenerateToolAdapter(self)._invoke(user_id, tool_parameters) + + def get_runtime_parameters(self) -> list[ToolParameter]: + return AIPPTGenerateToolAdapter(self).get_runtime_parameters() + + @classmethod + def _get_api_token(cls, credentials: dict[str, str], user_id: str) -> str: + return AIPPTGenerateToolAdapter()._get_api_token(credentials, user_id) diff --git a/api/core/workflow/nodes/tool/tool_node.py b/api/core/workflow/nodes/tool/tool_node.py index df22130d69..0994ccaedb 100644 --- a/api/core/workflow/nodes/tool/tool_node.py +++ b/api/core/workflow/nodes/tool/tool_node.py @@ -53,7 +53,7 @@ class ToolNode(BaseNode[ToolNodeData]): ) # get parameters - tool_parameters = tool_runtime.get_runtime_parameters() or [] + tool_parameters = tool_runtime.parameters or [] parameters = self._generate_parameters( tool_parameters=tool_parameters, variable_pool=self.graph_runtime_state.variable_pool, From 7a98dab6a4fd01152c543a656b0771d58b600a20 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Tue, 5 Nov 2024 09:27:51 +0800 Subject: [PATCH 31/73] refactor(parameter_extractor): implement custom error classes (#10260) --- .../workflow/nodes/parameter_extractor/exc.py | 50 ++++++++++++++++ .../parameter_extractor_node.py | 57 ++++++++++++------- 2 files changed, 86 insertions(+), 21 deletions(-) create mode 100644 api/core/workflow/nodes/parameter_extractor/exc.py diff --git a/api/core/workflow/nodes/parameter_extractor/exc.py b/api/core/workflow/nodes/parameter_extractor/exc.py new file mode 100644 index 0000000000..6511aba185 --- /dev/null +++ b/api/core/workflow/nodes/parameter_extractor/exc.py @@ -0,0 +1,50 @@ +class ParameterExtractorNodeError(ValueError): + """Base error for ParameterExtractorNode.""" + + +class InvalidModelTypeError(ParameterExtractorNodeError): + """Raised when the model is not a Large Language Model.""" + + +class ModelSchemaNotFoundError(ParameterExtractorNodeError): + """Raised when the model schema is not found.""" + + +class InvalidInvokeResultError(ParameterExtractorNodeError): + """Raised when the invoke result is invalid.""" + + +class InvalidTextContentTypeError(ParameterExtractorNodeError): + """Raised when the text content type is invalid.""" + + +class InvalidNumberOfParametersError(ParameterExtractorNodeError): + """Raised when the number of parameters is invalid.""" + + +class RequiredParameterMissingError(ParameterExtractorNodeError): + """Raised when a required parameter is missing.""" + + +class InvalidSelectValueError(ParameterExtractorNodeError): + """Raised when a select value is invalid.""" + + +class InvalidNumberValueError(ParameterExtractorNodeError): + """Raised when a number value is invalid.""" + + +class InvalidBoolValueError(ParameterExtractorNodeError): + """Raised when a bool value is invalid.""" + + +class InvalidStringValueError(ParameterExtractorNodeError): + """Raised when a string value is invalid.""" + + +class InvalidArrayValueError(ParameterExtractorNodeError): + """Raised when an array value is invalid.""" + + +class InvalidModelModeError(ParameterExtractorNodeError): + """Raised when the model mode is invalid.""" diff --git a/api/core/workflow/nodes/parameter_extractor/parameter_extractor_node.py b/api/core/workflow/nodes/parameter_extractor/parameter_extractor_node.py index 49546e9356..b64bde8ac5 100644 --- a/api/core/workflow/nodes/parameter_extractor/parameter_extractor_node.py +++ b/api/core/workflow/nodes/parameter_extractor/parameter_extractor_node.py @@ -32,6 +32,21 @@ from extensions.ext_database import db from models.workflow import WorkflowNodeExecutionStatus from .entities import ParameterExtractorNodeData +from .exc import ( + InvalidArrayValueError, + InvalidBoolValueError, + InvalidInvokeResultError, + InvalidModelModeError, + InvalidModelTypeError, + InvalidNumberOfParametersError, + InvalidNumberValueError, + InvalidSelectValueError, + InvalidStringValueError, + InvalidTextContentTypeError, + ModelSchemaNotFoundError, + ParameterExtractorNodeError, + RequiredParameterMissingError, +) from .prompts import ( CHAT_EXAMPLE, CHAT_GENERATE_JSON_USER_MESSAGE_TEMPLATE, @@ -85,7 +100,7 @@ class ParameterExtractorNode(LLMNode): model_instance, model_config = self._fetch_model_config(node_data.model) if not isinstance(model_instance.model_type_instance, LargeLanguageModel): - raise ValueError("Model is not a Large Language Model") + raise InvalidModelTypeError("Model is not a Large Language Model") llm_model = model_instance.model_type_instance model_schema = llm_model.get_model_schema( @@ -93,7 +108,7 @@ class ParameterExtractorNode(LLMNode): credentials=model_config.credentials, ) if not model_schema: - raise ValueError("Model schema not found") + raise ModelSchemaNotFoundError("Model schema not found") # fetch memory memory = self._fetch_memory( @@ -155,7 +170,7 @@ class ParameterExtractorNode(LLMNode): process_data["usage"] = jsonable_encoder(usage) process_data["tool_call"] = jsonable_encoder(tool_call) process_data["llm_text"] = text - except Exception as e: + except ParameterExtractorNodeError as e: return NodeRunResult( status=WorkflowNodeExecutionStatus.FAILED, inputs=inputs, @@ -177,7 +192,7 @@ class ParameterExtractorNode(LLMNode): try: result = self._validate_result(data=node_data, result=result or {}) - except Exception as e: + except ParameterExtractorNodeError as e: error = str(e) # transform result into standard format @@ -217,11 +232,11 @@ class ParameterExtractorNode(LLMNode): # handle invoke result if not isinstance(invoke_result, LLMResult): - raise ValueError(f"Invalid invoke result: {invoke_result}") + raise InvalidInvokeResultError(f"Invalid invoke result: {invoke_result}") text = invoke_result.message.content if not isinstance(text, str): - raise ValueError(f"Invalid text content type: {type(text)}. Expected str.") + raise InvalidTextContentTypeError(f"Invalid text content type: {type(text)}. Expected str.") usage = invoke_result.usage tool_call = invoke_result.message.tool_calls[0] if invoke_result.message.tool_calls else None @@ -344,7 +359,7 @@ class ParameterExtractorNode(LLMNode): files=files, ) else: - raise ValueError(f"Invalid model mode: {model_mode}") + raise InvalidModelModeError(f"Invalid model mode: {model_mode}") def _generate_prompt_engineering_completion_prompt( self, @@ -449,36 +464,36 @@ class ParameterExtractorNode(LLMNode): Validate result. """ if len(data.parameters) != len(result): - raise ValueError("Invalid number of parameters") + raise InvalidNumberOfParametersError("Invalid number of parameters") for parameter in data.parameters: if parameter.required and parameter.name not in result: - raise ValueError(f"Parameter {parameter.name} is required") + raise RequiredParameterMissingError(f"Parameter {parameter.name} is required") if parameter.type == "select" and parameter.options and result.get(parameter.name) not in parameter.options: - raise ValueError(f"Invalid `select` value for parameter {parameter.name}") + raise InvalidSelectValueError(f"Invalid `select` value for parameter {parameter.name}") if parameter.type == "number" and not isinstance(result.get(parameter.name), int | float): - raise ValueError(f"Invalid `number` value for parameter {parameter.name}") + raise InvalidNumberValueError(f"Invalid `number` value for parameter {parameter.name}") if parameter.type == "bool" and not isinstance(result.get(parameter.name), bool): - raise ValueError(f"Invalid `bool` value for parameter {parameter.name}") + raise InvalidBoolValueError(f"Invalid `bool` value for parameter {parameter.name}") if parameter.type == "string" and not isinstance(result.get(parameter.name), str): - raise ValueError(f"Invalid `string` value for parameter {parameter.name}") + raise InvalidStringValueError(f"Invalid `string` value for parameter {parameter.name}") if parameter.type.startswith("array"): parameters = result.get(parameter.name) if not isinstance(parameters, list): - raise ValueError(f"Invalid `array` value for parameter {parameter.name}") + raise InvalidArrayValueError(f"Invalid `array` value for parameter {parameter.name}") nested_type = parameter.type[6:-1] for item in parameters: if nested_type == "number" and not isinstance(item, int | float): - raise ValueError(f"Invalid `array[number]` value for parameter {parameter.name}") + raise InvalidArrayValueError(f"Invalid `array[number]` value for parameter {parameter.name}") if nested_type == "string" and not isinstance(item, str): - raise ValueError(f"Invalid `array[string]` value for parameter {parameter.name}") + raise InvalidArrayValueError(f"Invalid `array[string]` value for parameter {parameter.name}") if nested_type == "object" and not isinstance(item, dict): - raise ValueError(f"Invalid `array[object]` value for parameter {parameter.name}") + raise InvalidArrayValueError(f"Invalid `array[object]` value for parameter {parameter.name}") return result def _transform_result(self, data: ParameterExtractorNodeData, result: dict) -> dict: @@ -634,7 +649,7 @@ class ParameterExtractorNode(LLMNode): user_prompt_message = ChatModelMessage(role=PromptMessageRole.USER, text=input_text) return [system_prompt_messages, user_prompt_message] else: - raise ValueError(f"Model mode {model_mode} not support.") + raise InvalidModelModeError(f"Model mode {model_mode} not support.") def _get_prompt_engineering_prompt_template( self, @@ -669,7 +684,7 @@ class ParameterExtractorNode(LLMNode): .replace("}γγγ", "") ) else: - raise ValueError(f"Model mode {model_mode} not support.") + raise InvalidModelModeError(f"Model mode {model_mode} not support.") def _calculate_rest_token( self, @@ -683,12 +698,12 @@ class ParameterExtractorNode(LLMNode): model_instance, model_config = self._fetch_model_config(node_data.model) if not isinstance(model_instance.model_type_instance, LargeLanguageModel): - raise ValueError("Model is not a Large Language Model") + raise InvalidModelTypeError("Model is not a Large Language Model") llm_model = model_instance.model_type_instance model_schema = llm_model.get_model_schema(model_config.model, model_config.credentials) if not model_schema: - raise ValueError("Model schema not found") + raise ModelSchemaNotFoundError("Model schema not found") if set(model_schema.features or []) & {ModelFeature.MULTI_TOOL_CALL, ModelFeature.MULTI_TOOL_CALL}: prompt_template = self._get_function_calling_prompt_template(node_data, query, variable_pool, None, 2000) From 9305ad210225dd97813f85cd51cdad3dca379acc Mon Sep 17 00:00:00 2001 From: Matsuda Date: Tue, 5 Nov 2024 10:42:51 +0900 Subject: [PATCH 32/73] feat: support Claude 3.5 Haiku on Amazon Bedrock (#10265) --- .../llm/anthropic.claude-3-5-haiku-v1.yaml | 61 +++++++++++++++++++ .../llm/us.anthropic.claude-3-5-haiku-v1.yaml | 61 +++++++++++++++++++ 2 files changed, 122 insertions(+) create mode 100644 api/core/model_runtime/model_providers/bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml create mode 100644 api/core/model_runtime/model_providers/bedrock/llm/us.anthropic.claude-3-5-haiku-v1.yaml diff --git a/api/core/model_runtime/model_providers/bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml b/api/core/model_runtime/model_providers/bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml new file mode 100644 index 0000000000..7c676136db --- /dev/null +++ b/api/core/model_runtime/model_providers/bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml @@ -0,0 +1,61 @@ +model: anthropic.claude-3-5-haiku-20241022-v1:0 +label: + en_US: Claude 3.5 Haiku +model_type: llm +features: + - agent-thought + - vision + - tool-call + - stream-tool-call +model_properties: + mode: chat + context_size: 200000 +# docs: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-anthropic-claude-messages.html +parameter_rules: + - name: max_tokens + use_template: max_tokens + required: true + type: int + default: 4096 + min: 1 + max: 4096 + help: + zh_Hans: 停止前生成的最大令牌数。请注意，Anthropic Claude 模型可能会在达到 max_tokens 的值之前停止生成令牌。不同的 Anthropic Claude 模型对此参数具有不同的最大值。 + en_US: The maximum number of tokens to generate before stopping. Note that Anthropic Claude models might stop generating tokens before reaching the value of max_tokens. Different Anthropic Claude models have different maximum values for this parameter. + # docs: https://docs.anthropic.com/claude/docs/system-prompts + - name: temperature + use_template: temperature + required: false + type: float + default: 1 + min: 0.0 + max: 1.0 + help: + zh_Hans: 生成内容的随机性。 + en_US: The amount of randomness injected into the response. + - name: top_p + required: false + type: float + default: 0.999 + min: 0.000 + max: 1.000 + help: + zh_Hans: 在核采样中，Anthropic Claude 按概率递减顺序计算每个后续标记的所有选项的累积分布，并在达到 top_p 指定的特定概率时将其切断。您应该更改温度或top_p，但不能同时更改两者。 + en_US: In nucleus sampling, Anthropic Claude computes the cumulative distribution over all the options for each subsequent token in decreasing probability order and cuts it off once it reaches a particular probability specified by top_p. You should alter either temperature or top_p, but not both. + - name: top_k + required: false + type: int + default: 0 + min: 0 + # tip docs from aws has error, max value is 500 + max: 500 + help: + zh_Hans: 对于每个后续标记，仅从前 K 个选项中进行采样。使用 top_k 删除长尾低概率响应。 + en_US: Only sample from the top K options for each subsequent token. Use top_k to remove long tail low probability responses. + - name: response_format + use_template: response_format +pricing: + input: '0.001' + output: '0.005' + unit: '0.001' + currency: USD diff --git a/api/core/model_runtime/model_providers/bedrock/llm/us.anthropic.claude-3-5-haiku-v1.yaml b/api/core/model_runtime/model_providers/bedrock/llm/us.anthropic.claude-3-5-haiku-v1.yaml new file mode 100644 index 0000000000..a9b66b1925 --- /dev/null +++ b/api/core/model_runtime/model_providers/bedrock/llm/us.anthropic.claude-3-5-haiku-v1.yaml @@ -0,0 +1,61 @@ +model: us.anthropic.claude-3-5-haiku-20241022-v1:0 +label: + en_US: Claude 3.5 Haiku(US.Cross Region Inference) +model_type: llm +features: + - agent-thought + - vision + - tool-call + - stream-tool-call +model_properties: + mode: chat + context_size: 200000 +# docs: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-anthropic-claude-messages.html +parameter_rules: + - name: max_tokens + use_template: max_tokens + required: true + type: int + default: 4096 + min: 1 + max: 4096 + help: + zh_Hans: 停止前生成的最大令牌数。请注意，Anthropic Claude 模型可能会在达到 max_tokens 的值之前停止生成令牌。不同的 Anthropic Claude 模型对此参数具有不同的最大值。 + en_US: The maximum number of tokens to generate before stopping. Note that Anthropic Claude models might stop generating tokens before reaching the value of max_tokens. Different Anthropic Claude models have different maximum values for this parameter. + # docs: https://docs.anthropic.com/claude/docs/system-prompts + - name: temperature + use_template: temperature + required: false + type: float + default: 1 + min: 0.0 + max: 1.0 + help: + zh_Hans: 生成内容的随机性。 + en_US: The amount of randomness injected into the response. + - name: top_p + required: false + type: float + default: 0.999 + min: 0.000 + max: 1.000 + help: + zh_Hans: 在核采样中，Anthropic Claude 按概率递减顺序计算每个后续标记的所有选项的累积分布，并在达到 top_p 指定的特定概率时将其切断。您应该更改温度或top_p，但不能同时更改两者。 + en_US: In nucleus sampling, Anthropic Claude computes the cumulative distribution over all the options for each subsequent token in decreasing probability order and cuts it off once it reaches a particular probability specified by top_p. You should alter either temperature or top_p, but not both. + - name: top_k + required: false + type: int + default: 0 + min: 0 + # tip docs from aws has error, max value is 500 + max: 500 + help: + zh_Hans: 对于每个后续标记，仅从前 K 个选项中进行采样。使用 top_k 删除长尾低概率响应。 + en_US: Only sample from the top K options for each subsequent token. Use top_k to remove long tail low probability responses. + - name: response_format + use_template: response_format +pricing: + input: '0.001' + output: '0.005' + unit: '0.001' + currency: USD From 2c4d8dbe9b249d200def5b8c512ef8b8dee56624 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Tue, 5 Nov 2024 09:49:43 +0800 Subject: [PATCH 33/73] feat(document_extractor): support tool file in document extractor (#10217) --- api/core/workflow/nodes/document_extractor/node.py | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/api/core/workflow/nodes/document_extractor/node.py b/api/core/workflow/nodes/document_extractor/node.py index aacee94095..c90017d5e1 100644 --- a/api/core/workflow/nodes/document_extractor/node.py +++ b/api/core/workflow/nodes/document_extractor/node.py @@ -198,10 +198,8 @@ def _download_file_content(file: File) -> bytes: response = ssrf_proxy.get(file.remote_url) response.raise_for_status() return response.content - elif file.transfer_method == FileTransferMethod.LOCAL_FILE: - return file_manager.download(file) else: - raise ValueError(f"Unsupported transfer method: {file.transfer_method}") + return file_manager.download(file) except Exception as e: raise FileDownloadError(f"Error downloading file: {str(e)}") from e From cca2e7876d67596338e4732e3a5f9424f98705de Mon Sep 17 00:00:00 2001 From: GeorgeCaoJ Date: Tue, 5 Nov 2024 09:56:41 +0800 Subject: [PATCH 34/73] fix(workflow): handle else condition branch addition error in if-else node (#10257) --- .../workflow/nodes/if-else/use-config.ts | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/web/app/components/workflow/nodes/if-else/use-config.ts b/web/app/components/workflow/nodes/if-else/use-config.ts index d1210431a0..41e41f6b8b 100644 --- a/web/app/components/workflow/nodes/if-else/use-config.ts +++ b/web/app/components/workflow/nodes/if-else/use-config.ts @@ -78,24 +78,24 @@ const useConfig = (id: string, payload: IfElseNodeType) => { }) const handleAddCase = useCallback(() => { - const newInputs = produce(inputs, () => { - if (inputs.cases) { + const newInputs = produce(inputs, (draft) => { + if (draft.cases) { const case_id = uuid4() - inputs.cases.push({ + draft.cases.push({ case_id, logical_operator: LogicalOperator.and, conditions: [], }) - if (inputs._targetBranches) { - const elseCaseIndex = inputs._targetBranches.findIndex(branch => branch.id === 'false') + if (draft._targetBranches) { + const elseCaseIndex = draft._targetBranches.findIndex(branch => branch.id === 'false') if (elseCaseIndex > -1) { - inputs._targetBranches = branchNameCorrect([ - ...inputs._targetBranches.slice(0, elseCaseIndex), + draft._targetBranches = branchNameCorrect([ + ...draft._targetBranches.slice(0, elseCaseIndex), { id: case_id, name: '', }, - ...inputs._targetBranches.slice(elseCaseIndex), + ...draft._targetBranches.slice(elseCaseIndex), ]) } } From d1505b15c40aa7bfe71bdc6f07efacc885985b34 Mon Sep 17 00:00:00 2001 From: Novice Date: Tue, 5 Nov 2024 10:32:49 +0800 Subject: [PATCH 35/73] feat: Iteration node support parallel mode (#9493) --- .../advanced_chat/generate_task_pipeline.py | 3 +- .../apps/workflow/generate_task_pipeline.py | 3 +- api/core/app/apps/workflow_app_runner.py | 35 ++ api/core/app/entities/queue_entities.py | 37 +- api/core/app/entities/task_entities.py | 2 + .../task_pipeline/workflow_cycle_manage.py | 28 +- api/core/workflow/entities/node_entities.py | 1 + .../workflow/graph_engine/entities/event.py | 7 + .../workflow/graph_engine/graph_engine.py | 11 + api/core/workflow/nodes/iteration/entities.py | 10 + .../nodes/iteration/iteration_node.py | 412 ++++++++++++---- .../nodes/iteration/test_iteration.py | 449 +++++++++++++++++- web/app/components/base/select/index.tsx | 2 +- web/app/components/workflow/constants.ts | 4 +- .../workflow/hooks/use-nodes-interactions.ts | 5 + .../workflow/hooks/use-workflow-run.ts | 102 +++- .../workflow/nodes/_base/components/field.tsx | 6 +- .../components/workflow/nodes/_base/node.tsx | 24 +- .../workflow/nodes/iteration/default.ts | 39 +- .../workflow/nodes/iteration/node.tsx | 15 +- .../workflow/nodes/iteration/panel.tsx | 59 ++- .../workflow/nodes/iteration/types.ts | 5 + .../workflow/nodes/iteration/use-config.ts | 25 +- .../workflow/panel/debug-and-preview/hooks.ts | 12 +- web/app/components/workflow/run/index.tsx | 77 ++- .../workflow/run/iteration-result-panel.tsx | 20 +- web/app/components/workflow/run/node.tsx | 16 +- web/app/components/workflow/store.ts | 10 + web/app/components/workflow/types.ts | 6 +- web/app/components/workflow/utils.ts | 11 +- web/i18n/en-US/workflow.ts | 17 + web/i18n/zh-Hans/workflow.ts | 17 + web/types/workflow.ts | 5 + 33 files changed, 1283 insertions(+), 192 deletions(-) diff --git a/api/core/app/apps/advanced_chat/generate_task_pipeline.py b/api/core/app/apps/advanced_chat/generate_task_pipeline.py index e4cb3f8527..1fc7ffe2c7 100644 --- a/api/core/app/apps/advanced_chat/generate_task_pipeline.py +++ b/api/core/app/apps/advanced_chat/generate_task_pipeline.py @@ -20,6 +20,7 @@ from core.app.entities.queue_entities import ( QueueIterationStartEvent, QueueMessageReplaceEvent, QueueNodeFailedEvent, + QueueNodeInIterationFailedEvent, QueueNodeStartedEvent, QueueNodeSucceededEvent, QueueParallelBranchRunFailedEvent, @@ -314,7 +315,7 @@ class AdvancedChatAppGenerateTaskPipeline(BasedGenerateTaskPipeline, WorkflowCyc if response: yield response - elif isinstance(event, QueueNodeFailedEvent): + elif isinstance(event, QueueNodeFailedEvent | QueueNodeInIterationFailedEvent): workflow_node_execution = self._handle_workflow_node_execution_failed(event) response = self._workflow_node_finish_to_stream_response( diff --git a/api/core/app/apps/workflow/generate_task_pipeline.py b/api/core/app/apps/workflow/generate_task_pipeline.py index 419a5da806..d119d94a61 100644 --- a/api/core/app/apps/workflow/generate_task_pipeline.py +++ b/api/core/app/apps/workflow/generate_task_pipeline.py @@ -16,6 +16,7 @@ from core.app.entities.queue_entities import ( QueueIterationNextEvent, QueueIterationStartEvent, QueueNodeFailedEvent, + QueueNodeInIterationFailedEvent, QueueNodeStartedEvent, QueueNodeSucceededEvent, QueueParallelBranchRunFailedEvent, @@ -275,7 +276,7 @@ class WorkflowAppGenerateTaskPipeline(BasedGenerateTaskPipeline, WorkflowCycleMa if response: yield response - elif isinstance(event, QueueNodeFailedEvent): + elif isinstance(event, QueueNodeFailedEvent | QueueNodeInIterationFailedEvent): workflow_node_execution = self._handle_workflow_node_execution_failed(event) response = self._workflow_node_finish_to_stream_response( diff --git a/api/core/app/apps/workflow_app_runner.py b/api/core/app/apps/workflow_app_runner.py index ca23bbdd47..9a01e8a253 100644 --- a/api/core/app/apps/workflow_app_runner.py +++ b/api/core/app/apps/workflow_app_runner.py @@ -9,6 +9,7 @@ from core.app.entities.queue_entities import ( QueueIterationNextEvent, QueueIterationStartEvent, QueueNodeFailedEvent, + QueueNodeInIterationFailedEvent, QueueNodeStartedEvent, QueueNodeSucceededEvent, QueueParallelBranchRunFailedEvent, @@ -30,6 +31,7 @@ from core.workflow.graph_engine.entities.event import ( IterationRunNextEvent, IterationRunStartedEvent, IterationRunSucceededEvent, + NodeInIterationFailedEvent, NodeRunFailedEvent, NodeRunRetrieverResourceEvent, NodeRunStartedEvent, @@ -193,6 +195,7 @@ class WorkflowBasedAppRunner(AppRunner): node_run_index=event.route_node_state.index, predecessor_node_id=event.predecessor_node_id, in_iteration_id=event.in_iteration_id, + parallel_mode_run_id=event.parallel_mode_run_id, ) ) elif isinstance(event, NodeRunSucceededEvent): @@ -246,9 +249,40 @@ class WorkflowBasedAppRunner(AppRunner): error=event.route_node_state.node_run_result.error if event.route_node_state.node_run_result and event.route_node_state.node_run_result.error else "Unknown error", + execution_metadata=event.route_node_state.node_run_result.metadata + if event.route_node_state.node_run_result + else {}, in_iteration_id=event.in_iteration_id, ) ) + elif isinstance(event, NodeInIterationFailedEvent): + self._publish_event( + QueueNodeInIterationFailedEvent( + node_execution_id=event.id, + node_id=event.node_id, + node_type=event.node_type, + node_data=event.node_data, + parallel_id=event.parallel_id, + parallel_start_node_id=event.parallel_start_node_id, + parent_parallel_id=event.parent_parallel_id, + parent_parallel_start_node_id=event.parent_parallel_start_node_id, + start_at=event.route_node_state.start_at, + inputs=event.route_node_state.node_run_result.inputs + if event.route_node_state.node_run_result + else {}, + process_data=event.route_node_state.node_run_result.process_data + if event.route_node_state.node_run_result + else {}, + outputs=event.route_node_state.node_run_result.outputs + if event.route_node_state.node_run_result + else {}, + execution_metadata=event.route_node_state.node_run_result.metadata + if event.route_node_state.node_run_result + else {}, + in_iteration_id=event.in_iteration_id, + error=event.error, + ) + ) elif isinstance(event, NodeRunStreamChunkEvent): self._publish_event( QueueTextChunkEvent( @@ -326,6 +360,7 @@ class WorkflowBasedAppRunner(AppRunner): index=event.index, node_run_index=workflow_entry.graph_engine.graph_runtime_state.node_run_steps, output=event.pre_iteration_output, + parallel_mode_run_id=event.parallel_mode_run_id, ) ) elif isinstance(event, (IterationRunSucceededEvent | IterationRunFailedEvent)): diff --git a/api/core/app/entities/queue_entities.py b/api/core/app/entities/queue_entities.py index bc43baf8a5..f1542ec5d8 100644 --- a/api/core/app/entities/queue_entities.py +++ b/api/core/app/entities/queue_entities.py @@ -107,7 +107,8 @@ class QueueIterationNextEvent(AppQueueEvent): """parent parallel id if node is in parallel""" parent_parallel_start_node_id: Optional[str] = None """parent parallel start node id if node is in parallel""" - + parallel_mode_run_id: Optional[str] = None + """iteratoin run in parallel mode run id""" node_run_index: int output: Optional[Any] = None # output for the current iteration @@ -273,6 +274,8 @@ class QueueNodeStartedEvent(AppQueueEvent): in_iteration_id: Optional[str] = None """iteration id if node is in iteration""" start_at: datetime + parallel_mode_run_id: Optional[str] = None + """iteratoin run in parallel mode run id""" class QueueNodeSucceededEvent(AppQueueEvent): @@ -306,6 +309,37 @@ class QueueNodeSucceededEvent(AppQueueEvent): error: Optional[str] = None +class QueueNodeInIterationFailedEvent(AppQueueEvent): + """ + QueueNodeInIterationFailedEvent entity + """ + + event: QueueEvent = QueueEvent.NODE_FAILED + + node_execution_id: str + node_id: str + node_type: NodeType + node_data: BaseNodeData + parallel_id: Optional[str] = None + """parallel id if node is in parallel""" + parallel_start_node_id: Optional[str] = None + """parallel start node id if node is in parallel""" + parent_parallel_id: Optional[str] = None + """parent parallel id if node is in parallel""" + parent_parallel_start_node_id: Optional[str] = None + """parent parallel start node id if node is in parallel""" + in_iteration_id: Optional[str] = None + """iteration id if node is in iteration""" + start_at: datetime + + inputs: Optional[dict[str, Any]] = None + process_data: Optional[dict[str, Any]] = None + outputs: Optional[dict[str, Any]] = None + execution_metadata: Optional[dict[NodeRunMetadataKey, Any]] = None + + error: str + + class QueueNodeFailedEvent(AppQueueEvent): """ QueueNodeFailedEvent entity @@ -332,6 +366,7 @@ class QueueNodeFailedEvent(AppQueueEvent): inputs: Optional[dict[str, Any]] = None process_data: Optional[dict[str, Any]] = None outputs: Optional[dict[str, Any]] = None + execution_metadata: Optional[dict[NodeRunMetadataKey, Any]] = None error: str diff --git a/api/core/app/entities/task_entities.py b/api/core/app/entities/task_entities.py index 4b5f4716ed..7e9aad54be 100644 --- a/api/core/app/entities/task_entities.py +++ b/api/core/app/entities/task_entities.py @@ -244,6 +244,7 @@ class NodeStartStreamResponse(StreamResponse): parent_parallel_id: Optional[str] = None parent_parallel_start_node_id: Optional[str] = None iteration_id: Optional[str] = None + parallel_run_id: Optional[str] = None event: StreamEvent = StreamEvent.NODE_STARTED workflow_run_id: str @@ -432,6 +433,7 @@ class IterationNodeNextStreamResponse(StreamResponse): extras: dict = {} parallel_id: Optional[str] = None parallel_start_node_id: Optional[str] = None + parallel_mode_run_id: Optional[str] = None event: StreamEvent = StreamEvent.ITERATION_NEXT workflow_run_id: str diff --git a/api/core/app/task_pipeline/workflow_cycle_manage.py b/api/core/app/task_pipeline/workflow_cycle_manage.py index 2abee5bef5..b89edf9079 100644 --- a/api/core/app/task_pipeline/workflow_cycle_manage.py +++ b/api/core/app/task_pipeline/workflow_cycle_manage.py @@ -12,6 +12,7 @@ from core.app.entities.queue_entities import ( QueueIterationNextEvent, QueueIterationStartEvent, QueueNodeFailedEvent, + QueueNodeInIterationFailedEvent, QueueNodeStartedEvent, QueueNodeSucceededEvent, QueueParallelBranchRunFailedEvent, @@ -35,6 +36,7 @@ from core.model_runtime.utils.encoders import jsonable_encoder from core.ops.entities.trace_entity import TraceTaskName from core.ops.ops_trace_manager import TraceQueueManager, TraceTask from core.tools.tool_manager import ToolManager +from core.workflow.entities.node_entities import NodeRunMetadataKey from core.workflow.enums import SystemVariableKey from core.workflow.nodes import NodeType from core.workflow.nodes.tool.entities import ToolNodeData @@ -251,6 +253,12 @@ class WorkflowCycleManage: workflow_node_execution.status = WorkflowNodeExecutionStatus.RUNNING.value workflow_node_execution.created_by_role = workflow_run.created_by_role workflow_node_execution.created_by = workflow_run.created_by + workflow_node_execution.execution_metadata = json.dumps( + { + NodeRunMetadataKey.PARALLEL_MODE_RUN_ID: event.parallel_mode_run_id, + NodeRunMetadataKey.ITERATION_ID: event.in_iteration_id, + } + ) workflow_node_execution.created_at = datetime.now(timezone.utc).replace(tzinfo=None) session.add(workflow_node_execution) @@ -305,7 +313,9 @@ class WorkflowCycleManage: return workflow_node_execution - def _handle_workflow_node_execution_failed(self, event: QueueNodeFailedEvent) -> WorkflowNodeExecution: + def _handle_workflow_node_execution_failed( + self, event: QueueNodeFailedEvent | QueueNodeInIterationFailedEvent + ) -> WorkflowNodeExecution: """ Workflow node execution failed :param event: queue node failed event @@ -318,16 +328,19 @@ class WorkflowCycleManage: outputs = WorkflowEntry.handle_special_values(event.outputs) finished_at = datetime.now(timezone.utc).replace(tzinfo=None) elapsed_time = (finished_at - event.start_at).total_seconds() - + execution_metadata = ( + json.dumps(jsonable_encoder(event.execution_metadata)) if event.execution_metadata else None + ) db.session.query(WorkflowNodeExecution).filter(WorkflowNodeExecution.id == workflow_node_execution.id).update( { WorkflowNodeExecution.status: WorkflowNodeExecutionStatus.FAILED.value, WorkflowNodeExecution.error: event.error, WorkflowNodeExecution.inputs: json.dumps(inputs) if inputs else None, - WorkflowNodeExecution.process_data: json.dumps(process_data) if event.process_data else None, + WorkflowNodeExecution.process_data: json.dumps(event.process_data) if event.process_data else None, WorkflowNodeExecution.outputs: json.dumps(outputs) if outputs else None, WorkflowNodeExecution.finished_at: finished_at, WorkflowNodeExecution.elapsed_time: elapsed_time, + WorkflowNodeExecution.execution_metadata: execution_metadata, } ) @@ -342,6 +355,7 @@ class WorkflowCycleManage: workflow_node_execution.outputs = json.dumps(outputs) if outputs else None workflow_node_execution.finished_at = finished_at workflow_node_execution.elapsed_time = elapsed_time + workflow_node_execution.execution_metadata = execution_metadata self._wip_workflow_node_executions.pop(workflow_node_execution.node_execution_id) @@ -448,6 +462,7 @@ class WorkflowCycleManage: parent_parallel_id=event.parent_parallel_id, parent_parallel_start_node_id=event.parent_parallel_start_node_id, iteration_id=event.in_iteration_id, + parallel_run_id=event.parallel_mode_run_id, ), ) @@ -464,7 +479,7 @@ class WorkflowCycleManage: def _workflow_node_finish_to_stream_response( self, - event: QueueNodeSucceededEvent | QueueNodeFailedEvent, + event: QueueNodeSucceededEvent | QueueNodeFailedEvent | QueueNodeInIterationFailedEvent, task_id: str, workflow_node_execution: WorkflowNodeExecution, ) -> Optional[NodeFinishStreamResponse]: @@ -608,6 +623,7 @@ class WorkflowCycleManage: extras={}, parallel_id=event.parallel_id, parallel_start_node_id=event.parallel_start_node_id, + parallel_mode_run_id=event.parallel_mode_run_id, ), ) @@ -633,7 +649,9 @@ class WorkflowCycleManage: created_at=int(time.time()), extras={}, inputs=event.inputs or {}, - status=WorkflowNodeExecutionStatus.SUCCEEDED, + status=WorkflowNodeExecutionStatus.SUCCEEDED + if event.error is None + else WorkflowNodeExecutionStatus.FAILED, error=None, elapsed_time=(datetime.now(timezone.utc).replace(tzinfo=None) - event.start_at).total_seconds(), total_tokens=event.metadata.get("total_tokens", 0) if event.metadata else 0, diff --git a/api/core/workflow/entities/node_entities.py b/api/core/workflow/entities/node_entities.py index 0131bb342b..7e10cddc71 100644 --- a/api/core/workflow/entities/node_entities.py +++ b/api/core/workflow/entities/node_entities.py @@ -23,6 +23,7 @@ class NodeRunMetadataKey(str, Enum): PARALLEL_START_NODE_ID = "parallel_start_node_id" PARENT_PARALLEL_ID = "parent_parallel_id" PARENT_PARALLEL_START_NODE_ID = "parent_parallel_start_node_id" + PARALLEL_MODE_RUN_ID = "parallel_mode_run_id" class NodeRunResult(BaseModel): diff --git a/api/core/workflow/graph_engine/entities/event.py b/api/core/workflow/graph_engine/entities/event.py index 86d89e0a32..bacea191dd 100644 --- a/api/core/workflow/graph_engine/entities/event.py +++ b/api/core/workflow/graph_engine/entities/event.py @@ -59,6 +59,7 @@ class BaseNodeEvent(GraphEngineEvent): class NodeRunStartedEvent(BaseNodeEvent): predecessor_node_id: Optional[str] = None + parallel_mode_run_id: Optional[str] = None """predecessor node id""" @@ -81,6 +82,10 @@ class NodeRunFailedEvent(BaseNodeEvent): error: str = Field(..., description="error") +class NodeInIterationFailedEvent(BaseNodeEvent): + error: str = Field(..., description="error") + + ########################################### # Parallel Branch Events ########################################### @@ -129,6 +134,8 @@ class BaseIterationEvent(GraphEngineEvent): """parent parallel id if node is in parallel""" parent_parallel_start_node_id: Optional[str] = None """parent parallel start node id if node is in parallel""" + parallel_mode_run_id: Optional[str] = None + """iteratoin run in parallel mode run id""" class IterationRunStartedEvent(BaseIterationEvent): diff --git a/api/core/workflow/graph_engine/graph_engine.py b/api/core/workflow/graph_engine/graph_engine.py index 8f58af00ef..f07ad4de11 100644 --- a/api/core/workflow/graph_engine/graph_engine.py +++ b/api/core/workflow/graph_engine/graph_engine.py @@ -4,6 +4,7 @@ import time import uuid from collections.abc import Generator, Mapping from concurrent.futures import ThreadPoolExecutor, wait +from copy import copy, deepcopy from typing import Any, Optional from flask import Flask, current_app @@ -724,6 +725,16 @@ class GraphEngine: """ return time.perf_counter() - start_at > max_execution_time + def create_copy(self): + """ + create a graph engine copy + :return: with a new variable pool instance of graph engine + """ + new_instance = copy(self) + new_instance.graph_runtime_state = copy(self.graph_runtime_state) + new_instance.graph_runtime_state.variable_pool = deepcopy(self.graph_runtime_state.variable_pool) + return new_instance + class GraphRunFailedError(Exception): def __init__(self, error: str): diff --git a/api/core/workflow/nodes/iteration/entities.py b/api/core/workflow/nodes/iteration/entities.py index 4afc870e50..ebcb6f82fb 100644 --- a/api/core/workflow/nodes/iteration/entities.py +++ b/api/core/workflow/nodes/iteration/entities.py @@ -1,3 +1,4 @@ +from enum import Enum from typing import Any, Optional from pydantic import Field @@ -5,6 +6,12 @@ from pydantic import Field from core.workflow.nodes.base import BaseIterationNodeData, BaseIterationState, BaseNodeData +class ErrorHandleMode(str, Enum): + TERMINATED = "terminated" + CONTINUE_ON_ERROR = "continue-on-error" + REMOVE_ABNORMAL_OUTPUT = "remove-abnormal-output" + + class IterationNodeData(BaseIterationNodeData): """ Iteration Node Data. @@ -13,6 +20,9 @@ class IterationNodeData(BaseIterationNodeData): parent_loop_id: Optional[str] = None # redundant field, not used currently iterator_selector: list[str] # variable selector output_selector: list[str] # output selector + is_parallel: bool = False # open the parallel mode or not + parallel_nums: int = 10 # the numbers of parallel + error_handle_mode: ErrorHandleMode = ErrorHandleMode.TERMINATED # how to handle the error class IterationStartNodeData(BaseNodeData): diff --git a/api/core/workflow/nodes/iteration/iteration_node.py b/api/core/workflow/nodes/iteration/iteration_node.py index af79da9215..d121b0530a 100644 --- a/api/core/workflow/nodes/iteration/iteration_node.py +++ b/api/core/workflow/nodes/iteration/iteration_node.py @@ -1,12 +1,20 @@ import logging +import uuid from collections.abc import Generator, Mapping, Sequence +from concurrent.futures import Future, wait from datetime import datetime, timezone -from typing import Any, cast +from queue import Empty, Queue +from typing import TYPE_CHECKING, Any, Optional, cast + +from flask import Flask, current_app from configs import dify_config from core.model_runtime.utils.encoders import jsonable_encoder -from core.variables import IntegerSegment -from core.workflow.entities.node_entities import NodeRunMetadataKey, NodeRunResult +from core.workflow.entities.node_entities import ( + NodeRunMetadataKey, + NodeRunResult, +) +from core.workflow.entities.variable_pool import VariablePool from core.workflow.graph_engine.entities.event import ( BaseGraphEvent, BaseNodeEvent, @@ -17,6 +25,9 @@ from core.workflow.graph_engine.entities.event import ( IterationRunNextEvent, IterationRunStartedEvent, IterationRunSucceededEvent, + NodeInIterationFailedEvent, + NodeRunFailedEvent, + NodeRunStartedEvent, NodeRunStreamChunkEvent, NodeRunSucceededEvent, ) @@ -24,9 +35,11 @@ from core.workflow.graph_engine.entities.graph import Graph from core.workflow.nodes.base import BaseNode from core.workflow.nodes.enums import NodeType from core.workflow.nodes.event import NodeEvent, RunCompletedEvent -from core.workflow.nodes.iteration.entities import IterationNodeData +from core.workflow.nodes.iteration.entities import ErrorHandleMode, IterationNodeData from models.workflow import WorkflowNodeExecutionStatus +if TYPE_CHECKING: + from core.workflow.graph_engine.graph_engine import GraphEngine logger = logging.getLogger(__name__) @@ -38,6 +51,17 @@ class IterationNode(BaseNode[IterationNodeData]): _node_data_cls = IterationNodeData _node_type = NodeType.ITERATION + @classmethod + def get_default_config(cls, filters: Optional[dict] = None) -> dict: + return { + "type": "iteration", + "config": { + "is_parallel": False, + "parallel_nums": 10, + "error_handle_mode": ErrorHandleMode.TERMINATED.value, + }, + } + def _run(self) -> Generator[NodeEvent | InNodeEvent, None, None]: """ Run the node. @@ -83,7 +107,7 @@ class IterationNode(BaseNode[IterationNodeData]): variable_pool.add([self.node_id, "item"], iterator_list_value[0]) # init graph engine - from core.workflow.graph_engine.graph_engine import GraphEngine + from core.workflow.graph_engine.graph_engine import GraphEngine, GraphEngineThreadPool graph_engine = GraphEngine( tenant_id=self.tenant_id, @@ -123,108 +147,64 @@ class IterationNode(BaseNode[IterationNodeData]): index=0, pre_iteration_output=None, ) - outputs: list[Any] = [] try: - for _ in range(len(iterator_list_value)): - # run workflow - rst = graph_engine.run() - for event in rst: - if isinstance(event, (BaseNodeEvent | BaseParallelBranchEvent)) and not event.in_iteration_id: - event.in_iteration_id = self.node_id - - if ( - isinstance(event, BaseNodeEvent) - and event.node_type == NodeType.ITERATION_START - and not isinstance(event, NodeRunStreamChunkEvent) - ): + if self.node_data.is_parallel: + futures: list[Future] = [] + q = Queue() + thread_pool = GraphEngineThreadPool(max_workers=self.node_data.parallel_nums, max_submit_count=100) + for index, item in enumerate(iterator_list_value): + future: Future = thread_pool.submit( + self._run_single_iter_parallel, + current_app._get_current_object(), + q, + iterator_list_value, + inputs, + outputs, + start_at, + graph_engine, + iteration_graph, + index, + item, + ) + future.add_done_callback(thread_pool.task_done_callback) + futures.append(future) + succeeded_count = 0 + while True: + try: + event = q.get(timeout=1) + if event is None: + break + if isinstance(event, IterationRunNextEvent): + succeeded_count += 1 + if succeeded_count == len(futures): + q.put(None) + yield event + if isinstance(event, RunCompletedEvent): + q.put(None) + for f in futures: + if not f.done(): + f.cancel() + yield event + if isinstance(event, IterationRunFailedEvent): + q.put(None) + yield event + except Empty: continue - if isinstance(event, NodeRunSucceededEvent): - if event.route_node_state.node_run_result: - metadata = event.route_node_state.node_run_result.metadata - if not metadata: - metadata = {} - - if NodeRunMetadataKey.ITERATION_ID not in metadata: - metadata[NodeRunMetadataKey.ITERATION_ID] = self.node_id - index_variable = variable_pool.get([self.node_id, "index"]) - if not isinstance(index_variable, IntegerSegment): - yield RunCompletedEvent( - run_result=NodeRunResult( - status=WorkflowNodeExecutionStatus.FAILED, - error=f"Invalid index variable type: {type(index_variable)}", - ) - ) - return - metadata[NodeRunMetadataKey.ITERATION_INDEX] = index_variable.value - event.route_node_state.node_run_result.metadata = metadata - - yield event - elif isinstance(event, BaseGraphEvent): - if isinstance(event, GraphRunFailedEvent): - # iteration run failed - yield IterationRunFailedEvent( - iteration_id=self.id, - iteration_node_id=self.node_id, - iteration_node_type=self.node_type, - iteration_node_data=self.node_data, - start_at=start_at, - inputs=inputs, - outputs={"output": jsonable_encoder(outputs)}, - steps=len(iterator_list_value), - metadata={"total_tokens": graph_engine.graph_runtime_state.total_tokens}, - error=event.error, - ) - - yield RunCompletedEvent( - run_result=NodeRunResult( - status=WorkflowNodeExecutionStatus.FAILED, - error=event.error, - ) - ) - return - else: - event = cast(InNodeEvent, event) - yield event - - # append to iteration output variable list - current_iteration_output_variable = variable_pool.get(self.node_data.output_selector) - if current_iteration_output_variable is None: - yield RunCompletedEvent( - run_result=NodeRunResult( - status=WorkflowNodeExecutionStatus.FAILED, - error=f"Iteration output variable {self.node_data.output_selector} not found", - ) + # wait all threads + wait(futures) + else: + for _ in range(len(iterator_list_value)): + yield from self._run_single_iter( + iterator_list_value, + variable_pool, + inputs, + outputs, + start_at, + graph_engine, + iteration_graph, ) - return - current_iteration_output = current_iteration_output_variable.to_object() - outputs.append(current_iteration_output) - - # remove all nodes outputs from variable pool - for node_id in iteration_graph.node_ids: - variable_pool.remove([node_id]) - - # move to next iteration - current_index_variable = variable_pool.get([self.node_id, "index"]) - if not isinstance(current_index_variable, IntegerSegment): - raise ValueError(f"iteration {self.node_id} current index not found") - - next_index = current_index_variable.value + 1 - variable_pool.add([self.node_id, "index"], next_index) - - if next_index < len(iterator_list_value): - variable_pool.add([self.node_id, "item"], iterator_list_value[next_index]) - - yield IterationRunNextEvent( - iteration_id=self.id, - iteration_node_id=self.node_id, - iteration_node_type=self.node_type, - iteration_node_data=self.node_data, - index=next_index, - pre_iteration_output=jsonable_encoder(current_iteration_output), - ) - yield IterationRunSucceededEvent( iteration_id=self.id, iteration_node_id=self.node_id, @@ -330,3 +310,231 @@ class IterationNode(BaseNode[IterationNodeData]): } return variable_mapping + + def _handle_event_metadata( + self, event: BaseNodeEvent, iter_run_index: str, parallel_mode_run_id: str + ) -> NodeRunStartedEvent | BaseNodeEvent: + """ + add iteration metadata to event. + """ + if not isinstance(event, BaseNodeEvent): + return event + if self.node_data.is_parallel and isinstance(event, NodeRunStartedEvent): + event.parallel_mode_run_id = parallel_mode_run_id + return event + if event.route_node_state.node_run_result: + metadata = event.route_node_state.node_run_result.metadata + if not metadata: + metadata = {} + + if NodeRunMetadataKey.ITERATION_ID not in metadata: + metadata[NodeRunMetadataKey.ITERATION_ID] = self.node_id + if self.node_data.is_parallel: + metadata[NodeRunMetadataKey.PARALLEL_MODE_RUN_ID] = parallel_mode_run_id + else: + metadata[NodeRunMetadataKey.ITERATION_INDEX] = iter_run_index + event.route_node_state.node_run_result.metadata = metadata + return event + + def _run_single_iter( + self, + iterator_list_value: list[str], + variable_pool: VariablePool, + inputs: dict[str, list], + outputs: list, + start_at: datetime, + graph_engine: "GraphEngine", + iteration_graph: Graph, + parallel_mode_run_id: Optional[str] = None, + ) -> Generator[NodeEvent | InNodeEvent, None, None]: + """ + run single iteration + """ + try: + rst = graph_engine.run() + # get current iteration index + current_index = variable_pool.get([self.node_id, "index"]).value + next_index = int(current_index) + 1 + + if current_index is None: + raise ValueError(f"iteration {self.node_id} current index not found") + for event in rst: + if isinstance(event, (BaseNodeEvent | BaseParallelBranchEvent)) and not event.in_iteration_id: + event.in_iteration_id = self.node_id + + if ( + isinstance(event, BaseNodeEvent) + and event.node_type == NodeType.ITERATION_START + and not isinstance(event, NodeRunStreamChunkEvent) + ): + continue + + if isinstance(event, NodeRunSucceededEvent): + yield self._handle_event_metadata(event, current_index, parallel_mode_run_id) + elif isinstance(event, BaseGraphEvent): + if isinstance(event, GraphRunFailedEvent): + # iteration run failed + if self.node_data.is_parallel: + yield IterationRunFailedEvent( + iteration_id=self.id, + iteration_node_id=self.node_id, + iteration_node_type=self.node_type, + iteration_node_data=self.node_data, + parallel_mode_run_id=parallel_mode_run_id, + start_at=start_at, + inputs=inputs, + outputs={"output": jsonable_encoder(outputs)}, + steps=len(iterator_list_value), + metadata={"total_tokens": graph_engine.graph_runtime_state.total_tokens}, + error=event.error, + ) + else: + yield IterationRunFailedEvent( + iteration_id=self.id, + iteration_node_id=self.node_id, + iteration_node_type=self.node_type, + iteration_node_data=self.node_data, + start_at=start_at, + inputs=inputs, + outputs={"output": jsonable_encoder(outputs)}, + steps=len(iterator_list_value), + metadata={"total_tokens": graph_engine.graph_runtime_state.total_tokens}, + error=event.error, + ) + yield RunCompletedEvent( + run_result=NodeRunResult( + status=WorkflowNodeExecutionStatus.FAILED, + error=event.error, + ) + ) + return + else: + event = cast(InNodeEvent, event) + metadata_event = self._handle_event_metadata(event, current_index, parallel_mode_run_id) + if isinstance(event, NodeRunFailedEvent): + if self.node_data.error_handle_mode == ErrorHandleMode.CONTINUE_ON_ERROR: + yield NodeInIterationFailedEvent( + **metadata_event.model_dump(), + ) + outputs.insert(current_index, None) + variable_pool.add([self.node_id, "index"], next_index) + if next_index < len(iterator_list_value): + variable_pool.add([self.node_id, "item"], iterator_list_value[next_index]) + yield IterationRunNextEvent( + iteration_id=self.id, + iteration_node_id=self.node_id, + iteration_node_type=self.node_type, + iteration_node_data=self.node_data, + index=next_index, + parallel_mode_run_id=parallel_mode_run_id, + pre_iteration_output=None, + ) + return + elif self.node_data.error_handle_mode == ErrorHandleMode.REMOVE_ABNORMAL_OUTPUT: + yield NodeInIterationFailedEvent( + **metadata_event.model_dump(), + ) + variable_pool.add([self.node_id, "index"], next_index) + + if next_index < len(iterator_list_value): + variable_pool.add([self.node_id, "item"], iterator_list_value[next_index]) + yield IterationRunNextEvent( + iteration_id=self.id, + iteration_node_id=self.node_id, + iteration_node_type=self.node_type, + iteration_node_data=self.node_data, + index=next_index, + parallel_mode_run_id=parallel_mode_run_id, + pre_iteration_output=None, + ) + return + elif self.node_data.error_handle_mode == ErrorHandleMode.TERMINATED: + yield IterationRunFailedEvent( + iteration_id=self.id, + iteration_node_id=self.node_id, + iteration_node_type=self.node_type, + iteration_node_data=self.node_data, + start_at=start_at, + inputs=inputs, + outputs={"output": None}, + steps=len(iterator_list_value), + metadata={"total_tokens": graph_engine.graph_runtime_state.total_tokens}, + error=event.error, + ) + yield metadata_event + + current_iteration_output = variable_pool.get(self.node_data.output_selector).value + outputs.insert(current_index, current_iteration_output) + # remove all nodes outputs from variable pool + for node_id in iteration_graph.node_ids: + variable_pool.remove([node_id]) + + # move to next iteration + variable_pool.add([self.node_id, "index"], next_index) + + if next_index < len(iterator_list_value): + variable_pool.add([self.node_id, "item"], iterator_list_value[next_index]) + yield IterationRunNextEvent( + iteration_id=self.id, + iteration_node_id=self.node_id, + iteration_node_type=self.node_type, + iteration_node_data=self.node_data, + index=next_index, + parallel_mode_run_id=parallel_mode_run_id, + pre_iteration_output=jsonable_encoder(current_iteration_output) if current_iteration_output else None, + ) + + except Exception as e: + logger.exception(f"Iteration run failed:{str(e)}") + yield IterationRunFailedEvent( + iteration_id=self.id, + iteration_node_id=self.node_id, + iteration_node_type=self.node_type, + iteration_node_data=self.node_data, + start_at=start_at, + inputs=inputs, + outputs={"output": None}, + steps=len(iterator_list_value), + metadata={"total_tokens": graph_engine.graph_runtime_state.total_tokens}, + error=str(e), + ) + yield RunCompletedEvent( + run_result=NodeRunResult( + status=WorkflowNodeExecutionStatus.FAILED, + error=str(e), + ) + ) + + def _run_single_iter_parallel( + self, + flask_app: Flask, + q: Queue, + iterator_list_value: list[str], + inputs: dict[str, list], + outputs: list, + start_at: datetime, + graph_engine: "GraphEngine", + iteration_graph: Graph, + index: int, + item: Any, + ) -> Generator[NodeEvent | InNodeEvent, None, None]: + """ + run single iteration in parallel mode + """ + with flask_app.app_context(): + parallel_mode_run_id = uuid.uuid4().hex + graph_engine_copy = graph_engine.create_copy() + variable_pool_copy = graph_engine_copy.graph_runtime_state.variable_pool + variable_pool_copy.add([self.node_id, "index"], index) + variable_pool_copy.add([self.node_id, "item"], item) + for event in self._run_single_iter( + iterator_list_value=iterator_list_value, + variable_pool=variable_pool_copy, + inputs=inputs, + outputs=outputs, + start_at=start_at, + graph_engine=graph_engine_copy, + iteration_graph=iteration_graph, + parallel_mode_run_id=parallel_mode_run_id, + ): + q.put(event) diff --git a/api/tests/unit_tests/core/workflow/nodes/iteration/test_iteration.py b/api/tests/unit_tests/core/workflow/nodes/iteration/test_iteration.py index d755faee8a..29bd4d6c6c 100644 --- a/api/tests/unit_tests/core/workflow/nodes/iteration/test_iteration.py +++ b/api/tests/unit_tests/core/workflow/nodes/iteration/test_iteration.py @@ -10,6 +10,7 @@ from core.workflow.graph_engine.entities.graph import Graph from core.workflow.graph_engine.entities.graph_init_params import GraphInitParams from core.workflow.graph_engine.entities.graph_runtime_state import GraphRuntimeState from core.workflow.nodes.event import RunCompletedEvent +from core.workflow.nodes.iteration.entities import ErrorHandleMode from core.workflow.nodes.iteration.iteration_node import IterationNode from core.workflow.nodes.template_transform.template_transform_node import TemplateTransformNode from models.enums import UserFrom @@ -185,8 +186,6 @@ def test_run(): outputs={"output": "dify 123"}, ) - # print("") - with patch.object(TemplateTransformNode, "_run", new=tt_generator): # execute node result = iteration_node._run() @@ -404,18 +403,458 @@ def test_run_parallel(): outputs={"output": "dify 123"}, ) - # print("") - with patch.object(TemplateTransformNode, "_run", new=tt_generator): # execute node result = iteration_node._run() count = 0 for item in result: - # print(type(item), item) count += 1 if isinstance(item, RunCompletedEvent): assert item.run_result.status == WorkflowNodeExecutionStatus.SUCCEEDED assert item.run_result.outputs == {"output": ["dify 123", "dify 123"]} assert count == 32 + + +def test_iteration_run_in_parallel_mode(): + graph_config = { + "edges": [ + { + "id": "start-source-pe-target", + "source": "start", + "target": "pe", + }, + { + "id": "iteration-1-source-answer-3-target", + "source": "iteration-1", + "target": "answer-3", + }, + { + "id": "iteration-start-source-tt-target", + "source": "iteration-start", + "target": "tt", + }, + { + "id": "iteration-start-source-tt-2-target", + "source": "iteration-start", + "target": "tt-2", + }, + { + "id": "tt-source-if-else-target", + "source": "tt", + "target": "if-else", + }, + { + "id": "tt-2-source-if-else-target", + "source": "tt-2", + "target": "if-else", + }, + { + "id": "if-else-true-answer-2-target", + "source": "if-else", + "sourceHandle": "true", + "target": "answer-2", + }, + { + "id": "if-else-false-answer-4-target", + "source": "if-else", + "sourceHandle": "false", + "target": "answer-4", + }, + { + "id": "pe-source-iteration-1-target", + "source": "pe", + "target": "iteration-1", + }, + ], + "nodes": [ + {"data": {"title": "Start", "type": "start", "variables": []}, "id": "start"}, + { + "data": { + "iterator_selector": ["pe", "list_output"], + "output_selector": ["tt", "output"], + "output_type": "array[string]", + "startNodeType": "template-transform", + "start_node_id": "iteration-start", + "title": "iteration", + "type": "iteration", + }, + "id": "iteration-1", + }, + { + "data": { + "answer": "{{#tt.output#}}", + "iteration_id": "iteration-1", + "title": "answer 2", + "type": "answer", + }, + "id": "answer-2", + }, + { + "data": { + "iteration_id": "iteration-1", + "title": "iteration-start", + "type": "iteration-start", + }, + "id": "iteration-start", + }, + { + "data": { + "iteration_id": "iteration-1", + "template": "{{ arg1 }} 123", + "title": "template transform", + "type": "template-transform", + "variables": [{"value_selector": ["sys", "query"], "variable": "arg1"}], + }, + "id": "tt", + }, + { + "data": { + "iteration_id": "iteration-1", + "template": "{{ arg1 }} 321", + "title": "template transform", + "type": "template-transform", + "variables": [{"value_selector": ["sys", "query"], "variable": "arg1"}], + }, + "id": "tt-2", + }, + { + "data": {"answer": "{{#iteration-1.output#}}88888", "title": "answer 3", "type": "answer"}, + "id": "answer-3", + }, + { + "data": { + "conditions": [ + { + "comparison_operator": "is", + "id": "1721916275284", + "value": "hi", + "variable_selector": ["sys", "query"], + } + ], + "iteration_id": "iteration-1", + "logical_operator": "and", + "title": "if", + "type": "if-else", + }, + "id": "if-else", + }, + { + "data": {"answer": "no hi", "iteration_id": "iteration-1", "title": "answer 4", "type": "answer"}, + "id": "answer-4", + }, + { + "data": { + "instruction": "test1", + "model": { + "completion_params": {"temperature": 0.7}, + "mode": "chat", + "name": "gpt-4o", + "provider": "openai", + }, + "parameters": [ + {"description": "test", "name": "list_output", "required": False, "type": "array[string]"} + ], + "query": ["sys", "query"], + "reasoning_mode": "prompt", + "title": "pe", + "type": "parameter-extractor", + }, + "id": "pe", + }, + ], + } + + graph = Graph.init(graph_config=graph_config) + + init_params = GraphInitParams( + tenant_id="1", + app_id="1", + workflow_type=WorkflowType.CHAT, + workflow_id="1", + graph_config=graph_config, + user_id="1", + user_from=UserFrom.ACCOUNT, + invoke_from=InvokeFrom.DEBUGGER, + call_depth=0, + ) + + # construct variable pool + pool = VariablePool( + system_variables={ + SystemVariableKey.QUERY: "dify", + SystemVariableKey.FILES: [], + SystemVariableKey.CONVERSATION_ID: "abababa", + SystemVariableKey.USER_ID: "1", + }, + user_inputs={}, + environment_variables=[], + ) + pool.add(["pe", "list_output"], ["dify-1", "dify-2"]) + + parallel_iteration_node = IterationNode( + id=str(uuid.uuid4()), + graph_init_params=init_params, + graph=graph, + graph_runtime_state=GraphRuntimeState(variable_pool=pool, start_at=time.perf_counter()), + config={ + "data": { + "iterator_selector": ["pe", "list_output"], + "output_selector": ["tt", "output"], + "output_type": "array[string]", + "startNodeType": "template-transform", + "start_node_id": "iteration-start", + "title": "迭代", + "type": "iteration", + "is_parallel": True, + }, + "id": "iteration-1", + }, + ) + sequential_iteration_node = IterationNode( + id=str(uuid.uuid4()), + graph_init_params=init_params, + graph=graph, + graph_runtime_state=GraphRuntimeState(variable_pool=pool, start_at=time.perf_counter()), + config={ + "data": { + "iterator_selector": ["pe", "list_output"], + "output_selector": ["tt", "output"], + "output_type": "array[string]", + "startNodeType": "template-transform", + "start_node_id": "iteration-start", + "title": "迭代", + "type": "iteration", + "is_parallel": True, + }, + "id": "iteration-1", + }, + ) + + def tt_generator(self): + return NodeRunResult( + status=WorkflowNodeExecutionStatus.SUCCEEDED, + inputs={"iterator_selector": "dify"}, + outputs={"output": "dify 123"}, + ) + + with patch.object(TemplateTransformNode, "_run", new=tt_generator): + # execute node + parallel_result = parallel_iteration_node._run() + sequential_result = sequential_iteration_node._run() + assert parallel_iteration_node.node_data.parallel_nums == 10 + assert parallel_iteration_node.node_data.error_handle_mode == ErrorHandleMode.TERMINATED + count = 0 + parallel_arr = [] + sequential_arr = [] + for item in parallel_result: + count += 1 + parallel_arr.append(item) + if isinstance(item, RunCompletedEvent): + assert item.run_result.status == WorkflowNodeExecutionStatus.SUCCEEDED + assert item.run_result.outputs == {"output": ["dify 123", "dify 123"]} + assert count == 32 + + for item in sequential_result: + sequential_arr.append(item) + count += 1 + if isinstance(item, RunCompletedEvent): + assert item.run_result.status == WorkflowNodeExecutionStatus.SUCCEEDED + assert item.run_result.outputs == {"output": ["dify 123", "dify 123"]} + assert count == 64 + + +def test_iteration_run_error_handle(): + graph_config = { + "edges": [ + { + "id": "start-source-pe-target", + "source": "start", + "target": "pe", + }, + { + "id": "iteration-1-source-answer-3-target", + "source": "iteration-1", + "target": "answer-3", + }, + { + "id": "tt-source-if-else-target", + "source": "iteration-start", + "target": "if-else", + }, + { + "id": "if-else-true-answer-2-target", + "source": "if-else", + "sourceHandle": "true", + "target": "tt", + }, + { + "id": "if-else-false-answer-4-target", + "source": "if-else", + "sourceHandle": "false", + "target": "tt2", + }, + { + "id": "pe-source-iteration-1-target", + "source": "pe", + "target": "iteration-1", + }, + ], + "nodes": [ + {"data": {"title": "Start", "type": "start", "variables": []}, "id": "start"}, + { + "data": { + "iterator_selector": ["pe", "list_output"], + "output_selector": ["tt2", "output"], + "output_type": "array[string]", + "start_node_id": "if-else", + "title": "iteration", + "type": "iteration", + }, + "id": "iteration-1", + }, + { + "data": { + "iteration_id": "iteration-1", + "template": "{{ arg1.split(arg2) }}", + "title": "template transform", + "type": "template-transform", + "variables": [ + {"value_selector": ["iteration-1", "item"], "variable": "arg1"}, + {"value_selector": ["iteration-1", "index"], "variable": "arg2"}, + ], + }, + "id": "tt", + }, + { + "data": { + "iteration_id": "iteration-1", + "template": "{{ arg1 }}", + "title": "template transform", + "type": "template-transform", + "variables": [ + {"value_selector": ["iteration-1", "item"], "variable": "arg1"}, + ], + }, + "id": "tt2", + }, + { + "data": {"answer": "{{#iteration-1.output#}}88888", "title": "answer 3", "type": "answer"}, + "id": "answer-3", + }, + { + "data": { + "iteration_id": "iteration-1", + "title": "iteration-start", + "type": "iteration-start", + }, + "id": "iteration-start", + }, + { + "data": { + "conditions": [ + { + "comparison_operator": "is", + "id": "1721916275284", + "value": "1", + "variable_selector": ["iteration-1", "item"], + } + ], + "iteration_id": "iteration-1", + "logical_operator": "and", + "title": "if", + "type": "if-else", + }, + "id": "if-else", + }, + { + "data": { + "instruction": "test1", + "model": { + "completion_params": {"temperature": 0.7}, + "mode": "chat", + "name": "gpt-4o", + "provider": "openai", + }, + "parameters": [ + {"description": "test", "name": "list_output", "required": False, "type": "array[string]"} + ], + "query": ["sys", "query"], + "reasoning_mode": "prompt", + "title": "pe", + "type": "parameter-extractor", + }, + "id": "pe", + }, + ], + } + + graph = Graph.init(graph_config=graph_config) + + init_params = GraphInitParams( + tenant_id="1", + app_id="1", + workflow_type=WorkflowType.CHAT, + workflow_id="1", + graph_config=graph_config, + user_id="1", + user_from=UserFrom.ACCOUNT, + invoke_from=InvokeFrom.DEBUGGER, + call_depth=0, + ) + + # construct variable pool + pool = VariablePool( + system_variables={ + SystemVariableKey.QUERY: "dify", + SystemVariableKey.FILES: [], + SystemVariableKey.CONVERSATION_ID: "abababa", + SystemVariableKey.USER_ID: "1", + }, + user_inputs={}, + environment_variables=[], + ) + pool.add(["pe", "list_output"], ["1", "1"]) + iteration_node = IterationNode( + id=str(uuid.uuid4()), + graph_init_params=init_params, + graph=graph, + graph_runtime_state=GraphRuntimeState(variable_pool=pool, start_at=time.perf_counter()), + config={ + "data": { + "iterator_selector": ["pe", "list_output"], + "output_selector": ["tt", "output"], + "output_type": "array[string]", + "startNodeType": "template-transform", + "start_node_id": "iteration-start", + "title": "iteration", + "type": "iteration", + "is_parallel": True, + "error_handle_mode": ErrorHandleMode.CONTINUE_ON_ERROR, + }, + "id": "iteration-1", + }, + ) + # execute continue on error node + result = iteration_node._run() + result_arr = [] + count = 0 + for item in result: + result_arr.append(item) + count += 1 + if isinstance(item, RunCompletedEvent): + assert item.run_result.status == WorkflowNodeExecutionStatus.SUCCEEDED + assert item.run_result.outputs == {"output": [None, None]} + + assert count == 14 + # execute remove abnormal output + iteration_node.node_data.error_handle_mode = ErrorHandleMode.REMOVE_ABNORMAL_OUTPUT + result = iteration_node._run() + count = 0 + for item in result: + count += 1 + if isinstance(item, RunCompletedEvent): + assert item.run_result.status == WorkflowNodeExecutionStatus.SUCCEEDED + assert item.run_result.outputs == {"output": []} + assert count == 14 diff --git a/web/app/components/base/select/index.tsx b/web/app/components/base/select/index.tsx index ee5cee977b..c70cf24661 100644 --- a/web/app/components/base/select/index.tsx +++ b/web/app/components/base/select/index.tsx @@ -125,7 +125,7 @@ const Select: FC = ({
- {filteredItems.length > 0 && ( + {(filteredItems.length > 0 && open) && ( {filteredItems.map((item: Item) => ( { newNode.data.isInIteration = true newNode.data.iteration_id = prevNode.parentId newNode.zIndex = ITERATION_CHILDREN_Z_INDEX + if (newNode.data.type === BlockEnum.Answer || newNode.data.type === BlockEnum.Tool || newNode.data.type === BlockEnum.Assigner) { + const parentIterNodeIndex = nodes.findIndex(node => node.id === prevNode.parentId) + const iterNodeData: IterationNodeType = nodes[parentIterNodeIndex].data + iterNodeData._isShowTips = true + } } const newEdge: Edge = { diff --git a/web/app/components/workflow/hooks/use-workflow-run.ts b/web/app/components/workflow/hooks/use-workflow-run.ts index 0bbb1adab8..26654ef71e 100644 --- a/web/app/components/workflow/hooks/use-workflow-run.ts +++ b/web/app/components/workflow/hooks/use-workflow-run.ts @@ -14,6 +14,7 @@ import { NodeRunningStatus, WorkflowRunningStatus, } from '../types' +import { DEFAULT_ITER_TIMES } from '../constants' import { useWorkflowUpdate } from './use-workflow-interactions' import { useStore as useAppStore } from '@/app/components/app/store' import type { IOtherOptions } from '@/service/base' @@ -170,11 +171,13 @@ export const useWorkflowRun = () => { const { workflowRunningData, setWorkflowRunningData, + setIterParallelLogMap, } = workflowStore.getState() const { edges, setEdges, } = store.getState() + setIterParallelLogMap(new Map()) setWorkflowRunningData(produce(workflowRunningData!, (draft) => { draft.task_id = task_id draft.result = { @@ -244,6 +247,8 @@ export const useWorkflowRun = () => { const { workflowRunningData, setWorkflowRunningData, + iterParallelLogMap, + setIterParallelLogMap, } = workflowStore.getState() const { getNodes, @@ -259,10 +264,21 @@ export const useWorkflowRun = () => { const tracing = draft.tracing! const iterations = tracing.find(trace => trace.node_id === node?.parentId) const currIteration = iterations?.details![node.data.iteration_index] || iterations?.details![iterations.details!.length - 1] - currIteration?.push({ - ...data, - status: NodeRunningStatus.Running, - } as any) + if (!data.parallel_run_id) { + currIteration?.push({ + ...data, + status: NodeRunningStatus.Running, + } as any) + } + else { + if (!iterParallelLogMap.has(data.parallel_run_id)) + iterParallelLogMap.set(data.parallel_run_id, [{ ...data, status: NodeRunningStatus.Running } as any]) + else + iterParallelLogMap.get(data.parallel_run_id)!.push({ ...data, status: NodeRunningStatus.Running } as any) + setIterParallelLogMap(iterParallelLogMap) + if (iterations) + iterations.details = Array.from(iterParallelLogMap.values()) + } })) } else { @@ -309,6 +325,8 @@ export const useWorkflowRun = () => { const { workflowRunningData, setWorkflowRunningData, + iterParallelLogMap, + setIterParallelLogMap, } = workflowStore.getState() const { getNodes, @@ -317,21 +335,21 @@ export const useWorkflowRun = () => { const nodes = getNodes() const nodeParentId = nodes.find(node => node.id === data.node_id)!.parentId if (nodeParentId) { - setWorkflowRunningData(produce(workflowRunningData!, (draft) => { - const tracing = draft.tracing! - const iterations = tracing.find(trace => trace.node_id === nodeParentId) // the iteration node + if (!data.execution_metadata.parallel_mode_run_id) { + setWorkflowRunningData(produce(workflowRunningData!, (draft) => { + const tracing = draft.tracing! + const iterations = tracing.find(trace => trace.node_id === nodeParentId) // the iteration node - if (iterations && iterations.details) { - const iterationIndex = data.execution_metadata?.iteration_index || 0 - if (!iterations.details[iterationIndex]) - iterations.details[iterationIndex] = [] + if (iterations && iterations.details) { + const iterationIndex = data.execution_metadata?.iteration_index || 0 + if (!iterations.details[iterationIndex]) + iterations.details[iterationIndex] = [] - const currIteration = iterations.details[iterationIndex] - const nodeIndex = currIteration.findIndex(node => - node.node_id === data.node_id && ( - node.execution_metadata?.parallel_id === data.execution_metadata?.parallel_id || node.parallel_id === data.execution_metadata?.parallel_id), - ) - if (data.status === NodeRunningStatus.Succeeded) { + const currIteration = iterations.details[iterationIndex] + const nodeIndex = currIteration.findIndex(node => + node.node_id === data.node_id && ( + node.execution_metadata?.parallel_id === data.execution_metadata?.parallel_id || node.parallel_id === data.execution_metadata?.parallel_id), + ) if (nodeIndex !== -1) { currIteration[nodeIndex] = { ...currIteration[nodeIndex], @@ -344,8 +362,40 @@ export const useWorkflowRun = () => { } as any) } } - } - })) + })) + } + else { + // open parallel mode + setWorkflowRunningData(produce(workflowRunningData!, (draft) => { + const tracing = draft.tracing! + const iterations = tracing.find(trace => trace.node_id === nodeParentId) // the iteration node + + if (iterations && iterations.details) { + const iterRunID = data.execution_metadata?.parallel_mode_run_id + + const currIteration = iterParallelLogMap.get(iterRunID) + const nodeIndex = currIteration?.findIndex(node => + node.node_id === data.node_id && ( + node?.parallel_run_id === data.execution_metadata?.parallel_mode_run_id), + ) + if (currIteration) { + if (nodeIndex !== undefined && nodeIndex !== -1) { + currIteration[nodeIndex] = { + ...currIteration[nodeIndex], + ...data, + } as any + } + else { + currIteration.push({ + ...data, + } as any) + } + } + setIterParallelLogMap(iterParallelLogMap) + iterations.details = Array.from(iterParallelLogMap.values()) + } + })) + } } else { setWorkflowRunningData(produce(workflowRunningData!, (draft) => { @@ -379,6 +429,7 @@ export const useWorkflowRun = () => { const { workflowRunningData, setWorkflowRunningData, + setIterTimes, } = workflowStore.getState() const { getNodes, @@ -388,6 +439,7 @@ export const useWorkflowRun = () => { transform, } = store.getState() const nodes = getNodes() + setIterTimes(DEFAULT_ITER_TIMES) setWorkflowRunningData(produce(workflowRunningData!, (draft) => { draft.tracing!.push({ ...data, @@ -431,6 +483,8 @@ export const useWorkflowRun = () => { const { workflowRunningData, setWorkflowRunningData, + iterTimes, + setIterTimes, } = workflowStore.getState() const { data } = params @@ -445,13 +499,14 @@ export const useWorkflowRun = () => { if (iteration.details!.length >= iteration.metadata.iterator_length!) return } - iteration?.details!.push([]) + if (!data.parallel_mode_run_id) + iteration?.details!.push([]) })) const nodes = getNodes() const newNodes = produce(nodes, (draft) => { const currentNode = draft.find(node => node.id === data.node_id)! - - currentNode.data._iterationIndex = data.index > 0 ? data.index : 1 + currentNode.data._iterationIndex = iterTimes + setIterTimes(iterTimes + 1) }) setNodes(newNodes) @@ -464,6 +519,7 @@ export const useWorkflowRun = () => { const { workflowRunningData, setWorkflowRunningData, + setIterTimes, } = workflowStore.getState() const { getNodes, @@ -480,7 +536,7 @@ export const useWorkflowRun = () => { }) } })) - + setIterTimes(DEFAULT_ITER_TIMES) const newNodes = produce(nodes, (draft) => { const currentNode = draft.find(node => node.id === data.node_id)! diff --git a/web/app/components/workflow/nodes/_base/components/field.tsx b/web/app/components/workflow/nodes/_base/components/field.tsx index 6459cf8056..b2f815a325 100644 --- a/web/app/components/workflow/nodes/_base/components/field.tsx +++ b/web/app/components/workflow/nodes/_base/components/field.tsx @@ -12,15 +12,15 @@ import Tooltip from '@/app/components/base/tooltip' type Props = { className?: string title: JSX.Element | string | DefaultTFuncReturn + tooltip?: React.ReactNode isSubTitle?: boolean - tooltip?: string supportFold?: boolean children?: JSX.Element | string | null operations?: JSX.Element inline?: boolean } -const Filed: FC = ({ +const Field: FC = ({ className, title, isSubTitle, @@ -60,4 +60,4 @@ const Filed: FC = ({ ) } -export default React.memo(Filed) +export default React.memo(Field) diff --git a/web/app/components/workflow/nodes/_base/node.tsx b/web/app/components/workflow/nodes/_base/node.tsx index bd5921c735..e864c419e2 100644 --- a/web/app/components/workflow/nodes/_base/node.tsx +++ b/web/app/components/workflow/nodes/_base/node.tsx @@ -25,6 +25,7 @@ import { useToolIcon, } from '../../hooks' import { useNodeIterationInteractions } from '../iteration/use-interactions' +import type { IterationNodeType } from '../iteration/types' import { NodeSourceHandle, NodeTargetHandle, @@ -34,6 +35,7 @@ import NodeControl from './components/node-control' import AddVariablePopupWithPosition from './components/add-variable-popup-with-position' import cn from '@/utils/classnames' import BlockIcon from '@/app/components/workflow/block-icon' +import Tooltip from '@/app/components/base/tooltip' type BaseNodeProps = { children: ReactElement @@ -166,9 +168,27 @@ const BaseNode: FC = ({ />
- {data.title} +
+ {data.title} +
+ { + data.type === BlockEnum.Iteration && (data as IterationNodeType).is_parallel && ( + +
+ {t('workflow.nodes.iteration.parallelModeEnableTitle')} +
+ {t('workflow.nodes.iteration.parallelModeEnableDesc')} +
} + > +
+ {t('workflow.nodes.iteration.parallelModeUpper')} +
+ + ) + } { data._iterationLength && data._iterationIndex && data._runningStatus === NodeRunningStatus.Running && ( diff --git a/web/app/components/workflow/nodes/iteration/default.ts b/web/app/components/workflow/nodes/iteration/default.ts index 3afa52d06e..cdef268adb 100644 --- a/web/app/components/workflow/nodes/iteration/default.ts +++ b/web/app/components/workflow/nodes/iteration/default.ts @@ -1,7 +1,10 @@ -import { BlockEnum } from '../../types' +import { BlockEnum, ErrorHandleMode } from '../../types' import type { NodeDefault } from '../../types' import type { IterationNodeType } from './types' -import { ALL_CHAT_AVAILABLE_BLOCKS, ALL_COMPLETION_AVAILABLE_BLOCKS } from '@/app/components/workflow/constants' +import { + ALL_CHAT_AVAILABLE_BLOCKS, + ALL_COMPLETION_AVAILABLE_BLOCKS, +} from '@/app/components/workflow/constants' const i18nPrefix = 'workflow' const nodeDefault: NodeDefault = { @@ -10,25 +13,45 @@ const nodeDefault: NodeDefault = { iterator_selector: [], output_selector: [], _children: [], + _isShowTips: false, + is_parallel: false, + parallel_nums: 10, + error_handle_mode: ErrorHandleMode.Terminated, }, getAvailablePrevNodes(isChatMode: boolean) { const nodes = isChatMode ? ALL_CHAT_AVAILABLE_BLOCKS - : ALL_COMPLETION_AVAILABLE_BLOCKS.filter(type => type !== BlockEnum.End) + : ALL_COMPLETION_AVAILABLE_BLOCKS.filter( + type => type !== BlockEnum.End, + ) return nodes }, getAvailableNextNodes(isChatMode: boolean) { - const nodes = isChatMode ? ALL_CHAT_AVAILABLE_BLOCKS : ALL_COMPLETION_AVAILABLE_BLOCKS + const nodes = isChatMode + ? ALL_CHAT_AVAILABLE_BLOCKS + : ALL_COMPLETION_AVAILABLE_BLOCKS return nodes }, checkValid(payload: IterationNodeType, t: any) { let errorMessages = '' - if (!errorMessages && (!payload.iterator_selector || payload.iterator_selector.length === 0)) - errorMessages = t(`${i18nPrefix}.errorMsg.fieldRequired`, { field: t(`${i18nPrefix}.nodes.iteration.input`) }) + if ( + !errorMessages + && (!payload.iterator_selector || payload.iterator_selector.length === 0) + ) { + errorMessages = t(`${i18nPrefix}.errorMsg.fieldRequired`, { + field: t(`${i18nPrefix}.nodes.iteration.input`), + }) + } - if (!errorMessages && (!payload.output_selector || payload.output_selector.length === 0)) - errorMessages = t(`${i18nPrefix}.errorMsg.fieldRequired`, { field: t(`${i18nPrefix}.nodes.iteration.output`) }) + if ( + !errorMessages + && (!payload.output_selector || payload.output_selector.length === 0) + ) { + errorMessages = t(`${i18nPrefix}.errorMsg.fieldRequired`, { + field: t(`${i18nPrefix}.nodes.iteration.output`), + }) + } return { isValid: !errorMessages, diff --git a/web/app/components/workflow/nodes/iteration/node.tsx b/web/app/components/workflow/nodes/iteration/node.tsx index 48a005a261..fda033b87a 100644 --- a/web/app/components/workflow/nodes/iteration/node.tsx +++ b/web/app/components/workflow/nodes/iteration/node.tsx @@ -8,12 +8,16 @@ import { useNodesInitialized, useViewport, } from 'reactflow' +import { useTranslation } from 'react-i18next' import { IterationStartNodeDumb } from '../iteration-start' import { useNodeIterationInteractions } from './use-interactions' import type { IterationNodeType } from './types' import AddBlock from './add-block' import cn from '@/utils/classnames' import type { NodeProps } from '@/app/components/workflow/types' +import Toast from '@/app/components/base/toast' + +const i18nPrefix = 'workflow.nodes.iteration' const Node: FC> = ({ id, @@ -22,11 +26,20 @@ const Node: FC> = ({ const { zoom } = useViewport() const nodesInitialized = useNodesInitialized() const { handleNodeIterationRerender } = useNodeIterationInteractions() + const { t } = useTranslation() useEffect(() => { if (nodesInitialized) handleNodeIterationRerender(id) - }, [nodesInitialized, id, handleNodeIterationRerender]) + if (data.is_parallel && data._isShowTips) { + Toast.notify({ + type: 'warning', + message: t(`${i18nPrefix}.answerNodeWarningDesc`), + duration: 5000, + }) + data._isShowTips = false + } + }, [nodesInitialized, id, handleNodeIterationRerender, data, t]) return (
> = ({ data, }) => { const { t } = useTranslation() - + const responseMethod = [ + { + value: ErrorHandleMode.Terminated, + name: t(`${i18nPrefix}.ErrorMethod.operationTerminated`), + }, + { + value: ErrorHandleMode.ContinueOnError, + name: t(`${i18nPrefix}.ErrorMethod.continueOnError`), + }, + { + value: ErrorHandleMode.RemoveAbnormalOutput, + name: t(`${i18nPrefix}.ErrorMethod.removeAbnormalOutput`), + }, + ] const { readOnly, inputs, @@ -47,6 +66,9 @@ const Panel: FC> = ({ setIterator, iteratorInputKey, iterationRunResult, + changeParallel, + changeErrorResponseMode, + changeParallelNums, } = useConfig(id, data) return ( @@ -87,6 +109,39 @@ const Panel: FC> = ({ />
+
+ {t(`${i18nPrefix}.parallelPanelDesc`)}
} inline> + + + + { + inputs.is_parallel && (
+ {t(`${i18nPrefix}.MaxParallelismDesc`)}
}> +
+ { changeParallelNums(Number(e.target.value)) }} /> + +
+ + + ) + } +
+ +
+ +
+ + + +
+ {isShowSingleRun && ( { @@ -184,6 +185,25 @@ const useConfig = (id: string, payload: IterationNodeType) => { }) }, [iteratorInputKey, runInputData, setRunInputData]) + const changeParallel = useCallback((value: boolean) => { + const newInputs = produce(inputs, (draft) => { + draft.is_parallel = value + }) + setInputs(newInputs) + }, [inputs, setInputs]) + + const changeErrorResponseMode = useCallback((item: Item) => { + const newInputs = produce(inputs, (draft) => { + draft.error_handle_mode = item.value as ErrorHandleMode + }) + setInputs(newInputs) + }, [inputs, setInputs]) + const changeParallelNums = useCallback((num: number) => { + const newInputs = produce(inputs, (draft) => { + draft.parallel_nums = num + }) + setInputs(newInputs) + }, [inputs, setInputs]) return { readOnly, inputs, @@ -210,6 +230,9 @@ const useConfig = (id: string, payload: IterationNodeType) => { setIterator, iteratorInputKey, iterationRunResult, + changeParallel, + changeErrorResponseMode, + changeParallelNums, } } diff --git a/web/app/components/workflow/panel/debug-and-preview/hooks.ts b/web/app/components/workflow/panel/debug-and-preview/hooks.ts index 58a4561e2c..5d932a1ba2 100644 --- a/web/app/components/workflow/panel/debug-and-preview/hooks.ts +++ b/web/app/components/workflow/panel/debug-and-preview/hooks.ts @@ -9,6 +9,8 @@ import { produce, setAutoFreeze } from 'immer' import { uniqBy } from 'lodash-es' import { useWorkflowRun } from '../../hooks' import { NodeRunningStatus, WorkflowRunningStatus } from '../../types' +import { useWorkflowStore } from '../../store' +import { DEFAULT_ITER_TIMES } from '../../constants' import type { ChatItem, Inputs, @@ -43,6 +45,7 @@ export const useChat = ( const { notify } = useToastContext() const { handleRun } = useWorkflowRun() const hasStopResponded = useRef(false) + const workflowStore = useWorkflowStore() const conversationId = useRef('') const taskIdRef = useRef('') const [chatList, setChatList] = useState(prevChatList || []) @@ -52,6 +55,9 @@ export const useChat = ( const [suggestedQuestions, setSuggestQuestions] = useState([]) const suggestedQuestionsAbortControllerRef = useRef(null) + const { + setIterTimes, + } = workflowStore.getState() useEffect(() => { setAutoFreeze(false) return () => { @@ -102,15 +108,16 @@ export const useChat = ( handleResponding(false) if (stopChat && taskIdRef.current) stopChat(taskIdRef.current) - + setIterTimes(DEFAULT_ITER_TIMES) if (suggestedQuestionsAbortControllerRef.current) suggestedQuestionsAbortControllerRef.current.abort() - }, [handleResponding, stopChat]) + }, [handleResponding, setIterTimes, stopChat]) const handleRestart = useCallback(() => { conversationId.current = '' taskIdRef.current = '' handleStop() + setIterTimes(DEFAULT_ITER_TIMES) const newChatList = config?.opening_statement ? [{ id: `${Date.now()}`, @@ -126,6 +133,7 @@ export const useChat = ( config, handleStop, handleUpdateChatList, + setIterTimes, ]) const updateCurrentQA = useCallback(({ diff --git a/web/app/components/workflow/run/index.tsx b/web/app/components/workflow/run/index.tsx index 9e636e902b..89db43fa35 100644 --- a/web/app/components/workflow/run/index.tsx +++ b/web/app/components/workflow/run/index.tsx @@ -60,36 +60,67 @@ const RunPanel: FC = ({ hideResult, activeTab = 'RESULT', runID, getRe }, [notify, getResultCallback]) const formatNodeList = useCallback((list: NodeTracing[]) => { - const allItems = list.reverse() + const allItems = [...list].reverse() const result: NodeTracing[] = [] - allItems.forEach((item) => { - const { node_type, execution_metadata } = item - if (node_type !== BlockEnum.Iteration) { - const isInIteration = !!execution_metadata?.iteration_id + const groupMap = new Map() - if (isInIteration) { - const iterationNode = result.find(node => node.node_id === execution_metadata?.iteration_id) - const iterationDetails = iterationNode?.details - const currentIterationIndex = execution_metadata?.iteration_index ?? 0 - - if (Array.isArray(iterationDetails)) { - if (iterationDetails.length === 0 || !iterationDetails[currentIterationIndex]) - iterationDetails[currentIterationIndex] = [item] - else - iterationDetails[currentIterationIndex].push(item) - } - return - } - // not in iteration - result.push(item) - - return - } + const processIterationNode = (item: NodeTracing) => { result.push({ ...item, details: [], }) + } + const updateParallelModeGroup = (runId: string, item: NodeTracing, iterationNode: NodeTracing) => { + if (!groupMap.has(runId)) + groupMap.set(runId, [item]) + else + groupMap.get(runId)!.push(item) + if (item.status === 'failed') { + iterationNode.status = 'failed' + iterationNode.error = item.error + } + + iterationNode.details = Array.from(groupMap.values()) + } + const updateSequentialModeGroup = (index: number, item: NodeTracing, iterationNode: NodeTracing) => { + const { details } = iterationNode + if (details) { + if (!details[index]) + details[index] = [item] + else + details[index].push(item) + } + + if (item.status === 'failed') { + iterationNode.status = 'failed' + iterationNode.error = item.error + } + } + const processNonIterationNode = (item: NodeTracing) => { + const { execution_metadata } = item + if (!execution_metadata?.iteration_id) { + result.push(item) + return + } + + const iterationNode = result.find(node => node.node_id === execution_metadata.iteration_id) + if (!iterationNode || !Array.isArray(iterationNode.details)) + return + + const { parallel_mode_run_id, iteration_index = 0 } = execution_metadata + + if (parallel_mode_run_id) + updateParallelModeGroup(parallel_mode_run_id, item, iterationNode) + else + updateSequentialModeGroup(iteration_index, item, iterationNode) + } + + allItems.forEach((item) => { + item.node_type === BlockEnum.Iteration + ? processIterationNode(item) + : processNonIterationNode(item) }) + return result }, []) diff --git a/web/app/components/workflow/run/iteration-result-panel.tsx b/web/app/components/workflow/run/iteration-result-panel.tsx index 7e2f6cbc00..c4cd909f2e 100644 --- a/web/app/components/workflow/run/iteration-result-panel.tsx +++ b/web/app/components/workflow/run/iteration-result-panel.tsx @@ -5,6 +5,7 @@ import { useTranslation } from 'react-i18next' import { RiArrowRightSLine, RiCloseLine, + RiErrorWarningLine, } from '@remixicon/react' import { ArrowNarrowLeft } from '../../base/icons/src/vender/line/arrows' import TracingPanel from './tracing-panel' @@ -27,7 +28,7 @@ const IterationResultPanel: FC = ({ noWrap, }) => { const { t } = useTranslation() - const [expandedIterations, setExpandedIterations] = useState>([]) + const [expandedIterations, setExpandedIterations] = useState>({}) const toggleIteration = useCallback((index: number) => { setExpandedIterations(prev => ({ @@ -71,10 +72,19 @@ const IterationResultPanel: FC = ({ {t(`${i18nPrefix}.iteration`)} {index + 1} - + { + iteration.some(item => item.status === 'failed') + ? ( + + ) + : (< RiArrowRightSLine className={ + cn( + 'w-4 h-4 text-text-tertiary transition-transform duration-200 flex-shrink-0', + expandedIterations[index] && 'transform rotate-90', + )} /> + ) + } + {expandedIterations[index] &&
= ({ return iteration_length } + const getErrorCount = (details: NodeTracing[][] | undefined) => { + if (!details || details.length === 0) + return 0 + return details.reduce((acc, iteration) => { + if (iteration.some(item => item.status === 'failed')) + acc++ + return acc + }, 0) + } useEffect(() => { setCollapseState(!nodeInfo.expand) }, [nodeInfo.expand, setCollapseState]) @@ -136,7 +145,12 @@ const NodePanel: FC = ({ onClick={handleOnShowIterationDetail} > -
{t('workflow.nodes.iteration.iteration', { count: getCount(nodeInfo.details?.length, nodeInfo.metadata?.iterator_length) })}
+
{t('workflow.nodes.iteration.iteration', { count: getCount(nodeInfo.details?.length, nodeInfo.metadata?.iterator_length) })}{getErrorCount(nodeInfo.details) > 0 && ( + <> + {t('workflow.nodes.iteration.comma')} + {t('workflow.nodes.iteration.error', { count: getErrorCount(nodeInfo.details) })} + + )}
{justShowIterationNavArrow ? ( diff --git a/web/app/components/workflow/store.ts b/web/app/components/workflow/store.ts index c2a6823e6b..c4a625c777 100644 --- a/web/app/components/workflow/store.ts +++ b/web/app/components/workflow/store.ts @@ -21,6 +21,7 @@ import type { WorkflowRunningData, } from './types' import { WorkflowContext } from './context' +import type { NodeTracing } from '@/types/workflow' // #TODO chatVar# // const MOCK_DATA = [ @@ -166,6 +167,10 @@ type Shape = { setShowImportDSLModal: (showImportDSLModal: boolean) => void showTips: string setShowTips: (showTips: string) => void + iterTimes: number + setIterTimes: (iterTimes: number) => void + iterParallelLogMap: Map + setIterParallelLogMap: (iterParallelLogMap: Map) => void } export const createWorkflowStore = () => { @@ -281,6 +286,11 @@ export const createWorkflowStore = () => { setShowImportDSLModal: showImportDSLModal => set(() => ({ showImportDSLModal })), showTips: '', setShowTips: showTips => set(() => ({ showTips })), + iterTimes: 1, + setIterTimes: iterTimes => set(() => ({ iterTimes })), + iterParallelLogMap: new Map(), + setIterParallelLogMap: iterParallelLogMap => set(() => ({ iterParallelLogMap })), + })) } diff --git a/web/app/components/workflow/types.ts b/web/app/components/workflow/types.ts index 81bec41eac..9b6ad033bf 100644 --- a/web/app/components/workflow/types.ts +++ b/web/app/components/workflow/types.ts @@ -36,7 +36,11 @@ export enum ControlMode { Pointer = 'pointer', Hand = 'hand', } - +export enum ErrorHandleMode { + Terminated = 'terminated', + ContinueOnError = 'continue-on-error', + RemoveAbnormalOutput = 'remove-abnormal-output', +} export type Branch = { id: string name: string diff --git a/web/app/components/workflow/utils.ts b/web/app/components/workflow/utils.ts index 91656e3bbc..aaf333f4d7 100644 --- a/web/app/components/workflow/utils.ts +++ b/web/app/components/workflow/utils.ts @@ -19,7 +19,7 @@ import type { ToolWithProvider, ValueSelector, } from './types' -import { BlockEnum } from './types' +import { BlockEnum, ErrorHandleMode } from './types' import { CUSTOM_NODE, ITERATION_CHILDREN_Z_INDEX, @@ -267,8 +267,13 @@ export const initialNodes = (originNodes: Node[], originEdges: Edge[]) => { }) } - if (node.data.type === BlockEnum.Iteration) - node.data._children = iterationNodeMap[node.id] || [] + if (node.data.type === BlockEnum.Iteration) { + const iterationNodeData = node.data as IterationNodeType + iterationNodeData._children = iterationNodeMap[node.id] || [] + iterationNodeData.is_parallel = iterationNodeData.is_parallel || false + iterationNodeData.parallel_nums = iterationNodeData.parallel_nums || 10 + iterationNodeData.error_handle_mode = iterationNodeData.error_handle_mode || ErrorHandleMode.Terminated + } return node }) diff --git a/web/i18n/en-US/workflow.ts b/web/i18n/en-US/workflow.ts index ea8355500a..1c6639aba0 100644 --- a/web/i18n/en-US/workflow.ts +++ b/web/i18n/en-US/workflow.ts @@ -556,6 +556,23 @@ const translation = { iteration_one: '{{count}} Iteration', iteration_other: '{{count}} Iterations', currentIteration: 'Current Iteration', + comma: ', ', + error_one: '{{count}} Error', + error_other: '{{count}} Errors', + parallelMode: 'Parallel Mode', + parallelModeUpper: 'PARALLEL MODE', + parallelModeEnableTitle: 'Parallel Mode Enabled', + parallelModeEnableDesc: 'In parallel mode, tasks within iterations support parallel execution. You can configure this in the properties panel on the right.', + parallelPanelDesc: 'In parallel mode, tasks in the iteration support parallel execution.', + MaxParallelismTitle: 'Maximum parallelism', + MaxParallelismDesc: 'The maximum parallelism is used to control the number of tasks executed simultaneously in a single iteration.', + errorResponseMethod: 'Error response method', + ErrorMethod: { + operationTerminated: 'terminated', + continueOnError: 'continue-on-error', + removeAbnormalOutput: 'remove-abnormal-output', + }, + answerNodeWarningDesc: 'Parallel mode warning: Answer nodes, conversation variable assignments, and persistent read/write operations within iterations may cause exceptions.', }, note: { addNote: 'Add Note', diff --git a/web/i18n/zh-Hans/workflow.ts b/web/i18n/zh-Hans/workflow.ts index 515d0fe235..1229ba8c03 100644 --- a/web/i18n/zh-Hans/workflow.ts +++ b/web/i18n/zh-Hans/workflow.ts @@ -556,6 +556,23 @@ const translation = { iteration_one: '{{count}}个迭代', iteration_other: '{{count}}个迭代', currentIteration: '当前迭代', + comma: '，', + error_one: '{{count}}个失败', + error_other: '{{count}}个失败', + parallelMode: '并行模式', + parallelModeUpper: '并行模式', + parallelModeEnableTitle: '并行模式启用', + parallelModeEnableDesc: '启用并行模式时迭代内的任务支持并行执行。你可以在右侧的属性面板中进行配置。', + parallelPanelDesc: '在并行模式下，迭代中的任务支持并行执行。', + MaxParallelismTitle: '最大并行度', + MaxParallelismDesc: '最大并行度用于控制单次迭代中同时执行的任务数量。', + errorResponseMethod: '错误响应方法', + ErrorMethod: { + operationTerminated: '错误时终止', + continueOnError: '忽略错误并继续', + removeAbnormalOutput: '移除错误输出', + }, + answerNodeWarningDesc: '并行模式警告：在迭代中，回答节点、会话变量赋值和工具持久读/写操作可能会导致异常。', }, note: { addNote: '添加注释', diff --git a/web/types/workflow.ts b/web/types/workflow.ts index 810026b084..3c0675b605 100644 --- a/web/types/workflow.ts +++ b/web/types/workflow.ts @@ -19,6 +19,7 @@ export type NodeTracing = { process_data: any outputs?: any status: string + parallel_run_id?: string error?: string elapsed_time: number execution_metadata: { @@ -31,6 +32,7 @@ export type NodeTracing = { parallel_start_node_id?: string parent_parallel_id?: string parent_parallel_start_node_id?: string + parallel_mode_run_id?: string } metadata: { iterator_length: number @@ -121,6 +123,7 @@ export type NodeStartedResponse = { id: string node_id: string iteration_id?: string + parallel_run_id?: string node_type: string index: number predecessor_node_id?: string @@ -166,6 +169,7 @@ export type NodeFinishedResponse = { parallel_start_node_id?: string iteration_index?: number iteration_id?: string + parallel_mode_run_id: string } created_at: number files?: FileResponse[] @@ -200,6 +204,7 @@ export type IterationNextResponse = { output: any extras?: any created_at: number + parallel_mode_run_id: string execution_metadata: { parallel_id?: string } From acb22f0fde2e4fc780d01a626b068de0b9dd2e72 Mon Sep 17 00:00:00 2001 From: Benjamin Date: Tue, 5 Nov 2024 10:34:28 +0800 Subject: [PATCH 36/73] =?UTF-8?q?Updates:=20Add=20mplfonts=20library=20for?= =?UTF-8?q?=20customizing=20matplotlib=20fonts=20and=20Va=E2=80=A6=20(#990?= =?UTF-8?q?3)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- api/poetry.lock | 70 ++++++++++++++++++++++++++++++++++++++++++---- api/pyproject.toml | 3 +- 2 files changed, 67 insertions(+), 6 deletions(-) diff --git a/api/poetry.lock b/api/poetry.lock index f543b2b4b9..2a93fa38f9 100644 --- a/api/poetry.lock +++ b/api/poetry.lock @@ -2532,6 +2532,19 @@ files = [ {file = "filetype-1.2.0.tar.gz", hash = "sha256:66b56cd6474bf41d8c54660347d37afcc3f7d1970648de365c102ef77548aadb"}, ] +[[package]] +name = "fire" +version = "0.7.0" +description = "A library for automatically generating command line interfaces." +optional = false +python-versions = "*" +files = [ + {file = "fire-0.7.0.tar.gz", hash = "sha256:961550f07936eaf65ad1dc8360f2b2bf8408fad46abbfa4d2a3794f8d2a95cdf"}, +] + +[package.dependencies] +termcolor = "*" + [[package]] name = "flasgger" version = "0.9.7.1" @@ -2697,6 +2710,19 @@ files = [ {file = "flatbuffers-24.3.25.tar.gz", hash = "sha256:de2ec5b203f21441716617f38443e0a8ebf3d25bf0d9c0bb0ce68fa00ad546a4"}, ] +[[package]] +name = "fontmeta" +version = "1.6.1" +description = "An Utility to get ttf/otf font metadata" +optional = false +python-versions = "*" +files = [ + {file = "fontmeta-1.6.1.tar.gz", hash = "sha256:837e5bc4da879394b41bda1428a8a480eb7c4e993799a93cfb582bab771a9c24"}, +] + +[package.dependencies] +fonttools = "*" + [[package]] name = "fonttools" version = "4.54.1" @@ -5279,6 +5305,22 @@ files = [ {file = "monotonic-1.6.tar.gz", hash = "sha256:3a55207bcfed53ddd5c5bae174524062935efed17792e9de2ad0205ce9ad63f7"}, ] +[[package]] +name = "mplfonts" +version = "0.0.8" +description = "Fonts manager for matplotlib" +optional = false +python-versions = ">=3.7" +files = [ + {file = "mplfonts-0.0.8-py3-none-any.whl", hash = "sha256:b2182e5b0baa216cf016dec19942740e5b48956415708ad2d465e03952112ec1"}, + {file = "mplfonts-0.0.8.tar.gz", hash = "sha256:0abcb2fc0605645e1e7561c6923014d856f11676899b33b4d89757843f5e7c22"}, +] + +[package.dependencies] +fire = ">=0.4.0" +fontmeta = ">=1.6.1" +matplotlib = ">=3.4" + [[package]] name = "mpmath" version = "1.3.0" @@ -9300,6 +9342,20 @@ files = [ [package.dependencies] tencentcloud-sdk-python-common = "3.0.1257" +[[package]] +name = "termcolor" +version = "2.5.0" +description = "ANSI color formatting for output in terminal" +optional = false +python-versions = ">=3.9" +files = [ + {file = "termcolor-2.5.0-py3-none-any.whl", hash = "sha256:37b17b5fc1e604945c2642c872a3764b5d547a48009871aea3edd3afa180afb8"}, + {file = "termcolor-2.5.0.tar.gz", hash = "sha256:998d8d27da6d48442e8e1f016119076b690d962507531df4890fcd2db2ef8a6f"}, +] + +[package.extras] +tests = ["pytest", "pytest-cov"] + [[package]] name = "threadpoolctl" version = "3.5.0" @@ -10046,13 +10102,13 @@ files = [ [[package]] name = "vanna" -version = "0.7.3" +version = "0.7.5" description = "Generate SQL queries from natural language" optional = false python-versions = ">=3.9" files = [ - {file = "vanna-0.7.3-py3-none-any.whl", hash = "sha256:82ba39e5d6c503d1c8cca60835ed401d20ec3a3da98d487f529901dcb30061d6"}, - {file = "vanna-0.7.3.tar.gz", hash = "sha256:4590dd94d2fe180b4efc7a83c867b73144ef58794018910dc226857cfb703077"}, + {file = "vanna-0.7.5-py3-none-any.whl", hash = "sha256:07458c7befa49de517a8760c2d80a13147278b484c515d49a906acc88edcb835"}, + {file = "vanna-0.7.5.tar.gz", hash = "sha256:2fdffc58832898e4fc8e93c45b173424db59a22773b22ca348640161d391eacf"}, ] [package.dependencies] @@ -10073,7 +10129,7 @@ sqlparse = "*" tabulate = "*" [package.extras] -all = ["PyMySQL", "anthropic", "azure-common", "azure-identity", "azure-search-documents", "chromadb", "db-dtypes", "duckdb", "fastembed", "google-cloud-aiplatform", "google-cloud-bigquery", "google-generativeai", "httpx", "marqo", "mistralai (>=1.0.0)", "ollama", "openai", "opensearch-dsl", "opensearch-py", "pinecone-client", "psycopg2-binary", "pymilvus[model]", "qdrant-client", "qianfan", "snowflake-connector-python", "transformers", "weaviate-client", "zhipuai"] +all = ["PyMySQL", "anthropic", "azure-common", "azure-identity", "azure-search-documents", "boto", "boto3", "botocore", "chromadb", "db-dtypes", "duckdb", "faiss-cpu", "fastembed", "google-cloud-aiplatform", "google-cloud-bigquery", "google-generativeai", "httpx", "langchain_core", "langchain_postgres", "marqo", "mistralai (>=1.0.0)", "ollama", "openai", "opensearch-dsl", "opensearch-py", "pinecone-client", "psycopg2-binary", "pymilvus[model]", "qdrant-client", "qianfan", "snowflake-connector-python", "transformers", "weaviate-client", "xinference-client", "zhipuai"] anthropic = ["anthropic"] azuresearch = ["azure-common", "azure-identity", "azure-search-documents", "fastembed"] bedrock = ["boto3", "botocore"] @@ -10081,6 +10137,8 @@ bigquery = ["google-cloud-bigquery"] chromadb = ["chromadb"] clickhouse = ["clickhouse_connect"] duckdb = ["duckdb"] +faiss-cpu = ["faiss-cpu"] +faiss-gpu = ["faiss-gpu"] gemini = ["google-generativeai"] google = ["google-cloud-aiplatform", "google-generativeai"] hf = ["transformers"] @@ -10091,6 +10149,7 @@ mysql = ["PyMySQL"] ollama = ["httpx", "ollama"] openai = ["openai"] opensearch = ["opensearch-dsl", "opensearch-py"] +pgvector = ["langchain-postgres (>=0.0.12)"] pinecone = ["fastembed", "pinecone-client"] postgres = ["db-dtypes", "psycopg2-binary"] qdrant = ["fastembed", "qdrant-client"] @@ -10099,6 +10158,7 @@ snowflake = ["snowflake-connector-python"] test = ["tox"] vllm = ["vllm"] weaviate = ["weaviate-client"] +xinference-client = ["xinference-client"] zhipuai = ["zhipuai"] [[package]] @@ -10940,4 +11000,4 @@ cffi = ["cffi (>=1.11)"] [metadata] lock-version = "2.0" python-versions = ">=3.10,<3.13" -content-hash = "ef927b98c33d704d680e08db0e5c7d9a4e05454c66fcd6a5f656a65eb08e886b" +content-hash = "e4794898403da4ad7b51f248a6c07632a949114c1b569406d3aa6a94c62510a5" diff --git a/api/pyproject.toml b/api/pyproject.toml index ee7cf4d618..a79e1641d0 100644 --- a/api/pyproject.toml +++ b/api/pyproject.toml @@ -206,13 +206,14 @@ cloudscraper = "1.2.71" duckduckgo-search = "~6.3.0" jsonpath-ng = "1.6.1" matplotlib = "~3.8.2" +mplfonts = "~0.0.8" newspaper3k = "0.2.8" nltk = "3.9.1" numexpr = "~2.9.0" pydub = "~0.25.1" qrcode = "~7.4.2" twilio = "~9.0.4" -vanna = { version = "0.7.3", extras = ["postgres", "mysql", "clickhouse", "duckdb"] } +vanna = { version = "0.7.5", extras = ["postgres", "mysql", "clickhouse", "duckdb", "oracle"] } wikipedia = "1.4.0" yfinance = "~0.2.40" From de5dfd99f65151402140f6e0afc16a13154cbe89 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 10:57:32 +0800 Subject: [PATCH 37/73] chore: translate i18n files (#10273) Co-authored-by: laipz8200 <16485841+laipz8200@users.noreply.github.com> Co-authored-by: crazywoola <100913391+crazywoola@users.noreply.github.com> --- web/i18n/de-DE/workflow.ts | 17 +++++++++++++++++ web/i18n/es-ES/workflow.ts | 17 +++++++++++++++++ web/i18n/fa-IR/workflow.ts | 17 +++++++++++++++++ web/i18n/fr-FR/workflow.ts | 17 +++++++++++++++++ web/i18n/hi-IN/workflow.ts | 17 +++++++++++++++++ web/i18n/it-IT/workflow.ts | 17 +++++++++++++++++ web/i18n/ja-JP/workflow.ts | 17 +++++++++++++++++ web/i18n/ko-KR/workflow.ts | 17 +++++++++++++++++ web/i18n/pl-PL/workflow.ts | 17 +++++++++++++++++ web/i18n/pt-BR/workflow.ts | 17 +++++++++++++++++ web/i18n/ro-RO/workflow.ts | 17 +++++++++++++++++ web/i18n/ru-RU/workflow.ts | 17 +++++++++++++++++ web/i18n/tr-TR/workflow.ts | 17 +++++++++++++++++ web/i18n/uk-UA/workflow.ts | 17 +++++++++++++++++ web/i18n/vi-VN/workflow.ts | 17 +++++++++++++++++ web/i18n/zh-Hant/workflow.ts | 17 +++++++++++++++++ 16 files changed, 272 insertions(+) diff --git a/web/i18n/de-DE/workflow.ts b/web/i18n/de-DE/workflow.ts index bde0250fcc..d05070c308 100644 --- a/web/i18n/de-DE/workflow.ts +++ b/web/i18n/de-DE/workflow.ts @@ -557,6 +557,23 @@ const translation = { iteration_one: '{{count}} Iteration', iteration_other: '{{count}} Iterationen', currentIteration: 'Aktuelle Iteration', + ErrorMethod: { + operationTerminated: 'beendet', + removeAbnormalOutput: 'remove-abnormale_ausgabe', + continueOnError: 'Fehler "Fortfahren bei"', + }, + MaxParallelismTitle: 'Maximale Parallelität', + parallelMode: 'Paralleler Modus', + errorResponseMethod: 'Methode der Fehlerantwort', + error_one: '{{Anzahl}} Fehler', + error_other: '{{Anzahl}} Irrtümer', + MaxParallelismDesc: 'Die maximale Parallelität wird verwendet, um die Anzahl der Aufgaben zu steuern, die gleichzeitig in einer einzigen Iteration ausgeführt werden.', + parallelPanelDesc: 'Im parallelen Modus unterstützen Aufgaben in der Iteration die parallele Ausführung.', + parallelModeEnableDesc: 'Im parallelen Modus unterstützen Aufgaben innerhalb von Iterationen die parallele Ausführung. Sie können dies im Eigenschaftenbereich auf der rechten Seite konfigurieren.', + answerNodeWarningDesc: 'Warnung im parallelen Modus: Antwortknoten, Zuweisungen von Konversationsvariablen und persistente Lese-/Schreibvorgänge innerhalb von Iterationen können Ausnahmen verursachen.', + parallelModeEnableTitle: 'Paralleler Modus aktiviert', + parallelModeUpper: 'PARALLELER MODUS', + comma: ',', }, note: { editor: { diff --git a/web/i18n/es-ES/workflow.ts b/web/i18n/es-ES/workflow.ts index 59a330e7f4..6c9af49c4d 100644 --- a/web/i18n/es-ES/workflow.ts +++ b/web/i18n/es-ES/workflow.ts @@ -557,6 +557,23 @@ const translation = { iteration_one: '{{count}} Iteración', iteration_other: '{{count}} Iteraciones', currentIteration: 'Iteración actual', + ErrorMethod: { + operationTerminated: 'Terminado', + continueOnError: 'Continuar en el error', + removeAbnormalOutput: 'eliminar-salida-anormal', + }, + comma: ',', + errorResponseMethod: 'Método de respuesta a errores', + error_one: '{{conteo}} Error', + parallelPanelDesc: 'En el modo paralelo, las tareas de la iteración admiten la ejecución en paralelo.', + MaxParallelismTitle: 'Máximo paralelismo', + error_other: '{{conteo}} Errores', + parallelMode: 'Modo paralelo', + parallelModeEnableDesc: 'En el modo paralelo, las tareas dentro de las iteraciones admiten la ejecución en paralelo. Puede configurar esto en el panel de propiedades a la derecha.', + parallelModeUpper: 'MODO PARALELO', + MaxParallelismDesc: 'El paralelismo máximo se utiliza para controlar el número de tareas ejecutadas simultáneamente en una sola iteración.', + answerNodeWarningDesc: 'Advertencia de modo paralelo: Los nodos de respuesta, las asignaciones de variables de conversación y las operaciones de lectura/escritura persistentes dentro de las iteraciones pueden provocar excepciones.', + parallelModeEnableTitle: 'Modo paralelo habilitado', }, note: { addNote: 'Agregar nota', diff --git a/web/i18n/fa-IR/workflow.ts b/web/i18n/fa-IR/workflow.ts index b1f9384159..4b00390663 100644 --- a/web/i18n/fa-IR/workflow.ts +++ b/web/i18n/fa-IR/workflow.ts @@ -557,6 +557,23 @@ const translation = { iteration_one: '{{count}} تکرار', iteration_other: '{{count}} تکرارها', currentIteration: 'تکرار فعلی', + ErrorMethod: { + continueOnError: 'ادامه در خطا', + operationTerminated: 'فسخ', + removeAbnormalOutput: 'حذف خروجی غیرطبیعی', + }, + error_one: '{{تعداد}} خطا', + error_other: '{{تعداد}} خطاهای', + parallelMode: 'حالت موازی', + errorResponseMethod: 'روش پاسخ به خطا', + parallelModeEnableTitle: 'حالت موازی فعال است', + parallelModeUpper: 'حالت موازی', + comma: ',', + parallelModeEnableDesc: 'در حالت موازی، وظایف درون تکرارها از اجرای موازی پشتیبانی می کنند. می توانید این را در پانل ویژگی ها در سمت راست پیکربندی کنید.', + MaxParallelismTitle: 'حداکثر موازی سازی', + parallelPanelDesc: 'در حالت موازی، وظایف در تکرار از اجرای موازی پشتیبانی می کنند.', + MaxParallelismDesc: 'حداکثر موازی سازی برای کنترل تعداد وظایف اجرا شده به طور همزمان در یک تکرار واحد استفاده می شود.', + answerNodeWarningDesc: 'هشدار حالت موازی: گره های پاسخ، تکالیف متغیر مکالمه و عملیات خواندن/نوشتن مداوم در تکرارها ممکن است باعث استثنائات شود.', }, note: { addNote: 'افزودن یادداشت', diff --git a/web/i18n/fr-FR/workflow.ts b/web/i18n/fr-FR/workflow.ts index e56932455f..e736e2cb07 100644 --- a/web/i18n/fr-FR/workflow.ts +++ b/web/i18n/fr-FR/workflow.ts @@ -557,6 +557,23 @@ const translation = { iteration_one: '{{count}} Itération', iteration_other: '{{count}} Itérations', currentIteration: 'Itération actuelle', + ErrorMethod: { + operationTerminated: 'Terminé', + removeAbnormalOutput: 'remove-abnormal-output', + continueOnError: 'continuer sur l’erreur', + }, + comma: ',', + error_one: '{{compte}} Erreur', + error_other: '{{compte}} Erreurs', + parallelModeEnableDesc: 'En mode parallèle, les tâches au sein des itérations prennent en charge l’exécution parallèle. Vous pouvez le configurer dans le panneau des propriétés à droite.', + parallelModeUpper: 'MODE PARALLÈLE', + parallelPanelDesc: 'En mode parallèle, les tâches de l’itération prennent en charge l’exécution parallèle.', + MaxParallelismDesc: 'Le parallélisme maximal est utilisé pour contrôler le nombre de tâches exécutées simultanément en une seule itération.', + errorResponseMethod: 'Méthode de réponse aux erreurs', + MaxParallelismTitle: 'Parallélisme maximal', + answerNodeWarningDesc: 'Avertissement en mode parallèle : les nœuds de réponse, les affectations de variables de conversation et les opérations de lecture/écriture persistantes au sein des itérations peuvent provoquer des exceptions.', + parallelModeEnableTitle: 'Mode parallèle activé', + parallelMode: 'Mode parallèle', }, note: { addNote: 'Ajouter note', diff --git a/web/i18n/hi-IN/workflow.ts b/web/i18n/hi-IN/workflow.ts index 1473f78ccd..4112643488 100644 --- a/web/i18n/hi-IN/workflow.ts +++ b/web/i18n/hi-IN/workflow.ts @@ -577,6 +577,23 @@ const translation = { iteration_one: '{{count}} इटरेशन', iteration_other: '{{count}} इटरेशन्स', currentIteration: 'वर्तमान इटरेशन', + ErrorMethod: { + operationTerminated: 'समाप्त', + continueOnError: 'जारी रखें-पर-त्रुटि', + removeAbnormalOutput: 'निकालें-असामान्य-आउटपुट', + }, + comma: ',', + error_other: '{{गिनती}} त्रुटियों', + error_one: '{{गिनती}} चूक', + parallelMode: 'समानांतर मोड', + parallelModeUpper: 'समानांतर मोड', + errorResponseMethod: 'त्रुटि प्रतिक्रिया विधि', + MaxParallelismTitle: 'अधिकतम समांतरता', + parallelModeEnableTitle: 'समानांतर मोड सक्षम किया गया', + parallelModeEnableDesc: 'समानांतर मोड में, पुनरावृत्तियों के भीतर कार्य समानांतर निष्पादन का समर्थन करते हैं। आप इसे दाईं ओर गुण पैनल में कॉन्फ़िगर कर सकते हैं।', + parallelPanelDesc: 'समानांतर मोड में, पुनरावृत्ति में कार्य समानांतर निष्पादन का समर्थन करते हैं।', + MaxParallelismDesc: 'अधिकतम समांतरता का उपयोग एकल पुनरावृत्ति में एक साथ निष्पादित कार्यों की संख्या को नियंत्रित करने के लिए किया जाता है।', + answerNodeWarningDesc: 'समानांतर मोड चेतावनी: उत्तर नोड्स, वार्तालाप चर असाइनमेंट, और पुनरावृत्तियों के भीतर लगातार पढ़ने/लिखने की कार्रवाई अपवाद पैदा कर सकती है।', }, note: { addNote: 'नोट जोड़ें', diff --git a/web/i18n/it-IT/workflow.ts b/web/i18n/it-IT/workflow.ts index 19fa7bfbb5..756fb665af 100644 --- a/web/i18n/it-IT/workflow.ts +++ b/web/i18n/it-IT/workflow.ts @@ -584,6 +584,23 @@ const translation = { iteration_one: '{{count}} Iterazione', iteration_other: '{{count}} Iterazioni', currentIteration: 'Iterazione Corrente', + ErrorMethod: { + operationTerminated: 'Terminato', + continueOnError: 'continua sull\'errore', + removeAbnormalOutput: 'rimuovi-output-anomalo', + }, + error_one: '{{conteggio}} Errore', + parallelMode: 'Modalità parallela', + MaxParallelismTitle: 'Parallelismo massimo', + error_other: '{{conteggio}} Errori', + parallelModeEnableDesc: 'In modalità parallela, le attività all\'interno delle iterazioni supportano l\'esecuzione parallela. È possibile configurare questa opzione nel pannello delle proprietà a destra.', + MaxParallelismDesc: 'Il parallelismo massimo viene utilizzato per controllare il numero di attività eseguite contemporaneamente in una singola iterazione.', + errorResponseMethod: 'Metodo di risposta all\'errore', + parallelModeEnableTitle: 'Modalità parallela abilitata', + parallelModeUpper: 'MODALITÀ PARALLELA', + comma: ',', + parallelPanelDesc: 'In modalità parallela, le attività nell\'iterazione supportano l\'esecuzione parallela.', + answerNodeWarningDesc: 'Avviso in modalità parallela: i nodi di risposta, le assegnazioni di variabili di conversazione e le operazioni di lettura/scrittura persistenti all\'interno delle iterazioni possono causare eccezioni.', }, note: { addNote: 'Aggiungi Nota', diff --git a/web/i18n/ja-JP/workflow.ts b/web/i18n/ja-JP/workflow.ts index b6c7786081..a82ba71e48 100644 --- a/web/i18n/ja-JP/workflow.ts +++ b/web/i18n/ja-JP/workflow.ts @@ -558,6 +558,23 @@ const translation = { iteration_one: '{{count}} イテレーション', iteration_other: '{{count}} イテレーション', currentIteration: '現在のイテレーション', + ErrorMethod: { + operationTerminated: '終了', + continueOnError: 'エラー時に続行', + removeAbnormalOutput: 'アブノーマルアウトプットの削除', + }, + comma: ',', + error_other: '{{カウント}}エラー', + error_one: '{{カウント}}エラー', + parallelModeUpper: 'パラレルモード', + parallelMode: 'パラレルモード', + MaxParallelismTitle: '最大並列処理', + errorResponseMethod: 'エラー応答方式', + parallelPanelDesc: '並列モードでは、イテレーションのタスクは並列実行をサポートします。', + parallelModeEnableDesc: '並列モードでは、イテレーション内のタスクは並列実行をサポートします。これは、右側のプロパティパネルで構成できます。', + parallelModeEnableTitle: 'パラレルモード有効', + MaxParallelismDesc: '最大並列処理は、1 回の反復で同時に実行されるタスクの数を制御するために使用されます。', + answerNodeWarningDesc: '並列モードの警告: 応答ノード、会話変数の割り当て、およびイテレーション内の永続的な読み取り/書き込み操作により、例外が発生する可能性があります。', }, note: { addNote: 'コメントを追加', diff --git a/web/i18n/ko-KR/workflow.ts b/web/i18n/ko-KR/workflow.ts index b62aff2068..589831401c 100644 --- a/web/i18n/ko-KR/workflow.ts +++ b/web/i18n/ko-KR/workflow.ts @@ -557,6 +557,23 @@ const translation = { iteration_one: '{{count}} 반복', iteration_other: '{{count}} 반복', currentIteration: '현재 반복', + ErrorMethod: { + operationTerminated: '종료', + continueOnError: '오류 발생 시 계속', + removeAbnormalOutput: '비정상 출력 제거', + }, + comma: ',', + error_one: '{{개수}} 오류', + parallelMode: '병렬 모드', + errorResponseMethod: '오류 응답 방법', + parallelModeUpper: '병렬 모드', + MaxParallelismTitle: '최대 병렬 처리', + error_other: '{{개수}} 오류', + parallelModeEnableTitle: 'Parallel Mode Enabled(병렬 모드 사용)', + parallelPanelDesc: '병렬 모드에서 반복의 작업은 병렬 실행을 지원합니다.', + parallelModeEnableDesc: '병렬 모드에서는 반복 내의 작업이 병렬 실행을 지원합니다. 오른쪽의 속성 패널에서 이를 구성할 수 있습니다.', + MaxParallelismDesc: '최대 병렬 처리는 단일 반복에서 동시에 실행되는 작업 수를 제어하는 데 사용됩니다.', + answerNodeWarningDesc: '병렬 모드 경고: 응답 노드, 대화 변수 할당 및 반복 내의 지속적인 읽기/쓰기 작업으로 인해 예외가 발생할 수 있습니다.', }, note: { editor: { diff --git a/web/i18n/pl-PL/workflow.ts b/web/i18n/pl-PL/workflow.ts index aace1b2642..f118f7945c 100644 --- a/web/i18n/pl-PL/workflow.ts +++ b/web/i18n/pl-PL/workflow.ts @@ -557,6 +557,23 @@ const translation = { iteration_one: '{{count}} Iteracja', iteration_other: '{{count}} Iteracje', currentIteration: 'Bieżąca iteracja', + ErrorMethod: { + continueOnError: 'kontynuacja w przypadku błędu', + operationTerminated: 'Zakończone', + removeAbnormalOutput: 'usuń-nieprawidłowe-wyjście', + }, + comma: ',', + parallelModeUpper: 'TRYB RÓWNOLEGŁY', + parallelModeEnableTitle: 'Włączony tryb równoległy', + MaxParallelismTitle: 'Maksymalna równoległość', + error_one: '{{liczba}} Błąd', + error_other: '{{liczba}} Błędy', + parallelPanelDesc: 'W trybie równoległym zadania w iteracji obsługują wykonywanie równoległe.', + parallelMode: 'Tryb równoległy', + MaxParallelismDesc: 'Maksymalna równoległość służy do kontrolowania liczby zadań wykonywanych jednocześnie w jednej iteracji.', + parallelModeEnableDesc: 'W trybie równoległym zadania w iteracjach obsługują wykonywanie równoległe. Możesz to skonfigurować w panelu właściwości po prawej stronie.', + answerNodeWarningDesc: 'Ostrzeżenie w trybie równoległym: węzły odpowiedzi, przypisania zmiennych konwersacji i trwałe operacje odczytu/zapisu w iteracjach mogą powodować wyjątki.', + errorResponseMethod: 'Metoda odpowiedzi na błąd', }, note: { editor: { diff --git a/web/i18n/pt-BR/workflow.ts b/web/i18n/pt-BR/workflow.ts index f0f2fec0e2..44afda5cd4 100644 --- a/web/i18n/pt-BR/workflow.ts +++ b/web/i18n/pt-BR/workflow.ts @@ -557,6 +557,23 @@ const translation = { iteration_one: '{{count}} Iteração', iteration_other: '{{count}} Iterações', currentIteration: 'Iteração atual', + ErrorMethod: { + continueOnError: 'continuar em erro', + removeAbnormalOutput: 'saída anormal de remoção', + operationTerminated: 'Terminada', + }, + MaxParallelismTitle: 'Paralelismo máximo', + parallelModeEnableTitle: 'Modo paralelo ativado', + errorResponseMethod: 'Método de resposta de erro', + error_other: '{{contagem}} Erros', + parallelMode: 'Modo paralelo', + parallelModeUpper: 'MODO PARALELO', + error_one: '{{contagem}} Erro', + parallelModeEnableDesc: 'No modo paralelo, as tarefas dentro das iterações dão suporte à execução paralela. Você pode configurar isso no painel de propriedades à direita.', + comma: ',', + MaxParallelismDesc: 'O paralelismo máximo é usado para controlar o número de tarefas executadas simultaneamente em uma única iteração.', + answerNodeWarningDesc: 'Aviso de modo paralelo: nós de resposta, atribuições de variáveis de conversação e operações persistentes de leitura/gravação em iterações podem causar exceções.', + parallelPanelDesc: 'No modo paralelo, as tarefas na iteração dão suporte à execução paralela.', }, note: { editor: { diff --git a/web/i18n/ro-RO/workflow.ts b/web/i18n/ro-RO/workflow.ts index ab0100d347..d8cd84f730 100644 --- a/web/i18n/ro-RO/workflow.ts +++ b/web/i18n/ro-RO/workflow.ts @@ -557,6 +557,23 @@ const translation = { iteration_one: '{{count}} Iterație', iteration_other: '{{count}} Iterații', currentIteration: 'Iterație curentă', + ErrorMethod: { + operationTerminated: 'Încheiată', + continueOnError: 'continuare-la-eroare', + removeAbnormalOutput: 'elimină-ieșire-anormală', + }, + parallelModeEnableTitle: 'Modul paralel activat', + errorResponseMethod: 'Metoda de răspuns la eroare', + comma: ',', + parallelModeEnableDesc: 'În modul paralel, sarcinile din iterații acceptă execuția paralelă. Puteți configura acest lucru în panoul de proprietăți din dreapta.', + parallelModeUpper: 'MOD PARALEL', + MaxParallelismTitle: 'Paralelism maxim', + parallelMode: 'Mod paralel', + error_other: '{{număr}} Erori', + error_one: '{{număr}} Eroare', + parallelPanelDesc: 'În modul paralel, activitățile din iterație acceptă execuția paralelă.', + MaxParallelismDesc: 'Paralelismul maxim este utilizat pentru a controla numărul de sarcini executate simultan într-o singură iterație.', + answerNodeWarningDesc: 'Avertisment modul paralel: Nodurile de răspuns, atribuirea variabilelor de conversație și operațiunile persistente de citire/scriere în iterații pot cauza excepții.', }, note: { editor: { diff --git a/web/i18n/ru-RU/workflow.ts b/web/i18n/ru-RU/workflow.ts index 27735fbb7d..c822f8c3e5 100644 --- a/web/i18n/ru-RU/workflow.ts +++ b/web/i18n/ru-RU/workflow.ts @@ -557,6 +557,23 @@ const translation = { iteration_one: '{{count}} Итерация', iteration_other: '{{count}} Итераций', currentIteration: 'Текущая итерация', + ErrorMethod: { + operationTerminated: 'Прекращено', + continueOnError: 'продолжить по ошибке', + removeAbnormalOutput: 'удалить аномальный вывод', + }, + comma: ',', + error_other: '{{Количество}} Ошибки', + errorResponseMethod: 'Метод реагирования на ошибку', + MaxParallelismTitle: 'Максимальный параллелизм', + parallelModeUpper: 'ПАРАЛЛЕЛЬНЫЙ РЕЖИМ', + error_one: '{{Количество}} Ошибка', + parallelModeEnableTitle: 'Параллельный режим включен', + parallelMode: 'Параллельный режим', + parallelPanelDesc: 'В параллельном режиме задачи в итерации поддерживают параллельное выполнение.', + parallelModeEnableDesc: 'В параллельном режиме задачи в итерациях поддерживают параллельное выполнение. Вы можете настроить это на панели свойств справа.', + MaxParallelismDesc: 'Максимальный параллелизм используется для управления количеством задач, выполняемых одновременно в одной итерации.', + answerNodeWarningDesc: 'Предупреждение о параллельном режиме: узлы ответов, присвоение переменных диалога и постоянные операции чтения и записи в итерациях могут вызывать исключения.', }, note: { addNote: 'Добавить заметку', diff --git a/web/i18n/tr-TR/workflow.ts b/web/i18n/tr-TR/workflow.ts index 82718ebc03..e6e25f6d0e 100644 --- a/web/i18n/tr-TR/workflow.ts +++ b/web/i18n/tr-TR/workflow.ts @@ -558,6 +558,23 @@ const translation = { iteration_one: '{{count}} Yineleme', iteration_other: '{{count}} Yineleme', currentIteration: 'Mevcut Yineleme', + ErrorMethod: { + operationTerminated: 'Sonlandırıldı', + continueOnError: 'Hata Üzerine Devam Et', + removeAbnormalOutput: 'anormal çıktıyı kaldır', + }, + parallelModeUpper: 'PARALEL MOD', + parallelMode: 'Paralel Mod', + MaxParallelismTitle: 'Maksimum paralellik', + error_one: '{{sayı}} Hata', + errorResponseMethod: 'Hata yanıtı yöntemi', + comma: ',', + parallelModeEnableTitle: 'Paralel Mod Etkin', + error_other: '{{sayı}} Hata', + parallelPanelDesc: 'Paralel modda, yinelemedeki görevler paralel yürütmeyi destekler.', + answerNodeWarningDesc: 'Paralel mod uyarısı: Yinelemeler içindeki yanıt düğümleri, konuşma değişkeni atamaları ve kalıcı okuma/yazma işlemleri özel durumlara neden olabilir.', + parallelModeEnableDesc: 'Paralel modda, yinelemeler içindeki görevler paralel yürütmeyi destekler. Bunu sağdaki özellikler panelinde yapılandırabilirsiniz.', + MaxParallelismDesc: 'Maksimum paralellik, tek bir yinelemede aynı anda yürütülen görevlerin sayısını kontrol etmek için kullanılır.', }, note: { addNote: 'Not Ekle', diff --git a/web/i18n/uk-UA/workflow.ts b/web/i18n/uk-UA/workflow.ts index 1828b6499f..663b5e4c13 100644 --- a/web/i18n/uk-UA/workflow.ts +++ b/web/i18n/uk-UA/workflow.ts @@ -557,6 +557,23 @@ const translation = { iteration_one: '{{count}} Ітерація', iteration_other: '{{count}} Ітерацій', currentIteration: 'Поточна ітерація', + ErrorMethod: { + operationTerminated: 'Припинено', + continueOnError: 'Продовжити після помилки', + removeAbnormalOutput: 'видалити-ненормальний-вивід', + }, + error_one: '{{count}} Помилка', + comma: ',', + MaxParallelismTitle: 'Максимальна паралельність', + parallelModeUpper: 'ПАРАЛЕЛЬНИЙ РЕЖИМ', + error_other: '{{count}} Помилки', + parallelMode: 'Паралельний режим', + parallelModeEnableTitle: 'Увімкнено паралельний режим', + errorResponseMethod: 'Метод реагування на помилку', + parallelPanelDesc: 'У паралельному режимі завдання в ітерації підтримують паралельне виконання.', + parallelModeEnableDesc: 'У паралельному режимі завдання всередині ітерацій підтримують паралельне виконання. Ви можете налаштувати це на панелі властивостей праворуч.', + MaxParallelismDesc: 'Максимальний паралелізм використовується для контролю числа завдань, що виконуються одночасно за одну ітерацію.', + answerNodeWarningDesc: 'Попередження в паралельному режимі: вузли відповідей, призначення змінних розмови та постійні операції читання/запису в межах ітерацій можуть спричинити винятки.', }, note: { editor: { diff --git a/web/i18n/vi-VN/workflow.ts b/web/i18n/vi-VN/workflow.ts index 2866af8a2a..1176fdd2b5 100644 --- a/web/i18n/vi-VN/workflow.ts +++ b/web/i18n/vi-VN/workflow.ts @@ -557,6 +557,23 @@ const translation = { iteration_one: '{{count}} Lặp', iteration_other: '{{count}} Lặp', currentIteration: 'Lặp hiện tại', + ErrorMethod: { + operationTerminated: 'Chấm dứt', + removeAbnormalOutput: 'loại bỏ-bất thường-đầu ra', + continueOnError: 'Tiếp tục lỗi', + }, + comma: ',', + error_other: '{{đếm}} Lỗi', + error_one: '{{đếm}} Lỗi', + MaxParallelismTitle: 'Song song tối đa', + parallelPanelDesc: 'Ở chế độ song song, các tác vụ trong quá trình lặp hỗ trợ thực thi song song.', + parallelMode: 'Chế độ song song', + parallelModeEnableTitle: 'Đã bật Chế độ song song', + errorResponseMethod: 'Phương pháp phản hồi lỗi', + MaxParallelismDesc: 'Tính song song tối đa được sử dụng để kiểm soát số lượng tác vụ được thực hiện đồng thời trong một lần lặp.', + answerNodeWarningDesc: 'Cảnh báo chế độ song song: Các nút trả lời, bài tập biến hội thoại và các thao tác đọc/ghi liên tục trong các lần lặp có thể gây ra ngoại lệ.', + parallelModeEnableDesc: 'Trong chế độ song song, các tác vụ trong các lần lặp hỗ trợ thực thi song song. Bạn có thể định cấu hình điều này trong bảng thuộc tính ở bên phải.', + parallelModeUpper: 'CHẾ ĐỘ SONG SONG', }, note: { editor: { diff --git a/web/i18n/zh-Hant/workflow.ts b/web/i18n/zh-Hant/workflow.ts index d65b3999d2..f3fbfdedc2 100644 --- a/web/i18n/zh-Hant/workflow.ts +++ b/web/i18n/zh-Hant/workflow.ts @@ -557,6 +557,23 @@ const translation = { iteration_one: '{{count}}個迭代', iteration_other: '{{count}}個迭代', currentIteration: '當前迭代', + ErrorMethod: { + operationTerminated: '終止', + removeAbnormalOutput: 'remove-abnormal-output', + continueOnError: '出錯時繼續', + }, + comma: ',', + parallelMode: '並行模式', + parallelModeEnableTitle: 'Parallel Mode 已啟用', + MaxParallelismTitle: '最大並行度', + parallelModeUpper: '並行模式', + parallelPanelDesc: '在並行模式下，反覆運算中的任務支援並行執行。', + error_one: '{{count}}錯誤', + errorResponseMethod: '錯誤回應方法', + parallelModeEnableDesc: '在並行模式下，反覆運算中的任務支援並行執行。您可以在右側的 properties 面板中進行配置。', + answerNodeWarningDesc: '並行模式警告：反覆運算中的應答節點、對話變數賦值和持久讀/寫操作可能會導致異常。', + error_other: '{{count}}錯誤', + MaxParallelismDesc: '最大並行度用於控制在單個反覆運算中同時執行的任務數。', }, note: { editor: { From 302f4407f6ec88c1cd68cc4ab8d809a8f301c472 Mon Sep 17 00:00:00 2001 From: NFish Date: Tue, 5 Nov 2024 12:38:31 +0800 Subject: [PATCH 38/73] refactor the logic of refreshing access_token (#10068) --- web/app/account/avatar.tsx | 5 +- .../header/account-dropdown/index.tsx | 5 +- web/app/components/swr-initor.tsx | 39 ++---- web/app/signin/normalForm.tsx | 5 +- web/hooks/use-refresh-token.ts | 99 -------------- web/service/base.ts | 128 +++++++++++------- web/service/refresh-token.ts | 75 ++++++++++ 7 files changed, 171 insertions(+), 185 deletions(-) delete mode 100644 web/hooks/use-refresh-token.ts create mode 100644 web/service/refresh-token.ts diff --git a/web/app/account/avatar.tsx b/web/app/account/avatar.tsx index 2b9aeba5da..544e43ab27 100644 --- a/web/app/account/avatar.tsx +++ b/web/app/account/avatar.tsx @@ -23,8 +23,9 @@ export default function AppSelector() { params: {}, }) - if (localStorage?.getItem('console_token')) - localStorage.removeItem('console_token') + localStorage.removeItem('setup_status') + localStorage.removeItem('console_token') + localStorage.removeItem('refresh_token') router.push('/signin') } diff --git a/web/app/components/header/account-dropdown/index.tsx b/web/app/components/header/account-dropdown/index.tsx index 712906ebae..14f079c0f2 100644 --- a/web/app/components/header/account-dropdown/index.tsx +++ b/web/app/components/header/account-dropdown/index.tsx @@ -47,8 +47,9 @@ export default function AppSelector({ isMobile }: IAppSelector) { params: {}, }) - if (localStorage?.getItem('console_token')) - localStorage.removeItem('console_token') + localStorage.removeItem('setup_status') + localStorage.removeItem('console_token') + localStorage.removeItem('refresh_token') router.push('/signin') } diff --git a/web/app/components/swr-initor.tsx b/web/app/components/swr-initor.tsx index ff9a7b832f..2a119df996 100644 --- a/web/app/components/swr-initor.tsx +++ b/web/app/components/swr-initor.tsx @@ -4,7 +4,6 @@ import { SWRConfig } from 'swr' import { useCallback, useEffect, useState } from 'react' import type { ReactNode } from 'react' import { usePathname, useRouter, useSearchParams } from 'next/navigation' -import useRefreshToken from '@/hooks/use-refresh-token' import { fetchSetupStatus } from '@/service/common' type SwrInitorProps = { @@ -15,12 +14,11 @@ const SwrInitor = ({ }: SwrInitorProps) => { const router = useRouter() const searchParams = useSearchParams() - const pathname = usePathname() - const { getNewAccessToken } = useRefreshToken() - const consoleToken = searchParams.get('access_token') - const refreshToken = searchParams.get('refresh_token') + const consoleToken = decodeURIComponent(searchParams.get('access_token') || '') + const refreshToken = decodeURIComponent(searchParams.get('refresh_token') || '') const consoleTokenFromLocalStorage = localStorage?.getItem('console_token') const refreshTokenFromLocalStorage = localStorage?.getItem('refresh_token') + const pathname = usePathname() const [init, setInit] = useState(false) const isSetupFinished = useCallback(async () => { @@ -41,25 +39,6 @@ const SwrInitor = ({ } }, []) - const setRefreshToken = useCallback(async () => { - try { - if (!(consoleToken || refreshToken || consoleTokenFromLocalStorage || refreshTokenFromLocalStorage)) - return Promise.reject(new Error('No token found')) - - if (consoleTokenFromLocalStorage && refreshTokenFromLocalStorage) - await getNewAccessToken() - - if (consoleToken && refreshToken) { - localStorage.setItem('console_token', consoleToken) - localStorage.setItem('refresh_token', refreshToken) - await getNewAccessToken() - } - } - catch (error) { - return Promise.reject(error) - } - }, [consoleToken, refreshToken, consoleTokenFromLocalStorage, refreshTokenFromLocalStorage, getNewAccessToken]) - useEffect(() => { (async () => { try { @@ -68,9 +47,15 @@ const SwrInitor = ({ router.replace('/install') return } - await setRefreshToken() - if (searchParams.has('access_token') || searchParams.has('refresh_token')) + if (!((consoleToken && refreshToken) || (consoleTokenFromLocalStorage && refreshTokenFromLocalStorage))) { + router.replace('/signin') + return + } + if (searchParams.has('access_token') || searchParams.has('refresh_token')) { + consoleToken && localStorage.setItem('console_token', consoleToken) + refreshToken && localStorage.setItem('refresh_token', refreshToken) router.replace(pathname) + } setInit(true) } @@ -78,7 +63,7 @@ const SwrInitor = ({ router.replace('/signin') } })() - }, [isSetupFinished, setRefreshToken, router, pathname, searchParams]) + }, [isSetupFinished, router, pathname, searchParams, consoleToken, refreshToken, consoleTokenFromLocalStorage, refreshTokenFromLocalStorage]) return init ? ( diff --git a/web/app/signin/normalForm.tsx b/web/app/signin/normalForm.tsx index c0f2d89b37..f4f46c68ba 100644 --- a/web/app/signin/normalForm.tsx +++ b/web/app/signin/normalForm.tsx @@ -12,11 +12,9 @@ import cn from '@/utils/classnames' import { getSystemFeatures, invitationCheck } from '@/service/common' import { defaultSystemFeatures } from '@/types/feature' import Toast from '@/app/components/base/toast' -import useRefreshToken from '@/hooks/use-refresh-token' import { IS_CE_EDITION } from '@/config' const NormalForm = () => { - const { getNewAccessToken } = useRefreshToken() const { t } = useTranslation() const router = useRouter() const searchParams = useSearchParams() @@ -38,7 +36,6 @@ const NormalForm = () => { if (consoleToken && refreshToken) { localStorage.setItem('console_token', consoleToken) localStorage.setItem('refresh_token', refreshToken) - getNewAccessToken() router.replace('/apps') return } @@ -71,7 +68,7 @@ const NormalForm = () => { setSystemFeatures(defaultSystemFeatures) } finally { setIsLoading(false) } - }, [consoleToken, refreshToken, message, router, invite_token, isInviteLink, getNewAccessToken]) + }, [consoleToken, refreshToken, message, router, invite_token, isInviteLink]) useEffect(() => { init() }, [init]) diff --git a/web/hooks/use-refresh-token.ts b/web/hooks/use-refresh-token.ts deleted file mode 100644 index 53dc4faf00..0000000000 --- a/web/hooks/use-refresh-token.ts +++ /dev/null @@ -1,99 +0,0 @@ -'use client' -import { useCallback, useEffect, useRef } from 'react' -import { jwtDecode } from 'jwt-decode' -import dayjs from 'dayjs' -import utc from 'dayjs/plugin/utc' -import { useRouter } from 'next/navigation' -import type { CommonResponse } from '@/models/common' -import { fetchNewToken } from '@/service/common' -import { fetchWithRetry } from '@/utils' - -dayjs.extend(utc) - -const useRefreshToken = () => { - const router = useRouter() - const timer = useRef() - const advanceTime = useRef(5 * 60 * 1000) - - const getExpireTime = useCallback((token: string) => { - if (!token) - return 0 - const decoded = jwtDecode(token) - return (decoded.exp || 0) * 1000 - }, []) - - const getCurrentTimeStamp = useCallback(() => { - return dayjs.utc().valueOf() - }, []) - - const handleError = useCallback(() => { - localStorage?.removeItem('is_refreshing') - localStorage?.removeItem('console_token') - localStorage?.removeItem('refresh_token') - router.replace('/signin') - }, []) - - const getNewAccessToken = useCallback(async () => { - const currentAccessToken = localStorage?.getItem('console_token') - const currentRefreshToken = localStorage?.getItem('refresh_token') - if (!currentAccessToken || !currentRefreshToken) { - handleError() - return new Error('No access token or refresh token found') - } - if (localStorage?.getItem('is_refreshing') === '1') { - clearTimeout(timer.current) - timer.current = setTimeout(() => { - getNewAccessToken() - }, 1000) - return null - } - const currentTokenExpireTime = getExpireTime(currentAccessToken) - if (getCurrentTimeStamp() + advanceTime.current > currentTokenExpireTime) { - localStorage?.setItem('is_refreshing', '1') - const [e, res] = await fetchWithRetry(fetchNewToken({ - body: { refresh_token: currentRefreshToken }, - }) as Promise) - if (e) { - handleError() - return e - } - const { access_token, refresh_token } = res.data - localStorage?.setItem('is_refreshing', '0') - localStorage?.setItem('console_token', access_token) - localStorage?.setItem('refresh_token', refresh_token) - const newTokenExpireTime = getExpireTime(access_token) - clearTimeout(timer.current) - timer.current = setTimeout(() => { - getNewAccessToken() - }, newTokenExpireTime - advanceTime.current - getCurrentTimeStamp()) - } - else { - const newTokenExpireTime = getExpireTime(currentAccessToken) - clearTimeout(timer.current) - timer.current = setTimeout(() => { - getNewAccessToken() - }, newTokenExpireTime - advanceTime.current - getCurrentTimeStamp()) - } - return null - }, [getExpireTime, getCurrentTimeStamp, handleError]) - - const handleVisibilityChange = useCallback(() => { - if (document.visibilityState === 'visible') - getNewAccessToken() - }, []) - - useEffect(() => { - window.addEventListener('visibilitychange', handleVisibilityChange) - return () => { - window.removeEventListener('visibilitychange', handleVisibilityChange) - clearTimeout(timer.current) - localStorage?.removeItem('is_refreshing') - } - }, []) - - return { - getNewAccessToken, - } -} - -export default useRefreshToken diff --git a/web/service/base.ts b/web/service/base.ts index fbdd5c1fd3..fcf8d8bd7d 100644 --- a/web/service/base.ts +++ b/web/service/base.ts @@ -1,3 +1,4 @@ +import { refreshAccessTokenOrRelogin } from './refresh-token' import { API_PREFIX, IS_CE_EDITION, PUBLIC_API_PREFIX } from '@/config' import Toast from '@/app/components/base/toast' import type { AnnotationReply, MessageEnd, MessageReplace, ThoughtItem } from '@/app/components/base/chat/chat/type' @@ -356,39 +357,8 @@ const baseFetch = ( if (!/^(2|3)\d{2}$/.test(String(res.status))) { const bodyJson = res.json() switch (res.status) { - case 401: { - if (isPublicAPI) { - return bodyJson.then((data: ResponseError) => { - if (data.code === 'web_sso_auth_required') - requiredWebSSOLogin() - - if (data.code === 'unauthorized') { - removeAccessToken() - globalThis.location.reload() - } - - return Promise.reject(data) - }) - } - const loginUrl = `${globalThis.location.origin}/signin` - bodyJson.then((data: ResponseError) => { - if (data.code === 'init_validate_failed' && IS_CE_EDITION && !silent) - Toast.notify({ type: 'error', message: data.message, duration: 4000 }) - else if (data.code === 'not_init_validated' && IS_CE_EDITION) - globalThis.location.href = `${globalThis.location.origin}/init` - else if (data.code === 'not_setup' && IS_CE_EDITION) - globalThis.location.href = `${globalThis.location.origin}/install` - else if (location.pathname !== '/signin' || !IS_CE_EDITION) - globalThis.location.href = loginUrl - else if (!silent) - Toast.notify({ type: 'error', message: data.message }) - }).catch(() => { - // Handle any other errors - globalThis.location.href = loginUrl - }) - - break - } + case 401: + return Promise.reject(resClone) case 403: bodyJson.then((data: ResponseError) => { if (!silent) @@ -484,7 +454,9 @@ export const upload = (options: any, isPublicAPI?: boolean, url?: string, search export const ssePost = ( url: string, fetchOptions: FetchOptionType, - { + otherOptions: IOtherOptions, +) => { + const { isPublicAPI = false, onData, onCompleted, @@ -507,8 +479,7 @@ export const ssePost = ( onTextReplace, onError, getAbortController, - }: IOtherOptions, -) => { + } = otherOptions const abortController = new AbortController() const options = Object.assign({}, baseOptions, { @@ -532,21 +503,29 @@ export const ssePost = ( globalThis.fetch(urlWithPrefix, options as RequestInit) .then((res) => { if (!/^(2|3)\d{2}$/.test(String(res.status))) { - res.json().then((data: any) => { - if (isPublicAPI) { - if (data.code === 'web_sso_auth_required') - requiredWebSSOLogin() + if (res.status === 401) { + refreshAccessTokenOrRelogin(TIME_OUT).then(() => { + ssePost(url, fetchOptions, otherOptions) + }).catch(() => { + res.json().then((data: any) => { + if (isPublicAPI) { + if (data.code === 'web_sso_auth_required') + requiredWebSSOLogin() - if (data.code === 'unauthorized') { - removeAccessToken() - globalThis.location.reload() - } - if (res.status === 401) - return - } - Toast.notify({ type: 'error', message: data.message || 'Server Error' }) - }) - onError?.('Server Error') + if (data.code === 'unauthorized') { + removeAccessToken() + globalThis.location.reload() + } + } + }) + }) + } + else { + res.json().then((data) => { + Toast.notify({ type: 'error', message: data.message || 'Server Error' }) + }) + onError?.('Server Error') + } return } return handleStream(res, (str: string, isFirstMessage: boolean, moreInfo: IOnDataMoreInfo) => { @@ -568,7 +547,54 @@ export const ssePost = ( // base request export const request = (url: string, options = {}, otherOptions?: IOtherOptions) => { - return baseFetch(url, options, otherOptions || {}) + return new Promise((resolve, reject) => { + const otherOptionsForBaseFetch = otherOptions || {} + baseFetch(url, options, otherOptionsForBaseFetch).then(resolve).catch((errResp) => { + if (errResp?.status === 401) { + return refreshAccessTokenOrRelogin(TIME_OUT).then(() => { + baseFetch(url, options, otherOptionsForBaseFetch).then(resolve).catch(reject) + }).catch(() => { + const { + isPublicAPI = false, + silent, + } = otherOptionsForBaseFetch + const bodyJson = errResp.json() + if (isPublicAPI) { + return bodyJson.then((data: ResponseError) => { + if (data.code === 'web_sso_auth_required') + requiredWebSSOLogin() + + if (data.code === 'unauthorized') { + removeAccessToken() + globalThis.location.reload() + } + + return Promise.reject(data) + }) + } + const loginUrl = `${globalThis.location.origin}/signin` + bodyJson.then((data: ResponseError) => { + if (data.code === 'init_validate_failed' && IS_CE_EDITION && !silent) + Toast.notify({ type: 'error', message: data.message, duration: 4000 }) + else if (data.code === 'not_init_validated' && IS_CE_EDITION) + globalThis.location.href = `${globalThis.location.origin}/init` + else if (data.code === 'not_setup' && IS_CE_EDITION) + globalThis.location.href = `${globalThis.location.origin}/install` + else if (location.pathname !== '/signin' || !IS_CE_EDITION) + globalThis.location.href = loginUrl + else if (!silent) + Toast.notify({ type: 'error', message: data.message }) + }).catch(() => { + // Handle any other errors + globalThis.location.href = loginUrl + }) + }) + } + else { + reject(errResp) + } + }) + }) } // request methods diff --git a/web/service/refresh-token.ts b/web/service/refresh-token.ts new file mode 100644 index 0000000000..8bd2215041 --- /dev/null +++ b/web/service/refresh-token.ts @@ -0,0 +1,75 @@ +import { apiPrefix } from '@/config' +import { fetchWithRetry } from '@/utils' + +let isRefreshing = false +function waitUntilTokenRefreshed() { + return new Promise((resolve, reject) => { + function _check() { + const isRefreshingSign = localStorage.getItem('is_refreshing') + if ((isRefreshingSign && isRefreshingSign === '1') || isRefreshing) { + setTimeout(() => { + _check() + }, 1000) + } + else { + resolve() + } + } + _check() + }) +} + +// only one request can send +async function getNewAccessToken(): Promise { + try { + const isRefreshingSign = localStorage.getItem('is_refreshing') + if ((isRefreshingSign && isRefreshingSign === '1') || isRefreshing) { + await waitUntilTokenRefreshed() + } + else { + globalThis.localStorage.setItem('is_refreshing', '1') + isRefreshing = true + const refresh_token = globalThis.localStorage.getItem('refresh_token') + + // Do not use baseFetch to refresh tokens. + // If a 401 response occurs and baseFetch itself attempts to refresh the token, + // it can lead to an infinite loop if the refresh attempt also returns 401. + // To avoid this, handle token refresh separately in a dedicated function + // that does not call baseFetch and uses a single retry mechanism. + const [error, ret] = await fetchWithRetry(globalThis.fetch(`${apiPrefix}/refresh-token`, { + method: 'POST', + headers: { + 'Content-Type': 'application/json;utf-8', + }, + body: JSON.stringify({ refresh_token }), + })) + if (error) { + return Promise.reject(error) + } + else { + if (ret.status === 401) + return Promise.reject(ret) + + const { data } = await ret.json() + globalThis.localStorage.setItem('console_token', data.access_token) + globalThis.localStorage.setItem('refresh_token', data.refresh_token) + } + } + } + catch (error) { + console.error(error) + return Promise.reject(error) + } + finally { + isRefreshing = false + globalThis.localStorage.removeItem('is_refreshing') + } +} + +export async function refreshAccessTokenOrRelogin(timeout: number) { + return Promise.race([new Promise((resolve, reject) => setTimeout(() => { + isRefreshing = false + globalThis.localStorage.removeItem('is_refreshing') + reject(new Error('request timeout')) + }, timeout)), getNewAccessToken()]) +} From 08c731fd847d416f43f713f44c0dcbe4d2288ad7 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Tue, 5 Nov 2024 14:23:18 +0800 Subject: [PATCH 39/73] fix(node): correct file property name in function switch (#10284) --- api/core/workflow/nodes/list_operator/node.py | 2 +- .../core/workflow/nodes/test_list_operator.py | 49 +++++++++++++++++-- 2 files changed, 47 insertions(+), 4 deletions(-) diff --git a/api/core/workflow/nodes/list_operator/node.py b/api/core/workflow/nodes/list_operator/node.py index 0406b97eb8..49e7ca85fd 100644 --- a/api/core/workflow/nodes/list_operator/node.py +++ b/api/core/workflow/nodes/list_operator/node.py @@ -157,7 +157,7 @@ def _get_file_extract_string_func(*, key: str) -> Callable[[File], str]: return lambda x: x.type case "extension": return lambda x: x.extension or "" - case "mimetype": + case "mime_type": return lambda x: x.mime_type or "" case "transfer_method": return lambda x: x.transfer_method diff --git a/api/tests/unit_tests/core/workflow/nodes/test_list_operator.py b/api/tests/unit_tests/core/workflow/nodes/test_list_operator.py index 53e3c93fcc..0f5c8bf51b 100644 --- a/api/tests/unit_tests/core/workflow/nodes/test_list_operator.py +++ b/api/tests/unit_tests/core/workflow/nodes/test_list_operator.py @@ -2,11 +2,11 @@ from unittest.mock import MagicMock import pytest -from core.file import File -from core.file.models import FileTransferMethod, FileType +from core.file import File, FileTransferMethod, FileType from core.variables import ArrayFileSegment from core.workflow.nodes.list_operator.entities import FilterBy, FilterCondition, Limit, ListOperatorNodeData, OrderBy -from core.workflow.nodes.list_operator.node import ListOperatorNode +from core.workflow.nodes.list_operator.exc import InvalidKeyError +from core.workflow.nodes.list_operator.node import ListOperatorNode, _get_file_extract_string_func from models.workflow import WorkflowNodeExecutionStatus @@ -109,3 +109,46 @@ def test_filter_files_by_type(list_operator_node): assert expected_file["tenant_id"] == result_file.tenant_id assert expected_file["transfer_method"] == result_file.transfer_method assert expected_file["related_id"] == result_file.related_id + + +def test_get_file_extract_string_func(): + # Create a File object + file = File( + tenant_id="test_tenant", + type=FileType.DOCUMENT, + transfer_method=FileTransferMethod.LOCAL_FILE, + filename="test_file.txt", + extension=".txt", + mime_type="text/plain", + remote_url="https://example.com/test_file.txt", + related_id="test_related_id", + ) + + # Test each case + assert _get_file_extract_string_func(key="name")(file) == "test_file.txt" + assert _get_file_extract_string_func(key="type")(file) == "document" + assert _get_file_extract_string_func(key="extension")(file) == ".txt" + assert _get_file_extract_string_func(key="mime_type")(file) == "text/plain" + assert _get_file_extract_string_func(key="transfer_method")(file) == "local_file" + assert _get_file_extract_string_func(key="url")(file) == "https://example.com/test_file.txt" + + # Test with empty values + empty_file = File( + tenant_id="test_tenant", + type=FileType.DOCUMENT, + transfer_method=FileTransferMethod.LOCAL_FILE, + filename=None, + extension=None, + mime_type=None, + remote_url=None, + related_id="test_related_id", + ) + + assert _get_file_extract_string_func(key="name")(empty_file) == "" + assert _get_file_extract_string_func(key="extension")(empty_file) == "" + assert _get_file_extract_string_func(key="mime_type")(empty_file) == "" + assert _get_file_extract_string_func(key="url")(empty_file) == "" + + # Test invalid key + with pytest.raises(InvalidKeyError): + _get_file_extract_string_func(key="invalid_key") From 249b897872c65aea27e0505bb5d681ffc0b16e3c Mon Sep 17 00:00:00 2001 From: -LAN- Date: Tue, 5 Nov 2024 14:40:57 +0800 Subject: [PATCH 40/73] feat(model): add validation for custom disclaimer length (#10287) --- api/models/model.py | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/api/models/model.py b/api/models/model.py index bd124cce8e..d049cd373d 100644 --- a/api/models/model.py +++ b/api/models/model.py @@ -1298,7 +1298,7 @@ class Site(db.Model): privacy_policy = db.Column(db.String(255)) show_workflow_steps = db.Column(db.Boolean, nullable=False, server_default=db.text("true")) use_icon_as_answer_icon = db.Column(db.Boolean, nullable=False, server_default=db.text("false")) - custom_disclaimer: Mapped[str] = mapped_column(sa.TEXT, default="") + _custom_disclaimer: Mapped[str] = mapped_column("custom_disclaimer", sa.TEXT, default="") customize_domain = db.Column(db.String(255)) customize_token_strategy = db.Column(db.String(255), nullable=False) prompt_public = db.Column(db.Boolean, nullable=False, server_default=db.text("false")) @@ -1309,6 +1309,16 @@ class Site(db.Model): updated_at = db.Column(db.DateTime, nullable=False, server_default=db.text("CURRENT_TIMESTAMP(0)")) code = db.Column(db.String(255)) + @property + def custom_disclaimer(self): + return self._custom_disclaimer + + @custom_disclaimer.setter + def custom_disclaimer(self, value: str): + if len(value) > 512: + raise ValueError("Custom disclaimer cannot exceed 512 characters.") + self._custom_disclaimer = value + @staticmethod def generate_code(n): while True: From cb245b54354245388824e2f5541481cf633c27ef Mon Sep 17 00:00:00 2001 From: Matsuda Date: Tue, 5 Nov 2024 15:41:15 +0900 Subject: [PATCH 41/73] fix(model_runtime): fix wrong max_tokens for Claude 3.5 Haiku on Amazon Bedrock (#10286) --- .../bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/core/model_runtime/model_providers/bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml b/api/core/model_runtime/model_providers/bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml index 7c676136db..35fc8d0d11 100644 --- a/api/core/model_runtime/model_providers/bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml +++ b/api/core/model_runtime/model_providers/bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml @@ -16,9 +16,9 @@ parameter_rules: use_template: max_tokens required: true type: int - default: 4096 + default: 8192 min: 1 - max: 4096 + max: 8192 help: zh_Hans: 停止前生成的最大令牌数。请注意，Anthropic Claude 模型可能会在达到 max_tokens 的值之前停止生成令牌。不同的 Anthropic Claude 模型对此参数具有不同的最大值。 en_US: The maximum number of tokens to generate before stopping. Note that Anthropic Claude models might stop generating tokens before reaching the value of max_tokens. Different Anthropic Claude models have different maximum values for this parameter. From 4847548779f2ca93683702d787aae21666263fc2 Mon Sep 17 00:00:00 2001 From: Matsuda Date: Tue, 5 Nov 2024 15:41:39 +0900 Subject: [PATCH 42/73] feat(model_runtime): add new model 'claude-3-5-haiku-20241022' (#10285) --- .../anthropic/llm/_position.yaml | 1 + .../llm/claude-3-5-haiku-20241022.yaml | 39 +++++++++++++++++++ 2 files changed, 40 insertions(+) create mode 100644 api/core/model_runtime/model_providers/anthropic/llm/claude-3-5-haiku-20241022.yaml diff --git a/api/core/model_runtime/model_providers/anthropic/llm/_position.yaml b/api/core/model_runtime/model_providers/anthropic/llm/_position.yaml index aca9456313..b7b28a70d4 100644 --- a/api/core/model_runtime/model_providers/anthropic/llm/_position.yaml +++ b/api/core/model_runtime/model_providers/anthropic/llm/_position.yaml @@ -1,3 +1,4 @@ +- claude-3-5-haiku-20241022 - claude-3-5-sonnet-20241022 - claude-3-5-sonnet-20240620 - claude-3-haiku-20240307 diff --git a/api/core/model_runtime/model_providers/anthropic/llm/claude-3-5-haiku-20241022.yaml b/api/core/model_runtime/model_providers/anthropic/llm/claude-3-5-haiku-20241022.yaml new file mode 100644 index 0000000000..cae4c67e4a --- /dev/null +++ b/api/core/model_runtime/model_providers/anthropic/llm/claude-3-5-haiku-20241022.yaml @@ -0,0 +1,39 @@ +model: claude-3-5-haiku-20241022 +label: + en_US: claude-3-5-haiku-20241022 +model_type: llm +features: + - agent-thought + - vision + - tool-call + - stream-tool-call +model_properties: + mode: chat + context_size: 200000 +parameter_rules: + - name: temperature + use_template: temperature + - name: top_p + use_template: top_p + - name: top_k + label: + zh_Hans: 取样数量 + en_US: Top k + type: int + help: + zh_Hans: 仅从每个后续标记的前 K 个选项中采样。 + en_US: Only sample from the top K options for each subsequent token. + required: false + - name: max_tokens + use_template: max_tokens + required: true + default: 8192 + min: 1 + max: 8192 + - name: response_format + use_template: response_format +pricing: + input: '1.00' + output: '5.00' + unit: '0.000001' + currency: USD From bf9349c4dc22d4cbfe76ec1db057cf5a53dd3aca Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=9D=9E=E6=B3=95=E6=93=8D=E4=BD=9C?= Date: Tue, 5 Nov 2024 14:42:47 +0800 Subject: [PATCH 43/73] feat: add xAI model provider (#10272) --- .../model_providers/x/__init__.py | 0 .../model_providers/x/_assets/x-ai-logo.svg | 1 + .../model_providers/x/llm/__init__.py | 0 .../model_providers/x/llm/grok-beta.yaml | 63 ++++++ .../model_providers/x/llm/llm.py | 37 ++++ api/core/model_runtime/model_providers/x/x.py | 25 +++ .../model_runtime/model_providers/x/x.yaml | 38 ++++ api/tests/integration_tests/.env.example | 4 + .../model_runtime/x/__init__.py | 0 .../model_runtime/x/test_llm.py | 204 ++++++++++++++++++ 10 files changed, 372 insertions(+) create mode 100644 api/core/model_runtime/model_providers/x/__init__.py create mode 100644 api/core/model_runtime/model_providers/x/_assets/x-ai-logo.svg create mode 100644 api/core/model_runtime/model_providers/x/llm/__init__.py create mode 100644 api/core/model_runtime/model_providers/x/llm/grok-beta.yaml create mode 100644 api/core/model_runtime/model_providers/x/llm/llm.py create mode 100644 api/core/model_runtime/model_providers/x/x.py create mode 100644 api/core/model_runtime/model_providers/x/x.yaml create mode 100644 api/tests/integration_tests/model_runtime/x/__init__.py create mode 100644 api/tests/integration_tests/model_runtime/x/test_llm.py diff --git a/api/core/model_runtime/model_providers/x/__init__.py b/api/core/model_runtime/model_providers/x/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/api/core/model_runtime/model_providers/x/_assets/x-ai-logo.svg b/api/core/model_runtime/model_providers/x/_assets/x-ai-logo.svg new file mode 100644 index 0000000000..f8b745cb13 --- /dev/null +++ b/api/core/model_runtime/model_providers/x/_assets/x-ai-logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/api/core/model_runtime/model_providers/x/llm/__init__.py b/api/core/model_runtime/model_providers/x/llm/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/api/core/model_runtime/model_providers/x/llm/grok-beta.yaml b/api/core/model_runtime/model_providers/x/llm/grok-beta.yaml new file mode 100644 index 0000000000..7c305735b9 --- /dev/null +++ b/api/core/model_runtime/model_providers/x/llm/grok-beta.yaml @@ -0,0 +1,63 @@ +model: grok-beta +label: + en_US: Grok beta +model_type: llm +features: + - multi-tool-call +model_properties: + mode: chat + context_size: 131072 +parameter_rules: + - name: temperature + label: + en_US: "Temperature" + zh_Hans: "采样温度" + type: float + default: 0.7 + min: 0.0 + max: 2.0 + precision: 1 + required: true + help: + en_US: "The randomness of the sampling temperature control output. The temperature value is within the range of [0.0, 1.0]. The higher the value, the more random and creative the output; the lower the value, the more stable it is. It is recommended to adjust either top_p or temperature parameters according to your needs to avoid adjusting both at the same time." + zh_Hans: "采样温度控制输出的随机性。温度值在 [0.0, 1.0] 范围内，值越高，输出越随机和创造性；值越低，输出越稳定。建议根据需求调整 top_p 或 temperature 参数，避免同时调整两者。" + + - name: top_p + label: + en_US: "Top P" + zh_Hans: "Top P" + type: float + default: 0.7 + min: 0.0 + max: 1.0 + precision: 1 + required: true + help: + en_US: "The value range of the sampling method is [0.0, 1.0]. The top_p value determines that the model selects tokens from the top p% of candidate words with the highest probability; when top_p is 0, this parameter is invalid. It is recommended to adjust either top_p or temperature parameters according to your needs to avoid adjusting both at the same time." + zh_Hans: "采样方法的取值范围为 [0.0,1.0]。top_p 值确定模型从概率最高的前p%的候选词中选取 tokens；当 top_p 为 0 时，此参数无效。建议根据需求调整 top_p 或 temperature 参数，避免同时调整两者。" + + - name: frequency_penalty + use_template: frequency_penalty + label: + en_US: "Frequency Penalty" + zh_Hans: "频率惩罚" + type: float + default: 0 + min: 0 + max: 2.0 + precision: 1 + required: false + help: + en_US: "Number between 0 and 2.0. Positive values penalize new tokens based on their existing frequency in the text so far, decreasing the model's likelihood to repeat the same line verbatim." + zh_Hans: "介于0和2.0之间的数字。正值会根据新标记在文本中迄今为止的现有频率来惩罚它们，从而降低模型一字不差地重复同一句话的可能性。" + + - name: user + use_template: text + label: + en_US: "User" + zh_Hans: "用户" + type: string + required: false + help: + en_US: "Used to track and differentiate conversation requests from different users." + zh_Hans: "用于追踪和区分不同用户的对话请求。" diff --git a/api/core/model_runtime/model_providers/x/llm/llm.py b/api/core/model_runtime/model_providers/x/llm/llm.py new file mode 100644 index 0000000000..3f5325a857 --- /dev/null +++ b/api/core/model_runtime/model_providers/x/llm/llm.py @@ -0,0 +1,37 @@ +from collections.abc import Generator +from typing import Optional, Union + +from yarl import URL + +from core.model_runtime.entities.llm_entities import LLMMode, LLMResult +from core.model_runtime.entities.message_entities import ( + PromptMessage, + PromptMessageTool, +) +from core.model_runtime.model_providers.openai_api_compatible.llm.llm import OAIAPICompatLargeLanguageModel + + +class XAILargeLanguageModel(OAIAPICompatLargeLanguageModel): + def _invoke( + self, + model: str, + credentials: dict, + prompt_messages: list[PromptMessage], + model_parameters: dict, + tools: Optional[list[PromptMessageTool]] = None, + stop: Optional[list[str]] = None, + stream: bool = True, + user: Optional[str] = None, + ) -> Union[LLMResult, Generator]: + self._add_custom_parameters(credentials) + return super()._invoke(model, credentials, prompt_messages, model_parameters, tools, stop, stream) + + def validate_credentials(self, model: str, credentials: dict) -> None: + self._add_custom_parameters(credentials) + super().validate_credentials(model, credentials) + + @staticmethod + def _add_custom_parameters(credentials) -> None: + credentials["endpoint_url"] = str(URL(credentials["endpoint_url"])) or "https://api.x.ai/v1" + credentials["mode"] = LLMMode.CHAT.value + credentials["function_calling_type"] = "tool_call" diff --git a/api/core/model_runtime/model_providers/x/x.py b/api/core/model_runtime/model_providers/x/x.py new file mode 100644 index 0000000000..e3f2b8eeba --- /dev/null +++ b/api/core/model_runtime/model_providers/x/x.py @@ -0,0 +1,25 @@ +import logging + +from core.model_runtime.entities.model_entities import ModelType +from core.model_runtime.errors.validate import CredentialsValidateFailedError +from core.model_runtime.model_providers.__base.model_provider import ModelProvider + +logger = logging.getLogger(__name__) + + +class XAIProvider(ModelProvider): + def validate_provider_credentials(self, credentials: dict) -> None: + """ + Validate provider credentials + if validate failed, raise exception + + :param credentials: provider credentials, credentials form defined in `provider_credential_schema`. + """ + try: + model_instance = self.get_model_instance(ModelType.LLM) + model_instance.validate_credentials(model="grok-beta", credentials=credentials) + except CredentialsValidateFailedError as ex: + raise ex + except Exception as ex: + logger.exception(f"{self.get_provider_schema().provider} credentials validate failed") + raise ex diff --git a/api/core/model_runtime/model_providers/x/x.yaml b/api/core/model_runtime/model_providers/x/x.yaml new file mode 100644 index 0000000000..90d1cbfe7e --- /dev/null +++ b/api/core/model_runtime/model_providers/x/x.yaml @@ -0,0 +1,38 @@ +provider: x +label: + en_US: xAI +description: + en_US: xAI is a company working on building artificial intelligence to accelerate human scientific discovery. We are guided by our mission to advance our collective understanding of the universe. +icon_small: + en_US: x-ai-logo.svg +icon_large: + en_US: x-ai-logo.svg +help: + title: + en_US: Get your token from xAI + zh_Hans: 从 xAI 获取 token + url: + en_US: https://x.ai/api +supported_model_types: + - llm +configurate_methods: + - predefined-model +provider_credential_schema: + credential_form_schemas: + - variable: api_key + label: + en_US: API Key + type: secret-input + required: true + placeholder: + zh_Hans: 在此输入您的 API Key + en_US: Enter your API Key + - variable: endpoint_url + label: + en_US: API Base + type: text-input + required: false + default: https://api.x.ai/v1 + placeholder: + zh_Hans: 在此输入您的 API Base + en_US: Enter your API Base diff --git a/api/tests/integration_tests/.env.example b/api/tests/integration_tests/.env.example index 99728a8271..6fd144c5c2 100644 --- a/api/tests/integration_tests/.env.example +++ b/api/tests/integration_tests/.env.example @@ -95,3 +95,7 @@ GPUSTACK_API_KEY= # Gitee AI Credentials GITEE_AI_API_KEY= + +# xAI Credentials +XAI_API_KEY= +XAI_API_BASE= diff --git a/api/tests/integration_tests/model_runtime/x/__init__.py b/api/tests/integration_tests/model_runtime/x/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/api/tests/integration_tests/model_runtime/x/test_llm.py b/api/tests/integration_tests/model_runtime/x/test_llm.py new file mode 100644 index 0000000000..647a2f6480 --- /dev/null +++ b/api/tests/integration_tests/model_runtime/x/test_llm.py @@ -0,0 +1,204 @@ +import os +from collections.abc import Generator + +import pytest + +from core.model_runtime.entities.llm_entities import LLMResult, LLMResultChunk, LLMResultChunkDelta +from core.model_runtime.entities.message_entities import ( + AssistantPromptMessage, + PromptMessageTool, + SystemPromptMessage, + UserPromptMessage, +) +from core.model_runtime.entities.model_entities import AIModelEntity +from core.model_runtime.errors.validate import CredentialsValidateFailedError +from core.model_runtime.model_providers.x.llm.llm import XAILargeLanguageModel + +"""FOR MOCK FIXTURES, DO NOT REMOVE""" +from tests.integration_tests.model_runtime.__mock.openai import setup_openai_mock + + +def test_predefined_models(): + model = XAILargeLanguageModel() + model_schemas = model.predefined_models() + + assert len(model_schemas) >= 1 + assert isinstance(model_schemas[0], AIModelEntity) + + +@pytest.mark.parametrize("setup_openai_mock", [["chat"]], indirect=True) +def test_validate_credentials_for_chat_model(setup_openai_mock): + model = XAILargeLanguageModel() + + with pytest.raises(CredentialsValidateFailedError): + # model name to gpt-3.5-turbo because of mocking + model.validate_credentials( + model="gpt-3.5-turbo", + credentials={"api_key": "invalid_key", "endpoint_url": os.environ.get("XAI_API_BASE"), "mode": "chat"}, + ) + + model.validate_credentials( + model="grok-beta", + credentials={ + "api_key": os.environ.get("XAI_API_KEY"), + "endpoint_url": os.environ.get("XAI_API_BASE"), + "mode": "chat", + }, + ) + + +@pytest.mark.parametrize("setup_openai_mock", [["chat"]], indirect=True) +def test_invoke_chat_model(setup_openai_mock): + model = XAILargeLanguageModel() + + result = model.invoke( + model="grok-beta", + credentials={ + "api_key": os.environ.get("XAI_API_KEY"), + "endpoint_url": os.environ.get("XAI_API_BASE"), + "mode": "chat", + }, + prompt_messages=[ + SystemPromptMessage( + content="You are a helpful AI assistant.", + ), + UserPromptMessage(content="Hello World!"), + ], + model_parameters={ + "temperature": 0.0, + "top_p": 1.0, + "presence_penalty": 0.0, + "frequency_penalty": 0.0, + "max_tokens": 10, + }, + stop=["How"], + stream=False, + user="foo", + ) + + assert isinstance(result, LLMResult) + assert len(result.message.content) > 0 + + +@pytest.mark.parametrize("setup_openai_mock", [["chat"]], indirect=True) +def test_invoke_chat_model_with_tools(setup_openai_mock): + model = XAILargeLanguageModel() + + result = model.invoke( + model="grok-beta", + credentials={ + "api_key": os.environ.get("XAI_API_KEY"), + "endpoint_url": os.environ.get("XAI_API_BASE"), + "mode": "chat", + }, + prompt_messages=[ + SystemPromptMessage( + content="You are a helpful AI assistant.", + ), + UserPromptMessage( + content="what's the weather today in London?", + ), + ], + model_parameters={"temperature": 0.0, "max_tokens": 100}, + tools=[ + PromptMessageTool( + name="get_weather", + description="Determine weather in my location", + parameters={ + "type": "object", + "properties": { + "location": {"type": "string", "description": "The city and state e.g. San Francisco, CA"}, + "unit": {"type": "string", "enum": ["c", "f"]}, + }, + "required": ["location"], + }, + ), + PromptMessageTool( + name="get_stock_price", + description="Get the current stock price", + parameters={ + "type": "object", + "properties": {"symbol": {"type": "string", "description": "The stock symbol"}}, + "required": ["symbol"], + }, + ), + ], + stream=False, + user="foo", + ) + + assert isinstance(result, LLMResult) + assert isinstance(result.message, AssistantPromptMessage) + + +@pytest.mark.parametrize("setup_openai_mock", [["chat"]], indirect=True) +def test_invoke_stream_chat_model(setup_openai_mock): + model = XAILargeLanguageModel() + + result = model.invoke( + model="grok-beta", + credentials={ + "api_key": os.environ.get("XAI_API_KEY"), + "endpoint_url": os.environ.get("XAI_API_BASE"), + "mode": "chat", + }, + prompt_messages=[ + SystemPromptMessage( + content="You are a helpful AI assistant.", + ), + UserPromptMessage(content="Hello World!"), + ], + model_parameters={"temperature": 0.0, "max_tokens": 100}, + stream=True, + user="foo", + ) + + assert isinstance(result, Generator) + + for chunk in result: + assert isinstance(chunk, LLMResultChunk) + assert isinstance(chunk.delta, LLMResultChunkDelta) + assert isinstance(chunk.delta.message, AssistantPromptMessage) + assert len(chunk.delta.message.content) > 0 if chunk.delta.finish_reason is None else True + if chunk.delta.finish_reason is not None: + assert chunk.delta.usage is not None + assert chunk.delta.usage.completion_tokens > 0 + + +def test_get_num_tokens(): + model = XAILargeLanguageModel() + + num_tokens = model.get_num_tokens( + model="grok-beta", + credentials={"api_key": os.environ.get("XAI_API_KEY"), "endpoint_url": os.environ.get("XAI_API_BASE")}, + prompt_messages=[UserPromptMessage(content="Hello World!")], + ) + + assert num_tokens == 10 + + num_tokens = model.get_num_tokens( + model="grok-beta", + credentials={"api_key": os.environ.get("XAI_API_KEY"), "endpoint_url": os.environ.get("XAI_API_BASE")}, + prompt_messages=[ + SystemPromptMessage( + content="You are a helpful AI assistant.", + ), + UserPromptMessage(content="Hello World!"), + ], + tools=[ + PromptMessageTool( + name="get_weather", + description="Determine weather in my location", + parameters={ + "type": "object", + "properties": { + "location": {"type": "string", "description": "The city and state e.g. San Francisco, CA"}, + "unit": {"type": "string", "enum": ["c", "f"]}, + }, + "required": ["location"], + }, + ), + ], + ) + + assert num_tokens == 77 From 233bffdb7d4ce967295d03cd283b104b202c945e Mon Sep 17 00:00:00 2001 From: eux Date: Tue, 5 Nov 2024 14:42:59 +0800 Subject: [PATCH 44/73] fix: borken faq url in CONTRIBUTING.md (#10275) --- CONTRIBUTING.md | 2 +- CONTRIBUTING_VI.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8f57cd545e..da2928d189 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -81,7 +81,7 @@ Dify requires the following dependencies to build, make sure they're installed o Dify is composed of a backend and a frontend. Navigate to the backend directory by `cd api/`, then follow the [Backend README](api/README.md) to install it. In a separate terminal, navigate to the frontend directory by `cd web/`, then follow the [Frontend README](web/README.md) to install. -Check the [installation FAQ](https://docs.dify.ai/learn-more/faq/self-host-faq) for a list of common issues and steps to troubleshoot. +Check the [installation FAQ](https://docs.dify.ai/learn-more/faq/install-faq) for a list of common issues and steps to troubleshoot. ### 5. Visit dify in your browser diff --git a/CONTRIBUTING_VI.md b/CONTRIBUTING_VI.md index 80e68a046e..a77239ff38 100644 --- a/CONTRIBUTING_VI.md +++ b/CONTRIBUTING_VI.md @@ -79,7 +79,7 @@ Dify yêu cầu các phụ thuộc sau để build, hãy đảm bảo chúng đ Dify bao gồm một backend và một frontend. Đi đến thư mục backend bằng lệnh `cd api/`, sau đó làm theo hướng dẫn trong [README của Backend](api/README.md) để cài đặt. Trong một terminal khác, đi đến thư mục frontend bằng lệnh `cd web/`, sau đó làm theo hướng dẫn trong [README của Frontend](web/README.md) để cài đặt. -Kiểm tra [FAQ về cài đặt](https://docs.dify.ai/learn-more/faq/self-host-faq) để xem danh sách các vấn đề thường gặp và các bước khắc phục. +Kiểm tra [FAQ về cài đặt](https://docs.dify.ai/learn-more/faq/install-faq) để xem danh sách các vấn đề thường gặp và các bước khắc phục. ### 5. Truy cập Dify trong trình duyệt của bạn From 5f21d13572aa0a60ab4c7482626d0003e7def2c2 Mon Sep 17 00:00:00 2001 From: pinsily <13160724868@163.com> Date: Tue, 5 Nov 2024 14:47:15 +0800 Subject: [PATCH 45/73] fix: handle KeyError when accessing rules in CleanProcessor.clean (#10258) --- api/core/indexing_runner.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/core/indexing_runner.py b/api/core/indexing_runner.py index fb9fe8f210..e2a94073cf 100644 --- a/api/core/indexing_runner.py +++ b/api/core/indexing_runner.py @@ -598,7 +598,7 @@ class IndexingRunner: rules = DatasetProcessRule.AUTOMATIC_RULES else: rules = json.loads(processing_rule.rules) if processing_rule.rules else {} - document_text = CleanProcessor.clean(text, rules) + document_text = CleanProcessor.clean(text, {"rules": rules}) return document_text From 68e0b0ac84e1cbde7233f9e4ab66236bffe20b4f Mon Sep 17 00:00:00 2001 From: Matsuda Date: Tue, 5 Nov 2024 17:09:53 +0900 Subject: [PATCH 46/73] fix typo: writeOpner to writeOpener (#10290) --- web/i18n/pl-PL/app-debug.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/web/i18n/pl-PL/app-debug.ts b/web/i18n/pl-PL/app-debug.ts index 7cf6c77cb4..cf7232e563 100644 --- a/web/i18n/pl-PL/app-debug.ts +++ b/web/i18n/pl-PL/app-debug.ts @@ -355,7 +355,7 @@ const translation = { openingStatement: { title: 'Wstęp do rozmowy', add: 'Dodaj', - writeOpner: 'Napisz wstęp', + writeOpener: 'Napisz wstęp', placeholder: 'Tutaj napisz swoją wiadomość wprowadzającą, możesz użyć zmiennych, spróbuj wpisać {{variable}}.', openingQuestion: 'Pytania otwierające', From ae254f0a10114060ee32ff521eb8bafec2acf792 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Tue, 5 Nov 2024 16:30:23 +0800 Subject: [PATCH 47/73] fix(http_request): improve parameter initialization and reorganize tests (#10297) --- .../workflow/nodes/http_request/executor.py | 6 +- .../test_http_request_executor.py | 198 ++++++++++++++++++ .../test_http_request_node.py | 169 +-------------- 3 files changed, 203 insertions(+), 170 deletions(-) create mode 100644 api/tests/unit_tests/core/workflow/nodes/http_request/test_http_request_executor.py rename api/tests/unit_tests/core/workflow/nodes/{ => http_request}/test_http_request_node.py (52%) diff --git a/api/core/workflow/nodes/http_request/executor.py b/api/core/workflow/nodes/http_request/executor.py index 6204fc2644..d90dfcc766 100644 --- a/api/core/workflow/nodes/http_request/executor.py +++ b/api/core/workflow/nodes/http_request/executor.py @@ -88,8 +88,10 @@ class Executor: self.url = self.variable_pool.convert_template(self.node_data.url).text def _init_params(self): - params = self.variable_pool.convert_template(self.node_data.params).text - self.params = _plain_text_to_dict(params) + params = _plain_text_to_dict(self.node_data.params) + for key in params: + params[key] = self.variable_pool.convert_template(params[key]).text + self.params = params def _init_headers(self): headers = self.variable_pool.convert_template(self.node_data.headers).text diff --git a/api/tests/unit_tests/core/workflow/nodes/http_request/test_http_request_executor.py b/api/tests/unit_tests/core/workflow/nodes/http_request/test_http_request_executor.py new file mode 100644 index 0000000000..12c469a81a --- /dev/null +++ b/api/tests/unit_tests/core/workflow/nodes/http_request/test_http_request_executor.py @@ -0,0 +1,198 @@ +from core.workflow.entities.variable_pool import VariablePool +from core.workflow.nodes.http_request import ( + BodyData, + HttpRequestNodeAuthorization, + HttpRequestNodeBody, + HttpRequestNodeData, +) +from core.workflow.nodes.http_request.entities import HttpRequestNodeTimeout +from core.workflow.nodes.http_request.executor import Executor + + +def test_executor_with_json_body_and_number_variable(): + # Prepare the variable pool + variable_pool = VariablePool( + system_variables={}, + user_inputs={}, + ) + variable_pool.add(["pre_node_id", "number"], 42) + + # Prepare the node data + node_data = HttpRequestNodeData( + title="Test JSON Body with Number Variable", + method="post", + url="https://api.example.com/data", + authorization=HttpRequestNodeAuthorization(type="no-auth"), + headers="Content-Type: application/json", + params="", + body=HttpRequestNodeBody( + type="json", + data=[ + BodyData( + key="", + type="text", + value='{"number": {{#pre_node_id.number#}}}', + ) + ], + ), + ) + + # Initialize the Executor + executor = Executor( + node_data=node_data, + timeout=HttpRequestNodeTimeout(connect=10, read=30, write=30), + variable_pool=variable_pool, + ) + + # Check the executor's data + assert executor.method == "post" + assert executor.url == "https://api.example.com/data" + assert executor.headers == {"Content-Type": "application/json"} + assert executor.params == {} + assert executor.json == {"number": 42} + assert executor.data is None + assert executor.files is None + assert executor.content is None + + # Check the raw request (to_log method) + raw_request = executor.to_log() + assert "POST /data HTTP/1.1" in raw_request + assert "Host: api.example.com" in raw_request + assert "Content-Type: application/json" in raw_request + assert '{"number": 42}' in raw_request + + +def test_executor_with_json_body_and_object_variable(): + # Prepare the variable pool + variable_pool = VariablePool( + system_variables={}, + user_inputs={}, + ) + variable_pool.add(["pre_node_id", "object"], {"name": "John Doe", "age": 30, "email": "john@example.com"}) + + # Prepare the node data + node_data = HttpRequestNodeData( + title="Test JSON Body with Object Variable", + method="post", + url="https://api.example.com/data", + authorization=HttpRequestNodeAuthorization(type="no-auth"), + headers="Content-Type: application/json", + params="", + body=HttpRequestNodeBody( + type="json", + data=[ + BodyData( + key="", + type="text", + value="{{#pre_node_id.object#}}", + ) + ], + ), + ) + + # Initialize the Executor + executor = Executor( + node_data=node_data, + timeout=HttpRequestNodeTimeout(connect=10, read=30, write=30), + variable_pool=variable_pool, + ) + + # Check the executor's data + assert executor.method == "post" + assert executor.url == "https://api.example.com/data" + assert executor.headers == {"Content-Type": "application/json"} + assert executor.params == {} + assert executor.json == {"name": "John Doe", "age": 30, "email": "john@example.com"} + assert executor.data is None + assert executor.files is None + assert executor.content is None + + # Check the raw request (to_log method) + raw_request = executor.to_log() + assert "POST /data HTTP/1.1" in raw_request + assert "Host: api.example.com" in raw_request + assert "Content-Type: application/json" in raw_request + assert '"name": "John Doe"' in raw_request + assert '"age": 30' in raw_request + assert '"email": "john@example.com"' in raw_request + + +def test_executor_with_json_body_and_nested_object_variable(): + # Prepare the variable pool + variable_pool = VariablePool( + system_variables={}, + user_inputs={}, + ) + variable_pool.add(["pre_node_id", "object"], {"name": "John Doe", "age": 30, "email": "john@example.com"}) + + # Prepare the node data + node_data = HttpRequestNodeData( + title="Test JSON Body with Nested Object Variable", + method="post", + url="https://api.example.com/data", + authorization=HttpRequestNodeAuthorization(type="no-auth"), + headers="Content-Type: application/json", + params="", + body=HttpRequestNodeBody( + type="json", + data=[ + BodyData( + key="", + type="text", + value='{"object": {{#pre_node_id.object#}}}', + ) + ], + ), + ) + + # Initialize the Executor + executor = Executor( + node_data=node_data, + timeout=HttpRequestNodeTimeout(connect=10, read=30, write=30), + variable_pool=variable_pool, + ) + + # Check the executor's data + assert executor.method == "post" + assert executor.url == "https://api.example.com/data" + assert executor.headers == {"Content-Type": "application/json"} + assert executor.params == {} + assert executor.json == {"object": {"name": "John Doe", "age": 30, "email": "john@example.com"}} + assert executor.data is None + assert executor.files is None + assert executor.content is None + + # Check the raw request (to_log method) + raw_request = executor.to_log() + assert "POST /data HTTP/1.1" in raw_request + assert "Host: api.example.com" in raw_request + assert "Content-Type: application/json" in raw_request + assert '"object": {' in raw_request + assert '"name": "John Doe"' in raw_request + assert '"age": 30' in raw_request + assert '"email": "john@example.com"' in raw_request + + +def test_extract_selectors_from_template_with_newline(): + variable_pool = VariablePool() + variable_pool.add(("node_id", "custom_query"), "line1\nline2") + node_data = HttpRequestNodeData( + title="Test JSON Body with Nested Object Variable", + method="post", + url="https://api.example.com/data", + authorization=HttpRequestNodeAuthorization(type="no-auth"), + headers="Content-Type: application/json", + params="test: {{#node_id.custom_query#}}", + body=HttpRequestNodeBody( + type="none", + data=[], + ), + ) + + executor = Executor( + node_data=node_data, + timeout=HttpRequestNodeTimeout(connect=10, read=30, write=30), + variable_pool=variable_pool, + ) + + assert executor.params == {"test": "line1\nline2"} diff --git a/api/tests/unit_tests/core/workflow/nodes/test_http_request_node.py b/api/tests/unit_tests/core/workflow/nodes/http_request/test_http_request_node.py similarity index 52% rename from api/tests/unit_tests/core/workflow/nodes/test_http_request_node.py rename to api/tests/unit_tests/core/workflow/nodes/http_request/test_http_request_node.py index 720037d05f..741a3a1894 100644 --- a/api/tests/unit_tests/core/workflow/nodes/test_http_request_node.py +++ b/api/tests/unit_tests/core/workflow/nodes/http_request/test_http_request_node.py @@ -1,5 +1,3 @@ -import json - import httpx from core.app.entities.app_invoke_entities import InvokeFrom @@ -16,8 +14,7 @@ from core.workflow.nodes.http_request import ( HttpRequestNodeBody, HttpRequestNodeData, ) -from core.workflow.nodes.http_request.entities import HttpRequestNodeTimeout -from core.workflow.nodes.http_request.executor import Executor, _plain_text_to_dict +from core.workflow.nodes.http_request.executor import _plain_text_to_dict from models.enums import UserFrom from models.workflow import WorkflowNodeExecutionStatus, WorkflowType @@ -203,167 +200,3 @@ def test_http_request_node_form_with_file(monkeypatch): assert result.status == WorkflowNodeExecutionStatus.SUCCEEDED assert result.outputs is not None assert result.outputs["body"] == "" - - -def test_executor_with_json_body_and_number_variable(): - # Prepare the variable pool - variable_pool = VariablePool( - system_variables={}, - user_inputs={}, - ) - variable_pool.add(["pre_node_id", "number"], 42) - - # Prepare the node data - node_data = HttpRequestNodeData( - title="Test JSON Body with Number Variable", - method="post", - url="https://api.example.com/data", - authorization=HttpRequestNodeAuthorization(type="no-auth"), - headers="Content-Type: application/json", - params="", - body=HttpRequestNodeBody( - type="json", - data=[ - BodyData( - key="", - type="text", - value='{"number": {{#pre_node_id.number#}}}', - ) - ], - ), - ) - - # Initialize the Executor - executor = Executor( - node_data=node_data, - timeout=HttpRequestNodeTimeout(connect=10, read=30, write=30), - variable_pool=variable_pool, - ) - - # Check the executor's data - assert executor.method == "post" - assert executor.url == "https://api.example.com/data" - assert executor.headers == {"Content-Type": "application/json"} - assert executor.params == {} - assert executor.json == {"number": 42} - assert executor.data is None - assert executor.files is None - assert executor.content is None - - # Check the raw request (to_log method) - raw_request = executor.to_log() - assert "POST /data HTTP/1.1" in raw_request - assert "Host: api.example.com" in raw_request - assert "Content-Type: application/json" in raw_request - assert '{"number": 42}' in raw_request - - -def test_executor_with_json_body_and_object_variable(): - # Prepare the variable pool - variable_pool = VariablePool( - system_variables={}, - user_inputs={}, - ) - variable_pool.add(["pre_node_id", "object"], {"name": "John Doe", "age": 30, "email": "john@example.com"}) - - # Prepare the node data - node_data = HttpRequestNodeData( - title="Test JSON Body with Object Variable", - method="post", - url="https://api.example.com/data", - authorization=HttpRequestNodeAuthorization(type="no-auth"), - headers="Content-Type: application/json", - params="", - body=HttpRequestNodeBody( - type="json", - data=[ - BodyData( - key="", - type="text", - value="{{#pre_node_id.object#}}", - ) - ], - ), - ) - - # Initialize the Executor - executor = Executor( - node_data=node_data, - timeout=HttpRequestNodeTimeout(connect=10, read=30, write=30), - variable_pool=variable_pool, - ) - - # Check the executor's data - assert executor.method == "post" - assert executor.url == "https://api.example.com/data" - assert executor.headers == {"Content-Type": "application/json"} - assert executor.params == {} - assert executor.json == {"name": "John Doe", "age": 30, "email": "john@example.com"} - assert executor.data is None - assert executor.files is None - assert executor.content is None - - # Check the raw request (to_log method) - raw_request = executor.to_log() - assert "POST /data HTTP/1.1" in raw_request - assert "Host: api.example.com" in raw_request - assert "Content-Type: application/json" in raw_request - assert '"name": "John Doe"' in raw_request - assert '"age": 30' in raw_request - assert '"email": "john@example.com"' in raw_request - - -def test_executor_with_json_body_and_nested_object_variable(): - # Prepare the variable pool - variable_pool = VariablePool( - system_variables={}, - user_inputs={}, - ) - variable_pool.add(["pre_node_id", "object"], {"name": "John Doe", "age": 30, "email": "john@example.com"}) - - # Prepare the node data - node_data = HttpRequestNodeData( - title="Test JSON Body with Nested Object Variable", - method="post", - url="https://api.example.com/data", - authorization=HttpRequestNodeAuthorization(type="no-auth"), - headers="Content-Type: application/json", - params="", - body=HttpRequestNodeBody( - type="json", - data=[ - BodyData( - key="", - type="text", - value='{"object": {{#pre_node_id.object#}}}', - ) - ], - ), - ) - - # Initialize the Executor - executor = Executor( - node_data=node_data, - timeout=HttpRequestNodeTimeout(connect=10, read=30, write=30), - variable_pool=variable_pool, - ) - - # Check the executor's data - assert executor.method == "post" - assert executor.url == "https://api.example.com/data" - assert executor.headers == {"Content-Type": "application/json"} - assert executor.params == {} - assert executor.json == {"object": {"name": "John Doe", "age": 30, "email": "john@example.com"}} - assert executor.data is None - assert executor.files is None - assert executor.content is None - - # Check the raw request (to_log method) - raw_request = executor.to_log() - assert "POST /data HTTP/1.1" in raw_request - assert "Host: api.example.com" in raw_request - assert "Content-Type: application/json" in raw_request - assert '"object": {' in raw_request - assert '"name": "John Doe"' in raw_request - assert '"age": 30' in raw_request - assert '"email": "john@example.com"' in raw_request From 7962101e5e569cc47c2286dba4860f09762896f1 Mon Sep 17 00:00:00 2001 From: Novice <857526207@qq.com> Date: Tue, 5 Nov 2024 16:31:49 +0800 Subject: [PATCH 48/73] fix: iteration none output error (#10295) --- api/factories/variable_factory.py | 2 ++ api/tests/unit_tests/core/app/segments/test_factory.py | 7 +++++++ 2 files changed, 9 insertions(+) diff --git a/api/factories/variable_factory.py b/api/factories/variable_factory.py index d0c8c7e84f..0191102b90 100644 --- a/api/factories/variable_factory.py +++ b/api/factories/variable_factory.py @@ -91,6 +91,8 @@ def build_segment(value: Any, /) -> Segment: return ArrayObjectSegment(value=value) case SegmentType.FILE: return ArrayFileSegment(value=value) + case SegmentType.NONE: + return ArrayAnySegment(value=value) case _: raise ValueError(f"not supported value {value}") raise ValueError(f"not supported value {value}") diff --git a/api/tests/unit_tests/core/app/segments/test_factory.py b/api/tests/unit_tests/core/app/segments/test_factory.py index 72d277fad4..882a87239b 100644 --- a/api/tests/unit_tests/core/app/segments/test_factory.py +++ b/api/tests/unit_tests/core/app/segments/test_factory.py @@ -13,6 +13,7 @@ from core.variables import ( StringVariable, ) from core.variables.exc import VariableError +from core.variables.segments import ArrayAnySegment from factories import variable_factory @@ -156,3 +157,9 @@ def test_variable_cannot_large_than_200_kb(): "value": "a" * 1024 * 201, } ) + + +def test_array_none_variable(): + var = variable_factory.build_segment([None, None, None, None]) + assert isinstance(var, ArrayAnySegment) + assert var.value == [None, None, None, None] From 7f583ec1ac6e7fb5269ed696f40a96a8b6b6f5fc Mon Sep 17 00:00:00 2001 From: -LAN- Date: Tue, 5 Nov 2024 17:53:56 +0800 Subject: [PATCH 49/73] chore: update version to 0.11.0 across all relevant files (#10278) --- api/configs/packaging/__init__.py | 2 +- api/services/app_dsl_service/service.py | 6 +----- docker-legacy/docker-compose.yaml | 6 +++--- docker/docker-compose.yaml | 6 +++--- web/package.json | 2 +- 5 files changed, 9 insertions(+), 13 deletions(-) diff --git a/api/configs/packaging/__init__.py b/api/configs/packaging/__init__.py index 3dc87e3058..b5cb1f06d9 100644 --- a/api/configs/packaging/__init__.py +++ b/api/configs/packaging/__init__.py @@ -9,7 +9,7 @@ class PackagingInfo(BaseSettings): CURRENT_VERSION: str = Field( description="Dify version", - default="0.10.2", + default="0.11.0", ) COMMIT_SHA: str = Field( diff --git a/api/services/app_dsl_service/service.py b/api/services/app_dsl_service/service.py index 32b95ae3aa..e6b0d9a272 100644 --- a/api/services/app_dsl_service/service.py +++ b/api/services/app_dsl_service/service.py @@ -27,11 +27,7 @@ from .exc import ( logger = logging.getLogger(__name__) -current_dsl_version = "0.1.2" -dsl_to_dify_version_mapping: dict[str, str] = { - "0.1.2": "0.8.0", - "0.1.1": "0.6.0", # dsl version -> from dify version -} +current_dsl_version = "0.1.3" class AppDslService: diff --git a/docker-legacy/docker-compose.yaml b/docker-legacy/docker-compose.yaml index e3f1c3b761..88650194ec 100644 --- a/docker-legacy/docker-compose.yaml +++ b/docker-legacy/docker-compose.yaml @@ -2,7 +2,7 @@ version: '3' services: # API service api: - image: langgenius/dify-api:0.10.2 + image: langgenius/dify-api:0.11.0 restart: always environment: # Startup mode, 'api' starts the API server. @@ -227,7 +227,7 @@ services: # worker service # The Celery worker for processing the queue. worker: - image: langgenius/dify-api:0.10.2 + image: langgenius/dify-api:0.11.0 restart: always environment: CONSOLE_WEB_URL: '' @@ -396,7 +396,7 @@ services: # Frontend web application. web: - image: langgenius/dify-web:0.10.2 + image: langgenius/dify-web:0.11.0 restart: always environment: # The base URL of console application api server, refers to the Console base URL of WEB service if console domain is diff --git a/docker/docker-compose.yaml b/docker/docker-compose.yaml index a26838af10..cdcc62e127 100644 --- a/docker/docker-compose.yaml +++ b/docker/docker-compose.yaml @@ -273,7 +273,7 @@ x-shared-env: &shared-api-worker-env services: # API service api: - image: langgenius/dify-api:0.10.2 + image: langgenius/dify-api:0.11.0 restart: always environment: # Use the shared environment variables. @@ -293,7 +293,7 @@ services: # worker service # The Celery worker for processing the queue. worker: - image: langgenius/dify-api:0.10.2 + image: langgenius/dify-api:0.11.0 restart: always environment: # Use the shared environment variables. @@ -312,7 +312,7 @@ services: # Frontend web application. web: - image: langgenius/dify-web:0.10.2 + image: langgenius/dify-web:0.11.0 restart: always environment: CONSOLE_API_URL: ${CONSOLE_API_URL:-} diff --git a/web/package.json b/web/package.json index 04ef26afcd..de01eb4d48 100644 --- a/web/package.json +++ b/web/package.json @@ -1,6 +1,6 @@ { "name": "dify-web", - "version": "0.10.2", + "version": "0.11.0", "private": true, "engines": { "node": ">=18.17.0" From d92e3bd6209157e792c830ee768fccb58c1cb76a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=9D=9E=E6=B3=95=E6=93=8D=E4=BD=9C?= Date: Tue, 5 Nov 2024 18:21:41 +0800 Subject: [PATCH 50/73] fix: special prompt not work for comfyUI tool (#10307) --- .../builtin/comfyui/tools/comfyui_workflow.py | 26 ++++++++++++++++--- 1 file changed, 22 insertions(+), 4 deletions(-) diff --git a/api/core/tools/provider/builtin/comfyui/tools/comfyui_workflow.py b/api/core/tools/provider/builtin/comfyui/tools/comfyui_workflow.py index 79fe08a86b..d62772cda7 100644 --- a/api/core/tools/provider/builtin/comfyui/tools/comfyui_workflow.py +++ b/api/core/tools/provider/builtin/comfyui/tools/comfyui_workflow.py @@ -8,6 +8,20 @@ from core.tools.provider.builtin.comfyui.tools.comfyui_client import ComfyUiClie from core.tools.tool.builtin_tool import BuiltinTool +def sanitize_json_string(s): + escape_dict = { + "\n": "\\n", + "\r": "\\r", + "\t": "\\t", + "\b": "\\b", + "\f": "\\f", + } + for char, escaped in escape_dict.items(): + s = s.replace(char, escaped) + + return s + + class ComfyUIWorkflowTool(BuiltinTool): def _invoke(self, user_id: str, tool_parameters: dict[str, Any]) -> ToolInvokeMessage | list[ToolInvokeMessage]: comfyui = ComfyUiClient(self.runtime.credentials["base_url"]) @@ -26,13 +40,17 @@ class ComfyUIWorkflowTool(BuiltinTool): set_prompt_with_ksampler = True if "{{positive_prompt}}" in workflow: set_prompt_with_ksampler = False - workflow = workflow.replace("{{positive_prompt}}", positive_prompt) - workflow = workflow.replace("{{negative_prompt}}", negative_prompt) + workflow = workflow.replace("{{positive_prompt}}", positive_prompt.replace('"', "'")) + workflow = workflow.replace("{{negative_prompt}}", negative_prompt.replace('"', "'")) try: prompt = json.loads(workflow) - except: - return self.create_text_message("the Workflow JSON is not correct") + except json.JSONDecodeError: + cleaned_string = sanitize_json_string(workflow) + try: + prompt = json.loads(cleaned_string) + except: + return self.create_text_message("the Workflow JSON is not correct") if set_prompt_with_ksampler: try: From 1279e27825fb65ab5b75df8175bf982df9c97b86 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Tue, 5 Nov 2024 20:48:14 +0800 Subject: [PATCH 51/73] docs: remove the TOC part (#10324) --- README.md | 25 ------------------------- 1 file changed, 25 deletions(-) diff --git a/README.md b/README.md index 61bd0d1e26..cedd81bd8a 100644 --- a/README.md +++ b/README.md @@ -45,31 +45,6 @@ README Tiếng Việt

- -## Table of Content -0. [Quick-Start🚀](https://github.com/langgenius/dify?tab=readme-ov-file#quick-start) - -1. [Intro📖](https://github.com/langgenius/dify?tab=readme-ov-file#intro) - -2. [How to use🔧](https://github.com/langgenius/dify?tab=readme-ov-file#using-dify) - -3. [Stay Ahead🏃](https://github.com/langgenius/dify?tab=readme-ov-file#staying-ahead) - -4. [Next Steps🏹](https://github.com/langgenius/dify?tab=readme-ov-file#next-steps) - -5. [Contributing💪](https://github.com/langgenius/dify?tab=readme-ov-file#contributing) - -6. [Community and Contact🏠](https://github.com/langgenius/dify?tab=readme-ov-file#community--contact) - -7. [Star-History📈](https://github.com/langgenius/dify?tab=readme-ov-file#star-history) - -8. [Security🔒](https://github.com/langgenius/dify?tab=readme-ov-file#security-disclosure) - -9. [License🤝](https://github.com/langgenius/dify?tab=readme-ov-file#license) - -> Make sure you read through this README before you start utilizing Dify😊 - - ## Quick start The quickest way to deploy Dify locally is to run our [docker-compose.yml](https://github.com/langgenius/dify/blob/main/docker/docker-compose.yaml). Follow the instructions to start in 5 minutes. From d7b4d0756e8a538c582ee4d5a57f0830ec305c93 Mon Sep 17 00:00:00 2001 From: Benjamin Date: Tue, 5 Nov 2024 20:58:49 +0800 Subject: [PATCH 52/73] feat(vannaai): add base_url configuration (#10294) --- .../provider/builtin/vanna/tools/vanna.py | 3 ++- .../tools/provider/builtin/vanna/vanna.py | 23 ++++++++++++++++++- .../tools/provider/builtin/vanna/vanna.yaml | 7 ++++++ 3 files changed, 31 insertions(+), 2 deletions(-) diff --git a/api/core/tools/provider/builtin/vanna/tools/vanna.py b/api/core/tools/provider/builtin/vanna/tools/vanna.py index 2443991d57..1c7cb39c92 100644 --- a/api/core/tools/provider/builtin/vanna/tools/vanna.py +++ b/api/core/tools/provider/builtin/vanna/tools/vanna.py @@ -35,7 +35,8 @@ class VannaTool(BuiltinTool): password = tool_parameters.get("password", "") port = tool_parameters.get("port", 0) - vn = VannaDefault(model=model, api_key=api_key) + base_url = self.runtime.credentials.get("base_url", None) + vn = VannaDefault(model=model, api_key=api_key, config={"endpoint": base_url}) db_type = tool_parameters.get("db_type", "") if db_type in {"Postgres", "MySQL", "Hive", "ClickHouse"}: diff --git a/api/core/tools/provider/builtin/vanna/vanna.py b/api/core/tools/provider/builtin/vanna/vanna.py index 84724e921a..1d71414bf3 100644 --- a/api/core/tools/provider/builtin/vanna/vanna.py +++ b/api/core/tools/provider/builtin/vanna/vanna.py @@ -1,4 +1,6 @@ +import re from typing import Any +from urllib.parse import urlparse from core.tools.errors import ToolProviderCredentialValidationError from core.tools.provider.builtin.vanna.tools.vanna import VannaTool @@ -6,7 +8,26 @@ from core.tools.provider.builtin_tool_provider import BuiltinToolProviderControl class VannaProvider(BuiltinToolProviderController): + def _get_protocol_and_main_domain(self, url): + parsed_url = urlparse(url) + protocol = parsed_url.scheme + hostname = parsed_url.hostname + port = f":{parsed_url.port}" if parsed_url.port else "" + + # Check if the hostname is an IP address + is_ip = re.match(r"^\d{1,3}(\.\d{1,3}){3}$", hostname) is not None + + # Return the full hostname (with port if present) for IP addresses, otherwise return the main domain + main_domain = f"{hostname}{port}" if is_ip else ".".join(hostname.split(".")[-2:]) + port + return f"{protocol}://{main_domain}" + def _validate_credentials(self, credentials: dict[str, Any]) -> None: + base_url = credentials.get("base_url") + if not base_url: + base_url = "https://ask.vanna.ai/rpc" + else: + base_url = base_url.removesuffix("/") + credentials["base_url"] = base_url try: VannaTool().fork_tool_runtime( runtime={ @@ -17,7 +38,7 @@ class VannaProvider(BuiltinToolProviderController): tool_parameters={ "model": "chinook", "db_type": "SQLite", - "url": "https://vanna.ai/Chinook.sqlite", + "url": f'{self._get_protocol_and_main_domain(credentials["base_url"])}/Chinook.sqlite', "query": "What are the top 10 customers by sales?", }, ) diff --git a/api/core/tools/provider/builtin/vanna/vanna.yaml b/api/core/tools/provider/builtin/vanna/vanna.yaml index 7f953be172..cf3fdca562 100644 --- a/api/core/tools/provider/builtin/vanna/vanna.yaml +++ b/api/core/tools/provider/builtin/vanna/vanna.yaml @@ -26,3 +26,10 @@ credentials_for_provider: en_US: Get your API key from Vanna.AI zh_Hans: 从 Vanna.AI 获取你的 API key url: https://vanna.ai/account/profile + base_url: + type: text-input + required: false + label: + en_US: Vanna.AI Endpoint Base URL + placeholder: + en_US: https://ask.vanna.ai/rpc From bdadca1a65dd82ab35ce38946664b103d4c43d2b Mon Sep 17 00:00:00 2001 From: Infinitnet <6189915+infinitnet@users.noreply.github.com> Date: Wed, 6 Nov 2024 01:26:44 +0100 Subject: [PATCH 53/73] feat: add support for anthropic/claude-3-5-haiku through OpenRouter (#10331) --- .../openrouter/llm/claude-3-5-haiku.yaml | 39 +++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 api/core/model_runtime/model_providers/openrouter/llm/claude-3-5-haiku.yaml diff --git a/api/core/model_runtime/model_providers/openrouter/llm/claude-3-5-haiku.yaml b/api/core/model_runtime/model_providers/openrouter/llm/claude-3-5-haiku.yaml new file mode 100644 index 0000000000..773befbec5 --- /dev/null +++ b/api/core/model_runtime/model_providers/openrouter/llm/claude-3-5-haiku.yaml @@ -0,0 +1,39 @@ +model: anthropic/claude-3-5-haiku +label: + en_US: claude-3-5-haiku +model_type: llm +features: + - agent-thought + - vision + - tool-call + - stream-tool-call +model_properties: + mode: chat + context_size: 200000 +parameter_rules: + - name: temperature + use_template: temperature + - name: top_p + use_template: top_p + - name: top_k + label: + zh_Hans: 取样数量 + en_US: Top k + type: int + help: + zh_Hans: 仅从每个后续标记的前 K 个选项中采样。 + en_US: Only sample from the top K options for each subsequent token. + required: false + - name: max_tokens + use_template: max_tokens + required: true + default: 8192 + min: 1 + max: 8192 + - name: response_format + use_template: response_format +pricing: + input: "1" + output: "5" + unit: "0.000001" + currency: USD From ce1f9d935db9a6b668d69da9b4e144e58fc7fef8 Mon Sep 17 00:00:00 2001 From: Summer-Gu <37869445+gubinjie@users.noreply.github.com> Date: Wed, 6 Nov 2024 08:50:57 +0800 Subject: [PATCH 54/73] feat: The SSRF request timeout configuration item is added (#10292) --- api/.env.example | 5 +++++ api/configs/feature/__init__.py | 20 ++++++++++++++++++++ api/core/helper/ssrf_proxy.py | 12 ++++++++++++ 3 files changed, 37 insertions(+) diff --git a/api/.env.example b/api/.env.example index f7bcab6d6d..6fc58263c4 100644 --- a/api/.env.example +++ b/api/.env.example @@ -320,9 +320,14 @@ ETL_TYPE=dify UNSTRUCTURED_API_URL= UNSTRUCTURED_API_KEY= +#ssrf SSRF_PROXY_HTTP_URL= SSRF_PROXY_HTTPS_URL= SSRF_DEFAULT_MAX_RETRIES=3 +SSRF_DEFAULT_TIME_OUT= +SSRF_DEFAULT_CONNECT_TIME_OUT= +SSRF_DEFAULT_READ_TIME_OUT= +SSRF_DEFAULT_WRITE_TIME_OUT= BATCH_UPLOAD_LIMIT=10 KEYWORD_DATA_SOURCE_TYPE=database diff --git a/api/configs/feature/__init__.py b/api/configs/feature/__init__.py index 533a24dcbd..517b92fda4 100644 --- a/api/configs/feature/__init__.py +++ b/api/configs/feature/__init__.py @@ -286,6 +286,26 @@ class HttpConfig(BaseSettings): default=None, ) + SSRF_DEFAULT_TIME_OUT: PositiveFloat = Field( + description="The default timeout period used for network requests (SSRF)", + default=5, + ) + + SSRF_DEFAULT_CONNECT_TIME_OUT: PositiveFloat = Field( + description="The default connect timeout period used for network requests (SSRF)", + default=5, + ) + + SSRF_DEFAULT_READ_TIME_OUT: PositiveFloat = Field( + description="The default read timeout period used for network requests (SSRF)", + default=5, + ) + + SSRF_DEFAULT_WRITE_TIME_OUT: PositiveFloat = Field( + description="The default write timeout period used for network requests (SSRF)", + default=5, + ) + RESPECT_XFORWARD_HEADERS_ENABLED: bool = Field( description="Enable or disable the X-Forwarded-For Proxy Fix middleware from Werkzeug" " to respect X-* headers to redirect clients", diff --git a/api/core/helper/ssrf_proxy.py b/api/core/helper/ssrf_proxy.py index 6793e41978..df812ca83f 100644 --- a/api/core/helper/ssrf_proxy.py +++ b/api/core/helper/ssrf_proxy.py @@ -12,6 +12,10 @@ SSRF_PROXY_ALL_URL = os.getenv("SSRF_PROXY_ALL_URL", "") SSRF_PROXY_HTTP_URL = os.getenv("SSRF_PROXY_HTTP_URL", "") SSRF_PROXY_HTTPS_URL = os.getenv("SSRF_PROXY_HTTPS_URL", "") SSRF_DEFAULT_MAX_RETRIES = int(os.getenv("SSRF_DEFAULT_MAX_RETRIES", "3")) +SSRF_DEFAULT_TIME_OUT = float(os.getenv("SSRF_DEFAULT_TIME_OUT", "5")) +SSRF_DEFAULT_CONNECT_TIME_OUT = float(os.getenv("SSRF_DEFAULT_CONNECT_TIME_OUT", "5")) +SSRF_DEFAULT_READ_TIME_OUT = float(os.getenv("SSRF_DEFAULT_READ_TIME_OUT", "5")) +SSRF_DEFAULT_WRITE_TIME_OUT = float(os.getenv("SSRF_DEFAULT_WRITE_TIME_OUT", "5")) proxy_mounts = ( { @@ -32,6 +36,14 @@ def make_request(method, url, max_retries=SSRF_DEFAULT_MAX_RETRIES, **kwargs): if "follow_redirects" not in kwargs: kwargs["follow_redirects"] = allow_redirects + if "timeout" not in kwargs: + kwargs["timeout"] = httpx.Timeout( + SSRF_DEFAULT_TIME_OUT, + connect=SSRF_DEFAULT_CONNECT_TIME_OUT, + read=SSRF_DEFAULT_READ_TIME_OUT, + write=SSRF_DEFAULT_WRITE_TIME_OUT, + ) + retries = 0 while retries <= max_retries: try: From 2b7341af571664faa363e15ac91440a92f9770cc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=96=B9=E7=A8=8B?= Date: Wed, 6 Nov 2024 08:51:13 +0800 Subject: [PATCH 55/73] Gitee AI tools (#10314) --- .../builtin/gitee_ai/_assets/icon.svg | 3 + .../provider/builtin/gitee_ai/gitee_ai.py | 17 +++++ .../provider/builtin/gitee_ai/gitee_ai.yaml | 22 ++++++ .../builtin/gitee_ai/tools/text-to-image.py | 33 +++++++++ .../builtin/gitee_ai/tools/text-to-image.yaml | 72 +++++++++++++++++++ 5 files changed, 147 insertions(+) create mode 100644 api/core/tools/provider/builtin/gitee_ai/_assets/icon.svg create mode 100644 api/core/tools/provider/builtin/gitee_ai/gitee_ai.py create mode 100644 api/core/tools/provider/builtin/gitee_ai/gitee_ai.yaml create mode 100644 api/core/tools/provider/builtin/gitee_ai/tools/text-to-image.py create mode 100644 api/core/tools/provider/builtin/gitee_ai/tools/text-to-image.yaml diff --git a/api/core/tools/provider/builtin/gitee_ai/_assets/icon.svg b/api/core/tools/provider/builtin/gitee_ai/_assets/icon.svg new file mode 100644 index 0000000000..6dd75d1a6b --- /dev/null +++ b/api/core/tools/provider/builtin/gitee_ai/_assets/icon.svg @@ -0,0 +1,3 @@ + + + diff --git a/api/core/tools/provider/builtin/gitee_ai/gitee_ai.py b/api/core/tools/provider/builtin/gitee_ai/gitee_ai.py new file mode 100644 index 0000000000..151cafec14 --- /dev/null +++ b/api/core/tools/provider/builtin/gitee_ai/gitee_ai.py @@ -0,0 +1,17 @@ +import requests + +from core.tools.errors import ToolProviderCredentialValidationError +from core.tools.provider.builtin_tool_provider import BuiltinToolProviderController + + +class GiteeAIProvider(BuiltinToolProviderController): + def _validate_credentials(self, credentials: dict) -> None: + url = "https://ai.gitee.com/api/base/account/me" + headers = { + "accept": "application/json", + "authorization": f"Bearer {credentials.get('api_key')}", + } + + response = requests.get(url, headers=headers) + if response.status_code != 200: + raise ToolProviderCredentialValidationError("GiteeAI API key is invalid") diff --git a/api/core/tools/provider/builtin/gitee_ai/gitee_ai.yaml b/api/core/tools/provider/builtin/gitee_ai/gitee_ai.yaml new file mode 100644 index 0000000000..2e18f8a7fc --- /dev/null +++ b/api/core/tools/provider/builtin/gitee_ai/gitee_ai.yaml @@ -0,0 +1,22 @@ +identity: + author: Gitee AI + name: gitee_ai + label: + en_US: Gitee AI + zh_Hans: Gitee AI + description: + en_US: 快速体验大模型，领先探索 AI 开源世界 + zh_Hans: 快速体验大模型，领先探索 AI 开源世界 + icon: icon.svg + tags: + - image +credentials_for_provider: + api_key: + type: secret-input + required: true + label: + en_US: API Key + placeholder: + zh_Hans: 在此输入您的 API Key + en_US: Enter your API Key + url: https://ai.gitee.com/dashboard/settings/tokens diff --git a/api/core/tools/provider/builtin/gitee_ai/tools/text-to-image.py b/api/core/tools/provider/builtin/gitee_ai/tools/text-to-image.py new file mode 100644 index 0000000000..14291d1729 --- /dev/null +++ b/api/core/tools/provider/builtin/gitee_ai/tools/text-to-image.py @@ -0,0 +1,33 @@ +from typing import Any, Union + +import requests + +from core.tools.entities.tool_entities import ToolInvokeMessage +from core.tools.tool.builtin_tool import BuiltinTool + + +class GiteeAITool(BuiltinTool): + def _invoke( + self, user_id: str, tool_parameters: dict[str, Any] + ) -> Union[ToolInvokeMessage, list[ToolInvokeMessage]]: + headers = { + "content-type": "application/json", + "authorization": f"Bearer {self.runtime.credentials['api_key']}", + } + + payload = { + "inputs": tool_parameters.get("inputs"), + "width": tool_parameters.get("width", "720"), + "height": tool_parameters.get("height", "720"), + } + model = tool_parameters.get("model", "Kolors") + url = f"https://ai.gitee.com/api/serverless/{model}/text-to-image" + + response = requests.post(url, json=payload, headers=headers) + if response.status_code != 200: + return self.create_text_message(f"Got Error Response:{response.text}") + + # The returned image is base64 and needs to be mark as an image + result = [self.create_blob_message(blob=response.content, meta={"mime_type": "image/jpeg"})] + + return result diff --git a/api/core/tools/provider/builtin/gitee_ai/tools/text-to-image.yaml b/api/core/tools/provider/builtin/gitee_ai/tools/text-to-image.yaml new file mode 100644 index 0000000000..5e03f9abe9 --- /dev/null +++ b/api/core/tools/provider/builtin/gitee_ai/tools/text-to-image.yaml @@ -0,0 +1,72 @@ +identity: + name: text to image + author: gitee_ai + label: + en_US: text to image + icon: icon.svg +description: + human: + en_US: generate images using a variety of popular models + llm: This tool is used to generate image from text. +parameters: + - name: model + type: select + required: true + options: + - value: flux-1-schnell + label: + en_US: flux-1-schnell + - value: Kolors + label: + en_US: Kolors + - value: stable-diffusion-3-medium + label: + en_US: stable-diffusion-3-medium + - value: stable-diffusion-xl-base-1.0 + label: + en_US: stable-diffusion-xl-base-1.0 + - value: stable-diffusion-v1-4 + label: + en_US: stable-diffusion-v1-4 + default: Kolors + label: + en_US: Choose Image Model + zh_Hans: 选择生成图片的模型 + form: form + - name: inputs + type: string + required: true + label: + en_US: Input Text + zh_Hans: 输入文本 + human_description: + en_US: The text input used to generate the image. + zh_Hans: 用于生成图片的输入文本。 + llm_description: This text input will be used to generate image. + form: llm + - name: width + type: number + required: true + default: 720 + min: 1 + max: 1024 + label: + en_US: Image Width + zh_Hans: 图片宽度 + human_description: + en_US: The width of the generated image. + zh_Hans: 生成图片的宽度。 + form: form + - name: height + type: number + required: true + default: 720 + min: 1 + max: 1024 + label: + en_US: Image Height + zh_Hans: 图片高度 + human_description: + en_US: The height of the generated image. + zh_Hans: 生成图片的高度。 + form: form From fb656d480e22963f773f3c629c93a0c1ae4abc2f Mon Sep 17 00:00:00 2001 From: Chenhe Gu Date: Tue, 5 Nov 2024 16:57:49 -0800 Subject: [PATCH 56/73] Update README.md (#10332) --- README.md | 52 +++++++++++++++++++--------------------------------- 1 file changed, 19 insertions(+), 33 deletions(-) diff --git a/README.md b/README.md index cedd81bd8a..4779048001 100644 --- a/README.md +++ b/README.md @@ -45,21 +45,19 @@ README Tiếng Việt

-## Quick start -The quickest way to deploy Dify locally is to run our [docker-compose.yml](https://github.com/langgenius/dify/blob/main/docker/docker-compose.yaml). Follow the instructions to start in 5 minutes. +Dify is an open-source LLM app development platform. Its intuitive interface combines agentic AI workflow, RAG pipeline, agent capabilities, model management, observability features and more, letting you quickly go from prototype to production. + +## Quick start > Before installing Dify, make sure your machine meets the following minimum system requirements: > >- CPU >= 2 Core >- RAM >= 4 GiB ->- Docker and Docker Compose Installed +
-Run the following command in your terminal to clone the whole repo. -```bash -git clone https://github.com/langgenius/dify.git -``` -After cloning,run the following command one by one. +The easiest way to start the Dify server is through [docker compose](docker/docker-compose.yaml). Before running Dify with the following commands, make sure that [Docker](https://docs.docker.com/get-docker/) and [Docker Compose](https://docs.docker.com/compose/install/) are installed on your machine: + ```bash cd dify cd docker @@ -67,13 +65,14 @@ cp .env.example .env docker compose up -d ``` -After running, you can access the Dify dashboard in your browser at [http://localhost/install](http://localhost/install) and start the initialization process. You will be asked to setup an admin account. -For more info of quick setup, check [here](https://docs.dify.ai/getting-started/install-self-hosted/docker-compose) +After running, you can access the Dify dashboard in your browser at [http://localhost/install](http://localhost/install) and start the initialization process. -## Intro -Dify is an open-source LLM app development platform. Its intuitive interface combines AI workflow, RAG pipeline, agent capabilities, model management, observability features and more, letting you quickly go from prototype to production. Here's a list of the core features: -

+#### Seeking help +Please refer to our [FAQ](https://docs.dify.ai/getting-started/install-self-hosted/faqs) if you encounter problems setting up Dify. Reach out to [the community and us](#community--contact) if you are still having issues. +> If you'd like to contribute to Dify or do additional development, refer to our [guide to deploying from source code](https://docs.dify.ai/getting-started/install-self-hosted/local-source-code) + +## Key features **1. Workflow**: Build and test powerful AI workflows on a visual canvas, leveraging all the following features and beyond. @@ -124,20 +123,8 @@ Star Dify on GitHub and be instantly notified of new releases. ![star-us](https://github.com/langgenius/dify/assets/13230914/b823edc1-6388-4e25-ad45-2f6b187adbb4) -## Next steps -Go to [quick-start](https://github.com/langgenius/dify?tab=readme-ov-file#quick-start) to setup your Dify or setup by source code. - -#### If you...... -If you forget your admin account, you can refer to this [guide](https://docs.dify.ai/getting-started/install-self-hosted/faqs#id-4.-how-to-reset-the-password-of-the-admin-account) to reset the password. - -> Use docker compose up without "-d" to enable logs printing out in your terminal. This might be useful if you have encountered unknow problems when using Dify. - -If you encountered system error and would like to acquire help in Github issues, make sure you always paste logs of the error in the request to accerate the conversation. Go to [Community & contact](https://github.com/langgenius/dify?tab=readme-ov-file#community--contact) for more information. - -> Please read the [Dify Documentation](https://docs.dify.ai/) for detailed how-to-use guidance. Most of the potential problems are explained in the doc. - -> If you'd like to contribute to Dify or make additional development, refer to our [guide to deploying from source code](https://docs.dify.ai/getting-started/install-self-hosted/local-source-code) +## Advanced Setup If you need to customize the configuration, please refer to the comments in our [.env.example](docker/.env.example) file and update the corresponding values in your `.env` file. Additionally, you might need to make adjustments to the `docker-compose.yaml` file itself, such as changing image versions, port mappings, or volume mounts, based on your specific deployment environment and requirements. After making any changes, please re-run `docker-compose up -d`. You can find the full list of available environment variables [here](https://docs.dify.ai/getting-started/install-self-hosted/environments). @@ -165,19 +152,18 @@ At the same time, please consider supporting Dify by sharing it on social media > We are looking for contributors to help with translating Dify to languages other than Mandarin or English. If you are interested in helping, please see the [i18n README](https://github.com/langgenius/dify/blob/main/web/i18n/README.md) for more information, and leave us a comment in the `global-users` channel of our [Discord Community Server](https://discord.gg/8Tpq4AcN9c). -**Contributors** - - - - - ## Community & contact * [Github Discussion](https://github.com/langgenius/dify/discussions). Best for: sharing feedback and asking questions. * [GitHub Issues](https://github.com/langgenius/dify/issues). Best for: bugs you encounter using Dify.AI, and feature proposals. See our [Contribution Guide](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md). * [Discord](https://discord.gg/FngNHpbcY7). Best for: sharing your applications and hanging out with the community. * [X(Twitter)](https://twitter.com/dify_ai). Best for: sharing your applications and hanging out with the community. -* Make sure a log, if possible, is attached to an error reported to maximize solution efficiency. + +**Contributors** + + + + ## Star history From ac0fed640235a33e857799260b9fd8191406401f Mon Sep 17 00:00:00 2001 From: Nam Vu Date: Wed, 6 Nov 2024 08:05:05 +0700 Subject: [PATCH 57/73] feat: support png, gif, webp (#7947) Co-authored-by: xuanson9699 <84961581+xuanson9699@users.noreply.github.com> --- .../base/app-icon-picker/Uploader.tsx | 43 ++++++++++++---- .../components/base/app-icon-picker/index.tsx | 13 ++++- .../components/base/app-icon-picker/utils.ts | 49 +++++++++++++++++++ 3 files changed, 93 insertions(+), 12 deletions(-) diff --git a/web/app/components/base/app-icon-picker/Uploader.tsx b/web/app/components/base/app-icon-picker/Uploader.tsx index 4ddaa40447..ba0ef6b2b2 100644 --- a/web/app/components/base/app-icon-picker/Uploader.tsx +++ b/web/app/components/base/app-icon-picker/Uploader.tsx @@ -8,18 +8,22 @@ import classNames from 'classnames' import { ImagePlus } from '../icons/src/vender/line/images' import { useDraggableUploader } from './hooks' +import { checkIsAnimatedImage } from './utils' import { ALLOW_FILE_EXTENSIONS } from '@/types/app' type UploaderProps = { className?: string onImageCropped?: (tempUrl: string, croppedAreaPixels: Area, fileName: string) => void + onUpload?: (file?: File) => void } const Uploader: FC = ({ className, onImageCropped, + onUpload, }) => { const [inputImage, setInputImage] = useState<{ file: File; url: string }>() + const [isAnimatedImage, setIsAnimatedImage] = useState(false) useEffect(() => { return () => { if (inputImage) @@ -34,12 +38,19 @@ const Uploader: FC = ({ if (!inputImage) return onImageCropped?.(inputImage.url, croppedAreaPixels, inputImage.file.name) + onUpload?.(undefined) } const handleLocalFileInput = (e: ChangeEvent) => { const file = e.target.files?.[0] - if (file) + if (file) { setInputImage({ file, url: URL.createObjectURL(file) }) + checkIsAnimatedImage(file).then((isAnimatedImage) => { + setIsAnimatedImage(!!isAnimatedImage) + if (isAnimatedImage) + onUpload?.(file) + }) + } } const { @@ -52,6 +63,26 @@ const Uploader: FC = ({ const inputRef = createRef() + const handleShowImage = () => { + if (isAnimatedImage) { + return ( + + ) + } + + return ( + + ) + } + return (
= ({
Supports PNG, JPG, JPEG, WEBP and GIF
- : + : handleShowImage() }
diff --git a/web/app/components/base/app-icon-picker/index.tsx b/web/app/components/base/app-icon-picker/index.tsx index ba375abdd9..8a10d28653 100644 --- a/web/app/components/base/app-icon-picker/index.tsx +++ b/web/app/components/base/app-icon-picker/index.tsx @@ -74,6 +74,11 @@ const AppIconPicker: FC = ({ setImageCropInfo({ tempUrl, croppedAreaPixels, fileName }) } + const [uploadImageInfo, setUploadImageInfo] = useState<{ file?: File }>() + const handleUpload = async (file?: File) => { + setUploadImageInfo({ file }) + } + const handleSelect = async () => { if (activeTab === 'emoji') { if (emoji) { @@ -85,9 +90,13 @@ const AppIconPicker: FC = ({ } } else { - if (!imageCropInfo) + if (!imageCropInfo && !uploadImageInfo) return setUploading(true) + if (imageCropInfo.file) { + handleLocalFileUpload(imageCropInfo.file) + return + } const blob = await getCroppedImg(imageCropInfo.tempUrl, imageCropInfo.croppedAreaPixels, imageCropInfo.fileName) const file = new File([blob], imageCropInfo.fileName, { type: blob.type }) handleLocalFileUpload(file) @@ -121,7 +130,7 @@ const AppIconPicker: FC = ({ - +
diff --git a/web/app/components/base/app-icon-picker/utils.ts b/web/app/components/base/app-icon-picker/utils.ts index 14c9ae3f28..99154d56da 100644 --- a/web/app/components/base/app-icon-picker/utils.ts +++ b/web/app/components/base/app-icon-picker/utils.ts @@ -115,3 +115,52 @@ export default async function getCroppedImg( }, mimeType) }) } + +export function checkIsAnimatedImage(file) { + return new Promise((resolve, reject) => { + const fileReader = new FileReader() + + fileReader.onload = function (e) { + const arr = new Uint8Array(e.target.result) + + // Check file extension + const fileName = file.name.toLowerCase() + if (fileName.endsWith('.gif')) { + // If file is a GIF, assume it's animated + resolve(true) + } + // Check for WebP signature (RIFF and WEBP) + else if (isWebP(arr)) { + resolve(checkWebPAnimation(arr)) // Check if it's animated + } + else { + resolve(false) // Not a GIF or WebP + } + } + + fileReader.onerror = function (err) { + reject(err) // Reject the promise on error + } + + // Read the file as an array buffer + fileReader.readAsArrayBuffer(file) + }) +} + +// Function to check for WebP signature +function isWebP(arr) { + return ( + arr[0] === 0x52 && arr[1] === 0x49 && arr[2] === 0x46 && arr[3] === 0x46 + && arr[8] === 0x57 && arr[9] === 0x45 && arr[10] === 0x42 && arr[11] === 0x50 + ) // "WEBP" +} + +// Function to check if the WebP is animated (contains ANIM chunk) +function checkWebPAnimation(arr) { + // Search for the ANIM chunk in WebP to determine if it's animated + for (let i = 12; i < arr.length - 4; i++) { + if (arr[i] === 0x41 && arr[i + 1] === 0x4E && arr[i + 2] === 0x49 && arr[i + 3] === 0x4D) + return true // Found animation + } + return false // No animation chunk found +} From 1dae1a71fce151adbd9bbab8e2a27ef9b857882e Mon Sep 17 00:00:00 2001 From: -LAN- Date: Wed, 6 Nov 2024 12:29:58 +0800 Subject: [PATCH 58/73] fix(api): remove fixed source attribute from FileApi (#10353) --- api/controllers/service_api/app/file.py | 1 - 1 file changed, 1 deletion(-) diff --git a/api/controllers/service_api/app/file.py b/api/controllers/service_api/app/file.py index b0126058de..b0fd8e65ef 100644 --- a/api/controllers/service_api/app/file.py +++ b/api/controllers/service_api/app/file.py @@ -41,7 +41,6 @@ class FileApi(Resource): content=file.read(), mimetype=file.mimetype, user=end_user, - source="datasets", ) except services.errors.file.FileTooLargeError as file_too_large_error: raise FileTooLargeError(file_too_large_error.description) From 82a775eca344178e45a56fbb375d99ba0e246d45 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Wed, 6 Nov 2024 12:43:55 +0800 Subject: [PATCH 59/73] chore(ci): separate vector store tests into new workflow (#10354) --- .github/workflows/api-tests.yml | 19 --------- .github/workflows/vdb-tests.yml | 75 +++++++++++++++++++++++++++++++++ 2 files changed, 75 insertions(+), 19 deletions(-) create mode 100644 .github/workflows/vdb-tests.yml diff --git a/.github/workflows/api-tests.yml b/.github/workflows/api-tests.yml index c87d5a4dd4..dad206181a 100644 --- a/.github/workflows/api-tests.yml +++ b/.github/workflows/api-tests.yml @@ -77,22 +77,3 @@ jobs: - name: Run Workflow run: poetry run -C api bash dev/pytest/pytest_workflow.sh - - - name: Set up Vector Stores (Weaviate, Qdrant, PGVector, Milvus, PgVecto-RS, Chroma, MyScale, ElasticSearch, Couchbase) - uses: hoverkraft-tech/compose-action@v2.0.0 - with: - compose-file: | - docker/docker-compose.yaml - services: | - weaviate - qdrant - couchbase-server - etcd - minio - milvus-standalone - pgvecto-rs - pgvector - chroma - elasticsearch - - name: Test Vector Stores - run: poetry run -C api bash dev/pytest/pytest_vdb.sh diff --git a/.github/workflows/vdb-tests.yml b/.github/workflows/vdb-tests.yml new file mode 100644 index 0000000000..d859fff647 --- /dev/null +++ b/.github/workflows/vdb-tests.yml @@ -0,0 +1,75 @@ +name: Run VDB Tests + +on: + pull_request: + branches: + - main + paths: + - api/core/rag/datasource/** + - docker/** + +concurrency: + group: api-tests-${{ github.head_ref || github.run_id }} + cancel-in-progress: true + +jobs: + test: + name: VDB Tests + runs-on: ubuntu-latest + strategy: + matrix: + python-version: + - "3.10" + - "3.11" + - "3.12" + + steps: + - name: Checkout code + uses: actions/checkout@v4 + + - name: Set up Python ${{ matrix.python-version }} + uses: actions/setup-python@v5 + with: + python-version: ${{ matrix.python-version }} + cache-dependency-path: | + api/pyproject.toml + api/poetry.lock + + - name: Install Poetry + uses: abatilo/actions-poetry@v3 + + - name: Check Poetry lockfile + run: | + poetry check -C api --lock + poetry show -C api + + - name: Install dependencies + run: poetry install -C api --with dev + + - name: Set up dotenvs + run: | + cp docker/.env.example docker/.env + cp docker/middleware.env.example docker/middleware.env + + - name: Expose Service Ports + run: sh .github/workflows/expose_service_ports.sh + + - name: Set up Vector Stores (Weaviate, Qdrant, PGVector, Milvus, PgVecto-RS, Chroma, MyScale, ElasticSearch, Couchbase) + uses: hoverkraft-tech/compose-action@v2.0.0 + with: + compose-file: | + docker/docker-compose.yaml + services: | + weaviate + qdrant + couchbase-server + etcd + minio + milvus-standalone + pgvecto-rs + pgvector + chroma + elasticsearch + + - name: Test Vector Stores + run: poetry run -C api bash dev/pytest/pytest_vdb.sh From 42a9374e71236d54d6cd01fde8052813d333c920 Mon Sep 17 00:00:00 2001 From: comfuture Date: Wed, 6 Nov 2024 13:44:44 +0900 Subject: [PATCH 60/73] =?UTF-8?q?chore:=20update=20translation=20for=20'ac?= =?UTF-8?q?count'=20from=20'=EA=B3=84=EC=A2=8C'=20to=20'=EA=B3=84=EC=A0=95?= =?UTF-8?q?'=20(#10350)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- web/i18n/ko-KR/common.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/web/i18n/ko-KR/common.ts b/web/i18n/ko-KR/common.ts index d2035e7c71..43e7402bd4 100644 --- a/web/i18n/ko-KR/common.ts +++ b/web/i18n/ko-KR/common.ts @@ -169,7 +169,7 @@ const translation = { deleteConfirmTip: '확인하려면 등록된 이메일에서 다음 내용을 로 보내주세요 ', myAccount: '내 계정', studio: '디파이 스튜디오', - account: '계좌', + account: '계정', }, members: { team: '팀', From d45d90e8aee5743b384c0ae861fd29ed1a4b5caf Mon Sep 17 00:00:00 2001 From: Bowen Liang Date: Wed, 6 Nov 2024 12:45:22 +0800 Subject: [PATCH 61/73] chore: lazy import sagemaker (#10342) --- .../model_runtime/model_providers/sagemaker/llm/llm.py | 6 +++--- api/poetry.lock | 7 +------ api/pyproject.toml | 2 +- api/services/external_knowledge_service.py | 2 -- 4 files changed, 5 insertions(+), 12 deletions(-) diff --git a/api/core/model_runtime/model_providers/sagemaker/llm/llm.py b/api/core/model_runtime/model_providers/sagemaker/llm/llm.py index dd53914a69..5ff00f008e 100644 --- a/api/core/model_runtime/model_providers/sagemaker/llm/llm.py +++ b/api/core/model_runtime/model_providers/sagemaker/llm/llm.py @@ -4,10 +4,7 @@ import re from collections.abc import Generator, Iterator from typing import Any, Optional, Union, cast -# from openai.types.chat import ChatCompletion, ChatCompletionChunk import boto3 -from sagemaker import Predictor, serializers -from sagemaker.session import Session from core.model_runtime.entities.llm_entities import LLMMode, LLMResult, LLMResultChunk, LLMResultChunkDelta from core.model_runtime.entities.message_entities import ( @@ -212,6 +209,9 @@ class SageMakerLargeLanguageModel(LargeLanguageModel): :param user: unique user id :return: full response or stream response chunk generator result """ + from sagemaker import Predictor, serializers + from sagemaker.session import Session + if not self.sagemaker_session: access_key = credentials.get("aws_access_key_id") secret_key = credentials.get("aws_secret_access_key") diff --git a/api/poetry.lock b/api/poetry.lock index 2a93fa38f9..6cd5e24dec 100644 --- a/api/poetry.lock +++ b/api/poetry.lock @@ -8735,11 +8735,6 @@ files = [ {file = "scikit_learn-1.5.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f60021ec1574e56632be2a36b946f8143bf4e5e6af4a06d85281adc22938e0dd"}, {file = "scikit_learn-1.5.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:394397841449853c2290a32050382edaec3da89e35b3e03d6cc966aebc6a8ae6"}, {file = "scikit_learn-1.5.2-cp312-cp312-win_amd64.whl", hash = "sha256:57cc1786cfd6bd118220a92ede80270132aa353647684efa385a74244a41e3b1"}, - {file = "scikit_learn-1.5.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e9a702e2de732bbb20d3bad29ebd77fc05a6b427dc49964300340e4c9328b3f5"}, - {file = "scikit_learn-1.5.2-cp313-cp313-macosx_12_0_arm64.whl", hash = "sha256:b0768ad641981f5d3a198430a1d31c3e044ed2e8a6f22166b4d546a5116d7908"}, - {file = "scikit_learn-1.5.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:178ddd0a5cb0044464fc1bfc4cca5b1833bfc7bb022d70b05db8530da4bb3dd3"}, - {file = "scikit_learn-1.5.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f7284ade780084d94505632241bf78c44ab3b6f1e8ccab3d2af58e0e950f9c12"}, - {file = "scikit_learn-1.5.2-cp313-cp313-win_amd64.whl", hash = "sha256:b7b0f9a0b1040830d38c39b91b3a44e1b643f4b36e36567b80b7c6bd2202a27f"}, {file = "scikit_learn-1.5.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:757c7d514ddb00ae249832fe87100d9c73c6ea91423802872d9e74970a0e40b9"}, {file = "scikit_learn-1.5.2-cp39-cp39-macosx_12_0_arm64.whl", hash = "sha256:52788f48b5d8bca5c0736c175fa6bdaab2ef00a8f536cda698db61bd89c551c1"}, {file = "scikit_learn-1.5.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:643964678f4b5fbdc95cbf8aec638acc7aa70f5f79ee2cdad1eec3df4ba6ead8"}, @@ -11000,4 +10995,4 @@ cffi = ["cffi (>=1.11)"] [metadata] lock-version = "2.0" python-versions = ">=3.10,<3.13" -content-hash = "e4794898403da4ad7b51f248a6c07632a949114c1b569406d3aa6a94c62510a5" +content-hash = "bb8385625eb61de086b7a7156745066b4fb171d9ca67afd1d092fa7e872f3abd" diff --git a/api/pyproject.toml b/api/pyproject.toml index a79e1641d0..4438cf61db 100644 --- a/api/pyproject.toml +++ b/api/pyproject.toml @@ -168,7 +168,7 @@ readabilipy = "0.2.0" redis = { version = "~5.0.3", extras = ["hiredis"] } replicate = "~0.22.0" resend = "~0.7.0" -sagemaker = "2.231.0" +sagemaker = "~2.231.0" scikit-learn = "~1.5.1" sentry-sdk = { version = "~1.44.1", extras = ["flask"] } sqlalchemy = "~2.0.29" diff --git a/api/services/external_knowledge_service.py b/api/services/external_knowledge_service.py index b49738c61c..98e5d9face 100644 --- a/api/services/external_knowledge_service.py +++ b/api/services/external_knowledge_service.py @@ -7,8 +7,6 @@ import httpx import validators from constants import HIDDEN_VALUE - -# from tasks.external_document_indexing_task import external_document_indexing_task from core.helper import ssrf_proxy from extensions.ext_database import db from models.dataset import ( From eafe5a9d8f30bec12a404b2f50667cd133080ff1 Mon Sep 17 00:00:00 2001 From: Bowen Liang Date: Wed, 6 Nov 2024 13:55:29 +0800 Subject: [PATCH 62/73] chore(ci): bring back poetry cache to speed up CI jobs (#10347) --- .github/workflows/api-tests.yml | 14 +++++++------- .github/workflows/db-migration-test.yml | 2 +- .github/workflows/style.yml | 8 ++++---- .github/workflows/vdb-tests.yml | 16 ++++++++-------- api/README.md | 4 ++-- 5 files changed, 22 insertions(+), 22 deletions(-) diff --git a/.github/workflows/api-tests.yml b/.github/workflows/api-tests.yml index dad206181a..eb09abe77c 100644 --- a/.github/workflows/api-tests.yml +++ b/.github/workflows/api-tests.yml @@ -7,6 +7,7 @@ on: paths: - api/** - docker/** + - .github/workflows/api-tests.yml concurrency: group: api-tests-${{ github.head_ref || github.run_id }} @@ -27,16 +28,15 @@ jobs: - name: Checkout code uses: actions/checkout@v4 + - name: Install Poetry + uses: abatilo/actions-poetry@v3 + - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v5 with: python-version: ${{ matrix.python-version }} - cache-dependency-path: | - api/pyproject.toml - api/poetry.lock - - - name: Install Poetry - uses: abatilo/actions-poetry@v3 + cache: poetry + cache-dependency-path: api/poetry.lock - name: Check Poetry lockfile run: | @@ -67,7 +67,7 @@ jobs: run: sh .github/workflows/expose_service_ports.sh - name: Set up Sandbox - uses: hoverkraft-tech/compose-action@v2.0.0 + uses: hoverkraft-tech/compose-action@v2.0.2 with: compose-file: | docker/docker-compose.middleware.yaml diff --git a/.github/workflows/db-migration-test.yml b/.github/workflows/db-migration-test.yml index a33cdacd80..b8246aacb3 100644 --- a/.github/workflows/db-migration-test.yml +++ b/.github/workflows/db-migration-test.yml @@ -43,7 +43,7 @@ jobs: cp middleware.env.example middleware.env - name: Set up Middlewares - uses: hoverkraft-tech/compose-action@v2.0.0 + uses: hoverkraft-tech/compose-action@v2.0.2 with: compose-file: | docker/docker-compose.middleware.yaml diff --git a/.github/workflows/style.yml b/.github/workflows/style.yml index 7eb60aa51e..01f9757b3c 100644 --- a/.github/workflows/style.yml +++ b/.github/workflows/style.yml @@ -24,16 +24,16 @@ jobs: with: files: api/** + - name: Install Poetry + if: steps.changed-files.outputs.any_changed == 'true' + uses: abatilo/actions-poetry@v3 + - name: Set up Python uses: actions/setup-python@v5 if: steps.changed-files.outputs.any_changed == 'true' with: python-version: '3.10' - - name: Install Poetry - if: steps.changed-files.outputs.any_changed == 'true' - uses: abatilo/actions-poetry@v3 - - name: Python dependencies if: steps.changed-files.outputs.any_changed == 'true' run: poetry install -C api --only lint diff --git a/.github/workflows/vdb-tests.yml b/.github/workflows/vdb-tests.yml index d859fff647..8ea38fde76 100644 --- a/.github/workflows/vdb-tests.yml +++ b/.github/workflows/vdb-tests.yml @@ -7,9 +7,10 @@ on: paths: - api/core/rag/datasource/** - docker/** + - .github/workflows/vdb-tests.yml concurrency: - group: api-tests-${{ github.head_ref || github.run_id }} + group: vdb-tests-${{ github.head_ref || github.run_id }} cancel-in-progress: true jobs: @@ -27,16 +28,15 @@ jobs: - name: Checkout code uses: actions/checkout@v4 + - name: Install Poetry + uses: abatilo/actions-poetry@v3 + - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v5 with: python-version: ${{ matrix.python-version }} - cache-dependency-path: | - api/pyproject.toml - api/poetry.lock - - - name: Install Poetry - uses: abatilo/actions-poetry@v3 + cache: poetry + cache-dependency-path: api/poetry.lock - name: Check Poetry lockfile run: | @@ -55,7 +55,7 @@ jobs: run: sh .github/workflows/expose_service_ports.sh - name: Set up Vector Stores (Weaviate, Qdrant, PGVector, Milvus, PgVecto-RS, Chroma, MyScale, ElasticSearch, Couchbase) - uses: hoverkraft-tech/compose-action@v2.0.0 + uses: hoverkraft-tech/compose-action@v2.0.2 with: compose-file: | docker/docker-compose.yaml diff --git a/api/README.md b/api/README.md index 92cd88a6d4..de2baee4c5 100644 --- a/api/README.md +++ b/api/README.md @@ -76,13 +76,13 @@ 1. Install dependencies for both the backend and the test environment ```bash - poetry install --with dev + poetry install -C api --with dev ``` 2. Run the tests locally with mocked system environment variables in `tool.pytest_env` section in `pyproject.toml` ```bash - cd ../ poetry run -C api bash dev/pytest/pytest_all_tests.sh ``` + From 5a9448245bb9fe75e7f95546f0c9201c9ff33135 Mon Sep 17 00:00:00 2001 From: Infinitnet <6189915+infinitnet@users.noreply.github.com> Date: Wed, 6 Nov 2024 10:41:48 +0100 Subject: [PATCH 63/73] fix: remove unsupported vision in OpenRouter Haiku 3.5 (#10364) --- .../model_providers/openrouter/llm/claude-3-5-haiku.yaml | 1 - 1 file changed, 1 deletion(-) diff --git a/api/core/model_runtime/model_providers/openrouter/llm/claude-3-5-haiku.yaml b/api/core/model_runtime/model_providers/openrouter/llm/claude-3-5-haiku.yaml index 773befbec5..de45093a72 100644 --- a/api/core/model_runtime/model_providers/openrouter/llm/claude-3-5-haiku.yaml +++ b/api/core/model_runtime/model_providers/openrouter/llm/claude-3-5-haiku.yaml @@ -4,7 +4,6 @@ label: model_type: llm features: - agent-thought - - vision - tool-call - stream-tool-call model_properties: From 1e8457441df2bafd394e89248bc6fc4ab2352268 Mon Sep 17 00:00:00 2001 From: Matsuda Date: Wed, 6 Nov 2024 18:42:18 +0900 Subject: [PATCH 64/73] fix(model_runtime): remove vision from features for Claude 3.5 Haiku (#10360) --- .../model_providers/anthropic/llm/claude-3-5-haiku-20241022.yaml | 1 - .../bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml | 1 - .../bedrock/llm/us.anthropic.claude-3-5-haiku-v1.yaml | 1 - 3 files changed, 3 deletions(-) diff --git a/api/core/model_runtime/model_providers/anthropic/llm/claude-3-5-haiku-20241022.yaml b/api/core/model_runtime/model_providers/anthropic/llm/claude-3-5-haiku-20241022.yaml index cae4c67e4a..892146f6a5 100644 --- a/api/core/model_runtime/model_providers/anthropic/llm/claude-3-5-haiku-20241022.yaml +++ b/api/core/model_runtime/model_providers/anthropic/llm/claude-3-5-haiku-20241022.yaml @@ -4,7 +4,6 @@ label: model_type: llm features: - agent-thought - - vision - tool-call - stream-tool-call model_properties: diff --git a/api/core/model_runtime/model_providers/bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml b/api/core/model_runtime/model_providers/bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml index 35fc8d0d11..9d693dcd48 100644 --- a/api/core/model_runtime/model_providers/bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml +++ b/api/core/model_runtime/model_providers/bedrock/llm/anthropic.claude-3-5-haiku-v1.yaml @@ -4,7 +4,6 @@ label: model_type: llm features: - agent-thought - - vision - tool-call - stream-tool-call model_properties: diff --git a/api/core/model_runtime/model_providers/bedrock/llm/us.anthropic.claude-3-5-haiku-v1.yaml b/api/core/model_runtime/model_providers/bedrock/llm/us.anthropic.claude-3-5-haiku-v1.yaml index a9b66b1925..9781965555 100644 --- a/api/core/model_runtime/model_providers/bedrock/llm/us.anthropic.claude-3-5-haiku-v1.yaml +++ b/api/core/model_runtime/model_providers/bedrock/llm/us.anthropic.claude-3-5-haiku-v1.yaml @@ -4,7 +4,6 @@ label: model_type: llm features: - agent-thought - - vision - tool-call - stream-tool-call model_properties: From 3cb2fb82504e0b738301e57b9b60c282912ee557 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=9D=9E=E6=B3=95=E6=93=8D=E4=BD=9C?= Date: Wed, 6 Nov 2024 19:06:55 +0800 Subject: [PATCH 65/73] =?UTF-8?q?fix:=20remove=20duplicated=20category=20?= =?UTF-8?q?=E2=80=9Crecommended=E2=80=9D=20(#10375)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- web/app/components/explore/category.tsx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/web/app/components/explore/category.tsx b/web/app/components/explore/category.tsx index cbf6cd26fe..8f67f0fd49 100644 --- a/web/app/components/explore/category.tsx +++ b/web/app/components/explore/category.tsx @@ -28,7 +28,7 @@ const Category: FC = ({ allCategoriesEn, }) => { const { t } = useTranslation() - const isAllCategories = !list.includes(value as AppCategory) + const isAllCategories = !list.includes(value as AppCategory) || value === allCategoriesEn const itemClassName = (isSelected: boolean) => cn( 'flex items-center px-3 py-[7px] h-[32px] rounded-lg border-[0.5px] border-transparent text-gray-700 font-medium leading-[18px] cursor-pointer hover:bg-gray-200', @@ -44,7 +44,7 @@ const Category: FC = ({ {t('explore.apps.allCategories')}
- {list.map(name => ( + {list.filter(name => name !== allCategoriesEn).map(name => (
Date: Thu, 7 Nov 2024 11:40:57 +0900 Subject: [PATCH 66/73] fix typo: mMaximum -> Maximum (#10389) --- api/configs/feature/__init__.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/configs/feature/__init__.py b/api/configs/feature/__init__.py index 517b92fda4..3ac2c28c1f 100644 --- a/api/configs/feature/__init__.py +++ b/api/configs/feature/__init__.py @@ -109,7 +109,7 @@ class CodeExecutionSandboxConfig(BaseSettings): ) CODE_MAX_PRECISION: PositiveInt = Field( - description="mMaximum number of decimal places for floating-point numbers in code execution", + description="Maximum number of decimal places for floating-point numbers in code execution", default=20, ) From 12a9e2972a097ccec5608cc8fe1a188af549de90 Mon Sep 17 00:00:00 2001 From: powerfool Date: Thu, 7 Nov 2024 13:22:09 +0800 Subject: [PATCH 67/73] Adjusted docker manifests and environment variables for OceanBase vector database (#10395) --- .gitignore | 1 + api/.env.example | 4 ++-- docker/.env.example | 6 +++--- docker/docker-compose.yaml | 12 +++++++++--- docker/volumes/oceanbase/init.d/vec_memory.sql | 1 + 5 files changed, 16 insertions(+), 8 deletions(-) create mode 100644 docker/volumes/oceanbase/init.d/vec_memory.sql diff --git a/.gitignore b/.gitignore index 60b5781733..1423bfee56 100644 --- a/.gitignore +++ b/.gitignore @@ -175,6 +175,7 @@ docker/volumes/pgvector/data/* docker/volumes/pgvecto_rs/data/* docker/volumes/couchbase/* docker/volumes/oceanbase/* +!docker/volumes/oceanbase/init.d docker/nginx/conf.d/default.conf docker/nginx/ssl/* diff --git a/api/.env.example b/api/.env.example index 6fc58263c4..a92490608f 100644 --- a/api/.env.example +++ b/api/.env.example @@ -121,7 +121,7 @@ WEB_API_CORS_ALLOW_ORIGINS=http://127.0.0.1:3000,* CONSOLE_CORS_ALLOW_ORIGINS=http://127.0.0.1:3000,* -# Vector database configuration, support: weaviate, qdrant, milvus, myscale, relyt, pgvecto_rs, pgvector, pgvector, chroma, opensearch, tidb_vector, couchbase, vikingdb, upstash, lindorm +# Vector database configuration, support: weaviate, qdrant, milvus, myscale, relyt, pgvecto_rs, pgvector, pgvector, chroma, opensearch, tidb_vector, couchbase, vikingdb, upstash, lindorm, oceanbase VECTOR_STORE=weaviate # Weaviate configuration @@ -273,7 +273,7 @@ LINDORM_PASSWORD=admin OCEANBASE_VECTOR_HOST=127.0.0.1 OCEANBASE_VECTOR_PORT=2881 OCEANBASE_VECTOR_USER=root@test -OCEANBASE_VECTOR_PASSWORD= +OCEANBASE_VECTOR_PASSWORD=difyai123456 OCEANBASE_VECTOR_DATABASE=test OCEANBASE_MEMORY_LIMIT=6G diff --git a/docker/.env.example b/docker/.env.example index aa5e102bd0..9a178dc44c 100644 --- a/docker/.env.example +++ b/docker/.env.example @@ -374,7 +374,7 @@ SUPABASE_URL=your-server-url # ------------------------------ # The type of vector store to use. -# Supported values are `weaviate`, `qdrant`, `milvus`, `myscale`, `relyt`, `pgvector`, `pgvecto-rs`, `chroma`, `opensearch`, `tidb_vector`, `oracle`, `tencent`, `elasticsearch`, `analyticdb`, `couchbase`, `vikingdb`. +# Supported values are `weaviate`, `qdrant`, `milvus`, `myscale`, `relyt`, `pgvector`, `pgvecto-rs`, `chroma`, `opensearch`, `tidb_vector`, `oracle`, `tencent`, `elasticsearch`, `analyticdb`, `couchbase`, `vikingdb`, `oceanbase`. VECTOR_STORE=weaviate # The Weaviate endpoint URL. Only available when VECTOR_STORE is `weaviate`. @@ -537,10 +537,10 @@ LINDORM_USERNAME=username LINDORM_PASSWORD=password # OceanBase Vector configuration, only available when VECTOR_STORE is `oceanbase` -OCEANBASE_VECTOR_HOST=oceanbase-vector +OCEANBASE_VECTOR_HOST=oceanbase OCEANBASE_VECTOR_PORT=2881 OCEANBASE_VECTOR_USER=root@test -OCEANBASE_VECTOR_PASSWORD= +OCEANBASE_VECTOR_PASSWORD=difyai123456 OCEANBASE_VECTOR_DATABASE=test OCEANBASE_MEMORY_LIMIT=6G diff --git a/docker/docker-compose.yaml b/docker/docker-compose.yaml index cdcc62e127..a7cb8576fd 100644 --- a/docker/docker-compose.yaml +++ b/docker/docker-compose.yaml @@ -266,8 +266,9 @@ x-shared-env: &shared-api-worker-env OCEANBASE_VECTOR_HOST: ${OCEANBASE_VECTOR_HOST:-http://oceanbase-vector} OCEANBASE_VECTOR_PORT: ${OCEANBASE_VECTOR_PORT:-2881} OCEANBASE_VECTOR_USER: ${OCEANBASE_VECTOR_USER:-root@test} - OCEANBASE_VECTOR_PASSWORD: ${OCEANBASE_VECTOR_PASSWORD:-""} + OCEANBASE_VECTOR_PASSWORD: ${OCEANBASE_VECTOR_PASSWORD:-difyai123456} OCEANBASE_VECTOR_DATABASE: ${OCEANBASE_VECTOR_DATABASE:-test} + OCEANBASE_CLUSTER_NAME: ${OCEANBASE_CLUSTER_NAME:-difyai} OCEANBASE_MEMORY_LIMIT: ${OCEANBASE_MEMORY_LIMIT:-6G} services: @@ -597,16 +598,21 @@ services: IS_PERSISTENT: ${CHROMA_IS_PERSISTENT:-TRUE} # OceanBase vector database - oceanbase-vector: + oceanbase: image: quay.io/oceanbase/oceanbase-ce:4.3.3.0-100000142024101215 profiles: - - oceanbase-vector + - oceanbase restart: always volumes: - ./volumes/oceanbase/data:/root/ob - ./volumes/oceanbase/conf:/root/.obd/cluster + - ./volumes/oceanbase/init.d:/root/boot/init.d environment: OB_MEMORY_LIMIT: ${OCEANBASE_MEMORY_LIMIT:-6G} + OB_SYS_PASSWORD: ${OCEANBASE_VECTOR_PASSWORD:-difyai123456} + OB_TENANT_PASSWORD: ${OCEANBASE_VECTOR_PASSWORD:-difyai123456} + OB_CLUSTER_NAME: ${OCEANBASE_CLUSTER_NAME:-difyai} + OB_SERVER_IP: '127.0.0.1' # Oracle vector database oracle: diff --git a/docker/volumes/oceanbase/init.d/vec_memory.sql b/docker/volumes/oceanbase/init.d/vec_memory.sql new file mode 100644 index 0000000000..f4c283fdf4 --- /dev/null +++ b/docker/volumes/oceanbase/init.d/vec_memory.sql @@ -0,0 +1 @@ +ALTER SYSTEM SET ob_vector_memory_limit_percentage = 30; \ No newline at end of file From 1ccca7cc68dab0f2ae0fed48561eda46778ca094 Mon Sep 17 00:00:00 2001 From: luckylhb90 Date: Thu, 7 Nov 2024 08:55:19 +0300 Subject: [PATCH 68/73] fixed: web api remote urls error (#10383) Co-authored-by: hobo.l --- api/controllers/web/remote_files.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/controllers/web/remote_files.py b/api/controllers/web/remote_files.py index 0b8a586d0c..cf36ae302d 100644 --- a/api/controllers/web/remote_files.py +++ b/api/controllers/web/remote_files.py @@ -12,7 +12,7 @@ from services.file_service import FileService class RemoteFileInfoApi(WebApiResource): @marshal_with(remote_file_info_fields) - def get(self, url): + def get(self, app_model, end_user, url): decoded_url = urllib.parse.unquote(url) try: response = ssrf_proxy.head(decoded_url) From d3e9930235ac800a397b2554cb378c6792f882e3 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Thu, 7 Nov 2024 14:02:30 +0800 Subject: [PATCH 69/73] refactor(question_classifier): improve error handling with custom exceptions (#10365) --- api/core/workflow/nodes/question_classifier/exc.py | 6 ++++++ .../nodes/question_classifier/question_classifier_node.py | 6 ++++-- api/libs/json_in_md_parser.py | 2 +- 3 files changed, 11 insertions(+), 3 deletions(-) create mode 100644 api/core/workflow/nodes/question_classifier/exc.py diff --git a/api/core/workflow/nodes/question_classifier/exc.py b/api/core/workflow/nodes/question_classifier/exc.py new file mode 100644 index 0000000000..2c6354e2a7 --- /dev/null +++ b/api/core/workflow/nodes/question_classifier/exc.py @@ -0,0 +1,6 @@ +class QuestionClassifierNodeError(ValueError): + """Base class for QuestionClassifierNode errors.""" + + +class InvalidModelTypeError(QuestionClassifierNodeError): + """Raised when the model is not a Large Language Model.""" diff --git a/api/core/workflow/nodes/question_classifier/question_classifier_node.py b/api/core/workflow/nodes/question_classifier/question_classifier_node.py index ee160e7c69..0489020e5e 100644 --- a/api/core/workflow/nodes/question_classifier/question_classifier_node.py +++ b/api/core/workflow/nodes/question_classifier/question_classifier_node.py @@ -4,6 +4,7 @@ from collections.abc import Mapping, Sequence from typing import TYPE_CHECKING, Any, Optional, cast from core.app.entities.app_invoke_entities import ModelConfigWithCredentialsEntity +from core.llm_generator.output_parser.errors import OutputParserError from core.memory.token_buffer_memory import TokenBufferMemory from core.model_manager import ModelInstance from core.model_runtime.entities import LLMUsage, ModelPropertyKey, PromptMessageRole @@ -24,6 +25,7 @@ from libs.json_in_md_parser import parse_and_check_json_markdown from models.workflow import WorkflowNodeExecutionStatus from .entities import QuestionClassifierNodeData +from .exc import InvalidModelTypeError from .template_prompts import ( QUESTION_CLASSIFIER_ASSISTANT_PROMPT_1, QUESTION_CLASSIFIER_ASSISTANT_PROMPT_2, @@ -124,7 +126,7 @@ class QuestionClassifierNode(LLMNode): category_name = classes_map[category_id_result] category_id = category_id_result - except Exception: + except OutputParserError: logging.error(f"Failed to parse result text: {result_text}") try: process_data = { @@ -309,4 +311,4 @@ class QuestionClassifierNode(LLMNode): ) else: - raise ValueError(f"Model mode {model_mode} not support.") + raise InvalidModelTypeError(f"Model mode {model_mode} not support.") diff --git a/api/libs/json_in_md_parser.py b/api/libs/json_in_md_parser.py index 9131408817..41c5d20c4b 100644 --- a/api/libs/json_in_md_parser.py +++ b/api/libs/json_in_md_parser.py @@ -9,6 +9,7 @@ def parse_json_markdown(json_string: str) -> dict: starts = ["```json", "```", "``", "`", "{"] ends = ["```", "``", "`", "}"] end_index = -1 + start_index = 0 for s in starts: start_index = json_string.find(s) if start_index != -1: @@ -24,7 +25,6 @@ def parse_json_markdown(json_string: str) -> dict: break if start_index != -1 and end_index != -1 and start_index < end_index: extracted_content = json_string[start_index:end_index].strip() - print("content:", extracted_content, start_index, end_index) parsed = json.loads(extracted_content) else: raise Exception("Could not find JSON block in the output.") From 35d3da96971a21ccf8367db610af8916b73ce352 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Thu, 7 Nov 2024 14:02:38 +0800 Subject: [PATCH 70/73] refactor(tool-node): introduce specific exceptions for tool node errors (#10357) --- api/core/workflow/nodes/tool/exc.py | 16 +++++++++++++++ api/core/workflow/nodes/tool/tool_node.py | 24 ++++++++++++++--------- 2 files changed, 31 insertions(+), 9 deletions(-) create mode 100644 api/core/workflow/nodes/tool/exc.py diff --git a/api/core/workflow/nodes/tool/exc.py b/api/core/workflow/nodes/tool/exc.py new file mode 100644 index 0000000000..7212e8bfc0 --- /dev/null +++ b/api/core/workflow/nodes/tool/exc.py @@ -0,0 +1,16 @@ +class ToolNodeError(ValueError): + """Base exception for tool node errors.""" + + pass + + +class ToolParameterError(ToolNodeError): + """Exception raised for errors in tool parameters.""" + + pass + + +class ToolFileError(ToolNodeError): + """Exception raised for errors related to tool files.""" + + pass diff --git a/api/core/workflow/nodes/tool/tool_node.py b/api/core/workflow/nodes/tool/tool_node.py index 0994ccaedb..42e870c46c 100644 --- a/api/core/workflow/nodes/tool/tool_node.py +++ b/api/core/workflow/nodes/tool/tool_node.py @@ -6,7 +6,7 @@ from sqlalchemy import select from sqlalchemy.orm import Session from core.callback_handler.workflow_tool_callback_handler import DifyWorkflowCallbackHandler -from core.file.models import File, FileTransferMethod, FileType +from core.file import File, FileTransferMethod, FileType from core.tools.entities.tool_entities import ToolInvokeMessage, ToolParameter from core.tools.tool_engine import ToolEngine from core.tools.tool_manager import ToolManager @@ -15,12 +15,18 @@ from core.workflow.entities.node_entities import NodeRunMetadataKey, NodeRunResu from core.workflow.entities.variable_pool import VariablePool from core.workflow.nodes.base import BaseNode from core.workflow.nodes.enums import NodeType -from core.workflow.nodes.tool.entities import ToolNodeData from core.workflow.utils.variable_template_parser import VariableTemplateParser from extensions.ext_database import db from models import ToolFile from models.workflow import WorkflowNodeExecutionStatus +from .entities import ToolNodeData +from .exc import ( + ToolFileError, + ToolNodeError, + ToolParameterError, +) + class ToolNode(BaseNode[ToolNodeData]): """ @@ -42,7 +48,7 @@ class ToolNode(BaseNode[ToolNodeData]): tool_runtime = ToolManager.get_workflow_tool_runtime( self.tenant_id, self.app_id, self.node_id, self.node_data, self.invoke_from ) - except Exception as e: + except ToolNodeError as e: return NodeRunResult( status=WorkflowNodeExecutionStatus.FAILED, inputs={}, @@ -75,7 +81,7 @@ class ToolNode(BaseNode[ToolNodeData]): workflow_call_depth=self.workflow_call_depth, thread_pool_id=self.thread_pool_id, ) - except Exception as e: + except ToolNodeError as e: return NodeRunResult( status=WorkflowNodeExecutionStatus.FAILED, inputs=parameters_for_log, @@ -133,13 +139,13 @@ class ToolNode(BaseNode[ToolNodeData]): if tool_input.type == "variable": variable = variable_pool.get(tool_input.value) if variable is None: - raise ValueError(f"variable {tool_input.value} not exists") + raise ToolParameterError(f"Variable {tool_input.value} does not exist") parameter_value = variable.value elif tool_input.type in {"mixed", "constant"}: segment_group = variable_pool.convert_template(str(tool_input.value)) parameter_value = segment_group.log if for_log else segment_group.text else: - raise ValueError(f"unknown tool input type '{tool_input.type}'") + raise ToolParameterError(f"Unknown tool input type '{tool_input.type}'") result[parameter_name] = parameter_value return result @@ -181,7 +187,7 @@ class ToolNode(BaseNode[ToolNodeData]): stmt = select(ToolFile).where(ToolFile.id == tool_file_id) tool_file = session.scalar(stmt) if tool_file is None: - raise ValueError(f"tool file {tool_file_id} not exists") + raise ToolFileError(f"Tool file {tool_file_id} does not exist") result.append( File( @@ -203,7 +209,7 @@ class ToolNode(BaseNode[ToolNodeData]): stmt = select(ToolFile).where(ToolFile.id == tool_file_id) tool_file = session.scalar(stmt) if tool_file is None: - raise ValueError(f"tool file {tool_file_id} not exists") + raise ToolFileError(f"Tool file {tool_file_id} does not exist") result.append( File( tenant_id=self.tenant_id, @@ -224,7 +230,7 @@ class ToolNode(BaseNode[ToolNodeData]): stmt = select(ToolFile).where(ToolFile.id == tool_file_id) tool_file = session.scalar(stmt) if tool_file is None: - raise ValueError(f"tool file {tool_file_id} not exists") + raise ToolFileError(f"Tool file {tool_file_id} does not exist") if "." in url: extension = "." + url.split("/")[-1].split(".")[1] else: From 25785d8c3f6857a215481b09a38f5abecc99abe9 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Thu, 7 Nov 2024 14:02:46 +0800 Subject: [PATCH 71/73] refactor(knowledge-retrieval): improve error handling with custom exceptions (#10385) --- .../workflow/nodes/knowledge_retrieval/exc.py | 18 +++++++++++++ .../knowledge_retrieval_node.py | 27 ++++++++++++------- 2 files changed, 35 insertions(+), 10 deletions(-) create mode 100644 api/core/workflow/nodes/knowledge_retrieval/exc.py diff --git a/api/core/workflow/nodes/knowledge_retrieval/exc.py b/api/core/workflow/nodes/knowledge_retrieval/exc.py new file mode 100644 index 0000000000..0c3b6e86fa --- /dev/null +++ b/api/core/workflow/nodes/knowledge_retrieval/exc.py @@ -0,0 +1,18 @@ +class KnowledgeRetrievalNodeError(ValueError): + """Base class for KnowledgeRetrievalNode errors.""" + + +class ModelNotExistError(KnowledgeRetrievalNodeError): + """Raised when the model does not exist.""" + + +class ModelCredentialsNotInitializedError(KnowledgeRetrievalNodeError): + """Raised when the model credentials are not initialized.""" + + +class ModelNotSupportedError(KnowledgeRetrievalNodeError): + """Raised when the model is not supported.""" + + +class ModelQuotaExceededError(KnowledgeRetrievalNodeError): + """Raised when the model provider quota is exceeded.""" diff --git a/api/core/workflow/nodes/knowledge_retrieval/knowledge_retrieval_node.py b/api/core/workflow/nodes/knowledge_retrieval/knowledge_retrieval_node.py index 2a5795a3ed..8c5a9b5ecb 100644 --- a/api/core/workflow/nodes/knowledge_retrieval/knowledge_retrieval_node.py +++ b/api/core/workflow/nodes/knowledge_retrieval/knowledge_retrieval_node.py @@ -8,7 +8,6 @@ from core.app.app_config.entities import DatasetRetrieveConfigEntity from core.app.entities.app_invoke_entities import ModelConfigWithCredentialsEntity from core.entities.agent_entities import PlanningStrategy from core.entities.model_entities import ModelStatus -from core.errors.error import ModelCurrentlyNotSupportError, ProviderTokenNotInitError, QuotaExceededError from core.model_manager import ModelInstance, ModelManager from core.model_runtime.entities.model_entities import ModelFeature, ModelType from core.model_runtime.model_providers.__base.large_language_model import LargeLanguageModel @@ -18,11 +17,19 @@ from core.variables import StringSegment from core.workflow.entities.node_entities import NodeRunResult from core.workflow.nodes.base import BaseNode from core.workflow.nodes.enums import NodeType -from core.workflow.nodes.knowledge_retrieval.entities import KnowledgeRetrievalNodeData from extensions.ext_database import db from models.dataset import Dataset, Document, DocumentSegment from models.workflow import WorkflowNodeExecutionStatus +from .entities import KnowledgeRetrievalNodeData +from .exc import ( + KnowledgeRetrievalNodeError, + ModelCredentialsNotInitializedError, + ModelNotExistError, + ModelNotSupportedError, + ModelQuotaExceededError, +) + logger = logging.getLogger(__name__) default_retrieval_model = { @@ -61,8 +68,8 @@ class KnowledgeRetrievalNode(BaseNode[KnowledgeRetrievalNodeData]): status=WorkflowNodeExecutionStatus.SUCCEEDED, inputs=variables, process_data=None, outputs=outputs ) - except Exception as e: - logger.exception("Error when running knowledge retrieval node") + except KnowledgeRetrievalNodeError as e: + logger.warning("Error when running knowledge retrieval node") return NodeRunResult(status=WorkflowNodeExecutionStatus.FAILED, inputs=variables, error=str(e)) def _fetch_dataset_retriever(self, node_data: KnowledgeRetrievalNodeData, query: str) -> list[dict[str, Any]]: @@ -295,14 +302,14 @@ class KnowledgeRetrievalNode(BaseNode[KnowledgeRetrievalNodeData]): ) if provider_model is None: - raise ValueError(f"Model {model_name} not exist.") + raise ModelNotExistError(f"Model {model_name} not exist.") if provider_model.status == ModelStatus.NO_CONFIGURE: - raise ProviderTokenNotInitError(f"Model {model_name} credentials is not initialized.") + raise ModelCredentialsNotInitializedError(f"Model {model_name} credentials is not initialized.") elif provider_model.status == ModelStatus.NO_PERMISSION: - raise ModelCurrentlyNotSupportError(f"Dify Hosted OpenAI {model_name} currently not support.") + raise ModelNotSupportedError(f"Dify Hosted OpenAI {model_name} currently not support.") elif provider_model.status == ModelStatus.QUOTA_EXCEEDED: - raise QuotaExceededError(f"Model provider {provider_name} quota exceeded.") + raise ModelQuotaExceededError(f"Model provider {provider_name} quota exceeded.") # model config completion_params = node_data.single_retrieval_config.model.completion_params @@ -314,12 +321,12 @@ class KnowledgeRetrievalNode(BaseNode[KnowledgeRetrievalNodeData]): # get model mode model_mode = node_data.single_retrieval_config.model.mode if not model_mode: - raise ValueError("LLM mode is required.") + raise ModelNotExistError("LLM mode is required.") model_schema = model_type_instance.get_model_schema(model_name, model_credentials) if not model_schema: - raise ValueError(f"Model {model_name} not exist.") + raise ModelNotExistError(f"Model {model_name} not exist.") return model_instance, ModelConfigWithCredentialsEntity( provider=provider_name, From f8c958a409d5d3d27248ecc78d2a8d161896f9a4 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Thu, 7 Nov 2024 14:02:55 +0800 Subject: [PATCH 72/73] refactor(iteration): introduce specific exceptions for iteration errors (#10366) --- api/core/workflow/nodes/iteration/exc.py | 22 ++++++++++++++ .../nodes/iteration/iteration_node.py | 29 ++++++++++++------- 2 files changed, 41 insertions(+), 10 deletions(-) create mode 100644 api/core/workflow/nodes/iteration/exc.py diff --git a/api/core/workflow/nodes/iteration/exc.py b/api/core/workflow/nodes/iteration/exc.py new file mode 100644 index 0000000000..d9947e09bc --- /dev/null +++ b/api/core/workflow/nodes/iteration/exc.py @@ -0,0 +1,22 @@ +class IterationNodeError(ValueError): + """Base class for iteration node errors.""" + + +class IteratorVariableNotFoundError(IterationNodeError): + """Raised when the iterator variable is not found.""" + + +class InvalidIteratorValueError(IterationNodeError): + """Raised when the iterator value is invalid.""" + + +class StartNodeIdNotFoundError(IterationNodeError): + """Raised when the start node ID is not found.""" + + +class IterationGraphNotFoundError(IterationNodeError): + """Raised when the iteration graph is not found.""" + + +class IterationIndexNotFoundError(IterationNodeError): + """Raised when the iteration index is not found.""" diff --git a/api/core/workflow/nodes/iteration/iteration_node.py b/api/core/workflow/nodes/iteration/iteration_node.py index d121b0530a..e1d2b88360 100644 --- a/api/core/workflow/nodes/iteration/iteration_node.py +++ b/api/core/workflow/nodes/iteration/iteration_node.py @@ -38,6 +38,15 @@ from core.workflow.nodes.event import NodeEvent, RunCompletedEvent from core.workflow.nodes.iteration.entities import ErrorHandleMode, IterationNodeData from models.workflow import WorkflowNodeExecutionStatus +from .exc import ( + InvalidIteratorValueError, + IterationGraphNotFoundError, + IterationIndexNotFoundError, + IterationNodeError, + IteratorVariableNotFoundError, + StartNodeIdNotFoundError, +) + if TYPE_CHECKING: from core.workflow.graph_engine.graph_engine import GraphEngine logger = logging.getLogger(__name__) @@ -69,7 +78,7 @@ class IterationNode(BaseNode[IterationNodeData]): iterator_list_segment = self.graph_runtime_state.variable_pool.get(self.node_data.iterator_selector) if not iterator_list_segment: - raise ValueError(f"Iterator variable {self.node_data.iterator_selector} not found") + raise IteratorVariableNotFoundError(f"Iterator variable {self.node_data.iterator_selector} not found") if len(iterator_list_segment.value) == 0: yield RunCompletedEvent( @@ -83,14 +92,14 @@ class IterationNode(BaseNode[IterationNodeData]): iterator_list_value = iterator_list_segment.to_object() if not isinstance(iterator_list_value, list): - raise ValueError(f"Invalid iterator value: {iterator_list_value}, please provide a list.") + raise InvalidIteratorValueError(f"Invalid iterator value: {iterator_list_value}, please provide a list.") inputs = {"iterator_selector": iterator_list_value} graph_config = self.graph_config if not self.node_data.start_node_id: - raise ValueError(f"field start_node_id in iteration {self.node_id} not found") + raise StartNodeIdNotFoundError(f"field start_node_id in iteration {self.node_id} not found") root_node_id = self.node_data.start_node_id @@ -98,7 +107,7 @@ class IterationNode(BaseNode[IterationNodeData]): iteration_graph = Graph.init(graph_config=graph_config, root_node_id=root_node_id) if not iteration_graph: - raise ValueError("iteration graph not found") + raise IterationGraphNotFoundError("iteration graph not found") variable_pool = self.graph_runtime_state.variable_pool @@ -222,9 +231,9 @@ class IterationNode(BaseNode[IterationNodeData]): status=WorkflowNodeExecutionStatus.SUCCEEDED, outputs={"output": jsonable_encoder(outputs)} ) ) - except Exception as e: + except IterationNodeError as e: # iteration run failed - logger.exception("Iteration run failed") + logger.warning("Iteration run failed") yield IterationRunFailedEvent( iteration_id=self.id, iteration_node_id=self.node_id, @@ -272,7 +281,7 @@ class IterationNode(BaseNode[IterationNodeData]): iteration_graph = Graph.init(graph_config=graph_config, root_node_id=node_data.start_node_id) if not iteration_graph: - raise ValueError("iteration graph not found") + raise IterationGraphNotFoundError("iteration graph not found") for sub_node_id, sub_node_config in iteration_graph.node_id_config_mapping.items(): if sub_node_config.get("data", {}).get("iteration_id") != node_id: @@ -357,7 +366,7 @@ class IterationNode(BaseNode[IterationNodeData]): next_index = int(current_index) + 1 if current_index is None: - raise ValueError(f"iteration {self.node_id} current index not found") + raise IterationIndexNotFoundError(f"iteration {self.node_id} current index not found") for event in rst: if isinstance(event, (BaseNodeEvent | BaseParallelBranchEvent)) and not event.in_iteration_id: event.in_iteration_id = self.node_id @@ -484,8 +493,8 @@ class IterationNode(BaseNode[IterationNodeData]): pre_iteration_output=jsonable_encoder(current_iteration_output) if current_iteration_output else None, ) - except Exception as e: - logger.exception(f"Iteration run failed:{str(e)}") + except IterationNodeError as e: + logger.warning(f"Iteration run failed:{str(e)}") yield IterationRunFailedEvent( iteration_id=self.id, iteration_node_id=self.node_id, From 823ae03a0884e1fc0c9fbcc17540f97bfce63d20 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Thu, 7 Nov 2024 14:35:58 +0800 Subject: [PATCH 73/73] fix(remote-files): fallback to get when remote server not support head method (#10370) --- api/controllers/console/error.py | 24 ++++++++++ .../console/{files/__init__.py => files.py} | 2 +- api/controllers/console/files/errors.py | 25 ----------- api/controllers/console/remote_files.py | 44 ++++++++++++------- api/controllers/web/remote_files.py | 43 ++++++++++-------- 5 files changed, 77 insertions(+), 61 deletions(-) rename api/controllers/console/{files/__init__.py => files.py} (99%) delete mode 100644 api/controllers/console/files/errors.py diff --git a/api/controllers/console/error.py b/api/controllers/console/error.py index ed6a99a017..e0630ca66c 100644 --- a/api/controllers/console/error.py +++ b/api/controllers/console/error.py @@ -62,3 +62,27 @@ class EmailSendIpLimitError(BaseHTTPException): error_code = "email_send_ip_limit" description = "Too many emails have been sent from this IP address recently. Please try again later." code = 429 + + +class FileTooLargeError(BaseHTTPException): + error_code = "file_too_large" + description = "File size exceeded. {message}" + code = 413 + + +class UnsupportedFileTypeError(BaseHTTPException): + error_code = "unsupported_file_type" + description = "File type not allowed." + code = 415 + + +class TooManyFilesError(BaseHTTPException): + error_code = "too_many_files" + description = "Only one file is allowed." + code = 400 + + +class NoFileUploadedError(BaseHTTPException): + error_code = "no_file_uploaded" + description = "Please upload your file." + code = 400 diff --git a/api/controllers/console/files/__init__.py b/api/controllers/console/files.py similarity index 99% rename from api/controllers/console/files/__init__.py rename to api/controllers/console/files.py index 6c7bd8acfd..946d3db37f 100644 --- a/api/controllers/console/files/__init__.py +++ b/api/controllers/console/files.py @@ -15,7 +15,7 @@ from fields.file_fields import file_fields, upload_config_fields from libs.login import login_required from services.file_service import FileService -from .errors import ( +from .error import ( FileTooLargeError, NoFileUploadedError, TooManyFilesError, diff --git a/api/controllers/console/files/errors.py b/api/controllers/console/files/errors.py deleted file mode 100644 index 1654ef2cf4..0000000000 --- a/api/controllers/console/files/errors.py +++ /dev/null @@ -1,25 +0,0 @@ -from libs.exception import BaseHTTPException - - -class FileTooLargeError(BaseHTTPException): - error_code = "file_too_large" - description = "File size exceeded. {message}" - code = 413 - - -class UnsupportedFileTypeError(BaseHTTPException): - error_code = "unsupported_file_type" - description = "File type not allowed." - code = 415 - - -class TooManyFilesError(BaseHTTPException): - error_code = "too_many_files" - description = "Only one file is allowed." - code = 400 - - -class NoFileUploadedError(BaseHTTPException): - error_code = "no_file_uploaded" - description = "Please upload your file." - code = 400 diff --git a/api/controllers/console/remote_files.py b/api/controllers/console/remote_files.py index 42d6e25416..9b899bef64 100644 --- a/api/controllers/console/remote_files.py +++ b/api/controllers/console/remote_files.py @@ -1,9 +1,11 @@ import urllib.parse from typing import cast +import httpx from flask_login import current_user from flask_restful import Resource, marshal_with, reqparse +import services from controllers.common import helpers from core.file import helpers as file_helpers from core.helper import ssrf_proxy @@ -11,19 +13,25 @@ from fields.file_fields import file_fields_with_signed_url, remote_file_info_fie from models.account import Account from services.file_service import FileService +from .error import ( + FileTooLargeError, + UnsupportedFileTypeError, +) + class RemoteFileInfoApi(Resource): @marshal_with(remote_file_info_fields) def get(self, url): decoded_url = urllib.parse.unquote(url) - try: - response = ssrf_proxy.head(decoded_url) - return { - "file_type": response.headers.get("Content-Type", "application/octet-stream"), - "file_length": int(response.headers.get("Content-Length", 0)), - } - except Exception as e: - return {"error": str(e)}, 400 + resp = ssrf_proxy.head(decoded_url) + if resp.status_code != httpx.codes.OK: + # failed back to get method + resp = ssrf_proxy.get(decoded_url, timeout=3) + resp.raise_for_status() + return { + "file_type": resp.headers.get("Content-Type", "application/octet-stream"), + "file_length": int(resp.headers.get("Content-Length", 0)), + } class RemoteFileUploadApi(Resource): @@ -35,17 +43,17 @@ class RemoteFileUploadApi(Resource): url = args["url"] - response = ssrf_proxy.head(url) - response.raise_for_status() + resp = ssrf_proxy.head(url=url) + if resp.status_code != httpx.codes.OK: + resp = ssrf_proxy.get(url=url, timeout=3) + resp.raise_for_status() - file_info = helpers.guess_file_info_from_response(response) + file_info = helpers.guess_file_info_from_response(resp) if not FileService.is_file_size_within_limit(extension=file_info.extension, file_size=file_info.size): - return {"error": "File size exceeded"}, 400 + raise FileTooLargeError - response = ssrf_proxy.get(url) - response.raise_for_status() - content = response.content + content = resp.content if resp.request.method == "GET" else ssrf_proxy.get(url).content try: user = cast(Account, current_user) @@ -56,8 +64,10 @@ class RemoteFileUploadApi(Resource): user=user, source_url=url, ) - except Exception as e: - return {"error": str(e)}, 400 + except services.errors.file.FileTooLargeError as file_too_large_error: + raise FileTooLargeError(file_too_large_error.description) + except services.errors.file.UnsupportedFileTypeError: + raise UnsupportedFileTypeError() return { "id": upload_file.id, diff --git a/api/controllers/web/remote_files.py b/api/controllers/web/remote_files.py index cf36ae302d..d6b8eb2855 100644 --- a/api/controllers/web/remote_files.py +++ b/api/controllers/web/remote_files.py @@ -1,7 +1,9 @@ import urllib.parse +import httpx from flask_restful import marshal_with, reqparse +import services from controllers.common import helpers from controllers.web.wraps import WebApiResource from core.file import helpers as file_helpers @@ -9,19 +11,22 @@ from core.helper import ssrf_proxy from fields.file_fields import file_fields_with_signed_url, remote_file_info_fields from services.file_service import FileService +from .error import FileTooLargeError, UnsupportedFileTypeError + class RemoteFileInfoApi(WebApiResource): @marshal_with(remote_file_info_fields) def get(self, app_model, end_user, url): decoded_url = urllib.parse.unquote(url) - try: - response = ssrf_proxy.head(decoded_url) - return { - "file_type": response.headers.get("Content-Type", "application/octet-stream"), - "file_length": int(response.headers.get("Content-Length", -1)), - } - except Exception as e: - return {"error": str(e)}, 400 + resp = ssrf_proxy.head(decoded_url) + if resp.status_code != httpx.codes.OK: + # failed back to get method + resp = ssrf_proxy.get(decoded_url, timeout=3) + resp.raise_for_status() + return { + "file_type": resp.headers.get("Content-Type", "application/octet-stream"), + "file_length": int(resp.headers.get("Content-Length", -1)), + } class RemoteFileUploadApi(WebApiResource): @@ -33,28 +38,30 @@ class RemoteFileUploadApi(WebApiResource): url = args["url"] - response = ssrf_proxy.head(url) - response.raise_for_status() + resp = ssrf_proxy.head(url=url) + if resp.status_code != httpx.codes.OK: + resp = ssrf_proxy.get(url=url, timeout=3) + resp.raise_for_status() - file_info = helpers.guess_file_info_from_response(response) + file_info = helpers.guess_file_info_from_response(resp) if not FileService.is_file_size_within_limit(extension=file_info.extension, file_size=file_info.size): - return {"error": "File size exceeded"}, 400 + raise FileTooLargeError - response = ssrf_proxy.get(url) - response.raise_for_status() - content = response.content + content = resp.content if resp.request.method == "GET" else ssrf_proxy.get(url).content try: upload_file = FileService.upload_file( filename=file_info.filename, content=content, mimetype=file_info.mimetype, - user=end_user, # Use end_user instead of current_user + user=end_user, source_url=url, ) - except Exception as e: - return {"error": str(e)}, 400 + except services.errors.file.FileTooLargeError as file_too_large_error: + raise FileTooLargeError(file_too_large_error.description) + except services.errors.file.UnsupportedFileTypeError: + raise UnsupportedFileTypeError return { "id": upload_file.id,