KwaiAgents
可通过 OpenAI 或本地模型执行信息检索任务的轻量级智能体系统。
- Star 数
- ★ 1.2k
- 最近更新
- 2 年前
- License
- NOASSERTION
- 主语言
- Python
- FA 评分
- 0/100 · 缺口较多
30 秒速览
- 可在哪里用
- 兼容但需适配OpenAI API
- 开始前需要
- 典型场景
- 需要用 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 分数。
- 需要用 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 当前 | 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?
查看各维度的扣分理由
证据不足:仓库未提供权限管理、用户确认、数据流透明、敏感数据处理、依赖安全、外部影响、回滚或来源归属的说明。所有标准均无证据,故为0。
证据不足:未提供自一致性、依赖可用性或失败消息的说明。所有标准均无证据,故为0。
证据不足:未提供目标受众、能力边界、触发精度或环境适配的说明。所有标准均无证据,故为0。
证据不足:未提供信息架构、安装说明、命名稳定性、示例/FAQ、已知限制、许可证、版本/变更日志或维护责任的说明。所有标准均无证据,故为0。
证据不足:未提供输出可用性、边际价值或成本效益的说明。所有标准均无证据,故为0。
证据不足:未提供声明可追溯性、跨来源佐证或事实/推断分离的说明。所有标准均无证据,故为0。
- 源码中未见:最小权限约束只授予完成任务所需的权限:用专用账号或只读令牌,并限定可访问的目录和仓库。
- 源码中未见:执行前用户确认开启或自行加上执行前确认;先在沙箱或测试环境跑通,确认行为后再接入真实数据。
- 源码中未见:数据流向说明运行时观察它连接了哪些外部服务(代理或防火墙日志);弄清数据去向之前不要输入敏感数据。
- 源码中未见:敏感信息处理使用专用、低权限、可随时吊销的 API 密钥,不要复用生产凭据,也不要让密钥出现在日志里。
- 源码中未见:依赖安全审查安装前固定版本并做一次依赖扫描(如 npm audit、pip-audit);优先放在容器里运行。
- 源码中未见:外部影响披露先弄清它会写入、发送或修改哪些外部系统,用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 源码中未见:来源归属可核验从官方仓库或包源安装,核对发布者和仓库地址,避免同名仿冒包。
- 仓库未提供任何安全、权限或数据处理的文档,使用前需自行评估风险。
- 未提供依赖安全审计或已知漏洞信息,依赖版本可能过时。
- 未提供明确的维护责任或更新路径,项目可能缺乏持续维护。