コンテンツへスキップ

ユースケースエージェント

トレースでき、制限でき、止められるエージェント。

エージェントの1回の実行は、数十回のモデル呼び出しとツール呼び出しです。それらを1つのゲートウェイキーと1つのトレースIDで通すと、すべてのステップが1つのタイムラインに並び、すべてのツールは承認した定義から呼び出され、実行が超えられない支出上限が設定されます。

トレース checkout-123 · トリアージエージェント例
ステップ1 · モデルclaude-sonnet-5.5 · 200 · 1.8 s
ステップ2 · ツールgithub_list_issues · 200 · 0.6 s
ステップ3 · ツールgithub_close_issue · 拒否、付与されていない
ステップ4 · モデルclaude-sonnet-5.5 · 200 · 1.1 s

実行の例です。INFROはツールを実行しません。MCPサーバーとそのアカウントは、お客様のものです。

課題

コントロールプレーンがない場合

  • 各エージェントが、すべてのツールサーバーのトークンを自分の設定に持っている。
  • ツールの定義がサーバー側で変わり、エージェントがそれに従う。
  • ループする実行は、請求書で気づく。

INFROがある場合

  • ツールの認証情報はINFROに残り、エージェントはゲートウェイキーを送ります。
  • ツールは、管理者が承認して固定した定義から提供されます。
  • 各エージェントのキーに上限があり、すべての実行が1つのトレースになります。

仕組み

  1. ツールサーバーを一度だけ登録

    管理者が各MCPサーバーをトークンとともに追加し、ツールを承認します。エージェントがサーバーの認証情報を目にすることはありません。

  2. キーごとに付与

    既定では拒否されます。エージェントのキーに、1つのサーバーの読み取りツール、すべてのツール、または名前を指定した一部を付与してください。キーをローテーションしても付与は維持されます。

  3. トレースIDを1つ送る

    同じX-INFRO-Trace-Idを持つモデル呼び出しとツール呼び出しは、GET /v1/tracesから1つの実行として返され、ステップごとに結果、レイテンシー、コストが付きます。

得られるもの

いずれもドキュメント化されており、どのプランに含まれるかを明記しています。プランの記載がないものは、すべてのプランに含まれます。

  • 実行ごとに1つのトレース

    同じトレースIDを持つモデル呼び出しとツール呼び出しは、1つの実行として返され、各ステップに結果とレイテンシーが付きます。

    ドキュメント
  • 承認済みで固定されたツールBusinessから

    エージェントには、管理者が承認した定義が渡されます。サーバー側で変更されたツールは、誰かがレビューするまで拒否されます。

    ドキュメント
  • キーごとの許可Businessから

    既定では拒否されます。キーに、1つのサーバーの読み取りツール、そのすべてのツール、または名前を指定した一部を付与してください。

    ドキュメント
  • エージェントごとの上限

    エージェントのキーには、実行が超えられない上限があり、次のリクエストは、プロバイダー呼び出しの前に拒否されます。

    ドキュメント
  • ガードレールBusinessから

    プロンプト、レスポンス、ツールの引数と結果に対するパターンチェック:ブロック、マスク、またはフラグ付け。検出は見逃すことがあります。

    ドキュメント
  • すべてのプランにキルスイッチ

    サーバーの無効化、ツールのブロック、すべてのツールトラフィックの停止を、監査される1つの操作で行えます。アクセスをオフにすることが、プランで制限されることはありません。

    ドキュメント

対象

  • エージェント開発者5つのダッシュボードではなく、実行ごとに1つのタイムライン。ツールへのアクセスは、エージェントのコードの外で定義。
  • プラットフォームチームツールの認証情報を1か所に、キーごとに付与し、すべての呼び出しをログに記録。
  • セキュリティツールの定義は、レビューなしにエージェントの足元で変わることがなく、すべての呼び出しをオフにできます。

よくある質問

INFROは、ツールを実行しますか?

いいえ。INFROは、各呼び出しを、登録された認証情報を使ってお客様自身のMCPサーバーに転送し、記録します。サーバーとそのアカウントは、お客様のものです。

ガードレールはプロンプトインジェクションを防ぎますか?

いいえ。固定された定義、付与、ガードレールは、注入された指示が到達できる範囲を狭めますが、注入そのものを検出したり防いだりするものではありません。

どのエージェントフレームワークが使えますか?

Streamable HTTPに対応し、Authorizationヘッダーを送るあらゆるMCPクライアント。OpenAI Agents SDKとClaude Agent SDKを含みます。モデル呼び出しには、すでに送っているOpenAIまたはAnthropicの形式を使います。

契約の全文はMCPゲートウェイのドキュメントにあり、その他の質問はFAQにあります。

始める

自社のプロバイダーアカウントで試す。

プロバイダーを接続し、ゲートウェイキーを作成し、ベースURLを1つ変えるだけ。プロバイダーからの直接請求はそのままで、モデル支出への上乗せは0%です。