Guardianを 今あるエージェントの前に。
エージェントがツールを呼び出すなら、NrtVix経由で呼び出せます。エージェントが操作を提案し、Guardianが判断を返し、信頼済みゲートウェイが許可されたものを実行します。
NrtVix AI / 開発者
保護されたツール呼び出しまで 3ステップ。
- ステップ1
エージェントを登録
ワークスペースにエージェントを作成し、使えるツールを選びます。エージェントが受け取るのはアイデンティティだけで、使える秘密情報は渡しません。
- ステップ2
Guardian経由でツールを呼び出す
ツールを直接呼び出す代わりに、保護されたツールボックスを使います。すべての呼び出しは検証された後、Guardianに提案されます。
- ステップ3
判断を処理する
ステータスを読みます:実行済み、承認待ち、またはブロック。何が起きたかをユーザーに正直に伝えます。
- その後
承認後に再開
オーナーが承認したら、同じリクエストをIDで再開します。ゲートウェイで一度だけ実行されます。
from nrtvix import GuardedToolbox tools = GuardedToolbox(bridge) # your workspace + agent identity result = tools.call("refund_order", order="ORDER-1042", amount=180) if result.status == "executed": ... # done by the trusted gateway elif result.status == "awaiting_approval": ... # tell the customer it is with the owner else: ... # blocked or refused: do not retry
const res = await fetch(APP + "/api/m17/agents/" + agentId + "/chat/stream", { method: "POST", credentials: "include", headers: { "Content-Type": "application/json", "X-SaaS-CSRF": csrf }, body: JSON.stringify({ message: "Refund ORDER-1042 for $180" }), }); const reader = res.body.getReader(); // server-sent events over POST // event: delta -> text as the model writes it // event: tool -> one Guardian-checked tool result // event: done -> the final reply and all results
curl -X POST "$APP/api/m17/agents/$AGENT_ID/chat" \ -H "Content-Type: application/json" \ -H "X-SaaS-CSRF: $CSRF" -b cookies.txt \ -d '{"message": "Look up CUSTOMER-01"}' # {"reply": "...", "tool_results": [{"tool": "lookup_customer", # "status": "executed", "executed": true, ...}], "stopped": "completed"}
プレビュー。 このページの内容はすべて現在のビルドの説明です。名前やパスはリリース前に変わる可能性があり、ホスト型APIはまだ公開されていません。ドキュメントは早期アクセスで全面公開されます。
1回の呼び出しに、 1つの明確なステータス。
同じ種類のリクエストでも結果は異なります。エージェントはステータスを読み、何が起きたかをユーザーに正直に伝えます。
executed: the gateway ran the action onceawaiting_approval: the owner decides; resume the same request afterwardsblocked: policy does not allow it, so do not retryalready_executed: a repeated request is never run twice
executed
Guardianチェック
承認が必要
小さな接点。 強い保証。
保護されたツール
引数のスキーマが厳格な、固定のツールカタログ。エージェントがツールを作り出すことはできません。
ひとつの判断形式
どのツールも同じステータスなので、エージェントのロジックはシンプルなままです。
ストリーミングのチャットAPI
モデルが書いている間、回答がサーバー送信イベントとして届き、その間にツールの結果が入ります。
エージェントに秘密情報を持たせない
エージェントが持つのはアイデンティティだけ。ツールの認証情報はゲートウェイに残ります。
検証できる監査
エンドポイントがワークスペースの監査ハッシュチェーンを再計算します。
ローカルラボ
すべてサンプルデータを使ってローカルで動くので、本番前に安全にテストできます。
現在4つのツール。 さらに追加予定。
| ツール | 引数 | 内容 | Guardianが確認すること |
|---|---|---|---|
lookup_customer | customer | 番号で顧客記録を検索 | 読み取りのみ |
refund_order | order, amount | 米ドルで注文を返金 | 金額の上限、予算、承認 |
add_support_note | ticket, note | チケットに500文字までのメモを追加 | 文字数の上限 |
export_customer_manifest | export, rows | 1〜1,000行の顧客エクスポートを準備 | 行数の上限、承認 |
ツール呼び出しが 返すもの。
| ステータス | 意味 |
|---|---|
executed | 信頼済みゲートウェイが操作を一度実行しました。 |
awaiting_approval | リクエストはオーナーのキューにあります。まだ何も起きていません。 |
already_executed | このリクエストは以前に完了しています。二度実行されることはありません。 |
blocked | ポリシーで許可されていません。再試行しないでください。 |
rejected | オーナーが却下しました。 |
expired | 承認または許可の期限が切れました。 |
invalid | 引数が受け付けられませんでした。 |
duplicate_refused | 同じ呼び出しがこのタスクですでに行われています。 |
limit_reached | タスクが許可されたツール呼び出しをすべて使い切りました。 |
テキストは書かれるそばから。 結果は判断されるそばから。
| イベント | データ | 意味 |
|---|---|---|
delta | {text} | モデルが書いているテキスト。 |
turn | {} | ツール呼び出しの後、モデルの新しいターンが始まります。それまでに流れたテキストはプレビューにすぎません。 |
tool | {tool, status, executed, event_id, reason} | Guardianが確認したツールの結果1件。 |
done | {reply, tool_results, pending_approvals, stopped} | 保存された回答とすべての結果。 |
error | {detail, status} | 実行を完了できませんでした。 |
妥当な上限を、 最初に明示。
| 上限 | 値 |
|---|---|
| メッセージの長さ | 1〜2,000文字 |
| メッセージあたりのモデルのターン数 | Up to 6 |
| メッセージあたりのツール呼び出し数 | 最大4回。重複は拒否 |
| 会話の記憶 | 直近8ターン、それぞれ長さに上限あり |
| ビジネス情報 | エージェントごとに最大6,000文字 |
| エージェントごとの1日のメッセージ数 | 既定は50。変更可能 |
| ストリーミング回答のサイズ | 上限あり。使えないストリームはストリーミングなしで一度だけ再要求 |
シンプルなHTTPステータスコード。
| ステータス | 意味 |
|---|---|
401 | ログインしていません。 |
403 | CSRFトークンがないか誤っている、または別サイトからのリクエストです。 |
404 | そのエージェントはワークスペースに存在しません。 |
409 | エージェントはアーカイブされています。 |
422 | リクエストの本文が無効です。 |
429 | このエージェントの1日のメッセージ上限に達しました。 |
503 | サーバーでAIモデルが設定されていません。 |
開発者向けの予定。
Webhook 予定
リクエストが承認、却下、期限切れになった時に通知を受け取れます。
JavaScript SDK 予定
Node.jsとブラウザ向けの保護されたツールボックス。
APIキー 予定
ホスト型API用の権限範囲付きキー。ダッシュボードからローテーション。
バージョン付きAPI 予定
開始時にバージョンプレフィックス付きの安定したパス。
どのモデルやフレームワークで使えますか?
関数を呼び出せるモデルやフレームワークなら何でも。現在のビルドのホスト型エージェントは提供元のAPIを通じて大規模言語モデルを使用しています。SDKは特定のモデルに依存しません。
エージェントが自分のリクエストを承認できますか?
いいえ。承認は、正確なリクエストに紐づいた、認証済みのオーナーによる別の操作です。エージェントにできるのは依頼だけです。
ブロックされた呼び出しをエージェントが再試行するとどうなりますか?
再び拒否されます。タスク内で繰り返された同一の呼び出しは重複として拒否され、ブロックされた操作はブロックされたままです。
ホスト型APIはいつ使えますか?
2026年12月予定の早期アクセスからです。それまでAPIはローカルビルドでのみ動作します。
エージェントに行動を。 制御はあなたに。
NrtVix AIはまず少数の企業に公開します。あなたのビジネスについて教えてください。こちらからご連絡します。