← プロジェクト一覧に戻る

haystack

文書に基づく回答もエージェントも、コンポーネントをパイプラインにつないで自分で組み立てるPythonのライブラリです

公式Apache-2.0
スター
26.9k
フォーク
3.4k
オープンIssue
197
最終コミット
2026年10月30日

haystackとは

Haystackは、文書の取り込みから検索、モデルの呼び出しまでを1つずつコンポーネントとして置き、パイプラインの上で出力と入力を名前で指定してつないでいくフレームワークです。型の合わない組み合わせはつないだ瞬間にエラーになり、条件による分岐も、回数の上限つきで前のコンポーネントへ戻すループも、同じパイプラインの中に書けます。Agentもコンポーネントの一つなので、ツール呼び出しの繰り返しをパイプラインへ組み込んだり、別のAgentのツールとして渡したりできます。裏を返せば配線はすべて自分で書くことになり、PDFを置くだけで対話システムができあがる近道はありません。ライブラリなので自分のプロセスの中で動き、パイプラインをHTTPの窓口やMCPサーバーとして公開するには別プロジェクトのHayhooksを使うか、受け口を自分で用意することになります。

haystackで何ができますか?

  • つなぎ間違いは実行前に分かる — パイプラインにコンポーネントを登録し、出力と入力を名前で指定してつなぎます。型の合わない組み合わせはつないだ瞬間にエラーになります。ファイルの種類で経路を分ける分岐や、条件を満たすまで前のコンポーネントへ戻すループも同じパイプラインに書け、1つのコンポーネントが回れる回数には既定で100回の上限が設けられています。
  • Agentがツール呼び出しの繰り返しを受け持つ — Agentはチャットモデルの呼び出しとツールの実行を、終了条件を満たすか手数の上限(既定で100手)に達するまで繰り返します。ツール同士が共有する状態は型を宣言して持ち回り、応答は逐次流れ、複数のツール呼び出しは同時に走ります。Agent自体もコンポーネントなので、ComponentToolで包めば別のAgentのツールとして渡せます。
  • フックで6か所に割り込む — 実行前、モデル呼び出しの前、ツール実行の前と後、終了時、実行後の6か所にフックを差し込めます。ツールを実行する前に人へ確認を取るConfirmationHookと、大きくなったツールの戻り値をファイルなどの保管先へ退避し、会話には冒頭の抜粋と参照先だけを残すToolResultOffloadHookが同梱されており、内部に手を入れずに済みます。
  • 関数もコンポーネントもパイプラインもツールになる — Pythonの関数はデコレーターを付けるだけでツールになり、既存のコンポーネントやパイプライン全体もそれぞれ専用のクラスで包めばツールとして渡せます。数が増えて説明文がプロンプトを圧迫する場合は、SearchableToolsetがモデルにまず検索用のツールだけを見せ、必要になったものを読み込みます。手順書をSKILL.mdとして置いておくSkillToolsetも同じ考え方です。
  • Document Storeを入れ替えても残りは動く — 取り込み側は、ファイルを読み取るConverter、長い文書を切り分けるSplitter、ベクトルに変換するEmbedderが順に並び、結果をDocument Storeへ書き込みます。問い合わせ側はRetrieverが候補を取り出し、キーワードの一致でもベクトルの近さでも、両方を混ぜても検索できます。手元のInMemoryDocumentStoreからQdrantやElasticsearch、pgvectorへ移すとき、差し替えるのはDocument Storeと対応するRetrieverだけです。
  • 検索と回答の出来を数値で確かめる — 標準の評価コンポーネントで、必要な文書が返ってきたか、どれだけ上位に来たかを測れます。回答の側は、渡した文書から外れていないかを見るほか、判定基準を自分で書いてモデルに採点させることもできます。すでにRagasやDeepEvalを使っているなら、それらも同じくコンポーネントとして組み込めます。

haystackを選ぶ前に

  • 3.0で旧来のGeneratorが削除され、30のコンポーネントが別途インストールする統合パッケージへ移り、2.31への修正は2026年10月末までの安全性対応と重大バグ修正に限るとdeepsetは述べています。
  • 既製のパイプラインテンプレート、Helmチャートと導入手順、開発チームの直接サポート、プロンプトインジェクション対策などの先行提供は有償のHaystack Enterpriseの範囲で、公開されている本体には含まれません。

スター推移

8月17日〜10月30日 · +652

26.2k26.9k

よくある質問

haystackは商用利用できますか?

haystackはApache-2.0ライセンスで公開されています。OSI承認のオープンソースライセンスで、商用利用が認められています。

haystackはどの形で使えますか?

haystackはセルフホスト・ローカル実行の形で利用できます。