跳转至

Agentica

轻量级、功能强大的 Python 框架,用于构建自主 AI 智能体。

Logo

PyPI version Downloads License Apache 2.0 Python 3.12+


为什么选择 Agentica?

  • Async-First 架构 -- 所有核心方法原生 async,同步适配器无缝兼容。
  • 开发者友好 -- 简洁直观的面向对象 API,极低学习曲线。
  • 模块化可扩展 -- 模型、记忆后端、向量存储均可自由替换。
  • 功能完备 -- 内置 40+ 工具、RAG、多智能体团队、工作流编排、安全守卫。
  • 生产就绪 -- CLI / Web UI / API 服务多种部署方式,支持 MCP 与 ACP 协议。

系统架构

Architecture

快速导航

文档 内容
入门
What is Agentica 项目定位与核心特性
架构总览 五层架构与数据流
安装 安装与环境配置
快速入门 5 分钟上手
CLI 终端 命令行交互模式
核心概念
Agent Agent 核心概念、Model、Memory、Tools
Model 20+ 模型提供商
Tools 内置工具与自定义工具
Memory & Workspace 记忆系统与工作空间
Knowledge (RAG) 知识库、向量检索
多智能体
Team 动态委派团队协作
Workflow 确定性工作流编排
Swarm 自主多智能体协作
Subagent 子任务委派
高级功能
Hooks 生命周期钩子
RunConfig 运行时配置(超时、成本、白名单)
Guardrails 4 层安全守卫
Context Compression 上下文压缩
Skills Markdown Skill 系统
MCP Model Context Protocol
ACP Agent Client Protocol
参考
模型提供商 全部模型配置指南
最佳实践 设计原则与生产部署
Agent API 完整 API 参考

30 秒上手

pip install -U agentica
export ZHIPUAI_API_KEY="your-api-key"
import asyncio
from agentica import Agent, ZhipuAI

async def main():
    agent = Agent(model=ZhipuAI())
    result = await agent.run("一句话介绍北京")
    print(result.content)

asyncio.run(main())
北京是中国的首都,是一座拥有三千多年历史的文化名城,也是全国的政治、文化和国际交流中心。

查看完整快速入门 ->

社区与支持

  • GitHub Issues -- 提交 issue
  • 微信交流群 -- 添加微信号 xuming624,备注 "llm"

许可证

Apache License 2.0