agntk：零配置的模块化 AI 智能体框架

agntk 是一个基于 Vercel AI SDK 构建的模块化 AI 智能体框架，支持零配置启动、持久化记忆、子智能体派生和本地模型推理，为开发者提供开箱即用的智能体开发体验。

agntk 的 slogan 简洁明了："AI agent you install and point at problems. Zero config. Works immediately."（安装即用，指向问题即可。零配置，立即工作。）这种设计哲学直指当前智能体工具链的痛点——过度配置。

框架基于 Vercel AI SDK 构建，这意味着它继承了该 SDK 的流式响应、工具调用和结构化输出等能力。但 agntk 的价值不在于重新发明轮子，而在于将这些能力封装成开发者可以立即使用的形态。

agntk 实现了一套智能 Provider 检测机制，按优先级自动选择可用 AI 服务：

优先级	Provider	检测方式
1	用户 API Key	环境变量 OPENROUTER_API_KEY、OPENAI_API_KEY 或 CEREBRAS_API_KEY
2	Ollama	自动检测 localhost:11434，根据硬件选择合适模型
3	免费层级	内置 Cerebras 支持（有限速率）

这种设计让开发者无需关心底层模型配置。有 API Key 就用付费服务，没有就自动 fallback 到本地 Ollama 或免费层级。

当使用 Ollama 本地推理时，agntk 会检测系统硬件并自动选择最优模型：

内存容量	模型选择	策略说明
8 GB	qwen3:8b	内存占用适中，为操作系统预留空间
16 GB	qwen3:14b 标准 + qwen3:8b 快速	质量与速度的最佳平衡
32+ GB	qwen3:32b 推理 + qwen3:14b 标准	复杂任务全性能，常规任务高效率

框架会检测 Apple Silicon 统一内存、NVIDIA VRAM 和纯 CPU 系统，自动调整模型选择策略。

每个 agntk 智能体默认配备 20+ 内置工具，无需额外配置：

• 文件工具：读取、写入、编辑、创建、glob 匹配、跨工作区 grep 搜索
• 代码工具：基于 AST 的搜索和替换（ast-grep）

• Shell 工具：运行命令、管理后台进程
• 浏览器工具：网页导航、内容提取、页面交互

• 规划工具：任务分解、深度推理
• 记忆工具：事实记忆、上下文召回、跨会话知识构建
• 子智能体工具：派生专门化智能体进行并行工作，支持实时活动流
• 技能工具：自动发现项目中的 SKILL.md 文件，加载项目特定能力

这种工具集的完整性意味着开发者无需为常见任务编写自定义工具，可以专注于业务逻辑。