KwaiAgents

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

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

30 秒速览

可在哪里用
兼容但需适配OpenAI API
开始前需要
Python 3.10+MinicondaOpenAI API key for GPT-3.5 usageShell / 命令行网络访问本地文件系统
典型场景
需要用 GPT-3.5-turbo 对英文或中文信息查询进行命令行处理的团队。
主要局限
KAgentSys-Lite 明确只有较少工具,且不包含记忆机制,不等同于论文中的完整 KAgentSys。

这个 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 当前 0 · 缺口较多 ★ 1.2k 2 年前 Python OpenAI API
AgenticSeek 40 · 缺口较多 ★ 27k 2 天前 Python OpenAI API
活动策划多智能体系统 62 · 存在缺口 ★ 115 5 个月前 Python
Hermes Web UI 51 · 缺口较多 ★ 19k 今天 Python Codex · Claude Code · OpenAI API · Claude API

FollowAgents 如何评估这个 Agent?

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

证据不足:仓库未提供权限管理、用户确认、数据流透明、敏感数据处理、依赖安全、外部影响、回滚或来源归属的说明。所有标准均无证据,故为0。

可靠稳定0 / 14 · 0.0/5

证据不足:未提供自一致性、依赖可用性或失败消息的说明。所有标准均无证据,故为0。

适用触发0 / 18 · 0.0/5

证据不足:未提供目标受众、能力边界、触发精度或环境适配的说明。所有标准均无证据,故为0。

规范维护0 / 18 · 0.0/5

证据不足:未提供信息架构、安装说明、命名稳定性、示例/FAQ、已知限制、许可证、版本/变更日志或维护责任的说明。所有标准均无证据,故为0。

有效结果0 / 13 · 0.0/5

证据不足:未提供输出可用性、边际价值或成本效益的说明。所有标准均无证据,故为0。

证据核验0 / 8 · 0.0/5

证据不足:未提供声明可追溯性、跨来源佐证或事实/推断分离的说明。所有标准均无证据,故为0。

风险与缓解建议
  • 源码中未见:最小权限约束只授予完成任务所需的权限:用专用账号或只读令牌,并限定可访问的目录和仓库。
  • 源码中未见:执行前用户确认开启或自行加上执行前确认;先在沙箱或测试环境跑通,确认行为后再接入真实数据。
  • 源码中未见:数据流向说明运行时观察它连接了哪些外部服务(代理或防火墙日志);弄清数据去向之前不要输入敏感数据。
  • 源码中未见:敏感信息处理使用专用、低权限、可随时吊销的 API 密钥,不要复用生产凭据,也不要让密钥出现在日志里。
  • 源码中未见:依赖安全审查安装前固定版本并做一次依赖扫描(如 npm audit、pip-audit);优先放在容器里运行。
  • 源码中未见:外部影响披露先弄清它会写入、发送或修改哪些外部系统,用测试账号或测试仓库验证后再接入正式环境。
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • 源码中未见:来源归属可核验从官方仓库或包源安装,核对发布者和仓库地址,避免同名仿冒包。
  • 仓库未提供任何安全、权限或数据处理的文档,使用前需自行评估风险。
  • 未提供依赖安全审计或已知漏洞信息,依赖版本可能过时。
  • 未提供明确的维护责任或更新路径,项目可能缺乏持续维护。
证据充分度: 评估于 2026年8月9日 审查版本 3504ab8a00a3
查看完整评分方法 →

常见问题

使用 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 查看 ↗ 安装 ↓

相关 Agents