agentrisk

AgentRisk

AI 取引エージェント向けのリスクガードレールです。エージェントが提案し、ポリシーが判断します。

AgentRisk は取引執行の前段に位置し、ポートフォリオのリスクを分析して、提案された各取引をユーザーが作成したポリシーに照らして確認し、そのポリシーを管理します。コアは決定論的（同じ入力には同じ判定）、透明性が高く（ポリシーは読み取りや編集が可能なプレーンな YAML）、フェイルクローズ設計です（入力が無効、またはポリシーがない場合は、黙って通過させずブロックします）。

AgentRisk は取引を推奨せず、執行もしません。PASS は、取引がユーザー自身が作成したルールに違反しなかったという意味であり、安全または収益性があるという意味ではありません。DISCLAIMER.md を参照してください。

クイックスタート

Claude エージェントを使う最も手早い方法は、Claude Code プラグインです。Agent Skill をインストールし、MCP サーバーを一度に登録します（uvx 経由のため、ほかにインストールするものはありません）。

/plugin marketplace add trycoin-ai/agentrisk
/plugin install agentrisk@agentrisk

ほかの MCP クライアントを使う場合は、サーバーを自分で登録してください。

{
  "mcpServers": {
    "agentrisk": {
      "command": "uvx",
      "args": ["--from", "agentrisk[mcp]", "agentrisk-mcp"]
    }
  }
}

あとは自然な英語で質問するだけで、エージェントが質問を次の 3 つのツール呼び出しに変換します。

ツール	回答する質問	返される内容
analyze_portfolio_risk	保有しているリスクはどの程度ですか？	集中度、エクスポージャー、ポリシー準拠状況のレポート
check_trade_risk	この取引を実行してよいですか？	PASS／WARN／BLOCK と、その理由を示す 1 行の説明
generate_risk_policy	自分のルールは何ですか？	人が読みやすい YAML ポリシー（作成、更新、表示）

プラグインを使うには、uvx 用の uv が必要です。Claude Desktop を 2 分でセットアップする方法については、examples/claude_desktop.md を参照してください。

Agent Skill

Claude エージェント向けに、AgentRisk ではオプションの Agent Skill を提供しています。これはガードレールが依存する手順を定めるものです。注文をブローカーに送る前に、取引を分類し、check_trade_risk を呼び出し、判定に従い、結果を記録します。この順番を守る必要があります。上記のプラグインを使うと、サーバーと一緒にインストールされます。スキルだけをインストールするには、次の手順に従ってください。

• Claude Code または Claude Desktop： skills/agentrisk/ を ~/.claude/skills/ にコピーします。
• claude.ai： skills/agentrisk/SKILL.md をスキルとしてアップロードします。

執行契約

AgentRisk は助言を返します。注文を物理的に止めることはできないため、連携する側で判定に基づいて執行を制御する必要があります。

result = check_trade_risk(portfolio, trade)
if not result.proceed:
    refuse(result.summary)              # BLOCK: never call the broker
elif result.acknowledgements_required:
    confirm_with_user(result)           # WARN: surface warnings first
else:
    execute(trade)                      # PASS

判定にかかわらずブローカーを呼び出すなら、それはガードレールではなくロガーです。連携ガイドを参照してください。

ライブラリを直接使用する

3 つのツールは純粋な Python ライブラリとしても利用でき、コア部分でネットワーク呼び出しや LLM は使用しません。

pip install agentrisk

各パラメーター、戻り値のフィールド、エラーケースについては、ツールリファレンスを参照してください。

チェック項目

• 集中度の上限： 個別銘柄、セクター、テーマ、資産クラスごとに設定し、取引後のシミュレーション済みポートフォリオを対象に評価します。
• 資産クラスのルール： 暗号資産、オプション、マージンについて、許可、警告、またはブロックします。
• 注文の妥当性： 注文サイズの上限、最低現金残高、資金不足の検出。
• 取引制限対象のシンボルとデータ品質： 古いスナップショットには警告を出し、無効なスナップショットはブロックします。

ポリシーリファレンスでは、すべてのフィールドと安全動作（フェイルクローズ、決済を決して妨げないこと、違反を悪化させる取引のみをブロックすること、および 1 回限りのバイパス）について説明しています。

ドキュメント

ドキュメント	内容
コンセプト	メンタルモデルとエージェント／AgentRisk の役割分担
アーキテクチャ	モジュール構成と、コアを通じた呼び出しの流れ
ポリシーリファレンス	各ポリシーフィールドと、それによって決まるチェックの動作
ツールリファレンス	3 つすべてのツールのパラメーター、出力、エラーケース
CLI リファレンス	agentrisk コマンド：policy、check、analyze
統合ガイド	適用の契約、ブローカー MCP との組み合わせ、監査ログ
脅威モデル	AgentRisk で保護できることと、できないこと
分類データ	オープンな分類体系と、修正の提案方法

ロードマップ

次は決定論的なストレスシナリオ、ETF のルックスルー、行動制限（v0.2）を予定しています。その後、オプション分析、ブローカーのスナップショットアダプター、ショートポジション、複数通貨への対応（v0.3）を予定しています。取引の推奨、シグナル、執行、テレメトリーは恒久的に対象外です。マイルストーンをご覧ください。

コントリビューション

分類データの修正や、新しい決定論的チェックを特に歓迎します。CONTRIBUTING.mdをご覧ください。また、コアは純粋な状態に保ってください。ネットワーク、LLM の呼び出し、隠れた状態は使用しません。

ライセンス

MIT です。LICENSEをご覧ください。