
人工智能AI AgentAgent 框架后端多智能體RAG工具調(diào)用Agent 記憶【免費(fèi)下載鏈接】voltagentAI Agent Engineering Platform built on an Open Source TypeScript AI Agent Framework項(xiàng)目地址https://gitcode.com/gh_mirrors/vo/voltagent點(diǎn)擊查看免費(fèi)下載導(dǎo)讀本文圍繞 VoltAgent 模型路由Model Router對 Weights BiasesWB推理服務(wù)的官方支持展開介紹如何通過wandb/model形式的模型標(biāo)識符在 Agent 中直接調(diào)用 WB Inference 提供的開源大模型。讀完本文你將掌握WANDB_API_KEY與WANDB_BASE_URL的配置方法、ai-sdk/openai-compatible適配層的底層工作原理以及 WB 當(dāng)前支持的 10 個模型清單并能在 VoltAgent 項(xiàng)目中快速落地一個可運(yùn)行的 wandb Agent 示例。概述WB 提供方在 VoltAgent 中的定位VoltAgent 的模型路由體系通過統(tǒng)一的provider/model標(biāo)識符讓上層 Agent 代碼無需關(guān)心具體是哪一個廠商的 API。Weights Biases 是這一體系中的一個內(nèi)置提供方provider其注冊信息可以在 model-provider-registry.generated.ts 中看到字段值idwandbnameWeights Biasesnpmai-sdk/openai-compatibleapi默認(rèn) Base URLhttps://api.inference.wandb.ai/v1env必需環(huán)境變量WANDB_API_KEYdoc官方文檔https://weave-docs.wandb.ai/guides/integrations/inference/從該注冊表可以確認(rèn)WB 提供方基于 OpenAI 兼容協(xié)議接入因此無需為它單獨(dú)安裝 WB 專用 SDK而是復(fù)用ai-sdk/openai-compatible適配器。快速開始最小可用示例在項(xiàng)目依賴中安裝 VoltAgent Core 后即可用如下代碼創(chuàng)建使用 WB 模型的 Agentimport { Agent } from voltagent/core; const agent new Agent({ name: wandb-agent, instructions: You are a helpful assistant, model: wandb/Qwen/Qwen3-235B-A22B-Instruct-2507, });關(guān)鍵點(diǎn)在于model字段的值格式wandb/前綴對應(yīng)提供方 id斜杠之后是 WB 側(cè)的模型名同樣帶命名空間斜杠例如Qwen/Qwen3-235B-A22B-Instruct-2507。運(yùn)行前必須設(shè)置 API Keyexport WANDB_API_KEYyour_wandb_inference_api_key運(yùn)行時若未提供 API Key模型路由會拋出類似Missing API key for wandb. Set process.env.WANDB_API_KEY.的錯誤——該錯誤提示由 model-provider-registry.ts 中的requireApiKey邏輯生成它會遍歷提供方注冊表中的env列表此處即WANDB_API_KEY并校驗(yàn)環(huán)境變量是否存在。環(huán)境變量與 Base URL 覆蓋WANDB_API_KEY必需認(rèn)證憑據(jù)變量名WANDB_API_KEY用途向https://api.inference.wandb.ai/v1發(fā)起推理請求時的認(rèn)證憑據(jù)作用范圍僅 wandb 提供方若同時使用多個提供方各提供方的 Key 獨(dú)立生效WANDB_BASE_URL可選的端點(diǎn)覆蓋默認(rèn)請求端點(diǎn)固定為https://api.inference.wandb.ai/v1但可以通過設(shè)置WANDB_BASE_URL覆蓋適用于自建代理、私有化網(wǎng)關(guān)或測試環(huán)境等場景export WANDB_BASE_URLhttps://your-proxy.example.com/v1從底層實(shí)現(xiàn)看Base URL 的解析順序定義在 model-provider-registry.ts 的resolveBaseUrl中優(yōu)先讀取提供方env列表中名稱匹配ENDPOINT/BASE_URL/BASEURL的環(huán)境變量其次讀取慣例命名的${PROVIDER_ID}_BASE_URL將提供方 id 轉(zhuǎn)大寫并將連字符替換為下劃線即WANDB_BASE_URL均未設(shè)置時回退到注冊表中的api字段默認(rèn)值。因此即使不顯式配置WANDB_BASE_URL模型路由也會自動使用默認(rèn)端點(diǎn)無需任何額外代碼。Provider packageOpenAI 兼容適配層如何工作WB 提供方指定的 Provider package 為ai-sdk/openai-compatible。在 VoltAgent 中不同 npm 包會映射到不同的適配器實(shí)現(xiàn)映射表見 model-provider-registry.ts 的PACKAGE_ADAPTERS。ai-sdk/openai-compatible對應(yīng)buildOpenAICompatibleProvider見 model-provider-registry.ts其核心行為是通過requireApiKey(config)校驗(yàn)WANDB_API_KEY是否已設(shè)置通過resolveBaseUrl(config)確定最終請求端點(diǎn)調(diào)用createOpenAICompatible({ name, baseURL, apiKey, supportsStructuredOutputs: true })構(gòu)造提供方實(shí)例其中name取提供方 idwandbsupportsStructuredOutputs被顯式開啟表示該端點(diǎn)支持結(jié)構(gòu)化輸出。也就是說WB 推理端點(diǎn)只需遵循 OpenAI Chat Completions 協(xié)議即可被 VoltAgent 直接使用這也解釋了為何本文的快速開始示例中無需 import 任何 WB 專屬模塊。模型路由的解析過程wandb/Qwen/Qwen3-235B-A22B-Instruct-2507這類標(biāo)識符在內(nèi)部由 resolveLanguageModel 處理解析流程如下splitModelId以第一個/切分模型標(biāo)識符得到提供方 idwandb與模型 idQwen/Qwen3-235B-A22B-Instruct-2507詳見 model-provider-registry.ts從注冊表靜態(tài)內(nèi)置表 本地緩存 動態(tài)刷新中查找wandb提供方首次使用時懶加載ai-sdk/openai-compatible模塊并通過適配器構(gòu)建提供方實(shí)例用解析出的模型 id 調(diào)用提供方工廠函數(shù)返回可供 Agent 使用的LanguageModel。值得注意的是模型路由在非生產(chǎn)環(huán)境下默認(rèn)啟動自動刷新每 30 分鐘檢查一次https://models.dev/api.json源并會把最新的提供方/模型快照緩存到用戶目錄下的~/.voltagent/model-registry/provider-registry.json相關(guān)常量見 model-provider-registry.ts。這意味著模型清單可能隨刷新而更新本文列出的模型以當(dāng)前倉庫注冊表快照為準(zhǔn)。支持的模型列表以下是當(dāng)前倉庫注冊表快照中 wandb 提供方支持的 10 個模型類型定義見 model-provider-types.generated.ts模型名說明Qwen/Qwen3-235B-A22B-Instruct-2507通義千問 Qwen3 指令模型Qwen/Qwen3-235B-A22B-Thinking-2507通義千問 Qwen3 思考模型Qwen/Qwen3-Coder-480B-A35B-Instruct通義千問 Qwen3 代碼模型deepseek-ai/DeepSeek-R1-0528DeepSeek R1 推理模型deepseek-ai/DeepSeek-V3-0324DeepSeek V3 通用模型meta-llama/Llama-3.1-8B-InstructLlama 3.1 8B 指令模型meta-llama/Llama-3.3-70B-InstructLlama 3.3 70B 指令模型meta-llama/Llama-4-Scout-17B-16E-InstructLlama 4 Scout 多模態(tài)模型microsoft/Phi-4-mini-instructPhi-4 mini 輕量指令模型moonshotai/Kimi-K2-InstructKimi K2 指令模型在 Agent 中切換模型時只需將model字段改為wandb/上表中的模型名例如model: wandb/meta-llama/Llama-3.3-70B-Instruct在項(xiàng)目中使用 wandb 提供方的注意事項(xiàng)依賴安裝ai-sdk/openai-compatible由 VoltAgent Core 按需動態(tài) import見 model-provider-registry.ts 的createProviderLoader需確保該包已安裝若缺失路由會提示Failed to load provider wandb from ai-sdk/openai-compatible. Install the package and try again.。標(biāo)識符格式model必須使用wandb/模型名形式且模型名自帶廠商命名空間雙斜杠是正?,F(xiàn)象不要省略中間層。密鑰管理不要把WANDB_API_KEY硬編碼進(jìn)源碼建議通過.env文件或部署平臺的環(huán)境變量注入多提供方并存時各 Key 互不干擾。端點(diǎn)覆蓋僅當(dāng)請求需經(jīng)過代理或私有網(wǎng)關(guān)時才設(shè)置WANDB_BASE_URL普通使用無需配置。進(jìn)一步探索提供方注冊數(shù)據(jù)源與自動刷新機(jī)制見 model-provider-registry.ts單元測試覆蓋了 Base URL 覆蓋等行為參見 model-provider-registry-minimax.spec.ts。全部提供方總覽及各提供方所需環(huán)境變量對照表見 website/models-docs/providers/overview.md其中 Weights Biases 一行的模型前綴為wandb、環(huán)境變量為WANDB_API_KEY。各提供方頁面均由 website/scripts/generate-model-docs.js 根據(jù)注冊表快照自動生成模型清單會隨注冊表刷新而更新。如果希望了解其他 OpenAI 兼容提供方如 Vultr、Vivgrid、Xiaomi 等的接入方式它們在注冊表中均使用ai-sdk/openai-compatible適配層接入步驟與本指南完全一致。贊分享人工智能AI AgentAgent 框架后端多智能體RAG工具調(diào)用Agent 記憶【免費(fèi)下載鏈接】voltagentAI Agent Engineering Platform built on an Open Source TypeScript AI Agent Framework項(xiàng)目地址https://gitcode.com/gh_mirrors/vo/voltagent點(diǎn)擊查看免費(fèi)下載相關(guān)推薦在 VoltAgent 中使用 GitHub Copilot 模型github-copilot/model 模型路由接入指南在 VoltAgent 中使用 GitHub Copilot 模型github copilot/model 模型路由接入指南 本篇基于 VoltAgent人工智能AI AgentAgent 框架后端多智能體RAG工具調(diào)用Agent 記憶Agent 工作流AI 評測MCP 服務(wù)MCP Clients語音Dragonfly實(shí)體系統(tǒng)從怪物AI到自定義實(shí)體的完整實(shí)現(xiàn)Dragonfly實(shí)體系統(tǒng)從怪物AI到自定義實(shí)體的完整實(shí)現(xiàn) 探索Dragonfly實(shí)體系統(tǒng)的強(qiáng)大功能了解如何從基礎(chǔ)怪物AI到高級自定義實(shí)體的完整實(shí)現(xiàn)流程。D人工智能AI AgentAgent 框架后端多智能體RAG工具調(diào)用Agent 記憶Agent 工作流AI 評測MCP 服務(wù)MCP Clients語音在 VoltAgent 模型路由中使用 Inceptioninception/mercury接入指南與源碼級原理在 VoltAgent 模型路由中使用 Inceptioninception/mercury接入指南與源碼級原理 本指南講解如何在 VoltAgent 的人工智能AI AgentAgent 框架后端多智能體RAG工具調(diào)用Agent 記憶Agent 工作流AI 評測MCP 服務(wù)MCP Clients語音上一篇告別網(wǎng)盤限速困擾九大平臺直鏈下載助手的完整使用指南下一篇acwj 編譯器移植 QBE 后端以 SSA 中間語言替代手寫 x86-64 代碼生成器創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考