Repository files navigation

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

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

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

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

• 🤖 核心智能体能力：构建具备复杂规划、反思、短期和长期记忆以及强大工具使用能力的智能体。
• 🧩 高级编排：
  • 多智能体团队：创建由专业智能体组成的团队，协作解决问题。
  • 工作流：将复杂任务分解为一系列步骤，由不同的智能体或工具执行。
• 🛠️ 丰富的工具生态：
  • 大量内置工具（网络搜索、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.gitcd agenticapip install.

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

   # 月之暗面 Moonshot AIexport MOONSHOT_API_KEY="your-api-key"# 智谱AI ZhipuAIexport ZHIPUAI_API_KEY="your-api-key"# 搜索工具export SERPER_API_KEY="your-serper-api-key"

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

   fromagenticaimportAgent,Moonshot,WeatherTool# 初始化一个带模型和天气工具的智能体weather_agent=Agent(model=Moonshot(),tools=[WeatherTool()],# 为智能体提供时间概念，以便回答“明天”等问题add_datetime_to_instructions=True  )# 向智能体提问weather_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 的无限可能：

➡️查看所有示例

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

# 安装 agenticapip install -U agentica# 运行单个查询agentica --query"下一届奥运会在哪里举办？" --model_provider zhipuai --model_name glm-4-flash --tools web_search_pro# 启动交互式聊天会话agentica --model_provider zhipuai --model_name glm-4-flash --tools web_search_pro cogview --verbose 1

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 ={2024},publisher ={GitHub},journal ={GitHub Repository},howpublished ={\url{https://github.com/shibing624/agentica}},}

Agentica 采用Apache License 2.0 授权。

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

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

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