AnyTool: AI Agent 的通用工具使用层

✨ 只需一行代码，即可为任何 Agent 注入快速、可扩展且强大的工具使用能力 ✨

| ⚡ 极速 - 闪电般的工具检索  |  📈 可扩展 - 自进化工具编排  |  ⚡ 强大 - 通用工具自动化 |

🎯 什么是 AnyTool？

AnyTool 是一个通用工具使用层（Universal Tool-Use Layer），旨在改变 AI Agent 与工具交互的方式。它解决了阻碍 Agent 可靠自动化实现的三大核心挑战：工具上下文过载、社区工具不可靠以及能力覆盖范围有限，为生产级 AI Agent 提供了首个真正智能的工具编排系统。

💡 研究亮点

⚡ 极速 - 闪电般的工具检索

• 智能上下文管理：通过多阶段流水线进行渐进式工具过滤，在毫秒级内精确匹配所需工具，消除上下文污染的同时保持高性能。

• 零浪费处理：预计算嵌入（Embeddings）和延迟初始化消除了冗余处理，确保工具在所有执行过程中即刻可用。

📈 可扩展 - 自进化工具编排

• 自适应 MCP 工具选择：通过智能缓存和选择性重索引，在 10 到 10,000 个工具的规模下保持性能恒定，实现资源利用率最优。

• 自进化工具优化：系统通过持久化记忆不断自我完善，随着工具生态系统的扩展，效率会逐步提升。

🌍 强大 - 通用工具自动化

• 质量感知选择：内置可靠性跟踪和安全控制，通过持久化学习和执行保障，提供生产就绪的自动化能力。

• 通用工具使用能力：多后端架构通过统一接口，无缝扩展至 Web API、系统操作、GUI 自动化及深度调研。

⚡ 简单易用，零门槛集成

只需一行代码即可实现智能工具编排。零配置设置将复杂的各种工具工作流转化为单次 API 调用。

from anytool import AnyTool

# 一行代码实现智能工具编排
async with AnyTool() as tool_layer:
    result = await tool_layer.execute(
        "Research trending AI coding tools from GitHub and tech news, "
        "collect their features and user feedback, analyze adoption patterns, "
        "then create a comparison report with insights"
    )

---

📋 目录

• 🎯 快速开始
• 🚀 技术创新与实现
• 🔧 配置指南
• 📖 代码结构
• 🔗 相关项目

---

🎯 快速开始

1. 环境准备

# 克隆仓库
git clone https://github.com/HKUDS/AnyTool.git
cd AnyTool

# 创建并激活 conda 环境 (包含用于视频录制的 ffmpeg)
conda create -n anytool python=3.12 ffmpeg -c conda-forge -y
conda activate anytool

# 安装依赖
pip install -r requirements.txt

[!NOTE] 请创建一个 .env 文件并添加您的 API 密钥（参考 anytool/.env.example）。

2. 执行模式：本地 vs 服务器

AnyTool 的 Shell 和 GUI 后端支持两种执行模式。您可以在 anytool/config/config_grounding.json 中配置模式：

{
  "shell": { "mode": "local", ... },  // 或 "server"
  "gui":   { "mode": "local", ... }   // 或 "server"
}

本地模式（默认 — 无需服务器）

在本地模式下，Shell 和 GUI 操作通过 subprocess / asyncio 直接在进程内执行。这是最简单的设置方式 — 无需本地服务器。像往常一样使用 AnyTool 即可，具体使用示例请参见 快速集成。

[!TIP] 当您在希望控制的同一台机器（个人笔记本/台式机）上运行 AnyTool 时，建议使用本地模式。 这是大多数用户的推荐模式。

服务器模式（适用于远程虚拟机 / 隔离环境）

在服务器模式下，Shell 和 GUI 操作通过 HTTP 发送到正在运行的 local_server Flask 服务。在以下情况下需要使用此模式：

• 控制远程 VM — Agent 在宿主机上运行，而服务在 VM 内部运行。
• 进程隔离 / 沙箱 — 为了安全或稳定性，希望在独立进程中执行脚本。
• 多机部署 — Agent 和执行环境位于不同的机器上。

要使用服务器模式，请运行：