テンプレートの更新 - Qoder CN シリーズ - Alibaba Cloud ドキュメントセンター

ID を指定して Forward テンプレートを更新します。

リクエストヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT>`
`Content-Type`	はい	`application/json`
`Idempotency-Key`	いいえ	安全でないリクエスト用のオプションのべき等キー。

パスパラメーター

パラメーター	タイプ	必須	説明
`template_id`	文字列	はい	Forward テンプレートの ID。

リクエストボディ

パラメーター	タイプ	必須	説明
`name`	文字列	いいえ	新しいテンプレート名。
`description`	文字列	いいえ	新しいテンプレートの説明。
`model`	文字列	いいえ	新しいモデル識別子。
`system`	文字列	いいえ	新しいシステムプロンプト。
`tools`	配列	いいえ	ツール構成リストを置き換えます。
`mcp_servers`	配列	いいえ	MCP サーバーリストを置き換えます。
`skills`	配列	いいえ	スキルバインディングリストを置き換えます。
`multiagent`	オブジェクト	いいえ	マネージド型エージェント構成を置き換えます。
`environment_id`	string \| null	いいえ	デフォルトの環境 ID を置き換えます。 `null` または空の文字列でクリアされます。
`vault_ids`	array \| null	いいえ	デフォルトの Vault ID を置き換えます。 `null` でリストがクリアされます。
`files`	object \| null	いいえ	デフォルトのファイルリソースを置き換えます。 `null` でマップがクリアされます。
`environment_variables`	object \| string \| null	いいえ	デフォルトのセッション環境変数を置き換えます。 `null` でクリアされます。
`metadata`	オブジェクト	いいえ	更新をカスタムメタデータにマージします。

ネストされた構成オブジェクト

tools、mcp_servers、および skills はすべて配列フィールドです。更新時に指定した場合、各配列は以前の配列を完全に置き換えます。

ファイル

files は、ファイル ID をキーとするマップです。エントリー内に file_id、id、または resource_id を含めないでください。セッションが作成されると、Forward は mount_path を自動的に挿入します。

フィールド	タイプ	必須	説明
`enabled`	ブール値	いいえ	省略した場合は `true` として扱われます。ID 構成では、継承されたファイルを無効にするために `false` に設定します。

tools[] の項目

各 tools[] エントリーは、type フィールドによってその形状が決まります。

フィールド	タイプ	適用対象	説明
`type`	文字列	すべて	必須。 `agent_toolset_20260401`、`mcp_toolset`、または `custom` のいずれか。
`enabled_tools`	配列	`agent_toolset_20260401`	簡易的な許可リスト。空でない配列を指定すると、リストされている組み込みツールのみが有効になります。
`disallowed_tools`	配列	`agent_toolset_20260401`	簡易的な拒否リスト。ツールを無効化する設定へとコンパイルされます。
`configs`	配列	`agent_toolset_20260401`, `mcp_toolset`	ツールごとの有効化と許可ポリシー。
`mcp_server_name`	文字列	`mcp_toolset`	必須。 `mcp_servers[].name` と一致する必要があります。
`name`	文字列	`custom`	必須。カスタムツール名。組み込みツールと重複しないようにしてください。
`description`	文字列	`custom`	必須。カスタムツールの説明。
`input_schema`	オブジェクト	`custom`	必須の JSON Schema。 `input_schema.type` は `object` である必要があります。

組み込みツール名には、Bash、Read、Write、Edit、Glob、Grep、WebFetch、WebSearch、および DeliverArtifacts が含まれます。

ツール構成

tools[].configs[] の各エントリーは、次の構造を持ちます。

フィールド	タイプ	必須	説明
`name`	文字列	はい	ツール名。組み込みツールには組み込みツール名を、MCP ツールセットには MCP ツール名を使用します。
`enabled`	ブール値	いいえ	`false` はツールを非表示にして拒否します。 `true` は明示的に有効にします。
`permission_policy`	オブジェクト	いいえ	ランタイムの許可動作。

許可ポリシー

フィールド	タイプ	必須	説明
`type`	文字列	はい	`always_allow`、`always_ask`、または `always_deny` のいずれか。

MCP サーバー

フィールド	タイプ	必須	説明
`type`	文字列	いいえ	現在、 `http` のみがサポートされています。省略した場合、有効構成はこのエントリーを HTTP MCP サーバーとして扱います。
`name`	文字列	はい	`tools[].mcp_server_name` によって参照される、テンプレート内で一意の MCP サーバー名。
`url`	文字列	はい	ストリーミング可能な HTTP MCP エンドポイントの URL。

skills[] の項目

フィールド	タイプ	必須	説明
`type`	文字列	はい	`custom` または `qoder` のいずれか。
`skill_id`	文字列	はい	スキル ID。
`version`	文字列	いいえ	スキルバージョン。省略すると最新バージョンが使用されます。
`enabled`	ブール値	いいえ	省略した場合は `true` として扱われます。 `false` は、コンパイルされたエージェント構成からスキルを除外します。

リクエスト例

curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/templates/tmpl_support' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support assistant v2",
    "environment_id": "env_support_v2",
    "vault_ids": ["vault_crm", "vault_billing"],
    "environment_variables": {
      "BASE_MODE": "support_v2"
    }
  }'

レスポンス例

HTTP 200 OK

{
  "type": "template",
  "id": "tmpl_support",
  "name": "Support assistant v2",
  "description": "Handles pre-sales and after-sales support",
  "status": "active",
  "model": "ultimate",
  "system": "You are a helpful support assistant.",
  "tools": [],
  "mcp_servers": [],
  "skills": [],
  "multiagent": null,
  "environment_id": "env_support_v2",
  "vault_ids": ["vault_crm", "vault_billing"],
  "files": {},
  "environment_variables": {
    "BASE_MODE": "support_v2"
  },
  "metadata": {},
  "created_at": "2026-06-18T10:00:00Z",
  "updated_at": "2026-06-18T10:30:00Z"
}

レスポンスフィールド

更新されたテンプレートオブジェクトが返されます。

エラー

HTTP	タイプ	トリガー
400	`invalid_request_error`	リクエストボディが無効、またはサポートされていないフィールド値が指定された場合。
401	`authentication_error`	PAT が無効、または期限切れの場合。
404	`not_found_error`	テンプレートまたは参照先のリソースが存在しない場合。
409	`conflict_error`	テンプレート名がすでに存在する場合。

注意事項

アーカイブ済みのテンプレートは更新できません。
セッションのデフォルトを更新しても、既存のセッションは変更されません。