SuperAPI AI 工具集

claude-to-deerflow

智能体与模型

查看项目

更新于 10-15 17:30

技能介绍

用途:该技能用于通过 HTTP API 与一个正在运行的 DeerFlow 实例通信。DeerFlow 是构建在 LangGraph 之上的 AI 智能体平台,可编排子智能体进行调研、代码执行、网页浏览等任务。

体系结构:DeerFlow 在 Nginx 反向代理后暴露两个 API 面。Gateway API 提供 REST 端点与内嵌智能体运行时;LangGraph 兼容 API 负责智能体线程、运行与流式传输。两者直连端口均为 8001,通过代理访问。

环境变量:请求前应先读取。DEERFLOW_URL 默认 http://localhost:2026,为统一代理基础地址;DEERFLOW_GATEWAY_URL 默认取 DEERFLOW_URL;DEERFLOW_LANGGRAPH_URL 默认取 $DEERFLOW_URL/api/langgraph。调用前先解析这些变量。

主要操作:健康检查 GET $DEERFLOW_GATEWAY_URL/health;查询模型 GET /api/models;查询技能 GET /api/skills;启用或禁用技能 PUT /api/skills/<skill_name>;查询智能体 GET /api/agents;获取记忆 GET /api/memory;上传文件 POST /api/threads/<thread_id>/uploads(支持 PDF、PPTX、XLSX、DOCX,自动转为 Markdown);列出已上传文件 GET /api/threads/<thread_id>/uploads/list;获取线程历史与搜索线程。

发送消息与续接:核心操作是创建线程后流式运行。先 POST $DEERFLOW_LANGGRAPH_URL/threads 获取 thread_id,再 POST /threads/<thread_id>/runs/stream,请求体包含 assistant_id(如 lead_agent)、input.messages、stream_mode、stream_subgraphs、config.recursion_limit 与 context。响应为 SSE 流,事件类型含 metadata、values、messages-tuple、end。续接对话时复用同一 thread_id 再发一次 run 即可,线程 ID 会持久保存。context 可切换模式:Flash(不思考、不规划、无子智能体)、Standard、Pro、Ultra(全部开启)。工具提供辅助脚本 scripts/chat.sh 完成健康检查、创建线程、流式收集并打印最终回复。

解析与错误处理:从最后一个 values 事件中解析 data JSON,messages 数组里最后一条 type 为 ai 的消息 content 即回复文本。健康检查失败说明 DeerFlow 未运行,需提示用户启动;流返回 error 事件时提取并展示错误。常见问题包括端口未开放、服务仍在启动、配置错误。

适用场景与限制:适合把消息或问题发往 DeerFlow 做调研与分析。快速提问用 flash 模式,调研任务用 pro 或 ultra 模式。可先上传文件再在消息中引用。需已有运行中的实例并正确配置环境变量。资料未提供收费、价格或性能数据。