KwaiAgents
可通过 OpenAI 或本地模型执行信息检索任务的轻量级智能体系统。
- Star 数
- ★ 1.2k
- 最近更新
- 2 年前
- License
- NOASSERTION
- 主语言
- Python
- FA 评分
- 44/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配OpenAI API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要用 GPT-3.5-turbo 对英文或中文信息查询进行命令行处理的团队。
- 不适合
- 需要开箱即用完整 Agent 能力的团队:KAgentSys-Lite 工具更少且无记忆机制
- 没有 GPU 或不愿部署 FastChat/vLLM 服务的用户
- 需要明确开源许可条款再采用的项目
这个 Agent 能做什么,适合哪些场景?
KwaiAgents 是快手 KwaiKEG 开源的一组智能体相关工作,核心运行组件为 KAgentSys-Lite。该轻量系统可通过 kagentsys 命令接收问题,并使用 GPT-3.5-turbo 或已部署的本地 KAgentLM 生成回答。项目同时提供经 Meta-agent tuning 训练的 KAgentLMs、超过 20 万条的 KAgentInstruct 指令数据,以及含 3,000 多条人工编辑样本的 KAgentBench。KAgentBench 按规划、工具使用、反思、结论和画像五个维度评测能力,并输出各项分数与总分。KAgentSys-Lite 与论文中的完整 KAgentSys 不同:工具更少、没有记忆机制、性能略有下降,且代码基于 BabyAGI、Auto-GPT 等开源项目演进。
用户以 kagentsys --query="..." --llm_name="gpt-3.5-turbo" --lang="en" 提交问题;系统可使用 OPENAI_API_KEY 调用 GPT-3.5-turbo。若使用本地模型,可先以 FastChat 和 vLLM 启动 OpenAI 格式的服务,再通过 --use_local_llm、--local_llm_host 和 --local_llm_port 将 KAgentSys-Lite 连接到该服务;Qwen 的 GGUF 模型也可用 llama_cpp.server 在 CPU 上提供服务。天气问题可配置 WEATHER_API_KEY,使用 browse_website 工具则需要服务器安装 chromedriver。评测时,benchmark/infer_qwen.py 生成 JSONL 推理结果,benchmark/benchmark_eval.py 读取结果并输出 plan、tooluse、reflextion、conclusion、profile 和 overall 分数。
- 需要用 GPT-3.5-turbo 对英文或中文信息查询进行命令行处理的团队。
- 已用 vLLM 与 FastChat 部署 Qwen-7B-MAT、Qwen-14B-MAT 或 Baichuan2-13B-MAT,想将其接入 KAgentSys-Lite 的本地推理用户。
- 希望在无 GPU 环境下,用 llama-cpp-python 为 Qwen-7B-MAT GGUF 模型提供 OpenAI 兼容接口的开发者。
- 要为模型比较规划、工具使用、反思、结论和画像能力,并以 KAgentBench 生成量化结果的研究人员。
- 需要在智能体查询中处理天气相关问题,并可配置 WeatherAPI 凭据的应用开发者。
如何安装或部署这个 Agent?
先安装 Miniconda,然后执行:
conda create -n kagent python=3.10
conda activate kagent
pip install -r requirements.txtgit clone [email protected]:KwaiKEG/KwaiAgents.git
cd KwaiAgents
python setup.py develop使用 GPT-3.5-turbo 时还需配置:
export OPENAI_API_KEY=sk-xxxxx天气查询另需:
export WEATHER_API_KEY=xxxxxx如何使用这个 Agent?
首次调用 GPT-3.5-turbo:
kagentsys --query="Who is Andy Lau's wife?" --llm_name="gpt-3.5-turbo" --lang="en"使用本地模型时,先启动 FastChat controller、vLLM worker 与 OpenAI API server:
python -m fastchat.serve.controller
python -m fastchat.serve.vllm_worker --model-path $model_path --trust-remote-code
python -m fastchat.serve.openai_api_server --host localhost --port 8888随后运行:
kagentsys --query="Who is Andy Lau's wife?" --llm_name="kagentlms_qwen_7b_mat" --use_local_llm --local_llm_host="localhost" --local_llm_port=8888 --lang="en"这个 Agent 有哪些优点和局限?
- 同时提供可运行的 KAgentSys-Lite、KAgentLMs、KAgentInstruct 和 KAgentBench,覆盖运行、模型、训练数据和评测数据。
- 既支持通过 OPENAI_API_KEY 使用 GPT-3.5-turbo,也支持连接自托管的本地模型服务。
- 本地部署路径覆盖 GPU 的 vLLM/FastChat 和 CPU 的 llama-cpp-python GGUF 服务。
- KAgentBench 明确输出规划、工具使用、反思、结论、画像及总分,便于按维度比较模型。
- KAgentSys-Lite 明确只有较少工具,且不包含记忆机制,不等同于论文中的完整 KAgentSys。
- 使用本地模型需要额外部署 FastChat 与 vLLM,或安装 llama-cpp-python;GPU 路径还可能需要处理 Bfloat16 兼容性。
- 浏览网站需要在服务器配置 chromedriver;多次搜索失败时,文档提示可能需要设置 http_proxy。
- 仓库许可状态标为 NOASSERTION,采用前需要自行确认可用的许可条款。
这个 Agent 与同类方案有什么区别?
项目将 KAgentSys-Lite 定位为完整 KAgentSys 的轻量版本:Lite 的工具集合更有限、没有记忆机制、性能能力略低,且代码并非完整系统的同一代码库。README 的人工评测表还将 KAgentSys 与 NoAgent、ReACT 和 Auto-GPT 并列比较;这些结果是该项目报告的评测数据。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| KwaiAgents 当前 | 44 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.2k | 2 年前 | Python | OpenAI API |
| AgenticSeek | 44 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 28k | 17 天前 | Python | OpenAI API |
| Hermes Web UI | 68 · 存在缺口 | 网页应用免费 + 模型费 | ★ 19k | 今天 | Python | Codex · Claude Code · OpenAI API · Claude API |
| Hope Agent | 68 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 1.9k | 今天 | Rust | Codex · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 说明需配置 OpenAI 与可选天气 API 密钥,并列出浏览器、搜索和本地模型服务等外部依赖,提供了部分数据流和权限线索,因此给低分而非零分;但未见密钥保护、权限缩减、敏感数据处理、执行前确认或回滚机制,且工具副作用与数据去向说明有限,故各项扣分。README 提供论文、数据集和模型链接,来源归属有一定依据,但没有展示具体输出的引用规则,来源归因仍不充分。
README 给出模型服务、命令参数和基准分数,并明确 Lite 版本缺少记忆、工具较少且与论文版本有差异,说明部分行为边界;但这些声明未在所给代码或测试中交叉验证。requirements.txt 列出依赖和部分版本约束,但未固定全部依赖,且 README 提醒搜索可能因网络受限而失败;材料未展示一致性检查或用户可读的错误处理,因此失败消息为零。
README 将产品定位为通用信息检索 Agent,展示问答、天气查询、浏览网页、工具配置以及英文和中文参数,受众与场景、环境设置有较清楚的说明。它指出 Lite 相对完整系统的工具、记忆和性能限制,且提供最大迭代数、工具名和语言等参数,因此边界与触发配置有一定依据;未给出更细的任务适配规则,未满分。
README 按模型服务、Lite 使用、工具示例和基准评测组织内容,包含安装步骤、命令行参数、示例和已知限制;LICENSE.txt 明示 CC BY-NC-SA 4.0,故相关分数较高。命名和发布新闻可辨识,但版本变更摘要有限;README 署名 KwaiKEG/Kuaishou 并列作者,但没有清楚说明维护负责人或更新支持路径,维护责任只给部分分。
README 给出可复制的服务与问答命令、参数列表及评测维度和结果,输出形式对普通使用有一定可操作性。它宣称 Lite 可提供有竞争力表现,并展示基准表和人工评测表,支持其相对价值主张;但数据如何用于实际决策、结果的适用范围以及成本与收益权衡均未充分说明,因此效益和成本项扣分。
README 的使用步骤、依赖说明、论文/数据集/模型链接及基准表使部分主张可追溯。LICENSE 和 requirements 文件提供了不同类型的佐证,但所给材料没有源码或测试来印证 README 的行为和性能主张,跨源佐证较弱;评测数字有呈现,但与产品描述、评测方法之间的事实和推断界线说明不足,故未给高分。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 所给材料主要是 README、许可证和依赖清单,未包含实现代码或测试;评测数字和运行行为无法从该材料独立核验。
- 使用指南要求设置 API 密钥并启用外部搜索、浏览器或模型服务,但未说明密钥存储、数据传输细节、动作确认或撤销流程。
- 许可证为 CC BY-NC-SA 4.0;商用使用受到非商业条款限制。
常见问题
使用 GPT-3.5-turbo 需要什么凭据?
KAgentSys-Lite 是否包含记忆功能?
能否不使用 GPU?
网页浏览或搜索失败时应检查什么?
谢谢反馈,我们会据此改进页面。