システムプロンプトやエージェント指示を対象に、プロンプト抽出・インジェクションの脆弱性を検査するコマンドラインツール兼ライブラリ。
humanbound/humanbound
ライブエンドポイント経由でAIエージェントに攻撃を仕掛け、失敗をファイアウォールルールに変換するオープンソースの敵対的テストエンジン、SDK、CLI。
- スター
- 232
- フォーク
- 22
- 未解決の Issue
- 5
- 最終コミット
- 一昨日
これは何?
Humanboundは、単独のプロンプトではなくAIエージェントをテストします。ライブのエージェントエンドポイントに対して複数ターンの会話を実行し、ツールの使用状況やスコープの境界を調べ、scopeファイルで定義されたセキュリティポリシーに基づいて結果を採点します。テストは、独自のLLMプロバイダー(OpenAI、Anthropic、Gemini、Ollama)を使ってローカルで実行することも、Humanbound Platformに対して実行することもできます。
テスト後、hb guardrailsコマンドで検出結果をガードレールルールとファイアウォールポリシーファイルに変換でき、付属のhumanbound-firewallランタイムでデプロイできます。hb arenaコマンドを使うと、意図的に脆弱性を持たせたエージェントをDocker上でローカル実行し、練習できます。CLIとPython SDKは同じ実装を共有しており、Dockerイメージとしても利用できます。
主な機能
- 01ライブのエージェントHTTPエンドポイントに対する複数ターンの敵対的テスト
- 02scope.yamlの制限対象アクションリストに基づく、ツールの不正使用を調べるプローブ
- 03セキュリティ体制をスコアと評価で示し、HTMLレポートを出力
- 04テストの検出結果をhumanbound-firewallランタイム用のガードレールルールに変換
- 05OpenAI、Anthropic、Gemini、Ollamaを使ったローカル実行に対応し、完全オフラインの構成も可能
ユースケース
- リリース前のカスタマーサポートエージェントに対するレッドチームテスト
- LLMエージェントがツールや権限の境界を守るか確認
- 失敗したテストからガードレールルールを生成し、デプロイ済みエージェントを保護
- 意図的に脆弱性を持たせたエージェントを使ったAIセキュリティテストの練習
クイックスタート
- 1
PyPIからCLIとSDKをインストールする
pip install humanbound - 2
LLMプロバイダーとAPIキーを設定する
export HB_PROVIDER=openai - 3
エージェント設定に対して敵対的テストを実行する
hb test --endpoint ./bot-config.json --repo . --wait
使う前に知っておきたいこと
- テストの実行にはLLMプロバイダーのAPIキー、またはengine extraをインストールしたローカルのOllama環境が必要です。
- Platformバックエンドやファイアウォール連携など、一部の機能はオプションのextrasまたは外部サービスに依存します。
収録されている特集
トピック
よくある質問
- humanbound とは?
- ライブエンドポイント経由でAIエージェントに攻撃を仕掛け、失敗をファイアウォールルールに変換するオープンソースの敵対的テストエンジン、SDK、CLI。 Humanboundは、単独のプロンプトではなくAIエージェントをテストします。ライブのエージェントエンドポイントに対して複数ターンの会話を実行し、ツールの使用状況やスコープの境界を調べ、scopeファイルで定義されたセキュリティポリシーに基づいて結果を採点します。テストは、独自のLLMプロバイダー(OpenAI、Anthropic、Gemini、Ollama)を使ってローカルで実行することも、Humanbound Platformに対して実行することもできます。
- humanbound は無料で使えますか?ライセンスは?
- humanbound は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- humanbound は今もメンテナンスされていますか?
- 活発にメンテナンス中。humanbound の最終コミットは 2026年11月5日 です。
- humanbound は何に使えますか?
- リリース前のカスタマーサポートエージェントに対するレッドチームテスト LLMエージェントがツールや権限の境界を守るか確認 失敗したテストからガードレールルールを生成し、デプロイ済みエージェントを保護 意図的に脆弱性を持たせたエージェントを使ったAIセキュリティテストの練習
- humanbound のインストール方法は?
- PyPIからCLIとSDKをインストールする: pip install humanbound LLMプロバイダーとAPIキーを設定する: export HB_PROVIDER=openai エージェント設定に対して敵対的テストを実行する: hb test --endpoint ./bot-config.json --repo . --wait
- humanbound はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/humanbound/humanbound
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
Tencent Zhuque Labが開発するフルスタックのAIレッドチームプラットフォーム。AIエージェント、MCPサーバー、Agent Skills、AIインフラのセキュリティリスクをスキャンします。
AIモデルファイル、コード、稼働中のLLM・エージェント・MCPエンドポイント、記録済みのエージェントトレースを検証し、問題点と未確認項目を報告するオープンソースのCLI・ライブラリです。
prompt injection、データ漏洩、jailbreak、有害な出力などの問題をLLMに対して検査する、オープンソースのコマンドラインスキャナー。
LLMシステムやAIエージェントへの攻撃をシミュレーションして脆弱性を見つけ、本番環境向けのガードレールも提供する、オープンソースのPython製レッドチームフレームワーク。
プロンプトインジェクションや脱獄攻撃に対するLLM、ガードレール、LLMアプリケーションのテストに使えるPythonツールキット。