Skip to content

AI Agent 接入指南

Next API 支持所有主流 AI Agent 工具,只需简单配置即可使用。


🤖 什么是 AI Agent?

AI Agent 是能自动执行任务的 AI 助手,可以:

  • 💻 自动写代码、改代码
  • 📝 自动写文档、发邮件
  • 🔍 自动搜索、整理信息
  • 🛠️ 自动完成复杂工作流

Next API 支持的 AI Agent 工具:

工具类型特点难度
Hermes Agent自主 Agent自我学习、多平台⭐⭐⭐ 进阶
Cursor代码编辑器AI 写代码⭐ 简单
Windsurf代码编辑器AI 原生 IDE⭐ 简单
ContinueVS Code 插件免费、灵活⭐⭐ 中等
Aider终端工具Git 集成⭐⭐ 中等

🚀 快速选择

我是小白,想快速上手

推荐:Cursor(最简单)

  • ✅ 图形界面,无需命令行
  • ✅ 自动补全、代码生成
  • ✅ 5分钟配置完成

查看 Cursor 配置教程


我想用免费工具

推荐:Continue(完全免费)

  • ✅ VS Code 插件
  • ✅ 支持多种模型
  • ✅ 开源免费

查看 Continue 配置教程


我想用最强大的 Agent

推荐:Hermes Agent(自我学习)

  • ✅ 自主执行任务
  • ✅ 自动学习改进
  • ✅ 多平台支持

查看 Hermes Agent 配置教程


我想在终端用 AI

推荐:Aider(终端原生)

  • ✅ 命令行工具
  • ✅ Git 自动提交
  • ✅ 多模型支持

查看 Aider 配置教程


Cursor

什么是 Cursor?

Cursor 是 AI 原生代码编辑器,可以:

  • 💻 AI 自动写代码
  • 🔧 AI 修改代码
  • 💡 AI 解释代码
  • 🐛 AI 修复 Bug

安装 Cursor

  1. 访问 Cursor 官网
  2. 下载对应系统版本
  3. 安装并打开

配置 Next API

方法一:图形界面配置

  1. 打开 Cursor
  2. 点击右上角 ⚙️ 设置
  3. 选择 ModelsOpenAI API Key
  4. 输入以下信息:
    • API Key: sk-你的密钥
    • Base URL: https://api.nextapi.pro/v1
  5. 点击 Verify 验证
  6. 保存设置

方法二:配置文件

编辑 ~/.cursor/config.json

json
{
  "openai": {
    "apiKey": "sk-你的密钥",
    "baseUrl": "https://api.nextapi.pro/v1"
  }
}

开始使用

  1. 打开一个代码文件
  2. Cmd+K(Mac)或 Ctrl+K(Windows)
  3. 输入你的需求,例如:
    • "写一个 Python 爬虫"
    • "修复这个 Bug"
    • "优化这段代码"
  4. AI 会自动生成代码

推荐模型

任务推荐模型
写代码claude-sonnet-4-6deepseek-v3.1
解释代码gpt-4o-mini
优化代码gpt-4o

Windsurf

什么是 Windsurf?

Windsurf 是 Codeium 团队开发的 AI 原生 IDE,特点:

  • 🌊 Cascade:深度上下文 AI Agent
  • 🔄 自动读取代码库
  • 🛠️ 自动执行命令

安装 Windsurf

  1. 访问 Windsurf 官网
  2. 下载对应系统版本
  3. 安装并打开

配置 Next API

  1. 打开 Windsurf
  2. Cmd+,(Mac)或 Ctrl+,(Windows)打开设置
  3. 搜索 OpenAI
  4. 输入以下信息:
    • API Key: sk-你的密钥
    • Base URL: https://api.nextapi.pro/v1
  5. 保存设置

开始使用

  1. 打开项目文件夹
  2. Cmd+I(Mac)或 Ctrl+I(Windows)打开 Cascade
  3. 输入你的需求,例如:
    • "创建一个 React 组件"
    • "重构这个模块"
    • "添加单元测试"
  4. Cascade 会自动执行

Cascade 特点

  • ✅ 自动读取相关文件
  • ✅ 自动创建文件
  • ✅ 自动运行命令
  • ✅ 自动安装依赖

Continue

什么是 Continue?

Continue 是开源的 VS Code AI 插件,特点:

  • 💰 完全免费
  • 🔧 灵活配置
  • 🤖 支持多种模型

安装 Continue

  1. 打开 VS Code
  2. Cmd+Shift+X(Mac)或 Ctrl+Shift+X(Windows)
  3. 搜索 Continue
  4. 点击 Install
  5. 重启 VS Code

配置 Next API

  1. 打开 VS Code
  2. Cmd+Shift+P(Mac)或 Ctrl+Shift+P(Windows)
  3. 输入 Continue: Open Settings
  4. 编辑 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"
    }
  ]
}

开始使用

  1. 打开代码文件
  2. Cmd+L(Mac)或 Ctrl+L(Windows)打开 Continue
  3. 输入你的问题或需求
  4. 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 --version

Windows (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
  • ✅ WhatsApp
  • ✅ Signal

3. 工具调用

Hermes 可以:

  • 执行终端命令
  • 读写文件
  • 搜索网络
  • 调用 API

推荐配置

任务推荐模型
日常对话gpt-4o-mini
复杂任务gpt-4o
写代码claude-sonnet-4-6

💡 使用技巧

1. 选择合适的模型

场景推荐模型原因
简单对话gpt-4o-mini便宜快速
写代码claude-sonnet-4-6deepseek-v3.1代码能力强
复杂推理gpt-4o性能强
中文任务qwen3-max中文效果好

2. 提示词技巧

好的提示词:

写一个 Python 函数,输入 URL,返回网页标题。
要求:
1. 使用 requests 库
2. 添加错误处理
3. 添加超时设置

不好的提示词:

写个函数

3. 上下文管理

  • ✅ 只添加相关文件
  • ✅ 定期清理上下文
  • ✅ 使用 .gitignore 排除文件

4. 成本控制

  • 使用 gpt-4o-mini 进行简单任务
  • 使用 max_tokens 限制输出
  • 使用流式输出提前终止

❓ 常见问题

Q: 配置后无法使用?

检查:

  1. API Key 是否正确(以 sk- 开头)
  2. Base URL 是否正确(https://api.nextapi.pro/v1
  3. 账户余额是否充足

Q: 如何切换模型?

A: 在配置文件或界面中修改 model 参数即可。

Q: 支持哪些模型?

A: 支持 GPT-4、Claude、Gemini、Qwen、DeepSeek 等主流模型。

查看完整模型列表

Q: Hermes Agent 和其他工具有什么区别?

A:

特点HermesCursorContinue
自主执行
自我学习
多平台
图形界面
免费

下一步