尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

3行代码接入你的Agent:Super Agent Party的OpenAI兼容API与MCP接口开发者指南

3行代码接入你的Agent:Super Agent Party的OpenAI兼容API与MCP接口开发者指南 3行代码接入你的AgentSuper Agent Party的OpenAI兼容API与MCP接口开发者指南【免费下载链接】super-agent-party⭐全能型AI伴侣AI桌面女友 AI虚拟主播 AI即时通讯机器人 AI浏览器 AI智能家居 AI游戏 等你能想到的一切功能项目地址: https://gitcode.com/heshengtao/super-agent-partySuper Agent Party 是一个全能型 AI 伴侣项目它除了能做 AI 桌面女友、虚拟主播、IM 机器人之外还对外开放了 OpenAI 兼容 API 与 MCP 接口。这意味着你不需要重写任何代码——只要把base_url指向它任何支持 OpenAI 格式的客户端都能直接与你的 Agent 对话同时它也作为一个 MCP Server 运行可被 Claude、Cursor 等 MCP 客户端直接调用其工具能力。本文是面向初学者的完整接入指南带你用最少的代码打通这两条通道。为什么选择 Super Agent Party 的 API 与 MCP 接口在开始之前先了解一下它对外暴露了哪些能力OpenAI 兼容 API完美兼容 OpenAI 请求格式支持流式输出stream不影响原有 API 的反应速度调用代码零修改MCP 接口本地启动后即可作为 MCP Server被任意 MCP 客户端挂载使用多智能体路由通过model字段即可选择具体的角色 Agent默认模型super-model由系统自动调度。整体架构由 FastAPI 构建核心接口都定义在服务端入口 server.py 中MCP 客户端连接管理位于 py/mcp_clients.py。第一步启动服务Web 端 / Docker 端如果你的软件是桌面端安装包启动的同样自带服务Web 端或 Docker 端启动后访问http://localhost:3456/即可看到界面。API 与 MCP 默认都挂在3456 端口上端口在 server.py 的启动参数中定义默认为 3456。 提示如果 3456 端口被占用可以通过--port参数更换端口记得同步修改下面示例中的地址。3行代码接入OpenAI 兼容 API 实战Super Agent Party 的聊天接口为POST /v1/chat/completions路由定义在 server.py 中完整兼容 OpenAI 的ChatCompletion响应结构。因此接入只需要 3 行核心代码from openai import OpenAI client OpenAI(api_keysuper-secret-key, base_urlhttp://localhost:3456/v1) response client.chat.completions.create(modelsuper-model, messages[{role: user, content: 什么是 Super Agent Party}]) print(response.choices[0].message.content)就这么简单。几个常用要点要点说明base_url指向http://localhost:3456/v1与官方 OpenAI 地址结构完全一致model默认使用super-model也可填入具体 Agent 名称流式输出设置streamTrue即可响应结构与 OpenAI 完全兼容工具调用内置的 MCP 工具会以标准tools形式暴露给模型Agent 可自动调度查看有哪些模型Agent可调GET /v1/models按 OpenAI 标准格式返回模型列表每个 Agent 名称即一个模型 IDserver.pyGET /v1/agents扩展接口额外返回每个 Agent 的人设描述方便你快速了解可用角色server.pyGET /v1/tasks/list可查询 Agent 在后台任务中心执行的任务实现对话 长任务协同server.py。MCP 接口让任意 MCP 客户端驱动你的 Agent除了 HTTP APISuper Agent Party 还内置了 MCP Server挂载在 server.py把它的工具能力浏览器控制、桌面操作、文件读写、智能家居等暴露为标准 MCP 协议。接入方式只需在 MCP 客户端的配置文件中加一段{ mcpServers: { super-agent-party: { url: http://127.0.0.1:3456/mcp } } }保存后重启 MCP 客户端即可看到 Super Agent Party 提供的全部工具。它支持 stdio、SSE、WebSocket、Streamable HTTP 等多种传输方式连接与会话管理实现见 py/mcp_clients.py你甚至可以反向用它挂载你自己的 MCP 服务形成Agent 调用 Agent的玩法。进阶玩法从对话到任务中心接入 API 只是起点。Super Agent Party 的 Agent 不只是会聊天后台任务中心通过/v1/tasks/create创建长任务Agent 在后台自动操作电脑完成工作POST /v1/tasks/createserver.py多角色群聊把多个角色同时接入你的应用实现多 Agent 对话场景IM 一键部署QQ、微信、飞书、钉钉、Telegram、Discord、Slack 等平台直接复用同一个 Agent 大脑。常见问题FAQQ请求超时或报错 403服务开启了内容安全策略contentSafety时敏感输入会被拦截并返回 403这是正常的安全机制。Q和直接用大模型 API 有什么区别普通 API 只调用语言模型Super Agent Party 的 API 背后是完整的 Agent 系统——它会携带人设、记忆、MCP 工具链一起响应相当于把整个AI 伴侣大脑托管给了你的应用。Q配置文件在哪运行配置位于 config/settings_template.json其中agents字段定义了所有可被 API 调用的角色。总结3 行代码改一下base_url你的应用立刻接入 Super Agent Party 的 OpenAI 兼容 API1 段 JSON配置 MCP 接口让你的 MCP 客户端直接驱动 Agent 的全部工具零改造成本完全兼容 OpenAI 格式支持流式输出与工具调用不改变现有代码结构。无论是想给自家应用接一个有性格的 AI 大脑还是构建多 Agent 协作系统Super Agent Party 的 README_AGENT.md 中还有面向 CLI Agent 的完整接入说明值得延伸阅读。【免费下载链接】super-agent-party⭐全能型AI伴侣AI桌面女友 AI虚拟主播 AI即时通讯机器人 AI浏览器 AI智能家居 AI游戏 等你能想到的一切功能项目地址: https://gitcode.com/heshengtao/super-agent-party创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表