> ## Documentation Index
> Fetch the complete documentation index at: https://ikun.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 编写自己的 Toolkit

许多高级用例都需要您编写自定义的 Toolkits。以下是通用流程：

1. 创建一个继承 `agno.tools.Toolkit` 类的类。
2. 将您的函数添加到该类中。
3. **重要提示：** 在 `Toolkit` 构造函数的 `tools` 参数中包含所有函数。

现在您的 Toolkit 已准备好与 Agent 一起使用。例如：

```python shell_toolkit.py theme={null}
from typing import List

from agno.agent import Agent
from agno.tools import Toolkit
from agno.utils.log import logger

class ShellTools(Toolkit):
    def __init__(self, **kwargs):
        super().__init__(name="shell_tools", tools=[self.run_shell_command], **kwargs)

    def run_shell_command(self, args: List[str], tail: int = 100) -> str:
        """
        运行一个 shell 命令并返回输出或错误。

        Args:
            args (List[str]): 要运行的命令，以字符串列表形式表示。
            tail (int): 要从输出中返回的行数。
        Returns:
            str: 命令的输出。
        """
        import subprocess

        logger.info(f"Running shell command: {args}")
        try:
            logger.info(f"Running shell command: {args}")
            result = subprocess.run(args, capture_output=True, text=True)
            logger.debug(f"Result: {result}")
            logger.debug(f"Return code: {result.returncode}")
            if result.returncode != 0:
                return f"Error: {result.stderr}"
            # return only the last n lines of the output
            return "\n".join(result.stdout.split("\n")[-tail:])
        except Exception as e:
            logger.warning(f"Failed to run shell command: {e}")
            return f"Error: {e}"

agent = Agent(tools=[ShellTools()], show_tool_calls=True, markdown=True)
agent.print_response("List all the files in my home directory.")

```