comment

Change-Id: If1499dadbbc1dfbe54bc6218209b4e0cc8a44b5c

Author: kasarolzzw

cozeloop/_client.py

@@ -282,9 +282,9 @@ def execute_prompt(
         timeout: Optional[int] = None
     ) -> Union[ExecuteResult, StreamReader[ExecuteResult]]:
         """
-        执行Prompt请求
+        Execute Prompt request
         
-        :param timeout: 请求超时时间（秒），可选，默认为600秒（10分钟）
+        :param timeout: Request timeout (seconds), optional, default is 600 seconds (10 minutes)
         """
         if self._closed:
             raise ClientClosedError()
@@ -310,9 +310,9 @@ async def aexecute_prompt(
         timeout: Optional[int] = None
     ) -> Union[ExecuteResult, StreamReader[ExecuteResult]]:
         """
-        异步执行Prompt请求
+        Asynchronously execute Prompt request
         
-        :param timeout: 请求超时时间（秒），可选，默认为600秒（10分钟）
+        :param timeout: Request timeout (seconds), optional, default is 600 seconds (10 minutes)
         """
         if self._closed:
             raise ClientClosedError()
@@ -436,9 +436,9 @@ def execute_prompt(
     timeout: Optional[int] = None
 ) -> Union[ExecuteResult, StreamReader[ExecuteResult]]:
     """
-    执行Prompt请求
+    Execute Prompt request
     
-    :param timeout: 请求超时时间（秒），可选，默认为600秒（10分钟）
+    :param timeout: Request timeout (seconds), optional, default is 600 seconds (10 minutes)
     """
     return get_default_client().execute_prompt(
         prompt_key,
@@ -462,9 +462,9 @@ async def aexecute_prompt(
     timeout: Optional[int] = None
 ) -> Union[ExecuteResult, StreamReader[ExecuteResult]]:
     """
-    异步执行Prompt请求
+    Asynchronously execute Prompt request
     
-    :param timeout: 请求超时时间（秒），可选，默认为600秒（10分钟）
+    :param timeout: Request timeout (seconds), optional, default is 600 seconds (10 minutes)
     """
     return await get_default_client().aexecute_prompt(
         prompt_key,

cozeloop/internal/version.py

@@ -1,4 +1,4 @@
 # Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
 # SPDX-License-Identifier: MIT
 
-VERSION = 'v0.1.10'
+VERSION = 'v0.1.11'

examples/prompt/prompt_hub/prompt_hub_with_label.py

@@ -13,7 +13,7 @@
 
 
 def convert_model_input(messages: List[Message]) -> ModelInput:
-    """将 cozeloop Message 转换为 ModelInput"""
+    """Convert cozeloop Message to ModelInput"""
     model_messages = []
     for message in messages:
         model_messages.append(ModelMessage(
@@ -27,27 +27,27 @@ def convert_model_input(messages: List[Message]) -> ModelInput:
 
 
 class LLMRunner:
-    """LLM 运行器，用于模拟 LLM 调用并设置相关的 span 标签"""
+    """LLM runner for simulating LLM calls and setting related span tags"""
 
     def __init__(self, client):
         self.client = client
 
     def llm_call(self, input_data):
         """
-        模拟 LLM 调用并设置相关的 span 标签
+        Simulate LLM call and set related span tags
         """
         span = self.client.start_span("llmCall", "model")
         try:
-            # 模拟 LLM 处理过程
+            # Simulate LLM processing
             # output = ChatOpenAI().invoke(input=input_data)
 
-            # 模拟响应
+            # Simulate response
             time.sleep(1)
             output = "I'm a robot. I don't have a specific name. You can give me one."
             input_token = 232
             output_token = 1211
 
-            # 设置 span 标签
+            # Set span tags
             span.set_input(convert_model_input(input_data))
             span.set_output(output)
             span.set_model_provider("openai")
@@ -137,4 +137,4 @@ def llm_call(self, input_data):
         # Warning! In general, this method is not needed to be call, as spans will be automatically reported in batches.
         # Note that flush will block and wait for the report to complete, and it may cause frequent reporting,
         # affecting performance.
-        client.flush()
+        client.flush()

tests/internal/prompt/test_prompt.py

@@ -636,18 +636,18 @@ def test_format_normal_messages_null_message(prompt_provider):
     assert result[1].role == Role.USER
     assert result[1].content == "World"
 def test_validate_variable_values_type_boolean_valid(prompt_provider):
-    """测试有效的 boolean 类型变量"""
+    """Test valid boolean type variable"""
     var_defs = [VariableDef(key="enabled", desc="Enable feature", type=VariableType.BOOLEAN)]
     variables = {"enabled": True}
 
-    # 应该不抛出异常
+    # Should not raise exception
     prompt_provider._validate_variable_values_type(var_defs, variables)
 
 
 def test_validate_variable_values_type_boolean_invalid(prompt_provider):
-    """测试无效的 boolean 类型变量"""
+    """Test invalid boolean type variable"""
     var_defs = [VariableDef(key="enabled", desc="Enable feature", type=VariableType.BOOLEAN)]
-    variables = {"enabled": "true"}  # 字符串而不是布尔值
+    variables = {"enabled": "true"}  # String instead of boolean
 
     with pytest.raises(ValueError) as excinfo:
         prompt_provider._validate_variable_values_type(var_defs, variables)
@@ -656,18 +656,18 @@ def test_validate_variable_values_type_boolean_invalid(prompt_provider):
 
 
 def test_validate_variable_values_type_integer_valid(prompt_provider):
-    """测试有效的 integer 类型变量"""
+    """Test valid integer type variable"""
     var_defs = [VariableDef(key="count", desc="Item count", type=VariableType.INTEGER)]
     variables = {"count": 42}
 
-    # 应该不抛出异常
+    # Should not raise exception
     prompt_provider._validate_variable_values_type(var_defs, variables)
 
 
 def test_validate_variable_values_type_integer_invalid(prompt_provider):
-    """测试无效的 integer 类型变量"""
+    """Test invalid integer type variable"""
     var_defs = [VariableDef(key="count", desc="Item count", type=VariableType.INTEGER)]
-    variables = {"count": "42"}  # 字符串而不是整数
+    variables = {"count": "42"}  # String instead of integer
 
     with pytest.raises(ValueError) as excinfo:
         prompt_provider._validate_variable_values_type(var_defs, variables)
@@ -676,18 +676,18 @@ def test_validate_variable_values_type_integer_invalid(prompt_provider):
 
 
 def test_validate_variable_values_type_float_valid(prompt_provider):
-    """测试有效的 float 类型变量"""
+    """Test valid float type variable"""
     var_defs = [VariableDef(key="temperature", desc="Temperature value", type=VariableType.FLOAT)]
     variables = {"temperature": 3.14}
 
-    # 应该不抛出异常
+    # Should not raise exception
     prompt_provider._validate_variable_values_type(var_defs, variables)
 
 
 def test_validate_variable_values_type_float_invalid(prompt_provider):
-    """测试无效的 float 类型变量"""
+    """Test invalid float type variable"""
     var_defs = [VariableDef(key="temperature", desc="Temperature value", type=VariableType.FLOAT)]
-    variables = {"temperature": "3.14"}  # 字符串而不是浮点数
+    variables = {"temperature": "3.14"}  # String instead of float
 
     with pytest.raises(ValueError) as excinfo:
         prompt_provider._validate_variable_values_type(var_defs, variables)
@@ -696,18 +696,18 @@ def test_validate_variable_values_type_float_invalid(prompt_provider):
 
 
 def test_validate_variable_values_type_array_string_valid(prompt_provider):
-    """测试有效的 array<string> 类型变量"""
+    """Test valid array<string> type variable"""
     var_defs = [VariableDef(key="tags", desc="Tag list", type=VariableType.ARRAY_STRING)]
     variables = {"tags": ["tag1", "tag2", "tag3"]}
 
-    # 应该不抛出异常
+    # Should not raise exception
     prompt_provider._validate_variable_values_type(var_defs, variables)
 
 
 def test_validate_variable_values_type_array_string_invalid_not_list(prompt_provider):
-    """测试无效的 array<string> 类型变量 - 不是列表"""
+    """Test invalid array<string> type variable - not a list"""
     var_defs = [VariableDef(key="tags", desc="Tag list", type=VariableType.ARRAY_STRING)]
-    variables = {"tags": "tag1,tag2,tag3"}  # 字符串而不是列表
+    variables = {"tags": "tag1,tag2,tag3"}  # String instead of list
 
     with pytest.raises(ValueError) as excinfo:
         prompt_provider._validate_variable_values_type(var_defs, variables)
@@ -716,9 +716,9 @@ def test_validate_variable_values_type_array_string_invalid_not_list(prompt_prov
 
 
 def test_validate_variable_values_type_array_string_invalid_wrong_element_type(prompt_provider):
-    """测试无效的 array<string> 类型变量 - 元素类型错误"""
+    """Test invalid array<string> type variable - wrong element type"""
     var_defs = [VariableDef(key="tags", desc="Tag list", type=VariableType.ARRAY_STRING)]
-    variables = {"tags": ["tag1", 123, "tag3"]}  # 包含非字符串元素
+    variables = {"tags": ["tag1", 123, "tag3"]}  # Contains non-string elements
 
     with pytest.raises(ValueError) as excinfo:
         prompt_provider._validate_variable_values_type(var_defs, variables)
@@ -727,18 +727,18 @@ def test_validate_variable_values_type_array_string_invalid_wrong_element_type(p
 
 
 def test_validate_variable_values_type_array_boolean_valid(prompt_provider):
-    """测试有效的 array<boolean> 类型变量"""
+    """Test valid array<boolean> type variable"""
     var_defs = [VariableDef(key="flags", desc="Boolean flags", type=VariableType.ARRAY_BOOLEAN)]
     variables = {"flags": [True, False, True]}
 
-    # 应该不抛出异常
+    # Should not raise exception
     prompt_provider._validate_variable_values_type(var_defs, variables)
 
 
 def test_validate_variable_values_type_array_boolean_invalid(prompt_provider):
-    """测试无效的 array<boolean> 类型变量"""
+    """Test invalid array<boolean> type variable"""
     var_defs = [VariableDef(key="flags", desc="Boolean flags", type=VariableType.ARRAY_BOOLEAN)]
-    variables = {"flags": [True, "false", True]}  # 包含字符串而不是布尔值
+    variables = {"flags": [True, "false", True]}  # Contains string instead of boolean
 
     with pytest.raises(ValueError) as excinfo:
         prompt_provider._validate_variable_values_type(var_defs, variables)
@@ -747,16 +747,16 @@ def test_validate_variable_values_type_array_boolean_invalid(prompt_provider):
 
 
 def test_validate_variable_values_type_array_integer_valid(prompt_provider):
-    """测试有效的 array<integer> 类型变量"""
+    """Test valid array<integer> type variable"""
     var_defs = [VariableDef(key="numbers", desc="Number list", type=VariableType.ARRAY_INTEGER)]
     variables = {"numbers": [1, 2, 3, 4, 5]}
 
-    # 应该不抛出异常
+    # Should not raise exception
     prompt_provider._validate_variable_values_type(var_defs, variables)
 
 
 def test_validate_variable_values_type_array_integer_invalid(prompt_provider):
-    """测试无效的 array<integer> 类型变量"""
+    """Test invalid array<integer> type variable"""
     var_defs = [VariableDef(key="numbers", desc="Number list", type=VariableType.ARRAY_INTEGER)]
     variables = {"numbers": [1, "2", 3]}  # 包含字符串而不是整数