AI Agent 接入指南
Next API 支持所有主流 AI Agent 工具,只需简单配置即可使用。
🤖 什么是 AI Agent?
AI Agent 是能自动执行任务的 AI 助手,可以:
- 💻 自动写代码、改代码
- 📝 自动写文档、发邮件
- 🔍 自动搜索、整理信息
- 🛠️ 自动完成复杂工作流
Next API 支持的 AI Agent 工具:
| 工具 | 类型 | 特点 | 难度 |
|---|---|---|---|
| Hermes Agent | 自主 Agent | 自我学习、多平台 | ⭐⭐⭐ 进阶 |
| Cursor | 代码编辑器 | AI 写代码 | ⭐ 简单 |
| Windsurf | 代码编辑器 | AI 原生 IDE | ⭐ 简单 |
| Continue | VS Code 插件 | 免费、灵活 | ⭐⭐ 中等 |
| Aider | 终端工具 | Git 集成 | ⭐⭐ 中等 |
🚀 快速选择
我是小白,想快速上手
推荐:Cursor(最简单)
- ✅ 图形界面,无需命令行
- ✅ 自动补全、代码生成
- ✅ 5分钟配置完成
我想用免费工具
推荐:Continue(完全免费)
- ✅ VS Code 插件
- ✅ 支持多种模型
- ✅ 开源免费
我想用最强大的 Agent
推荐:Hermes Agent(自我学习)
- ✅ 自主执行任务
- ✅ 自动学习改进
- ✅ 多平台支持
我想在终端用 AI
推荐:Aider(终端原生)
- ✅ 命令行工具
- ✅ Git 自动提交
- ✅ 多模型支持
Cursor
什么是 Cursor?
Cursor 是 AI 原生代码编辑器,可以:
- 💻 AI 自动写代码
- 🔧 AI 修改代码
- 💡 AI 解释代码
- 🐛 AI 修复 Bug
安装 Cursor
- 访问 Cursor 官网
- 下载对应系统版本
- 安装并打开
配置 Next API
方法一:图形界面配置
- 打开 Cursor
- 点击右上角 ⚙️ 设置
- 选择 Models → OpenAI API Key
- 输入以下信息:
- API Key:
sk-你的密钥 - Base URL:
https://api.nextapi.pro/v1
- API Key:
- 点击 Verify 验证
- 保存设置
方法二:配置文件
编辑 ~/.cursor/config.json:
json
{
"openai": {
"apiKey": "sk-你的密钥",
"baseUrl": "https://api.nextapi.pro/v1"
}
}开始使用
- 打开一个代码文件
- 按
Cmd+K(Mac)或Ctrl+K(Windows) - 输入你的需求,例如:
- "写一个 Python 爬虫"
- "修复这个 Bug"
- "优化这段代码"
- AI 会自动生成代码
推荐模型
| 任务 | 推荐模型 |
|---|---|
| 写代码 | claude-sonnet-4-6 或 deepseek-v3.1 |
| 解释代码 | gpt-4o-mini |
| 优化代码 | gpt-4o |
Windsurf
什么是 Windsurf?
Windsurf 是 Codeium 团队开发的 AI 原生 IDE,特点:
- 🌊 Cascade:深度上下文 AI Agent
- 🔄 自动读取代码库
- 🛠️ 自动执行命令
安装 Windsurf
- 访问 Windsurf 官网
- 下载对应系统版本
- 安装并打开
配置 Next API
- 打开 Windsurf
- 按
Cmd+,(Mac)或Ctrl+,(Windows)打开设置 - 搜索 OpenAI
- 输入以下信息:
- API Key:
sk-你的密钥 - Base URL:
https://api.nextapi.pro/v1
- API Key:
- 保存设置
开始使用
- 打开项目文件夹
- 按
Cmd+I(Mac)或Ctrl+I(Windows)打开 Cascade - 输入你的需求,例如:
- "创建一个 React 组件"
- "重构这个模块"
- "添加单元测试"
- Cascade 会自动执行
Cascade 特点
- ✅ 自动读取相关文件
- ✅ 自动创建文件
- ✅ 自动运行命令
- ✅ 自动安装依赖
Continue
什么是 Continue?
Continue 是开源的 VS Code AI 插件,特点:
- 💰 完全免费
- 🔧 灵活配置
- 🤖 支持多种模型
安装 Continue
- 打开 VS Code
- 按
Cmd+Shift+X(Mac)或Ctrl+Shift+X(Windows) - 搜索 Continue
- 点击 Install
- 重启 VS Code
配置 Next API
- 打开 VS Code
- 按
Cmd+Shift+P(Mac)或Ctrl+Shift+P(Windows) - 输入 Continue: Open Settings
- 编辑
config.json:
json
{
"models": [
{
"title": "Next API GPT-4o",
"provider": "openai",
"model": "gpt-4o",
"apiKey": "sk-你的密钥",
"apiBase": "https://api.nextapi.pro/v1"
},
{
"title": "Next API Claude",
"provider": "openai",
"model": "claude-sonnet-4-6",
"apiKey": "sk-你的密钥",
"apiBase": "https://api.nextapi.pro/v1"
}
]
}开始使用
- 打开代码文件
- 按
Cmd+L(Mac)或Ctrl+L(Windows)打开 Continue - 输入你的问题或需求
- AI 会自动回答或生成代码
快捷键
| 快捷键 | 功能 |
|---|---|
Cmd+L / Ctrl+L | 打开 Continue |
Cmd+I / Ctrl+I | 内联编辑 |
Cmd+Shift+R / Ctrl+Shift+R | 解释代码 |
Aider
什么是 Aider?
Aider 是终端 AI 编程助手,特点:
- 💻 命令行工具
- 🔄 Git 自动提交
- 📝 多文件编辑
安装 Aider
bash
# 使用 pip 安装
pip install aider-chat
# 或使用 brew 安装(macOS)
brew install aider配置 Next API
方法一:环境变量
bash
# 设置 API Key
export OPENAI_API_KEY="sk-你的密钥"
# 设置 Base URL
export OPENAI_API_BASE="https://api.nextapi.pro/v1"方法二:配置文件
创建 ~/.aider.conf.yml:
yaml
api-key: sk-你的密钥
api-base: https://api.nextapi.pro/v1
model: gpt-4o开始使用
bash
# 进入项目目录
cd your-project
# 启动 aider
aider
# 添加文件到上下文
aider> add main.py utils.py
# 输入你的需求
aider> 写一个函数,读取 JSON 文件并返回字典
# AI 会自动编辑文件并提交到 Git常用命令
| 命令 | 功能 |
|---|---|
add <file> | 添加文件到上下文 |
drop <file> | 移除文件 |
clear | 清空上下文 |
undo | 撤销上次修改 |
diff | 查看修改 |
Hermes Agent
什么是 Hermes Agent?
Hermes Agent 是 Nous Research 开发的自主 AI Agent,特点:
- 🧠 自我学习:自动生成技能文档
- 🔄 多平台:支持 Telegram、Discord、Slack 等
- 🛠️ 工具调用:自动执行命令
- 📚 记忆系统:长期记忆
安装 Hermes Agent
macOS / Linux:
bash
# 一键安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 重新加载配置
source ~/.bashrc # 或 source ~/.zshrc
# 验证安装
hermes --versionWindows (WSL2):
bash
# 安装 WSL2
wsl --install
# 在 WSL2 中运行安装命令
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash配置 Next API
步骤 1:初始化
bash
# 运行初始化向导
hermes init
# 选择模型提供商
? Choose LLM provider: OpenAI
# 输入 API Key
? API Key: sk-你的密钥
# 输入 Base URL
? Base URL: https://api.nextapi.pro/v1
# 选择模型
? Model: gpt-4o-mini步骤 2:配置文件
编辑 ~/.hermes/config.yaml:
yaml
llm:
provider: openai
api_key: sk-你的密钥
base_url: https://api.nextapi.pro/v1
model: gpt-4o-mini
# 可选:配置消息平台
channels:
- type: telegram
token: YOUR_BOT_TOKEN
chat_id: YOUR_CHAT_ID开始使用
终端模式:
bash
# 启动交互式聊天
hermes
# 输入你的需求
You: 帮我写一个 Python 脚本,监控网站变化
# Hermes 会自动:
# 1. 分析需求
# 2. 编写代码
# 3. 测试代码
# 4. 生成技能文档Telegram 模式:
bash
# 配置 Telegram Bot
hermes setup --telegram
# 启动 Bot
hermes start --telegram
# 在 Telegram 中与 Hermes 对话Hermes 特点
1. 自我学习
Hermes 会自动生成技能文档:
markdown
# skill: website-monitor
## 描述
监控网站变化并发送通知
## 使用场景
- 监控网站更新
- 监控价格变化
- 监控新闻发布
## 代码示例
...2. 多平台支持
- ✅ Telegram
- ✅ Discord
- ✅ Slack
- ✅ Signal
3. 工具调用
Hermes 可以:
- 执行终端命令
- 读写文件
- 搜索网络
- 调用 API
推荐配置
| 任务 | 推荐模型 |
|---|---|
| 日常对话 | gpt-4o-mini |
| 复杂任务 | gpt-4o |
| 写代码 | claude-sonnet-4-6 |
💡 使用技巧
1. 选择合适的模型
| 场景 | 推荐模型 | 原因 |
|---|---|---|
| 简单对话 | gpt-4o-mini | 便宜快速 |
| 写代码 | claude-sonnet-4-6 或 deepseek-v3.1 | 代码能力强 |
| 复杂推理 | gpt-4o | 性能强 |
| 中文任务 | qwen3-max | 中文效果好 |
2. 提示词技巧
好的提示词:
写一个 Python 函数,输入 URL,返回网页标题。
要求:
1. 使用 requests 库
2. 添加错误处理
3. 添加超时设置不好的提示词:
写个函数3. 上下文管理
- ✅ 只添加相关文件
- ✅ 定期清理上下文
- ✅ 使用
.gitignore排除文件
4. 成本控制
- 使用
gpt-4o-mini进行简单任务 - 使用
max_tokens限制输出 - 使用流式输出提前终止
❓ 常见问题
Q: 配置后无法使用?
检查:
- API Key 是否正确(以
sk-开头) - Base URL 是否正确(
https://api.nextapi.pro/v1) - 账户余额是否充足
Q: 如何切换模型?
A: 在配置文件或界面中修改 model 参数即可。
Q: 支持哪些模型?
A: 支持 GPT-4、Claude、Gemini、Qwen、DeepSeek 等主流模型。
Q: Hermes Agent 和其他工具有什么区别?
A:
| 特点 | Hermes | Cursor | Continue |
|---|---|---|---|
| 自主执行 | ✅ | ❌ | ❌ |
| 自我学习 | ✅ | ❌ | ❌ |
| 多平台 | ✅ | ❌ | ❌ |
| 图形界面 | ❌ | ✅ | ✅ |
| 免费 | ✅ | ❌ | ✅ |
