Perbarui templat - Seri Qoder CN - Alibaba Cloud Documentation Center

Perbarui templat Forward berdasarkan ID.

Header permintaan

Header	Wajib	Deskripsi
`Authorization`	Ya	`Bearer <PAT>`
`Content-Type`	Ya	`application/json`
`Idempotency-Key`	Tidak	Kunci idempotensi opsional untuk permintaan yang tidak aman.

Parameter path

Parameter	Tipe	Wajib	Deskripsi
`template_id`	string	Ya	ID Templat Forward.

Badan permintaan

Parameter	Tipe	Wajib	Deskripsi
`name`	string	Tidak	Nama templat baru.
`description`	string	Tidak	Deskripsi templat baru.
`model`	string	Tidak	Identifier model baru.
`system`	string	Tidak	Prompt sistem baru.
`tools`	array	Tidak	Menggantikan daftar konfigurasi tool.
`mcp_servers`	array	Tidak	Menggantikan daftar server MCP.
`skills`	array	Tidak	Menggantikan daftar binding Skill.
`multiagent`	object	Tidak	Menggantikan konfigurasi Managed Agents.
`environment_id`	string \| null	Tidak	Menggantikan ID Environment default. `null` atau string kosong akan menghapusnya.
`vault_ids`	array \| null	Tidak	Menggantikan ID Vault default. `null` akan menghapus daftar tersebut.
`files`	object \| null	Tidak	Menggantikan resource file default. `null` akan menghapus map tersebut.
`environment_variables`	object \| string \| null	Tidak	Menggantikan variabel lingkungan session default. `null` akan menghapusnya.
`metadata`	object	Tidak	Menggabungkan pembaruan ke dalam metadata kustom.

Objek konfigurasi bersarang

tools, mcp_servers, dan skills semuanya merupakan field array; ketika disediakan dalam pembaruan, setiap array sepenuhnya menggantikan array sebelumnya.

Files

files adalah map yang diindeks berdasarkan File ID. Jangan sertakan file_id, id, atau resource_id di dalam entri. Forward secara otomatis menyisipkan mount_path saat session dibuat.

Field	Tipe	Wajib	Deskripsi
`enabled`	boolean	Tidak	Jika dihilangkan, dianggap sebagai `true`. Dalam Identity Config, atur ke `false` untuk menonaktifkan file yang diwariskan.

Item tools[]

Setiap entri tools[] menentukan bentuknya melalui field type.

Field	Tipe	Berlaku untuk	Deskripsi
`type`	string	Semua	Wajib. Salah satu dari `agent_toolset_20260401`, `mcp_toolset`, atau `custom`.
`enabled_tools`	array	`agent_toolset_20260401`	Daftar izin praktis; array tidak kosong hanya mengaktifkan tool bawaan yang tercantum.
`disallowed_tools`	array	`agent_toolset_20260401`	Daftar penolakan praktis; dikompilasi menjadi konfigurasi tool yang dinonaktifkan.
`configs`	array	`agent_toolset_20260401`, `mcp_toolset`	Izin dan kebijakan pengaktifan per-tool.
`mcp_server_name`	string	`mcp_toolset`	Wajib. Harus sesuai dengan `mcp_servers[].name`.
`name`	string	`custom`	Wajib. Nama tool kustom; tidak boleh bertabrakan dengan tool bawaan.
`description`	string	`custom`	Wajib. Deskripsi tool kustom.
`input_schema`	object	`custom`	Skema JSON wajib. `input_schema.type` harus bernilai `object`.

Nama tool bawaan mencakup Bash, Read, Write, Edit, Glob, Grep, WebFetch, WebSearch, dan DeliverArtifacts.

Konfigurasi tool

Setiap entri dalam tools[].configs[] menggunakan struktur berikut.

Field	Tipe	Wajib	Deskripsi
`name`	string	Ya	Nama tool; gunakan nama tool bawaan untuk tool bawaan dan nama tool MCP untuk toolset MCP.
`enabled`	boolean	Tidak	`false` menyembunyikan dan menolak tool; `true` mengaktifkannya secara eksplisit.
`permission_policy`	object	Tidak	Perilaku izin saat runtime.

Kebijakan izin

Field	Tipe	Wajib	Deskripsi
`type`	string	Ya	Salah satu dari `always_allow`, `always_ask`, atau `always_deny`.

Server MCP

Field	Tipe	Wajib	Deskripsi
`type`	string	Tidak	Hanya `http` yang didukung saat ini. Jika dihilangkan, Effective Config memperlakukan entri tersebut sebagai server MCP HTTP.
`name`	string	Ya	Nama server MCP yang unik dalam Templat dan dirujuk oleh `tools[].mcp_server_name`.
`url`	string	Ya	URL titik akhir MCP HTTP yang dapat dialirkan.

Item skills[]

Field	Tipe	Wajib	Deskripsi
`type`	string	Ya	Salah satu dari `custom` atau `qoder`.
`skill_id`	string	Ya	ID Skill.
`version`	string	Tidak	Versi Skill. Hilangkan untuk menggunakan versi terbaru.
`enabled`	boolean	Tidak	Jika dihilangkan, dianggap sebagai `true`. `false` mengecualikan skill dari konfigurasi Agent yang dikompilasi.

Contoh permintaan

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"
    }
  }'

Contoh tanggapan

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"
}

Field tanggapan

Mengembalikan objek Templat yang telah diperbarui.

Kesalahan

HTTP	Tipe	Pemicu
400	`invalid_request_error`	Badan permintaan tidak valid atau nilai field tidak didukung.
401	`authentication_error`	PAT tidak valid atau kedaluwarsa.
404	`not_found_error`	Templat atau resource yang dirujuk tidak ada.
409	`conflict_error`	Nama templat sudah ada.

Catatan

Templat yang diarsipkan tidak dapat diperbarui.
Memperbarui sesi default tidak mengubah sesi yang sudah ada.