SuperAPI AI 工具集

agent-engines

智能体与模型

查看项目

更新于 10-15 20:09

技能介绍

用途:Agent Engines 用于检查和配置驱动智能体的 AI 引擎(模型提供商),适用于切换模型、查看当前引擎、测试新引擎等场景。

主要能力:框架在智能体循环下支持可插拔引擎。默认且最优路径为 Anthropic 引擎(Claude 模型),其他引擎可通过 Vercel AI SDK 添加。提供三个工具:list-agent-engines 列出所有已注册引擎、能力与当前选择;set-agent-engine 设置活动引擎与模型(持久化到 settings);test-agent-engine 发送简单提示验证连通性与 API key。

使用方式:查看当前引擎用 list-agent-engines。切换引擎示例:set-agent-engine --engine "ai-sdk:openai" --model "gpt-4o",更改在下次对话生效,设置通过 settings store 的 agent-engine 键持久化。解析优先级从高到低为:服务器插件中 createAgentChatPlugin() 显式传入的引擎选项、settings store、AGENT_ENGINE 环境变量,默认 "anthropic"(需 ANTHROPIC_API_KEY)。切换前可测试:test-agent-engine --engine "ai-sdk:openai" --model "gpt-4o",返回 { ok, latencyMs, response, capabilities }。

内置引擎与所需环境变量:anthropic(ANTHROPIC_API_KEY)、ai-sdk:anthropic(ANTHROPIC_API_KEY)、ai-sdk:openai(OPENAI_API_KEY)、ai-sdk:openrouter(OPENROUTER_API_KEY)、ai-sdk:google(GOOGLE_GENERATIVE_AI_API_KEY)、ai-sdk:groq(GROQ_API_KEY)、ai-sdk:mistral(MISTRAL_API_KEY)、ai-sdk:cohere(COHERE_API_KEY)、ai-sdk:ollama(本地,无需 key)。

能力差异:thinking 在 Anthropic、AI SDK Anthropic、AI SDK Google 支持,OpenAI 不支持;promptCaching 仅 Anthropic 与 AI SDK Anthropic 支持;vision 与 parallelToolCalls 各引擎普遍支持;computerUse 仅 Anthropic 支持。Anthropic 专属功能包括自动提示缓存和通过 providerOptions.anthropic.thinking 启用扩展思考,非 Anthropic 引擎会静默忽略。

OpenRouter:ai-sdk:openrouter 通过单一 API 访问 300+ 模型,模型 ID 用 vendor/model 形式,如 anthropic/claude-sonnet-4.5、openai/gpt-4o、google/gemini-2.5-pro。可选传入 appName/appUrl 设置 X-OpenRouter-Title / HTTP-Referer 头。

自定义引擎:在服务器插件启动时从 @agent-native/core/agent/engine 子路径导入 registerAgentEngine 注册。引擎的 stream(opts) 必须按顺序发出:零或多个 text-delta、thinking-delta、tool-call、usage 事件;恰好一个 assistant-content 事件;恰好一个终止 stop 事件。注册后即可在 list-agent-engines 中看到并通过 set-agent-engine 选择。

限制:资料未提供价格、性能基准或平台兼容性等更多信息。