agentica 0.2.1__tar.gz → 0.2.3__tar.gz

agentica-0.2.3/MANIFEST.in

@@ -0,0 +1 @@
+exclude tests/*

{agentica-0.2.1 → agentica-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: agentica
-Version: 0.2.1
+Version: 0.2.3
 Summary: LLM agents
 Home-page: https://github.com/shibing624/agentica
 Author: XuMing
@@ -49,40 +49,53 @@ Requires-Dist: rich
 [![Wechat Group](https://img.shields.io/badge/wechat-group-green.svg?logo=wechat)](#Contact)
 
 
-**Agentica**: Build Smarter, Reflective, and Collaborative AI Agents with Ease!
+**Agentica**: 轻松构建智能、具备反思能力、可协作的多模态AI Agent。
 
-**Agentica**: 快速打造智能、能反思、协作的AI Agent。
 
-## Overview
+## 📖 Introduction
 
-#### LLM Agent
+**Agentica** 可以构建AI Agent，包括规划、记忆和工具使用、执行等组件。
+
+#### Agent Components
 <img src="https://github.com/shibing624/agentica/blob/main/docs/llm_agentv2.png" width="800" />
 
 - **规划（Planning）**：任务拆解、生成计划、反思
 - **记忆（Memory）**：短期记忆（prompt实现）、长期记忆（RAG实现）
 - **工具使用（Tool use）**：function call能力，调用外部API，以获取外部信息，包括当前日期、日历、代码执行能力、对专用信息源的访问等
 
-#### Agentica Architecture  
+#### Agentica Workflow
+
+**Agentica** can also build multi-agent systems and workflows.
+
+**Agentica** 还可以构建多Agent系统和工作流。
+
 <img src="https://github.com/shibing624/agentica/blob/main/docs/agent_arch.png" width="800" />
 
 - **Planner**：负责让LLM生成一个多步计划来完成复杂任务，生成相互依赖的“链式计划”，定义每一步所依赖的上一步的输出
 - **Worker**：接受“链式计划”，循环遍历计划中的每个子任务，并调用工具完成任务，可以自动反思纠错以完成任务
 - **Solver**：求解器将所有这些输出整合为最终答案
 
+## 🔥 News
+[2024/12/29] v0.2.3版本: 支持了`ZhipuAI`的api调用，包括免费模型和工具使用，详见[Release-v0.2.3](https://github.com/shibing624/agentica/releases/tag/0.2.3)
+
+[2024/12/25] v0.2.0版本: 支持了多模态模型，输入可以是文本、图片、音频、视频，升级Assistant为Agent，Workflow支持拆解并实现复杂任务，详见[Release-v0.2.0](https://github.com/shibing624/agentica/releases/tag/0.2.0)
+
+[2024/07/02] v0.1.0版本：实现了基于LLM的Assistant，可以快速用function call搭建大语言模型助手，详见[Release-v0.1.0](https://github.com/shibing624/agentica/releases/tag/0.1.0)
+
 
-## Features
+## 😊 Features
 `Agentica`是一个用于构建Agent的工具，具有以下功能：
 
-- **Agent编排**：通过简单代码快速编排Agent，支持 Reflection(反思）、Plan and Solve(计划并执行)、RAG、Agent、Multi-Agent、Multi-Role、Workflow等功能
+- **Agent编排**：通过简单代码快速编排Agent，支持 Reflection(反思）、Plan and Solve(计划并执行)、RAG、Agent、Multi-Agent、Team、Workflow等功能
 - **自定义prompt**：Agent支持自定义prompt和多种工具调用（tool_calls）
 - **LLM集成**：支持OpenAI、Azure、Deepseek、Moonshot、Claude、Ollama、Together等多方大模型厂商的API
 - **记忆功能**：包括短期记忆和长期记忆功能
-- **Multi-Agent协作**：支持多Agent和多角色的团队协作。
+- **Multi-Agent协作**：支持多Agent和任务委托（Team）的团队协作。
 - **Workflow工作流**：拆解复杂任务为多个Agent，基于工作流自动化串行逐步完成任务，如投资研究、新闻文章撰写和技术教程创建
 - **自我进化Agent**：具有反思和增强记忆能力的自我进化Agent
 - **Web UI**：兼容ChatPilot，可以基于Web页面交互，支持主流的open-webui、streamlit、gradio等前端交互框架
 
-## Installation
+## 💾 Install
 
 ```bash
 pip install -U agentica
@@ -96,7 +109,7 @@ cd agentica
 pip install .
 ```
 
-## Getting Started
+## 🚀 Getting Started
 
 #### Run the example
 ```shell
@@ -107,7 +120,7 @@ cd examples
 python web_search_moonshot_demo.py
 ```
 
-1. 复制[.env.example](https://github.com/shibing624/agentica/blob/main/.env.example)文件为`~/.agentica/.env`，并填写LLM api key(选填DEEPSEEK_API_KEY、MOONSHOT_API_KEY、OPENAI_API_KEY等任一个即可)。或者使用`export`命令设置环境变量：
+1. 复制[.env.example](https://github.com/shibing624/agentica/blob/main/.env.example)文件为`~/.agentica/.env`，并填写LLM api key(选填DEEPSEEK_API_KEY、MOONSHOT_API_KEY、OPENAI_API_KEY、ZHIPUAI_API_KEY等任一个即可)。或者使用`export`命令设置环境变量：
     
     ```shell
     export MOONSHOT_API_KEY=your_moonshot_api_key
@@ -127,7 +140,7 @@ print(r)
 ```
 
 
-## Web UI
+## ▶️ Web UI
 
 [shibing624/ChatPilot](https://github.com/shibing624/ChatPilot) 兼容`agentica`，可以通过Web UI进行交互。
 
@@ -146,7 +159,7 @@ bash start.sh
 ```
 
 
-## Examples
+## 😀 Examples
 
 
 | 示例                                                                                                                                                    | 描述                                                                                                                                |
@@ -230,7 +243,7 @@ streamlit run 34_llm_os_demo.py
 
 <img alt="LLM OS" src="https://github.com/shibing624/agentica/blob/main/docs/llm_os_snap.png" width="800" />
 
-## Contact
+## ☎️ Contact
 
 - Issue(建议)
   ：[![GitHub issues](https://img.shields.io/github/issues/shibing624/agentica.svg)](https://github.com/shibing624/agentica/issues)
@@ -239,7 +252,7 @@ streamlit run 34_llm_os_demo.py
 
 <img src="https://github.com/shibing624/agentica/blob/main/docs/wechat.jpeg" width="200" />
 
-## Citation
+## 😇 Citation
 
 如果你在研究中使用了`agentica`，请按如下格式引用：
 
@@ -260,10 +273,10 @@ BibTeX:
 }
 ```
 
-## License
+## ⚠️ License
 
 授权协议为 [The Apache License 2.0](/LICENSE)，可免费用做商业用途。请在产品说明中附加`agentica`的链接和授权协议。
-## Contribute
+## 😍 Contribute
 
 项目代码还很粗糙，如果大家对代码有所改进，欢迎提交回本项目，在提交之前，注意以下两点：
 
@@ -272,11 +285,11 @@ BibTeX:
 
 之后即可提交PR。
 
-## Acknowledgements 
+## 💕 Acknowledgements
 
-- [https://github.com/langchain-ai/langchain](https://github.com/langchain-ai/langchain)
-- [https://github.com/simonmesmith/agentflow](https://github.com/simonmesmith/agentflow)
-- [https://github.com/phidatahq/phidata](https://github.com/phidatahq/phidata)
+- [langchain-ai/langchain](https://github.com/langchain-ai/langchain)
+- [simonmesmith/agentflow](https://github.com/simonmesmith/agentflow)
+- [phidatahq/phidata](https://github.com/phidatahq/phidata)
 
 
 Thanks for their great work!

{agentica-0.2.1 → agentica-0.2.3}/README.md

@@ -18,40 +18,53 @@
 [![Wechat Group](https://img.shields.io/badge/wechat-group-green.svg?logo=wechat)](#Contact)
 
 
-**Agentica**: Build Smarter, Reflective, and Collaborative AI Agents with Ease!
+**Agentica**: 轻松构建智能、具备反思能力、可协作的多模态AI Agent。
 
-**Agentica**: 快速打造智能、能反思、协作的AI Agent。
 
-## Overview
+## 📖 Introduction
 
-#### LLM Agent
+**Agentica** 可以构建AI Agent，包括规划、记忆和工具使用、执行等组件。
+
+#### Agent Components
 <img src="https://github.com/shibing624/agentica/blob/main/docs/llm_agentv2.png" width="800" />
 
 - **规划（Planning）**：任务拆解、生成计划、反思
 - **记忆（Memory）**：短期记忆（prompt实现）、长期记忆（RAG实现）
 - **工具使用（Tool use）**：function call能力，调用外部API，以获取外部信息，包括当前日期、日历、代码执行能力、对专用信息源的访问等
 
-#### Agentica Architecture  
+#### Agentica Workflow
+
+**Agentica** can also build multi-agent systems and workflows.
+
+**Agentica** 还可以构建多Agent系统和工作流。
+
 <img src="https://github.com/shibing624/agentica/blob/main/docs/agent_arch.png" width="800" />
 
 - **Planner**：负责让LLM生成一个多步计划来完成复杂任务，生成相互依赖的“链式计划”，定义每一步所依赖的上一步的输出
 - **Worker**：接受“链式计划”，循环遍历计划中的每个子任务，并调用工具完成任务，可以自动反思纠错以完成任务
 - **Solver**：求解器将所有这些输出整合为最终答案
 
+## 🔥 News
+[2024/12/29] v0.2.3版本: 支持了`ZhipuAI`的api调用，包括免费模型和工具使用，详见[Release-v0.2.3](https://github.com/shibing624/agentica/releases/tag/0.2.3)
+
+[2024/12/25] v0.2.0版本: 支持了多模态模型，输入可以是文本、图片、音频、视频，升级Assistant为Agent，Workflow支持拆解并实现复杂任务，详见[Release-v0.2.0](https://github.com/shibing624/agentica/releases/tag/0.2.0)
+
+[2024/07/02] v0.1.0版本：实现了基于LLM的Assistant，可以快速用function call搭建大语言模型助手，详见[Release-v0.1.0](https://github.com/shibing624/agentica/releases/tag/0.1.0)
+
 
-## Features
+## 😊 Features
 `Agentica`是一个用于构建Agent的工具，具有以下功能：
 
-- **Agent编排**：通过简单代码快速编排Agent，支持 Reflection(反思）、Plan and Solve(计划并执行)、RAG、Agent、Multi-Agent、Multi-Role、Workflow等功能
+- **Agent编排**：通过简单代码快速编排Agent，支持 Reflection(反思）、Plan and Solve(计划并执行)、RAG、Agent、Multi-Agent、Team、Workflow等功能
 - **自定义prompt**：Agent支持自定义prompt和多种工具调用（tool_calls）
 - **LLM集成**：支持OpenAI、Azure、Deepseek、Moonshot、Claude、Ollama、Together等多方大模型厂商的API
 - **记忆功能**：包括短期记忆和长期记忆功能
-- **Multi-Agent协作**：支持多Agent和多角色的团队协作。
+- **Multi-Agent协作**：支持多Agent和任务委托（Team）的团队协作。
 - **Workflow工作流**：拆解复杂任务为多个Agent，基于工作流自动化串行逐步完成任务，如投资研究、新闻文章撰写和技术教程创建
 - **自我进化Agent**：具有反思和增强记忆能力的自我进化Agent
 - **Web UI**：兼容ChatPilot，可以基于Web页面交互，支持主流的open-webui、streamlit、gradio等前端交互框架
 
-## Installation
+## 💾 Install
 
 ```bash
 pip install -U agentica
@@ -65,7 +78,7 @@ cd agentica
 pip install .
 ```
 
-## Getting Started
+## 🚀 Getting Started
 
 #### Run the example
 ```shell
@@ -76,7 +89,7 @@ cd examples
 python web_search_moonshot_demo.py
 ```
 
-1. 复制[.env.example](https://github.com/shibing624/agentica/blob/main/.env.example)文件为`~/.agentica/.env`，并填写LLM api key(选填DEEPSEEK_API_KEY、MOONSHOT_API_KEY、OPENAI_API_KEY等任一个即可)。或者使用`export`命令设置环境变量：
+1. 复制[.env.example](https://github.com/shibing624/agentica/blob/main/.env.example)文件为`~/.agentica/.env`，并填写LLM api key(选填DEEPSEEK_API_KEY、MOONSHOT_API_KEY、OPENAI_API_KEY、ZHIPUAI_API_KEY等任一个即可)。或者使用`export`命令设置环境变量：
     
     ```shell
     export MOONSHOT_API_KEY=your_moonshot_api_key
@@ -96,7 +109,7 @@ print(r)
 ```
 
 
-## Web UI
+## ▶️ Web UI
 
 [shibing624/ChatPilot](https://github.com/shibing624/ChatPilot) 兼容`agentica`，可以通过Web UI进行交互。
 
@@ -115,7 +128,7 @@ bash start.sh
 ```
 
 
-## Examples
+## 😀 Examples
 
 
 | 示例                                                                                                                                                    | 描述                                                                                                                                |
@@ -199,7 +212,7 @@ streamlit run 34_llm_os_demo.py
 
 <img alt="LLM OS" src="https://github.com/shibing624/agentica/blob/main/docs/llm_os_snap.png" width="800" />
 
-## Contact
+## ☎️ Contact
 
 - Issue(建议)
   ：[![GitHub issues](https://img.shields.io/github/issues/shibing624/agentica.svg)](https://github.com/shibing624/agentica/issues)
@@ -208,7 +221,7 @@ streamlit run 34_llm_os_demo.py
 
 <img src="https://github.com/shibing624/agentica/blob/main/docs/wechat.jpeg" width="200" />
 
-## Citation
+## 😇 Citation
 
 如果你在研究中使用了`agentica`，请按如下格式引用：
 
@@ -229,10 +242,10 @@ BibTeX:
 }
 ```
 
-## License
+## ⚠️ License
 
 授权协议为 [The Apache License 2.0](/LICENSE)，可免费用做商业用途。请在产品说明中附加`agentica`的链接和授权协议。
-## Contribute
+## 😍 Contribute
 
 项目代码还很粗糙，如果大家对代码有所改进，欢迎提交回本项目，在提交之前，注意以下两点：
 
@@ -241,11 +254,11 @@ BibTeX:
 
 之后即可提交PR。
 
-## Acknowledgements 
+## 💕 Acknowledgements
 
-- [https://github.com/langchain-ai/langchain](https://github.com/langchain-ai/langchain)
-- [https://github.com/simonmesmith/agentflow](https://github.com/simonmesmith/agentflow)
-- [https://github.com/phidatahq/phidata](https://github.com/phidatahq/phidata)
+- [langchain-ai/langchain](https://github.com/langchain-ai/langchain)
+- [simonmesmith/agentflow](https://github.com/simonmesmith/agentflow)
+- [phidatahq/phidata](https://github.com/phidatahq/phidata)
 
 
 Thanks for their great work!

{agentica-0.2.1 → agentica-0.2.3}/agentica/__init__.py

@@ -21,6 +21,7 @@ from agentica.model.doubao.chat import DoubaoChat
 from agentica.model.together.togetherchat import TogetherChat
 from agentica.model.xai.grok import GrokChat
 from agentica.model.yi.chat import YiChat
+from agentica.model.zhipuai.chat import ZhipuAIChat
 
 # memory
 from agentica.model.base import Model
@@ -72,6 +73,7 @@ from agentica.emb.hash_emb import HashEmb
 from agentica.emb.ollama_emb import OllamaEmb
 from agentica.emb.together_emb import TogetherEmb
 from agentica.emb.fireworks_emb import FireworksEmb
+from agentica.emb.zhipuai_emb import ZhipuAIEmb
 
 # file
 from agentica.file.base import File
@@ -94,7 +96,7 @@ from agentica.tools.search_serper_tool import SearchSerperTool
 from agentica.tools.run_python_code_tool import RunPythonCodeTool
 from agentica.tools.analyze_image_tool import AnalyzeImageTool
 from agentica.tools.calculator_tool import CalculatorTool
-from agentica.tools.create_image_tool import CreateImageTool
+from agentica.tools.dalle_tool import DalleTool
 from agentica.tools.file_tool import FileTool
 from agentica.tools.hackernews_tool import HackerNewsTool
 from agentica.tools.jina_tool import JinaTool

{agentica-0.2.1 → agentica-0.2.3}/agentica/agent.py

@@ -1998,7 +1998,8 @@ class Agent(BaseModel):
                         logger.warning(f"Failed to convert response to pydantic model: {exc}")
                         # Check if response starts with ```json
                         if run_response.content.startswith("```json"):
-                            run_response.content = run_response.content.replace("```json\n", "").replace("\n```", "")
+                            run_response.content = run_response.content.replace(
+                                "```json\n", "").replace("\n```", "")
                             try:
                                 structured_output = self.response_model.model_validate_json(run_response.content)
                             except ValidationError as exc:
@@ -2307,7 +2308,8 @@ class Agent(BaseModel):
                         logger.warning(f"Failed to convert response to pydantic model: {exc}")
                         # Check if response starts with ```json
                         if run_response.content.startswith("```json"):
-                            run_response.content = run_response.content.replace("```json\n", "").replace("\n```", "")
+                            run_response.content = run_response.content.replace(
+                                "```json\n", "").replace("\n```", "")
                             try:
                                 structured_output = self.response_model.model_validate_json(run_response.content)
                             except ValidationError as exc:

agentica-0.2.3/agentica/emb/zhipuai_emb.py

@@ -0,0 +1,15 @@
+"""
+@author:XuMing(xuming624@qq.com)
+@description:
+"""
+from os import getenv
+from typing import Optional
+
+from agentica.emb.openai_emb import OpenAIEmb
+
+
+class ZhipuAIEmb(OpenAIEmb):
+    model: str = "embedding-3"
+    dimensions: int = 2048
+    api_key: Optional[str] = getenv("ZHIPUAI_API_KEY")
+    base_url: str = "https://open.bigmodel.cn/api/paas/v4"

{agentica-0.2.1 → agentica-0.2.3}/agentica/model/doubao/chat.py

@@ -18,7 +18,7 @@ class DoubaoChat(OpenAILike):
 
     id: str = "ep-20241012172611-btlgr"
     name: str = "DoubaoChat"
-    provider: str = "Doubao"
+    provider: str = "ByteDance"
 
     api_key: Optional[str] = getenv("ARK_API_KEY", None)
     base_url: str = "https://ark.cn-beijing.volces.com/api/v3"

{agentica-0.2.1 → agentica-0.2.3}/agentica/model/message.py

@@ -85,7 +85,8 @@ class Message(BaseModel):
         @param level: The level to log the message at. One of debug, info, warning, or error.
             Defaults to debug.
         """
-        _logger = logger.debug
+        level = level or "debug"
+        level = level.lower()
         if level == "debug":
             _logger = logger.debug
         elif level == "info":
@@ -94,6 +95,8 @@ class Message(BaseModel):
             _logger = logger.warning
         elif level == "error":
             _logger = logger.error
+        else:
+            _logger = logger.debug
 
         _logger(f"============== {self.role} ==============")
         if self.name:
@@ -120,8 +123,6 @@ class Message(BaseModel):
                     _logger("Message contains raw audio data")
             else:
                 _logger(f"Audio file added: {self.audio}")
-        # if self.model_extra and "images" in self.model_extra:
-        #     _logger("images: {}".format(self.model_extra["images"]))
 
     def content_is_valid(self) -> bool:
         """Check if the message content is valid."""

agentica-0.2.3/agentica/model/zhipuai/__init__.py

@@ -0,0 +1 @@
+from agentica.model.zhipuai.chat import ZhipuAIChat

agentica-0.2.3/agentica/model/zhipuai/chat.py

@@ -0,0 +1,24 @@
+from typing import Optional
+from os import getenv
+
+from agentica.model.openai.like import OpenAILike
+
+
+class ZhipuAIChat(OpenAILike):
+    """
+    A model class for ZhipuAI Chat API.
+
+    Attributes:
+    - id: str: The unique identifier of the model, model_name.
+    - name: str: The name of the class.
+    - provider: str: The provider of the model.
+    - api_key: Optional[str]: The API key for the model.
+    - base_url: str: The base URL for the model.
+    """
+
+    id: str = "glm-4-flash"
+    name: str = "ZhipuAIChat"
+    provider: str = "ZhipuAI"
+
+    api_key: Optional[str] = getenv("ZHIPUAI_API_KEY", None)
+    base_url: str = "https://open.bigmodel.cn/api/paas/v4"

{agentica-0.2.1 → agentica-0.2.3}/agentica/python_agent.py

@@ -1,3 +1,8 @@
+# -*- coding: utf-8 -*-
+"""
+@author:XuMing(xuming624@qq.com)
+@description:
+"""
 from typing import Optional, List, Dict, Any
 from pathlib import Path
 import json

agentica-0.2.3/agentica/react_agent.py

@@ -0,0 +1,195 @@
+# -*- coding: utf-8 -*-
+"""
+A minimal implementation of a ReACT agent with support for multiple tools.
+"""
+import re
+from loguru import logger
+from openai import OpenAI
+
+# Registry to hold available actions
+action_registry = {}
+
+
+def register_action(action_name):
+    """Decorator to register an action in the action registry."""
+
+    def decorator(func):
+        action_registry[action_name] = func
+        return func
+
+    return decorator
+
+
+def parse_response(response):
+    """Parse the model's response into thoughts and actions."""
+    thoughts = []
+    actions = []
+    lines = response.split('\n')
+    for line in lines:
+        if line.startswith("Thought:"):
+            thoughts.append(line[len("Thought:"):].strip())
+        elif line.startswith("Action:"):
+            actions.append(line[len("Action:"):].strip())
+    return thoughts, actions
+
+
+def parse_action(action_str):
+    """Parse an action string into action name and parameters."""
+    match = re.match(r'^(\w+)\((.*)\)$', action_str)
+    if match:
+        action_name = match.group(1)
+        params = match.group(2)
+        # Remove parameter names and keep only values
+        params = re.sub(r'\w+=', '', params)
+        logger.debug(f"Action name: {action_name}, Params: {params}")
+        return action_name, params
+    else:
+        logger.warning(f"Invalid action string: {action_str}")
+        return None, None
+
+
+TOOL_DESC = """{name_for_model}: Call this tool to interact with the {name_for_human} API. What is the {name_for_human} API useful for? {description_for_model} Parameters: {parameters}"""
+
+PROMPT_REACT = """You are an assistant that uses the ReACT framework to answer questions. 
+
+First, describe your thought process in the "Thought:" section, then describe the action you will take in the "Action:" section. 
+Each section should start with its respective label. 
+Adjust your thoughts and actions based on the results of previous actions until you arrive at the final answer. 
+Ensure that each action is described in the format "Action: action_name(parameters)".
+Available actions include: 
+
+{tools_text}
+
+Begin!
+"""
+
+
+class ReactAgent:
+    """A ReACT agent that interacts with the OpenAI API to perform actions based on user queries."""
+
+    def __init__(self, model_name="gpt-4o", tools=None):
+        self.model_name = model_name
+        self.tools = tools or []
+        self.action_registry = action_registry
+        self.client = OpenAI()
+        self.logger = logger
+        self.system_prompt = self._generate_system_prompt()
+
+    def _generate_system_prompt(self):
+        tools_text = "\n".join([TOOL_DESC.format(**tool) for tool in self.tools])
+        return PROMPT_REACT.format(tools_text=tools_text)
+
+    def get_model_response(self, messages):
+        """Get a response from the OpenAI model."""
+        response = self.client.chat.completions.create(
+            model=self.model_name,
+            messages=messages
+        )
+        return response.choices[0].message.content
+
+    def run(self, user_query, max_iterations=5):
+        """Run the agent with the given user query."""
+        context = []
+        for _ in range(max_iterations):
+            messages = [
+                {"role": "system", "content": self.system_prompt.format(query=user_query)},
+                {"role": "user", "content": user_query},
+                *context
+            ]
+            self.logger.info(f"Messages: {messages}")
+            response = self.get_model_response(messages)
+            self.logger.info(f"Model response: {response}")
+            thoughts, actions = parse_response(response)
+            if not actions:
+                break
+            action_str = actions[0]
+            self.logger.info(f"Executing action: {action_str}")
+            action_result = self.execute_action(action_str)
+            if action_result.startswith("Action"):
+                action_result = action_result.split("Result: ")[-1]
+            self.logger.info(f"Action result: {action_result}")
+            context.append({
+                "role": "assistant",
+                "content": f"Thought: {thoughts}\nAction: {action_str}\nResult: {action_result}"
+            })
+        return response
+
+    def execute_action(self, action_str):
+        """Execute an action based on the action string."""
+        action_name, params = parse_action(action_str)
+        if action_name in self.action_registry:
+            try:
+                self.logger.debug(f"Executing action: {action_name} with params: {params}")
+                result = self.action_registry[action_name](params)
+                self.logger.debug(f"Action '{action_name}' executed successfully, Result: {result}")
+                return f"Action '{action_name}' executed successfully, Result: {result}"
+            except Exception as e:
+                self.logger.warning(f"Action '{action_name}' failed, Error: {str(e)}")
+                return f"Action '{action_name}' failed, Error: {str(e)}"
+        else:
+            return f"Unknown action '{action_name}'"
+
+
+if __name__ == '__main__':
+    @register_action("calculate")
+    def calculate(expression=""):
+        """Calculate the result of a mathematical expression."""
+        try:
+            result = eval(expression)
+            return result
+        except Exception as e:
+            return f"Error in calculation: {str(e)}"
+
+
+    @register_action("reverse_string")
+    def reverse_string(s=""):
+        """Reverse the input string."""
+        try:
+            logger.debug(f"Reversing string: {s}")
+            r = s[::-1]
+            logger.debug(f"Reversed string: {r}")
+            return r
+        except Exception as e:
+            return f"Error in reversing string: {str(e)}"
+
+
+    @register_action("text_length")
+    def text_length(s):
+        """Calculate the length of the input text string."""
+        try:
+            logger.debug(f"Calculating text length: {s}")
+            r = len(s)
+            logger.debug(f"Text length: {r}")
+            return r
+        except Exception as e:
+            return f"Error in calculating text length: {str(e)}"
+
+
+    tools = [
+        {
+            "name_for_model": "calculate",
+            "name_for_human": "Calculator",
+            "description_for_model": "useful for performing mathematical calculations.",
+            "parameters": "expression: a mathematical expression to evaluate."
+        },
+        {
+            "name_for_model": "reverse_string",
+            "name_for_human": "String Reverser",
+            "description_for_model": "useful for reversing strings.",
+            "parameters": "the string to reverse."
+        },
+        # get text string length
+        {
+            "name_for_model": "text_length",
+            "name_for_human": "Text Length Calculator",
+            "description_for_model": "useful for calculating the length of a text string.",
+            "parameters": "the text string to calculate the length."
+        }
+    ]
+
+    agent = ReactAgent(tools=tools)
+
+    # Run the agent with a query that requires both tools
+    response = agent.run(
+        "What is the result of reversing the string '123hello111---232323k23你好，水电费不着调。。。。--23' and then calculating the length of the reversed string, 不要包括引号")
+    logger.info(response)