人工智能AI AgentAgent 框架后端多智能体RAG工具调用Agent 记忆【免费下载链接】voltagentAI Agent Engineering Platform built on an Open Source TypeScript AI Agent Framework项目地址https://gitcode.com/gh_mirrors/vo/voltagent点击查看免费下载iFlowiflowcn是 VoltAgent 模型路由器中内置的模型提供商之一通过 OpenAI 兼容适配器将 iFlow 平台托管的 DeepSeek、GLM、Kimi、Qwen3 等 14 个模型接入 Agent 应用。本文基于 VoltAgent 仓库中的 iflowcn Provider 文档结合 模型提供商注册表源码 深入讲解从环境变量配置、Base URL 解析到模型选择与调用的完整链路读完即可在自己的 Agent 项目中稳定使用iflowcn/model模型标识。iFlow Provider 概览iFlow 是一个聚合多家开源模型推理服务的平台VoltAgent 通过模型路由器Model Router为它建立了原生注册项。在 模型提供商注册表 中iflowcn的注册条目定义如下iflowcn: { id: iflowcn, name: iFlow, npm: ai-sdk/openai-compatible, api: https://apis.iflow.cn/v1, env: [IFLOW_API_KEY], doc: https://platform.iflow.cn/en/docs, },从源码结构可以推断该注册表是 VoltAgent 统一管理所有第三方模型提供商的入口id决定模型标识前缀、npm声明底层适配器包、api是默认接入地址、env声明鉴权所需的环境变量。iFlow 与仓库中绝大多数第三方提供商一样采用ai-sdk/openai-compatible适配器这意味着你无需安装任何 iFlow 专属 SDKVoltAgent 核心包会按需加载对应适配器完成连接。快速开始在 iflowcn Provider 文档 给出的最小示例中只需在Agent的model字段中使用iflowcn/model格式的标识即可import { Agent } from voltagent/core; const agent new Agent({ name: iflowcn-agent, instructions: You are a helpful assistant, model: iflowcn/deepseek-r1, });要让这段代码真正运行需要先完成鉴权配置见下一节。完整可运行的落地形态如下# 设置 iFlow API Key export IFLOW_API_KEYyour-iflow-api-key # 可选如需走代理或自定义网关可覆盖默认地址 export IFLOWCN_BASE_URLhttps://your-gateway.example.com/v1import { Agent } from voltagent/core; const agent new Agent({ name: iflowcn-agent, instructions: You are a helpful assistant, model: iflowcn/deepseek-r1, // provider 前缀 模型 ID }); const result await agent.run(用一句话介绍你自己); console.log(result.text);model字段支持静态的provider/model字符串也可以按需替换为iflowcn/glm-4.6、iflowcn/qwen3-coder-plus等其他模型切换成本仅是修改一个字符串。环境变量与鉴权根据 iflowcn Provider 文档 与注册表定义iFlow Provider 涉及两个环境变量环境变量是否必需作用IFLOW_API_KEY必需iFlow 平台 API 密钥用于请求鉴权IFLOWCN_BASE_URL可选覆盖默认 Base URL用于代理或私有网关场景其中IFLOW_API_KEY是注册表env字段中声明的唯一鉴权变量。从 模型提供商注册表实现 可以看到运行时解析逻辑会遍历该env列表依次查找process.env中非空的值作为 API Key 传入适配器const resolveEnvValue (names: string[]): ProviderEnvMatch | undefined { for (const name of names) { const value getEnvValue(name); if (value) { return { name, value }; } } return undefined; };因此只需保证IFLOW_API_KEY已正确注入环境本地终端、.env文件或部署平台的 Secrets 配置均可VoltAgent 即可自动完成鉴权装配无需在业务代码中手动传递密钥。默认 Base URL 与覆盖机制iFlow 的默认接入地址为https://apis.iflow.cn/v1。如果你所在网络无法直连或希望经由自己的 API 网关统一出口可以通过IFLOWCN_BASE_URL覆盖。这一覆盖行为的底层实现在 model-provider-registry.ts 的resolveBaseUrl函数中其解析优先级为优先查找 provider 的env列表中名称匹配ENDPOINT | BASE_URL | BASEURL模式的环境变量其次查找${providerId}_BASE_URL惯例命名变量即IFLOWCN_BASE_URL两者都未设置时回退到注册表中的默认api地址https://apis.iflow.cn/v1。const resolveBaseUrl (config: ModelProviderRegistryEntry): string | undefined { const envNames config.env ?? []; const override resolveEnvValue( envNames.filter((name) /ENDPOINT|BASE_URL|BASEURL/i.test(name)), )?.value; if (override) { return override; } const conventional getEnvValue(${envKeyForProvider(config.id)}_BASE_URL); if (conventional) { return conventional; } return config.api; };也就是说文档中声明的IFLOWCN_BASE_URL正是由 providerId _BASE_URL 的惯例命名规则生成的通配能力——这一点不仅适用于 iFlow也适用于注册表中所有提供商minimax 的测试用例 就以MINIMAX_BASE_URL覆盖场景验证了同一套解析逻辑。理解这一机制后即使将来 iFlow 调整端点你也能在不改代码的前提下通过环境变量平滑切换。支持的模型清单iflowcn Provider 文档 与 模型类型注册表 中登记的 iFlow 模型共 14 个覆盖推理、通用对话、代码生成与多模态视觉等用途模型 ID系列 / 用途说明依据命名与系列deepseek-r1DeepSeek 系列推理模型deepseek-v3DeepSeek 系列通用对话模型deepseek-v3.2DeepSeek 系列通用对话模型glm-4.6智谱 GLM 系列通用模型kimi-k2Kimi 系列模型kimi-k2-0905Kimi 系列模型0905 版本快照qwen3-235bQwen3 大规模参数版本qwen3-235b-a22b-instructQwen3 235B 稀疏激活 instruct 版本qwen3-235b-a22b-thinking-2507Qwen3 235B 稀疏激活 thinking推理版本qwen3-32bQwen3 32B 版本qwen3-coder-plusQwen3 代码生成系列qwen3-maxQwen3 旗舰版本qwen3-max-previewQwen3 旗舰预览版本qwen3-vl-plusQwen3 视觉语言多模态系列使用方式即iflowcn/模型ID例如model: iflowcn/qwen3-coder-plus, // 代码任务 model: iflowcn/qwen3-vl-plus, // 图文理解任务 model: iflowcn/deepseek-r1, // 深度推理任务注意模型清单来源于仓库注册表快照由 generate-model-docs.js 自动生成可能与 iFlow 平台最新上架情况存在时差具体能力规格上下文长度、价格、限流以 iFlow 平台官方文档为准。底层原理OpenAI 兼容适配器iFlow Provider 的npm字段为ai-sdk/openai-compatible说明它走的是 OpenAI 兼容协议通道。这意味着 iFlow 平台暴露的/v1/chat/completions风格接口与 OpenAI 协议对齐VoltAgent 无需为每个兼容平台单独开发适配器而是通过注册表统一路由到 OpenAI-compatible 适配器完成请求转发与响应解析。模型提供商目录总览 中记录了 VoltAgent 支持的全部提供商可以看到iflowcn与其他数十个 OpenAI 兼容平台共享同一套接入机制只是id、api、env与模型清单不同。这一点带来的直接收益是生态互通任何按 OpenAI 协议设计的工具链、网关与观测平台均可直接复用接入成本低配置仅需 API Key 与模型标识不引入额外的 SDK 依赖便于迁移同一套 Agent 代码仅更换model前缀即可在 iFlow 与其他兼容提供商之间切换。进阶动态选择 iFlow 模型在实际业务中模型选择往往需要根据上下文动态决定。VoltAgent 的model字段除了静态字符串还支持函数形式动态返回模型参见 动态 Agent 文档 中model: ({ context }) ...的用法。结合 iFlow 的多模型能力可以实现诸如推理任务走deepseek-r1、代码任务走qwen3-coder-plus的路由策略import { Agent } from voltagent/core; const agent new Agent({ name: iflowcn-router, instructions: You are a helpful assistant, model: ({ context }) { // 依据任务特征动态选择 iFlow 模型 if (context.topic coding) { return iflowcn/qwen3-coder-plus; } if (context.topic vision) { return iflowcn/qwen3-vl-plus; } return iflowcn/deepseek-v3; }, });每次生成调用前Agent 都会重新解析该函数并解析出最终的provider/model因此 iFlow 的 14 个模型可以被编排为同一 Agent 内部的模型池按需取用。小结iFlow 是 VoltAgent 模型路由器内置的 OpenAI 兼容提供商模型标识格式为iflowcn/model鉴权仅需IFLOW_API_KEY环境变量默认端点https://apis.iflow.cn/v1可通过IFLOWCN_BASE_URL覆盖注册表与解析源码model-provider-registry.generated.ts、model-provider-registry.ts共同保证了配置到请求的完整闭环14 个可用模型覆盖 DeepSeek、GLM、Kimi、Qwen3 四大系列可结合动态模型函数实现任务级路由。赞分享人工智能AI AgentAgent 框架后端多智能体RAG工具调用Agent 记忆【免费下载链接】voltagentAI Agent Engineering Platform built on an Open Source TypeScript AI Agent Framework项目地址https://gitcode.com/gh_mirrors/vo/voltagent点击查看免费下载相关推荐在 VoltAgent 中接入 Together AI使用 togetherai/model 模型路由与 ai-sdk/togetherai Provider在 VoltAgent 中接入 Together AI使用 togetherai/model 模型路由与 ai sdk/togetherai Provid人工智能AI AgentAgent 框架后端多智能体RAG工具调用Agent 记忆Agent 工作流AI 评测MCP 服务MCP Clients语音在 VoltAgent 中接入 Groq 快速推理模型voltagent/groq-ai 使用与迁移指南在 VoltAgent 中接入 Groq 快速推理模型voltagent/groq ai 使用与迁移指南 VoltAgent 是构建在 TypeScript人工智能AI AgentAgent 框架后端多智能体RAG工具调用Agent 记忆Agent 工作流AI 评测MCP 服务MCP Clients语音VoltAgent Anthropic AI Provider 完整指南在 Agent 中接入 Claude 模型与弃用迁移实践VoltAgent Anthropic AI Provider 完整指南在 Agent 中接入 Claude 模型与弃用迁移实践 本文围绕 VoltAgent人工智能AI AgentAgent 框架后端多智能体RAG工具调用Agent 记忆Agent 工作流AI 评测MCP 服务MCP Clients语音上一篇NUR 开源项目教程下一篇DevOps Interview Guide中的边缘计算分布式系统面试重点创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
