常见问题
常见问题
本页由 README 拆分而来,内容与代码同步维护。返回 README。
AgentFlow 是免费的吗?
是的,AgentFlow 以 Apache-2.0 开源,允许包括商业用途在内的使用、修改与再分发。你需要自行承担服务器与 LLM API 调用费用。
注意 skills/ 下的技能来自不同社区,各自许可不同(Apache-2.0 / MIT / 无声明 / 保留所有权利),不能整体按本仓库协议再分发,详见 THIRD_PARTY_NOTICES.md。
不会写代码能用 AgentFlow 吗?
可以。AgentFlow 的核心就是零代码拖拽式工作流编辑器,通过可视化画布连接节点即可构建 AI Agent。6 个行业模板开箱即用,5 分钟即可上线。
支持哪些大模型?
目前支持 OpenAI(GPT-4o / GPT-4.1 / o3 / o4-mini)、Anthropic(Claude Sonnet 4 / Claude 3.5 Haiku)、DeepSeek(V3 / R1)和 Ollama 本地模型。通过 GET /api/v1/templates/models/list 可获取完整模型列表。
知识库 RAG 是怎么工作的?
三步流程:1)上传文档 → 自动分块;2)调用 独立配置的 embedding 端点生成向量,默认存入 chromadb(换 PostgreSQL + pgvector 是可选路径);3)提问时检索相关片段,注入上下文生成回答。支持 PDF、TXT、Markdown 等格式。
Docker 部署必须填
EMBEDDING_BASE_URL:官方镜像没装本地 embedding 模型(2GB+),留空会静默失败——表现为知识库能建但检索不出内容。
可以自托管吗?数据安全吗?
可以完全自托管,Docker 一键部署。数据(用户、Agent、对话、知识库记录)默认存在你自己的 SQLite 文件(./data/agentflow.db),也可以切到 PostgreSQL;模型调用走你配置的端点,可以指向本地 Ollama,连外网都不出。
AgentFlow 和 Dify 有什么区别?
Dify 功能更全(插件市场、观测、多租户都更成熟),本项目更小更轻,差异主要在部署与交付形态:
- 部署成本:本项目默认 SQLite + 两个容器(backend + nginx);Dify 起步需要 PostgreSQL + Redis + worker,四五个容器。
- 产物交付:本项目生成的文件作为附件回传,图片类直接内联在对话里;Dify 部分支持。
- 扩展方式:本项目是「加一个带
SKILL.md的目录」,也能直接改源码(Apache-2.0);Dify 走插件市场。
反过来说清楚的短板:本项目没有异步任务队列、没有细粒度权限、没有插件生态,并发能力也远不如 Dify。选它是因为「一台小机器 + 数据不出内网」,不是因为功能更多。完整对照见 COMPARISON.md。
如何贡献代码?
标准流程:Issue → Fork → Branch → Develop → Test → PR → Review → Merge。详细开发指南见项目 CONTRIBUTING.md。