camel-ai 0.2.9__py3-none-any.whl → 0.2.11__py3-none-any.whl

camel/runtime/remote_http_runtime.py

@@ -0,0 +1,204 @@
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+import atexit
+import json
+import logging
+import subprocess
+import time
+from functools import wraps
+from pathlib import Path
+from subprocess import Popen
+from typing import Any, Dict, List, Optional, Union
+
+import requests
+from pydantic import BaseModel
+
+from camel.runtime import BaseRuntime
+from camel.toolkits.function_tool import FunctionTool
+
+logger = logging.getLogger(__name__)
+
+
+class RemoteHttpRuntime(BaseRuntime):
+    r"""A runtime that runs functions in a remote HTTP server.
+    You need to run the API server in the remote server first.
+
+    Args:
+        host (str): The host of the remote server.
+        port (int): The port of the remote server. (default::obj: `8000`)
+        python_exec (str): The python executable to run the API server.
+            (default::obj: `python3`)
+    """
+
+    def __init__(
+        self, host: str, port: int = 8000, python_exec: str = "python3"
+    ):
+        super().__init__()
+        self.host = host
+        self.port = port
+        self.python_exec = python_exec
+        self.api_path = Path(__file__).parent / "api.py"
+        self.entrypoint: Dict[str, str] = dict()
+        self.process: Optional[Popen] = None
+
+    def build(self) -> "RemoteHttpRuntime":
+        r"""Build the API server.
+
+        Returns:
+            RemoteHttpRuntime: The current runtime.
+        """
+        self.process = subprocess.Popen(
+            [
+                self.python_exec,
+                str(self.api_path),
+                *list(self.entrypoint.values()),
+            ]
+        )
+        atexit.register(self._cleanup)
+        return self
+
+    def _cleanup(self):
+        r"""Clean up the API server when exiting."""
+
+        if self.process and self.process.poll() is None:
+            self.process.terminate()
+            self.process.wait()
+            self.process = None
+
+    def add(  # type: ignore[override]
+        self,
+        funcs: Union[FunctionTool, List[FunctionTool]],
+        entrypoint: str,
+        redirect_stdout: bool = False,
+        arguments: Optional[Dict[str, Any]] = None,
+    ) -> "RemoteHttpRuntime":
+        r"""Add a function or list of functions to the runtime.
+
+        Args:
+            funcs (Union[FunctionTool, List[FunctionTool]]): The function or
+                list of functions to add.
+            entrypoint (str): The entrypoint for the function.
+            redirect_stdout (bool): Whether to return the stdout of
+                the function. (default::obj: `False`)
+            arguments (Optional[Dict[str, Any]]): The arguments for the
+                function. (default::obj: `None`)
+
+        Returns:
+            RemoteHttpRuntime: The current runtime.
+        """
+        if not isinstance(funcs, list):
+            funcs = [funcs]
+        if arguments is not None:
+            entrypoint += json.dumps(arguments)
+
+        for func in funcs:
+            inner_func = func.func
+
+            # Create a wrapper that explicitly binds `func`
+            @wraps(inner_func)
+            def wrapper(
+                *args, func=func, redirect_stdout=redirect_stdout, **kwargs
+            ):
+                for key, value in kwargs.items():
+                    if isinstance(value, BaseModel):
+                        kwargs[key] = value.model_dump()
+
+                resp = requests.post(
+                    f"http://{self.host}:{self.port}/{func.get_function_name()}",
+                    json=dict(
+                        args=args,
+                        kwargs=kwargs,
+                        redirect_stdout=redirect_stdout,
+                    ),
+                )
+                if resp.status_code != 200:
+                    logger.error(
+                        f"""ailed to execute function: 
+                        {func.get_function_name()}, 
+                        status code: {resp.status_code}, 
+                        response: {resp.text}"""
+                    )
+                    return {
+                        "error": f"""Failed to execute function:
+                        {func.get_function_name()}, 
+                        response: {resp.text}"""
+                    }
+                data = resp.json()
+                if redirect_stdout:
+                    print(data["stdout"])
+                return json.loads(data["output"])
+
+            func.func = wrapper
+            self.tools_map[func.get_function_name()] = func
+        self.entrypoint[func.get_function_name()] = entrypoint
+
+        return self
+
+    @property
+    def ok(self) -> bool:
+        r"""Check if the API Server is running.
+
+        Returns:
+            bool: Whether the API Server is running.
+        """
+        try:
+            _ = requests.get(f"http://{self.host}:{self.port}")
+            return True
+        except requests.exceptions.ConnectionError:
+            return False
+
+    def wait(self, timeout: int = 10) -> bool:
+        r"""Wait for the API Server to be ready.
+
+        Args:
+            timeout (int): The number of seconds to wait. (default::obj: `10`)
+
+        Returns:
+            bool: Whether the API Server is ready.
+        """
+        for _ in range(timeout):
+            if self.ok:
+                return True
+            time.sleep(1)
+        return False
+
+    def __del__(self):
+        r"""Clean up the API server when the object is deleted."""
+        self._cleanup()
+
+    def stop(self) -> "RemoteHttpRuntime":
+        r"""Stop the API server.
+
+        Returns:
+            RemoteHttpRuntime: The current runtime.
+        """
+        self._cleanup()
+        return self
+
+    def reset(self) -> "RemoteHttpRuntime":
+        r"""Reset the API server.
+
+        Returns:
+            RemoteHttpRuntime: The current runtime.
+        """
+        return self.stop().build()
+
+    @property
+    def docs(self) -> str:
+        r"""Get the URL for the API documentation.
+
+        Returns:
+            str: The URL for the API documentation.
+        """
+        return f"http://{self.host}:{self.port}/docs"

