🇨🇳中文 | 🌐English | 🇯🇵日本語

Agentica 是一个轻量级、功能强大的 Python 框架，用于构建、管理和部署自主 AI 智能体。

无论您是想创建一个简单的聊天机器人、一个复杂的研究助理，还是一个由专业智能体组成的协作团队，Agentica 都能为您提供所需的工具和抽象，助您更快实现目标。我们采用开发者优先的设计方法，简化了 RAG、多智能体工作流和长期记忆等高级功能，让每一位开发者都能轻松上手。

• 开发者优先的 API：简洁、直观、面向对象的接口，易于学习，使用愉快。
• 模块化与可扩展：轻松替换 LLM、记忆后端和向量存储等组件。
• 功能完备：开箱即用，提供丰富的内置工具（网络搜索、代码解释器、文件读写）、记忆类型和高级 RAG 功能。
• 高级功能，简化实现：轻松实现多智能体协作（团队）、任务分解（工作流）和自我反思等复杂模式。
• 生产就绪：通过命令行界面、Web UI 或作为服务部署您的智能体。同时支持模型上下文协议（MCP），实现标准化工具集成。
• Agent Skill 支持：基于 Prompt Engineering 的技能系统，将技能说明注入 System Prompt，任何支持 tool calling 的模型都可使用。

• 🤖 核心智能体能力：构建具备复杂规划、反思、短期和长期记忆以及强大工具使用能力的智能体。
• 🧩 高级编排：
  • 多智能体团队：创建由专业智能体组成的团队，协作解决问题。
  • 工作流：将复杂任务分解为一系列步骤，由不同的智能体或工具执行。
• 🛡️ 安全守卫（Guardrails）：
  • 输入/输出守卫：在智能体处理前验证用户输入，在返回前检查智能体输出。
  • 工具守卫：在工具执行前验证参数，在返回结果前过滤敏感数据。
  • 三种行为模式：允许（allow）、拒绝并继续（reject_content）、抛出异常（raise_exception）。
• 🎯 Agent Skill 技能系统：
  • Prompt Engineering 技术：Skill 是一种文本指令，不是代码级别的能力扩展。
  • 实现方式：解析 SKILL.md 的元数据，将技能描述注入 System Prompt。
  • 执行流程：LLM 阅读技能说明后，使用基础 tools（shell、python、file viewer）执行任务。
  • 模型无关：任何支持 tool calling 的模型都可以使用，因为 skill 只是文本指令。
  • 优势：可扩展、模型无关、易于维护（只需更新 Markdown 文档）。
• 🛠️ 丰富的工具生态：
  • 大量内置工具（网络搜索、OCR、图像生成、Shell 命令）。
  • 轻松创建您自己的自定义工具。
  • 一流的**模型上下文协议（MCP）**支持，实现标准化工具集成。
• 📚 灵活的 RAG 流程：
  • 内置知识库管理和文档解析（PDF、文本）。
  • 混合检索策略和结果重排序，以实现最高准确性。
  • 与 LangChain 和 LlamaIndex 等流行库集成。
• 🌌 多模态支持：构建能够理解和生成文本、图像、音频和视频的智能体。
• 🧠 广泛的 LLM 兼容性：支持来自 OpenAI、Azure、Deepseek、Moonshot、Anthropic、智谱AI、Ollama、Together 等提供商的数十种模型。
• 💡 自我进化智能体：具备反思和记忆增强能力的智能体，能够自我进化。

Agentica 的模块化设计实现了最大的灵活性和可扩展性。其核心是 Agent、Model、Tool 和 Memory 组件，这些组件可以轻松组合和扩展，以创建强大的应用程序。

pip install -U agentica

从源码安装：

git clone https://github.com/shibing624/agentica.git
cd agentica
pip install .

1. 设置您的 API 密钥。 在 ~/.agentica/.env 路径下创建一个文件，或设置环境变量。

   # 智谱AI ZhipuAI, glm-4.6v-flash 免费用，支持工具调用，128k
   export ZHIPUAI_API_KEY="your-api-key"

2. 运行您的第一个智能体！ 这个例子创建了一个可以查询天气的智能体。

   from agentica import Agent, ZhipuAI, WeatherTool
   
   # 初始化一个带模型和天气工具的智能体
   agent = Agent(
       model=ZhipuAI(),
       tools=[WeatherTool()],
       # 为智能体提供时间概念，以便回答"明天"等问题
       add_datetime_to_instructions=True  
   )
   
   # 向智能体提问
   agent.print_response("明天北京天气怎么样？")

   输出：

   明天北京的天气预报如下：
   
   - 早晨：晴朗，气温约18°C，风速较小，约为3 km/h。
   - 中午：晴朗，气温升至23°C，风速6-7 km/h。
   - 傍晚：晴朗，气温略降至21°C，风速较大，为35-44 km/h。
   - 夜晚：晴朗转晴，气温下降至15°C，风速32-39 km/h。
   
   全天无降水，能见度良好。请注意傍晚时分的风速较大，外出时需注意安全。

• Agent：思考、决策和执行动作的核心组件。它将模型、工具和记忆连接在一起。
• Model：智能体的"大脑"。通常是一个大型语言模型（LLM），为智能体的推理能力提供动力。
• Tool：智能体可用于与外部世界交互的功能或能力（例如，搜索网页、运行代码、访问数据库）。
• Memory：允许智能体记住过去的交互（短期记忆）并存储关键信息以供日后调用（长期记忆）。
• Knowledge：外部知识源（如文档集合），智能体可以使用检索增强生成（RAG）进行查询。
• Workflow/Team：用于编排复杂、多步骤任务或管理多个智能体之间协作的高级结构。

浏览我们全面的示例，了解 Agentica 的无限可能：

➡️ 查看所有示例

直接从终端与您的智能体互动。

# 安装 agentica
pip install -U agentica

# 运行单个查询
agentica --query "下一届奥运会在哪里举办？" --model_provider zhipuai --model_name glm-4.6v-flash --tools baidu_search

# 启动交互式聊天会话
agentica --model_provider zhipuai --model_name glm-4.6v-flash

CLI show case (实现ClaudeCode效果):

Agentica 与 ChatPilot 完全兼容，为您的智能体提供功能丰富、基于 Gradio 的 Web 界面。

请查看 ChatPilot 仓库了解设置说明。

• GitHub Issues：有任何问题或功能请求？提交 issue。
• 微信：加入我们的开发者社群！添加微信号 xuming624，并备注"agentica"，即可加入群聊。

如果您在研究中使用了 Agentica，请按以下格式引用：

@misc{agentica,
  author = {Ming Xu},
  title = {Agentica: Effortlessly Build Intelligent, Reflective, and Collaborative Multimodal AI Agents},
  year = {2025},
  publisher = {GitHub},
  journal = {GitHub Repository},
  howpublished = {\url{https://github.com/shibing624/agentica}},
}

Agentica 采用 Apache License 2.0 授权。

我们欢迎各种形式的贡献！请查看我们的贡献指南以开始。

我们的工作受到了许多优秀项目的启发和帮助。我们在此感谢以下项目团队：

• langchain-ai/langchain
• phidatahq/phidata
• simonmesmith/agentflow