autonomous-hr-chatbot 是一个自主 HR 智能体原型,旨在通过工具回答用户的人力资源查询。项目由 stepanogil 创建,仓库中同时保留了 2023 年的原始实现和 2026 年的现代化更新版本。
用途:该智能体面向企业 HR 场景,能够自主调用可用工具来回答员工或管理者的查询,例如查询考勤政策、获取员工数据、执行计算等。
主要能力:
- 考勤政策查询:使用 ChatGPT 生成的示例 HR 政策文档,通过 OpenAI 的 text-embedding-ada-002 模型创建嵌入,并存储在 Pinecone 索引中,实现基于向量检索的政策问答。
- 员工数据操作:加载包含虚拟员工数据(如姓名、主管、剩余假期数等)的 CSV 文件为 pandas 数据框,由 LLM 通过 LangChain 的 PythonAstREPLTool 进行查询和操作。
- 计算器:集成 LangChain 的计算器链模块 LLMMathChain,用于数学计算。
- 前端交互:使用 Streamlit 和 streamlit_chat 组件构建聊天界面。
使用方式:
- 安装 Python 3.10(支持 Windows 和 Mac)。
- 克隆仓库到本地目录。
- 在终端中运行 pip install -r requirements.txt 安装所有依赖模块。
- 在 hr_agent_backend_local.py 文件中填入自己的 API 密钥(如需使用 Azure 版本,可修改 hr_agent_backend_azure.py,并在 frontend.py 中取消注释)。
- 在终端运行 streamlit run hr_agent_frontent.py 启动应用。
- 在 pinecone.io 创建 Pinecone 账户(有免费层),记录 Pinecone API 和环境值。
- 运行 notebook 'store_embeddings_in_pinecone.ipynb',替换为自己的 Pinecone 和 OpenAI API 密钥(用于嵌入模型)。
适用场景:适合作为企业自主智能体的原型参考,用于演示如何结合 LLM、向量数据库和工具调用来构建 HR 助手。也可用于学习 LangChain 智能体与工具模块的集成方式。
限制:
- 原始版本(2023)依赖 LangChain、Pinecone 和 ChatGPT/gpt-3.5-turbo。
- 2026 更新版本(v2/)使用 OpenAI Responses API 的智能体循环,不再使用 LangChain 和 Pinecone,并包含 gpt-5.2 推理摘要。
- 项目为原型,使用虚拟员工数据和示例政策文档,未提及生产环境部署细节。
- 需要用户自行提供 OpenAI 和 Pinecone 的 API 密钥。
- 其他技术组件包括 Azure OpenAI Service、Azure Data Lake、Azure Data Factory、SAP HCM 等,但具体集成方式暂未提供详细说明。