camel/runtime/utils/__init__.py

@@ -0,0 +1,20 @@
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+from .function_risk_toolkit import FunctionRiskToolkit
+from .ignore_risk_toolkit import IgnoreRiskToolkit
+
+__all__ = [
+    "FunctionRiskToolkit",
+    "IgnoreRiskToolkit",
+]

camel/runtime/utils/function_risk_toolkit.py

@@ -0,0 +1,58 @@
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+from typing import List, Optional
+
+from camel.toolkits import FunctionTool
+from camel.toolkits.base import BaseToolkit
+
+
+class FunctionRiskToolkit(BaseToolkit):
+    r"""A toolkit for assessing the risk associated with functions.
+
+    Args:
+        verbose (Optional[bool]): Whether to print verbose output.
+            (default::obj:`False`)
+    """
+
+    def __init__(self, verbose: Optional[bool] = False):
+        self.verbose = verbose
+
+    def function_risk(self, score: int, reason: str):
+        r"""Provides an assessment of the potential risk associated
+            with a function.
+
+        Args:
+            score (int): The risk level associated with the function,
+                ranging from 1 to 3:
+                    - 1: No harm
+                        (e.g., simple math operations, content searches)
+                    - 2: Minimal harm (e.g., accessing user files)
+                    - 3: Risk present
+                        (e.g., deleting files, modifying the file system)
+            reason (str): A brief explanation of the reasoning behind
+                the assigned score, describing the specific aspects that
+                contribute to the assessed risk.
+        """
+        if self.verbose:
+            print(f"Function risk assessment: {reason} (score: {score})")
+
+    def get_tools(self) -> List[FunctionTool]:
+        r"""Returns a list of FunctionTool objects representing the
+        functions in the toolkit.
+
+        Returns:
+            List[FunctionTool]: A list of FunctionTool objects
+                representing the functions in the toolkit.
+        """
+        return [FunctionTool(self.function_risk)]

camel/runtime/utils/ignore_risk_toolkit.py

