KwaiAgents

可通过 OpenAI 或本地模型执行信息检索任务的轻量级智能体系统。

Star 数
★ 1.2k
最近更新
2 年前
License
NOASSERTION
主语言
Python

30 秒速览

运行形态
命令行工具
可在哪里用
兼容但需适配OpenAI API
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Python 3.10+Miniconda用于 GPT-3.5 使用的 OpenAI API 密钥Shell / 命令行网络访问本地文件系统
典型场景
需要用 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 分数。

  1. 需要用 GPT-3.5-turbo 对英文或中文信息查询进行命令行处理的团队。
  2. 已用 vLLM 与 FastChat 部署 Qwen-7B-MAT、Qwen-14B-MAT 或 Baichuan2-13B-MAT,想将其接入 KAgentSys-Lite 的本地推理用户。
  3. 希望在无 GPU 环境下,用 llama-cpp-python 为 Qwen-7B-MAT GGUF 模型提供 OpenAI 兼容接口的开发者。
  4. 要为模型比较规划、工具使用、反思、结论和画像能力,并以 KAgentBench 生成量化结果的研究人员。
  5. 需要在智能体查询中处理天气相关问题,并可配置 WeatherAPI 凭据的应用开发者。

如何安装或部署这个 Agent?

先安装 Miniconda,然后执行:

conda create -n kagent python=3.10
conda activate kagent
pip install -r requirements.txt
git 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
44/ 100 五分制 2.2 / 5
信任安全 8/29
可靠稳定 3/14
适用触发 12/18
规范维护 10/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全8 / 29 · 1.4/5

README 说明需配置 OpenAI 与可选天气 API 密钥,并列出浏览器、搜索和本地模型服务等外部依赖,提供了部分数据流和权限线索,因此给低分而非零分;但未见密钥保护、权限缩减、敏感数据处理、执行前确认或回滚机制,且工具副作用与数据去向说明有限,故各项扣分。README 提供论文、数据集和模型链接,来源归属有一定依据,但没有展示具体输出的引用规则,来源归因仍不充分。

可靠稳定3 / 14 · 1.1/5

README 给出模型服务、命令参数和基准分数,并明确 Lite 版本缺少记忆、工具较少且与论文版本有差异,说明部分行为边界;但这些声明未在所给代码或测试中交叉验证。requirements.txt 列出依赖和部分版本约束,但未固定全部依赖,且 README 提醒搜索可能因网络受限而失败;材料未展示一致性检查或用户可读的错误处理,因此失败消息为零。

适用触发12 / 18 · 3.3/5

README 将产品定位为通用信息检索 Agent,展示问答、天气查询、浏览网页、工具配置以及英文和中文参数,受众与场景、环境设置有较清楚的说明。它指出 Lite 相对完整系统的工具、记忆和性能限制,且提供最大迭代数、工具名和语言等参数,因此边界与触发配置有一定依据;未给出更细的任务适配规则,未满分。

规范维护10 / 18 · 2.8/5

README 按模型服务、Lite 使用、工具示例和基准评测组织内容,包含安装步骤、命令行参数、示例和已知限制;LICENSE.txt 明示 CC BY-NC-SA 4.0,故相关分数较高。命名和发布新闻可辨识,但版本变更摘要有限;README 署名 KwaiKEG/Kuaishou 并列作者,但没有清楚说明维护负责人或更新支持路径,维护责任只给部分分。

有效结果7 / 13 · 2.7/5

README 给出可复制的服务与问答命令、参数列表及评测维度和结果,输出形式对普通使用有一定可操作性。它宣称 Lite 可提供有竞争力表现,并展示基准表和人工评测表,支持其相对价值主张;但数据如何用于实际决策、结果的适用范围以及成本与收益权衡均未充分说明,因此效益和成本项扣分。

证据核验4 / 8 · 2.5/5

README 的使用步骤、依赖说明、论文/数据集/模型链接及基准表使部分主张可追溯。LICENSE 和 requirements 文件提供了不同类型的佐证,但所给材料没有源码或测试来印证 README 的行为和性能主张,跨源佐证较弱;评测数字有呈现,但与产品描述、评测方法之间的事实和推断界线说明不足,故未给高分。

风险与缓解建议
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • 所给材料主要是 README、许可证和依赖清单,未包含实现代码或测试;评测数字和运行行为无法从该材料独立核验。
  • 使用指南要求设置 API 密钥并启用外部搜索、浏览器或模型服务,但未说明密钥存储、数据传输细节、动作确认或撤销流程。
  • 许可证为 CC BY-NC-SA 4.0;商用使用受到非商业条款限制。
证据充分度:低 评估于 2026年11月8日 审查版本 3504ab8a00a3
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/kwaiagents.svg?lang=zh)](https://followagents.com/zh/agents/kwaiagents)
<a href="https://followagents.com/zh/agents/kwaiagents"><img src="https://followagents.com/badge/kwaiagents.svg?lang=zh" alt="FARS 评测"></a>

常见问题

使用 GPT-3.5-turbo 需要什么凭据?
需要设置 OPENAI_API_KEY。天气相关问题还需要 WEATHER_API_KEY。
KAgentSys-Lite 是否包含记忆功能?
不包含;项目明确说明 Lite 缺少记忆机制。
能否不使用 GPU?
可以。README 提供了通过 llama-cpp-python 和 Qwen-7B-MAT GGUF 模型在 CPU 上启动 OpenAI 兼容服务的方式。
网页浏览或搜索失败时应检查什么?
browse_website 需要配置 chromedriver;若搜索多次失败,README 提示可能是无法访问 duckduckgo_search,可设置 http_proxy。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