🤖 Agent 框架

Mini-Agent

使用 MiniMax M2.7 构建 Agent 的最佳实践 — 完整执行框架、持久化记忆、智能上下文管理、15种 Claude Skills、MCP 工具集成、开箱即用。

✨ 核心特性

🔄

完整执行循环

完整可靠的执行框架，配备文件系统和 Shell 操作的基础工具集

🧠

持久化记忆

通过内置 Session Note Tool，Agent 能够在多个会话中保留关键信息

📜

智能上下文管理

自动对会话历史进行摘要，可处理可配置 Token 上限的上下文，支持无限长任务

🛠️

Claude Skills

内置 15 种专业技能，涵盖文档处理、设计、测试和开发等领域

🔌

MCP 工具集成

原生支持 MCP 协议，可轻松接入知识图谱、网页搜索等工具

📋

全面日志记录

为每个请求、响应和工具执行提供详细日志，便于调试

💡 设计理念： Mini-Agent 通过兼容 Anthropic 的 API，完全支持交错思维链（interleaved thinking），从而解锁模型在处理长而复杂的任务时强大的推理能力。简洁明了的设计使其成为构建高级 Agent 的理想起点。

💡 使用示例

任务执行

要求 Agent 创建一个简洁美观的网页并在浏览器中显示它，展示基础的工具使用循环。

使用 Claude Skill（如 PDF 生成）

Agent 利用 Claude Skill 根据用户请求创建专业文档（如 PDF 或 DOCX），展示了其强大的高级能力。

网页搜索与摘要（MCP 工具）

Agent 使用网页搜索工具在线查找最新信息，并为用户进行总结。

🚀 快速开始

安装 uv

curl -LsSf https://astral.sh/uv/install.sh | sh

安装完成后，重启终端或运行：source ~/.bashrc（或 source ~/.zshrc）

安装 Mini Agent

uv tool install git+https://github.com/MiniMax-AI/Mini-Agent.git

运行配置脚本

curl -fsSL https://raw.githubusercontent.com/MiniMax-AI/Mini-Agent/main/scripts/setup-config.sh | bash

配置 API Key

编辑配置文件 ~/.mini-agent/config/config.yaml：

api_key: "YOUR_API_KEY_HERE"  # 填入您的 API Key
api_base: "https://api.minimaxi.com"  # 国内版
# api_base: "https://api.minimax.io"  # 海外版
model: "MiniMax-M2.7"

开始使用

# 使用当前目录作为工作空间
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 sync

# 3. 初始化 Claude Skills（可选）
git submodule update --init --recursive

# 4. 复制配置模板
cp mini_agent/config/config-example.yaml mini_agent/config/config.yaml

# 5. 编辑配置文件
vim mini_agent/config/config.yaml

填入您的 API Key：

api_key: "YOUR_API_KEY_HERE"
api_base: "https://api.minimaxi.com"  # 国内
# api_base: "https://api.minimax.io"  # 海外
model: "MiniMax-M2.7"
max_steps: 100
workspace_dir: "./workspace"

运行方式

# 方式 1：作为模块直接运行（适合调试）
uv run python -m mini_agent.cli

# 方式 2：以可编辑模式安装（推荐）
uv tool install -e . mini-agent
mini-agent --workspace /path/to/your/project

⚡ ACP & Zed Editor 集成

Mini Agent 支持 Agent Communication Protocol（ACP），可与 Zed 等代码编辑器集成。

在 Zed Editor 中设置

以开发模式或工具模式安装 Mini Agent

在 Zed settings.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" 打开 Agent 面板

Agent 下拉列表 → 选择 "mini-agent"

直接在编辑器中 → 开始与 Mini Agent 对话

📝 总结

安装：uv tool install git+https://github.com/MiniMax-AI/Mini-Agent.git
配置：~/.mini-agent/config/config.yaml 填入 API Key 和 api_base
核心：完整执行框架 + 持久化记忆 + 智能上下文摘要 + 15种 Claude Skills
MCP 原生支持：可接入网页搜索、知识图谱等工具
开发模式：uv sync + uv run python -m mini_agent.cli
Zed 集成：通过 ACP 协议在 Zed Editor 中使用 Mini Agent
GitHub: https://github.com/MiniMax-AI/Mini-Agent

来源：MiniMax 开放平台 · Mini-Agent 指南 · platform.minimaxi.com/docs/token-plan/mini-agent