@@ -0,0 +1,72 @@
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+from typing import Dict, List, Optional
+
+from camel.toolkits import FunctionTool
+from camel.toolkits.base import BaseToolkit
+
+
+class IgnoreRiskToolkit(BaseToolkit):
+    r"""A toolkit for ignoring risks associated with functions.
+
+    Args:
+        function_names (Optional[List[str]]): A list of function names to
+            ignore risks for. (default::obj:`None`)
+        verbose (Optional[bool]): Whether to print verbose output.
+            (default::obj:`False`)
+    """
+
+    def __init__(
+        self,
+        function_name: Optional[List[str]] = None,
+        verbose: Optional[bool] = False,
+    ):
+        self.verbose = verbose
+        self.function_names = function_name or []
+        self.ignored_risks: Dict[str, str] = dict()
+
+    def add(self, name: str):
+        r"""Adds a function to the toolkit.
+
+        Args:
+            name (str): The name of the function to add.
+        """
+        self.function_names.append(name)
+
+    def ignore_risk(self, name: str, reason: str) -> str:
+        r"""Force ignores the risk associated with named function. This ONLY
+        ignores the RISK for the NEXT Function Call.
+
+        Args:
+            name (str): The name of the function to ignore.
+            reason (str): A brief explanation of the reasoning
+                behind the decision to ignore the risk.
+        """
+        if name not in self.function_names:
+            raise ValueError(f"Function {name} not found in the toolkit.")
+
+        self.ignored_risks[name] = reason
+        if self.verbose:
+            print(f"Ignoring risk for function {name}: {reason}")
+        return f"Ignored risk for function {name}!"
+
+    def get_tools(self) -> List[FunctionTool]:
+        r"""Returns a list of FunctionTool objects representing the
+        functions in the toolkit.
+
+        Returns:
+            List[FunctionTool]: A list of FunctionTool objects representing
+                the functions in the toolkit.
+        """
+        return [FunctionTool(self.ignore_risk)]

camel/schemas/__init__.py

@@ -0,0 +1,17 @@
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+
+from .openai_converter import OpenAISchemaConverter
+
+__all__ = ["OpenAISchemaConverter"]

camel/schemas/base.py

@@ -0,0 +1,45 @@
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+
+from abc import ABC, abstractmethod
+from typing import Any, Dict
+
+from pydantic import BaseModel
+
+
+class BaseConverter(ABC):
+    r"""A base class for schema outputs that includes functionality
+    for managing the response format.
+
+    Args:
+        output_schema (Optional[Type[BaseModel]], optional): The expected
+            format of the response. (default: :obj:`None`)
+    """
+
+    @abstractmethod
+    def convert(
+        self, content: str, *args: Any, **kwargs: Dict[str, Any]
+    ) -> BaseModel:
+        r"""Structures the input text into the expected response format.
+
+        Args:
+            text (str): The input text to be structured.
+            output_schema (Optional[Type[BaseModel]], optional):
+                The expected format of the response. Defaults to None.
+            prompt (Optional[str], optional): The prompt to be used.
+
+        Returns:
+            Optional[BaseModel]: The structured response.
+        """
+        pass

camel/schemas/openai_converter.py

@@ -0,0 +1,116 @@
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+
+import os
+from typing import Any, Callable, Dict, Optional, Type, Union
+
+from pydantic import BaseModel
+
+from camel.models import ModelFactory
+from camel.types import ModelType
+from camel.types.enums import ModelPlatformType
+from camel.utils import (
+    api_keys_required,
+    get_pydantic_model,
+)
+
+from .base import BaseConverter
+
+DEFAULT_CONVERTER_PROMPTS = """
+    Extract key entities and attributes from the provided text,
+        and convert them into a structured JSON format.
+"""
+
+
+class OpenAISchemaConverter(BaseConverter):
+    r"""OpenAISchemaConverter is a class that converts a string or a function
+    into a BaseModel schema.
+
+    Args:
+        model_type (ModelType, optional): The model type to be used.
+            (default: ModelType.GPT_4O_MINI)
+        model_config_dict (Optional[Dict[str, Any]], optional): A dictionary
+            that will be fed into:obj:`openai.ChatCompletion.create()`. If
+            :obj:`None`, :obj:`ChatGPTConfig().as_dict()` will be used.
+            (default: :obj:`None`)
+        api_key (Optional[str], optional): The API key for authenticating
+            with the OpenAI service. (default: :obj:`None`)
+        output_schema (Optional[Type[BaseModel]], optional): The expected
+            format of the response. (default: :obj:`None`)
+        prompt (Optional[str], optional): The prompt to be used.
+            (default: :obj:`None`)
+
+    """
+
+    def __init__(
+        self,
+        model_type: ModelType = ModelType.GPT_4O_MINI,
+        model_config_dict: Optional[Dict[str, Any]] = None,
+        api_key: Optional[str] = None,
+    ):
+        self.model_type = model_type
+        self.model_config_dict = model_config_dict or {}
+        api_key = api_key or os.environ.get("OPENAI_API_KEY")
+        self._client = ModelFactory.create(  # type: ignore[attr-defined]
+            ModelPlatformType.OPENAI,
+            model_type,
+            api_key=api_key,
+        )._client
+        super().__init__()
+
+    @api_keys_required("OPENAI_API_KEY")
+    def convert(  # type: ignore[override]
+        self,
+        content: str,
+        output_schema: Union[Type[BaseModel], str, Callable],
+        prompt: Optional[str] = DEFAULT_CONVERTER_PROMPTS,
+    ) -> BaseModel:
+        r"""Formats the input content into the expected BaseModel
+
+        Args:
+            content (str): The content to be formatted.
+            output_schema (Union[Type[BaseModel], str, Callable]): The expected
+                format of the response.
+
+        Returns:
+            BaseModel: The formatted response.
+        """
+        prompt = prompt or DEFAULT_CONVERTER_PROMPTS
+        if output_schema is None:
+            raise ValueError("Expected an output schema, got None.")
+        if not isinstance(output_schema, type):
+            output_schema = get_pydantic_model(output_schema)
+        elif not issubclass(output_schema, BaseModel):
+            raise ValueError(
+                f"Expected a BaseModel, got {type(output_schema)}"
+            )
+
+        self.model_config_dict["response_format"] = output_schema
+        response = self._client.beta.chat.completions.parse(
+            messages=[
+                {'role': 'system', 'content': prompt},
+                {'role': 'user', 'content': content},
+            ],
+            model=self.model_type,
+            **self.model_config_dict,
+        )
+
+        message = response.choices[0].message
+
+        if not isinstance(message.parsed, output_schema):
+            raise ValueError(
+                f"Expected a {output_schema}, got {type(message.parsed)}."
+            )
+
+        return message.parsed

