Mini Agent是一个极简但专业的演示项目，旨在展示使用 MiniMax M2 模型构建 Agent 的最佳实践。项目通过兼容 Anthropic 的 API，完全支持交错思维（interleaved thinking），从而解锁 M2 模型在处理长而复杂的任务时强大的推理能力。
该项目具备一系列为稳健、智能的 Agent 开发而设计的特性：
- ✅完整的 Agent 执行循环：一个完整可靠的执行框架，配备了文件系统和 Shell 操作的基础工具集。
- ✅持久化记忆：通过内置的Session Note Tool，Agent 能够在多个会话中保留关键信息。
- ✅智能上下文管理：自动对会话历史进行摘要，可处理长达可配置 Token 上限的上下文，从而支持无限长的任务。
- ✅集成 Claude Skills：内置 15 种专业技能，涵盖文档处理、设计、测试和开发等领域。
- ✅集成 MCP 工具：原生支持 MCP 协议，可轻松接入知识图谱、网页搜索等工具。
- ✅全面的日志记录：为每个请求、响应和工具执行提供详细日志，便于调试。
- ✅简洁明了的设计：美观的命令行界面和易于理解的代码库，使其成为构建高级 Agent 的理想起点。
- 使用实例 -
这里有几个 Mini Agent 能力的演示。
1.任务执行
在这个演示中，我们要求 Agent 创建一个简洁美观的网页并在浏览器中显示它，以此展示基础的工具使用循环。
2.使用 Claude Skill（例如：PDF 生成）
这里，Agent 利用 Claude Skill 根据用户请求创建专业文档（如 PDF 或 DOCX），展示了其强大的高级能力。
3.网页搜索与摘要（MCP 工具）
此演示展示了 Agent 如何使用其网页搜索工具在线查找最新信息，并为用户进行总结。
- 快速开始 -
1. 获取 API Key
MiniMax 提供国内和海外两个平台，请根据您的网络环境选择：
国内版平台地址：platform.minimaxi.com
国内 API Base：api.minimaxi.com
海外版平台地址：platform.minimax.io
海外 API Base：api.minimax.io
获取步骤：
1.访问相应平台注册并登录
2.进入账户管理 > API 密钥
3.点击“创建新密钥”
4.复制并妥善保存（密钥仅显示一次）
💡提示：请记住您所选平台对应的 API Base 地址，后续配置时会用到。
2. 选择使用模式
前置要求：安装 uv
两种使用模式都需要 uv。如果您尚未安装：
# macOS/Linux/WSL curl -LsSf https://astral.sh/uv/install.sh | sh # Windows (PowerShell) python -m pip install --user pipx python -m pipx ensurepath # 安装后需要重启 PowerShell # 安装完成后，重启终端或运行： source ~/.bashrc # 或 ~/.zshrc (macOS/Linux)我们提供两种使用模式，请根据您的需求选择：
🚀 快速上手模式（推荐新手）
此模式适合希望快速体验 Mini Agent，而无需克隆代码仓库或修改代码的用户。
安装步骤：
# 1. 直接从 GitHub 安装 uv tool install git+https://github.com/MiniMax-AI/Mini-Agent.git # 2. 运行配置脚本（自动创建配置文件） # macOS/Linux: curl -fsSL https://raw.githubusercontent.com/MiniMax-AI/Mini-Agent/main/scripts/setup-config.sh | bash # Windows (PowerShell): Invoke-WebRequest -Uri "https://raw.githubusercontent.com/MiniMax-AI/Mini-Agent/main/scripts/setup-config.ps1" -OutFile "$env:TEMP\setup-config.ps1" powershell -ExecutionPolicy Bypass -File "$env:TEMP\setup-config.ps1"💡提示：如果您希望在本地进行开发或修改代码，请使用下方的"开发模式"。
配置步骤：
配置脚本会在~/.mini-agent/config/目录下创建配置文件，请编辑该文件：
# 编辑配置文件 nano ~/.mini-agent/config/config.yaml填入您的 API Key 和对应的 API Base：
api_key: "YOUR_API_KEY_HERE" # 填入第1步获取的API Key api_base: "https://api.minimaxi.com" # 国内版 # api_base: "https://api.minimax.io" # 海外版（如使用海外平台，请取消本行注释） model: "MiniMax-M2"开始使用：
mini-agent # 使用当前目录作为工作空间 mini-agent --workspace /path/to/your/project # 指定工作空间目录 mini-agent --version # 查看版本信息 # 管理命令 uv tool upgrade mini-agent # 升级到最新版本 uv tool uninstall mini-agent # 卸载工具（如需要） uv tool list # 查看所有已安装的工具🔧 开发模式
此模式适合需要修改代码、添加功能或进行调试的开发者。
安装与配置步骤：
# 1. 克隆仓库 git clone https://github.com/MiniMax-AI/Mini-Agent.git cd Mini-Agent # 2. 安装 uv（如果尚未安装） # macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh # Windows (PowerShell): irm https://astral.sh/uv/install.ps1 | iex # 安装后需要重启终端 # 3. 同步依赖 uv sync # 替代方案: 手动安装依赖（如果不使用 uv） # pip install -r requirements.txt # 或者安装必需的包: # pip install tiktoken pyyaml httpx pydantic requests prompt-toolkit mcp # 4. 初始化 Claude Skills（可选） git submodule update --init --recursive # 5. 复制配置模板macOS/Linux:
cp mini_agent/config/config-example.yaml mini_agent/config/config.yamlWindows:
Copy-Item mini_agent\config\config-example.yaml mini_agent\config\config.yaml # 6. 编辑配置文件 vim mini_agent/config/config.yaml # 或使用您偏好的编辑器填入您的 API Key 和对应的 API Base：
api_key: "YOUR_API_KEY_HERE" # 填入第 1 步获取的 API Key api_base: "https://api.minimaxi.com" # 国内版 # api_base: "https://api.minimax.io" # 海外版（如使用海外平台，请修改此行） model: "MiniMax-M2" max_steps: 100 workspace_dir: "./workspace"📖 完整的配置指南，请参阅 config-example.yaml
运行方式：
选择您偏好的方式运行：
# 方式 1：作为模块直接运行（适合调试） uv run python -m mini_agent.cli # 方式 2：以可编辑模式安装（推荐） uv tool install -e . # 安装后，您可以在任何路径下运行，且代码更改会立即生效 mini-agent mini-agent --workspace /path/to/your/project📖 更多开发指引，请参阅开发指南：
https://github.com/MiniMax-AI/Mini-Agent/blob/main/docs/DEVELOPMENT_GUIDE_CN.md
📖 更多生产部署指引，请参阅生产指南：
https://github.com/MiniMax-AI/Mini-Agent/blob/main/docs/PRODUCTION_GUIDE_CN.md
- ACP & Zed Editor 集成（可选）-
Mini Agent 支持 Agent Communication Protocol (ACP)，可与 Zed 等代码编辑器集成。
在 Zed Editor 中设置：
1.以开发模式或工具模式安装 Mini Agent
2.在您的 Zedsettings.json中添加：
{ "agent_servers": { "mini-agent": { "command": "/path/to/mini-agent-acp" } } }命令路径应为：
- 通过
uv tool install安装：使用which mini-agent-acp的输出结果 - 开发模式：
./mini_agent/acp/server.py
使用方法：
- 使用
Ctrl+Shift+P→ “Agent: Toggle Panel” 打开 Zed 的 Agent 面板 - 从 Agent 下拉列表中选择 “mini-agent”
- 直接在编辑器中开始与 Mini Agent 对话
- 测试 -
项目包含了覆盖单元测试、功能测试和集成测试的全面测试用例。
快速运行
# 运行所有测试 pytest tests/ -v # 仅运行核心功能测试 pytest tests/test_agent.py tests/test_note_tool.py -v测试覆盖范围
- ✅单元测试- 工具类、LLM 客户端
- ✅功能测试- Session Note Tool、MCP 加载
- ✅集成测试- Agent 端到端执行
- ✅外部服务- Git MCP 服务器加载
学AI大模型的正确顺序，千万不要搞错了
🤔2026年AI风口已来！各行各业的AI渗透肉眼可见，超多公司要么转型做AI相关产品，要么高薪挖AI技术人才，机遇直接摆在眼前！
有往AI方向发展，或者本身有后端编程基础的朋友，直接冲AI大模型应用开发转岗超合适！
就算暂时不打算转岗，了解大模型、RAG、Prompt、Agent这些热门概念，能上手做简单项目，也绝对是求职加分王🔋
📝给大家整理了超全最新的AI大模型应用开发学习清单和资料，手把手帮你快速入门！👇👇
学习路线:
✅大模型基础认知—大模型核心原理、发展历程、主流模型（GPT、文心一言等）特点解析
✅核心技术模块—RAG检索增强生成、Prompt工程实战、Agent智能体开发逻辑
✅开发基础能力—Python进阶、API接口调用、大模型开发框架（LangChain等）实操
✅应用场景开发—智能问答系统、企业知识库、AIGC内容生成工具、行业定制化大模型应用
✅项目落地流程—需求拆解、技术选型、模型调优、测试上线、运维迭代
✅面试求职冲刺—岗位JD解析、简历AI项目包装、高频面试题汇总、模拟面经
以上6大模块，看似清晰好上手，实则每个部分都有扎实的核心内容需要吃透！
我把大模型的学习全流程已经整理📚好了！抓住AI时代风口，轻松解锁职业新可能，希望大家都能把握机遇，实现薪资/职业跃迁～
