Haystack
用可组合管线与工作流构建可控的生产级 LLM 应用。
- Star 数
- ★ 27k
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 52/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- Python 团队需要把文档检索、排序和生成拆成可检查步骤，构建带明确上下文控制的 RAG 问答系统。
- 不适合
- 需要开箱即用 REST API 或 MCP 服务的团队，需另配 Hayhooks
- 希望用非 Python 语言构建应用的开发者
这个 Agent 能做什么，适合哪些场景？
Haystack 是一个用于在 Python 中构建生产级 LLM 应用的开源 AI 编排框架。其核心接口包括可同步或异步运行并支持逐 token 流式输出的 Pipeline，以及可并发调用工具的 Agent。开发者可以把检索、排序、过滤、记忆、工具调用、路由和生成组织为带循环、分支与条件逻辑的工作流。项目提供检索、索引、工具调用、记忆和评估组件，并允许按一致接口扩展自定义组件。它面向 RAG、语义搜索、问答、多模态应用和自主代理；若要将管线或代理作为 REST API 或 MCP 服务发布，README 指向配套项目 Hayhooks。
应用通过 Pipeline 连接内置或自定义组件，在模型调用前检索、排序、过滤、组合、结构化并路由上下文，然后执行生成或工具调用。Pipeline 可同步或异步执行，并逐 token 流式输出；Agent 可并发运行工具调用。Agent 生命周期可接入 before_llm、before_tool、on_exit 等钩子，并记录 step_count、token_usage 和工具调用。SkillToolset 可按需将技能描述放入上下文；Agent Pack 提供 deep research agent 和 advanced RAG agent 等预制代理。
- Python 团队需要把文档检索、排序和生成拆成可检查步骤，构建带明确上下文控制的 RAG 问答系统。
- 企业搜索团队需要组合索引、检索与过滤组件，为内部知识库提供语义搜索。
- 需要流式响应的应用团队想用同一个 Pipeline 在同步和异步执行模式之间切换。
- 正在开发可调用外部工具的代理团队，需要并发工具调用、生命周期钩子及 token_usage 记录。
- 需要把文本以外输入纳入工作流的产品团队，构建多模态应用。
- 已有 Haystack 管线的服务团队需要通过 Hayhooks 将其包装为 HTTP REST API 或 MCP 服务。
如何安装或部署这个 Agent？
运行：pip install haystack-ai
README 还提供预发布版本安装命令：pip install --pre haystack-ai。运行时需要 Python 与 pip。
如何使用这个 Agent？
README 未提供可复制的首个 Pipeline 或 Agent 代码示例，也未说明模型提供商凭据、环境变量、配置格式或最小工作调用。已明确的使用边界是：在 Python 中用 Pipeline 组装组件并同步或异步运行，或使用 Agent 编排工具调用；模型与基础设施可接入 OpenAI、Mistral、Anthropic、Cohere、Hugging Face、Google、Azure OpenAI、AWS Bedrock、本地模型等。部署为 REST API 或 MCP 服务需使用 README 指向的 Hayhooks。
这个 Agent 有哪些优点和局限？
- Pipeline 支持同步、异步和逐 token 流式执行，适合同时覆盖交互式与服务端执行模式。
- 工作流可表达循环、分支和条件逻辑，并让检索、记忆、工具和生成过程保持可追踪。
- Agent 提供 before_llm、before_tool、on_exit 等生命周期钩子，并原生记录 step_count、token_usage 与工具调用。
- 框架声明可在多家模型和基础设施提供商之间替换组件，而无需重写整个系统。
- README 没有给出最小可运行代码、凭据配置或完整首个调用，落地前需要查找额外文档。
- 将 Pipeline 或 Agent 发布为 REST API 或 MCP 服务不是该仓库 README 中的内置命令，而是依赖配套的 Hayhooks 项目。
- 使用云模型或云基础设施时仍需为所选提供商完成各自的集成与凭据配置；README 未说明统一认证方式。
- 匿名遥测会在管线组件初始化时发送事件；需要退出时必须按文档另行配置。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Haystack 当前 | 52 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 27k | 今天 | Python | OpenAI API |
| 《深入理解 AI Agent：设计原理与工程实践》开源仓库 | 41 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 57k | 29 天前 | Python | — |
| Hello-Agents 智能体教程 | 54 · 缺口较多 | 网页应用免费 + 模型费 | ★ 86k | 23 天前 | Python | OpenAI API |
| Puppyone 上下文驱动器 | 39 · 缺口较多 | 自托管服务免费版 + 付费版 | ★ 1.3k | 4 个月前 | TypeScript | ChatGPT · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：框架设计为在可信执行环境中运行，安全边界明确（SECURITY.md），但未提供最小权限原则的明确实现；用户确认机制未提及；数据流透明度部分体现（如telemetry说明），但未详细说明数据流向；敏感数据处理未专门说明；依赖安全有措施（如uv exclude-newer），但未提供完整漏洞扫描证据；外部影响（如网络请求）有说明但未提供控制；回滚机制未提及；来源归属有版权声明但未提供详细贡献者信息。扣分原因：缺乏具体实现细节和证据。
证据显示：项目结构一致，测试配置完整（pyproject.toml），依赖声明明确，但未提供运行时可靠性保证；失败消息未详细说明。扣分原因：静态审查无法验证运行时行为。
证据显示：面向广泛受众（开发者、企业），场景多样（RAG、agents等），能力边界在README中有描述，但触发精度（如agent的exit conditions）未详细说明；环境适配（Python版本、Docker等）有说明。扣分原因：触发精度和边界细节不足。
证据显示：信息架构清晰（README、docs链接），安装说明明确，命名稳定（haystack-ai），示例和FAQ有提供，已知限制在SECURITY.md中有说明，许可证为Apache-2.0，版本管理有VERSION.txt和changelog（reno），维护责任明确（deepset）。扣分原因：部分文档未在本次审查中提供。
证据显示：输出可用性高（组件化、可序列化），边际价值高（开源框架），成本效益合理（免费使用）。扣分原因：缺乏实际运行数据。
证据显示：README中的声明部分有链接支持，但未提供独立验证；跨来源佐证有限；事实与推断未明确区分。扣分原因：静态审查无法验证声明。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 静态审查无法验证运行时行为，所有可靠性相关评分基于代码和文档推断。
- 安全边界明确，但用户需自行负责输入验证和SSRF防护，框架不提供默认保护。
- 依赖安全措施存在，但未提供完整的漏洞扫描报告，建议使用前检查依赖版本。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
🔒 Security Notes - Haystack now requires anyio>=4.14.2. anyio is installed transitively through httpx and openai; versions before 4.14.2 are affected by CVE-2026-63374 (GHSA-82r6-8w77-94w6). - Haystack now requires certifi>=2026.10.19. certifi is installed transitively through httpx and posthog; earlier versions trust eMudhra/emSign certificate authorities whose private keys were compromised (GHSA-6q48-6c7w-9gw2). If you pin certifi, raise the pin to at least 2026.10.19.在 GitHub 查看 ↗ -
发布说明摘录
🔒 Security Notes - Haystack now requires certifi>=2026.10.19. certifi is installed transitively through httpx and posthog; earlier versions trust eMudhra/emSign certificate authorities whose private keys were compromised (GHSA-6q48-6c7w-9gw2). If you pin certifi, raise the pin to at least 2026.10.19.在 GitHub 查看 ↗