camel/societies/__init__.py

@@ -1,16 +1,16 @@
-# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========
-# Licensed under the Apache License, Version 2.0 (the “License”);
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
 #     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an “AS IS” BASIS,
+# distributed under the License is distributed on an "AS IS" BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 from .babyagi_playing import BabyAGI
 from .role_playing import RolePlaying
 

camel/societies/babyagi_playing.py

@@ -1,16 +1,16 @@
-# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========
-# Licensed under the Apache License, Version 2.0 (the “License”);
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
 #     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an “AS IS” BASIS,
+# distributed under the License is distributed on an "AS IS" BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 from collections import deque
 from typing import Dict, List, Optional
 
@@ -22,10 +22,13 @@ from camel.agents import (
 )
 from camel.agents.chat_agent import ChatAgentResponse
 from camel.generators import SystemMessageGenerator
+from camel.logger import get_logger
 from camel.messages import BaseMessage
 from camel.prompts import TextPrompt
 from camel.types import RoleType, TaskType
 
+logger = get_logger(__name__)
+
 
 class BabyAGI:
     r"""The BabyAGI Agent adapted from `"Task-driven Autonomous Agent"
@@ -261,7 +264,7 @@ class BabyAGI:
             )
             self.subtasks = deque(prioritized_subtask_list)
         else:
-            print("no new tasks")
+            logger.info("no new tasks")
         assistant_response.info['task_name'] = task_name
         assistant_response.info['subtasks'] = list(self.subtasks)
         if not self.subtasks:

camel/societies/role_playing.py

@@ -1,16 +1,16 @@
-# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========
-# Licensed under the Apache License, Version 2.0 (the “License”);
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
 #     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an “AS IS” BASIS,
+# distributed under the License is distributed on an "AS IS" BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 import logging
 from typing import Dict, List, Optional, Sequence, Tuple, Union
 

camel/societies/workforce/__init__.py

@@ -1,16 +1,16 @@
-# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========
-# Licensed under the Apache License, Version 2.0 (the “License”);
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
 #     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an “AS IS” BASIS,
+# distributed under the License is distributed on an "AS IS" BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 
 from .role_playing_worker import RolePlayingWorker
 from .single_agent_worker import SingleAgentWorker

camel/societies/workforce/base.py

@@ -1,16 +1,16 @@
-# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========
-# Licensed under the Apache License, Version 2.0 (the “License”);
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
 #     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an “AS IS” BASIS,
+# distributed under the License is distributed on an "AS IS" BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 from abc import ABC, abstractmethod
 from typing import Any