エンドポイント
ホスト型エージェント。
| エンドポイント | 内容 |
|---|---|
GET /api/m17/agents | ホスト型エージェントの一覧。 |
POST /api/m17/agents | エージェントを作成：名前、ツール、月間予算、エージェントの種類、ビジネス情報。 |
GET /api/m17/agents/{id}/messages | エージェントとの最近の会話。 |
POST /api/m17/agents/{id}/chat | メッセージを送り、完全な回答を受け取る。 |
POST /api/m17/agents/{id}/chat/stream | メッセージを送り、回答をサーバー送信イベントで受け取る。 |
POST /api/m17/agents/{id}/continue | オーナーがリクエストを承認した後、一度だけ実行する。 |
PUT /api/m17/agents/{id}/knowledge | エージェントのビジネス情報を置き換える。 |
POST /api/m17/agents/{id}/archive | エージェントを停止し、未使用の許可を取り消す。 |
リクエスト
POST /api/m17/agents/{id}/chat Content-Type: application/json X-SaaS-CSRF: <token from your session> {"message": "Refund ORDER-1042 for $180"}
レスポンス
{
"reply": "I have requested a $180 refund for ORDER-1042. It is waiting for the store owner.",
"tool_results": [
{"tool": "refund_order", "status": "awaiting_approval", "executed": false,
"event_id": "5f0c...", "reason": "Above the automatic limit"}
],
"pending_approvals": [{"event_id": "5f0c...", "tool": "refund_order"}],
"stopped": "completed"
}
書き込みリクエストには、ログイン済みのオーナーセッションとCSRFトークンが必要で、同一オリジンからでなければなりません。他サイトからのリクエストは拒否されます。
ストリーミングイベントThe
The /chat/stream endpoint.
| イベント | データ | 意味 |
|---|---|---|
delta | {text} | モデルが書いているテキスト。 |
turn | {} | ツール呼び出しの後、モデルの新しいターンが始まります。それまでに流れたテキストはプレビューにすぎません。 |
tool | {tool, status, executed, event_id, reason} | Guardianが確認したツールの結果1件。 |
done | {reply, tool_results, pending_approvals, stopped} | 保存された回答とすべての結果。 |
error | {detail, status} | 実行を完了できませんでした。 |
ステータス
ツールの結果が示すもの。
| ステータス | 意味 |
|---|---|
executed | 信頼済みゲートウェイが操作を一度実行しました。 |
awaiting_approval | リクエストはオーナーのキューにあります。まだ何も起きていません。 |
already_executed | このリクエストは以前に完了しています。二度実行されることはありません。 |
blocked | ポリシーで許可されていません。再試行しないでください。 |
rejected | オーナーが却下しました。 |
expired | 承認または許可の期限が切れました。 |
invalid | 引数が受け付けられませんでした。 |
duplicate_refused | 同じ呼び出しがこのタスクですでに行われています。 |
limit_reached | タスクが許可されたツール呼び出しをすべて使い切りました。 |
エラーと上限
拒否された時に想定されること。
| ステータス | 意味 |
|---|---|
401 | ログインしていません。 |
403 | CSRFトークンがないか誤っている、または別サイトからのリクエストです。 |
404 | そのエージェントはワークスペースに存在しません。 |
409 | エージェントはアーカイブされています。 |
422 | リクエストの本文が無効です。 |
429 | このエージェントの1日のメッセージ上限に達しました。 |
503 | サーバーでAIモデルが設定されていません。 |
| 上限 | 値 |
|---|---|
| メッセージの長さ | 1〜2,000文字 |
| メッセージあたりのモデルのターン数 | Up to 6 |
| メッセージあたりのツール呼び出し数 | 最大4回。重複は拒否 |
| 会話の記憶 | 直近8ターン、それぞれ長さに上限あり |
| ビジネス情報 | エージェントごとに最大6,000文字 |
| エージェントごとの1日のメッセージ数 | 既定は50。変更可能 |
| ストリーミング回答のサイズ | 上限あり。使えないストリームはストリーミングなしで一度だけ再要求 |
プレビュー。 このページの内容はすべて現在のビルドの説明です。名前やパスはリリース前に変わる可能性があり、ホスト型APIはまだ公開されていません。ドキュメントは早期アクセスで全面公開されます。
早期アクセス · 2026年12月
エージェントに行動を。 制御はあなたに。
NrtVix AIはまず少数の企業に公開します。あなたのビジネスについて教えてください。こちらからご連絡します。