AI Coding Assistant Lingma:Perbarui agen

Header permintaan

Header	Wajib	Deskripsi
Authorization	Ya	Bearer <PAT>
Content-Type	Ya	application/json

Parameter path

Parameter	Tipe	Wajib	Deskripsi
agent_id	string	Ya	Identifier unik agen.

Badan permintaan

Bidang	Tipe	Wajib	Deskripsi
version	integer	Ya	Nomor versi saat ini untuk OCC. Harus sesuai dengan nilai di sisi server.
name	string	Tidak	Nama agen, 1–256 karakter.
model	string|object	Tidak	Identifier model.
instructions	string	Tidak	Prompt sistem.
description	string	Tidak	Deskripsi agen.
tools	array	Tidak	Daftar konfigurasi tool.
mcp_servers	array	Tidak	Daftar konfigurasi server MCP.
skills	array	Tidak	Binding skill, dalam bentuk [{"type":"custom","skill_id":"[skill_id]"}]. Maksimal 20 entri.
metadata	object	Tidak	Pasangan kunci-nilai metadata kustom.
default_environment	string	Tidak	Lingkungan runtime default.

Contoh permintaan

curl -X PUT "https://api.qoder.com.cn/api/v1/cloud/agents/agent_019eXXXX..." \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "doc-test-agent-updated",
    "model": "ultimate",
    "instructions": "You are the updated documentation test assistant.",
    "description": "Used for API documentation testing.",
    "version": 1
  }'

Contoh respons

HTTP 200 OK

{
  "type": "agent",
  "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "name": "doc-test-agent-updated",
  "description": "Used for API documentation testing.",
  "model": "ultimate",
  "system": "You are the updated documentation test assistant.",
  "instructions": "You are the updated documentation test assistant.",
  "tools": [],
  "mcp_servers": [],
  "default_environment": "",
  "version": 2,
  "archived": false,
  "archived_at": null,
  "created_at": "2026-05-18T15:26:39.61669Z",
  "updated_at": "2026-05-18T15:27:07.967138Z"
}

Optimistic concurrency control (OCC)

Permintaan pembaruan menggunakan nomor versi sebagai kunci optimis:

1. Klien pertama-tama memanggil GET untuk mendapatkan version agen saat ini.

2. Klien mengirim pembaruan dengan menyertakan version tersebut dalam badan permintaan.

3. Server memverifikasi bahwa version tersebut sesuai dengan nilai saat ini di sisi server.

4. Jika sesuai, pembaruan berhasil dan version dinaikkan sebesar 1.

5. Jika tidak sesuai, server mengembalikan respons 409 Conflict.

Mekanisme ini mencegah klien konkuren saling menimpa perubahan pada agen yang sama.

Kesalahan

HTTP	Tipe	Pemicu
400	invalid_request_error	Badan permintaan atau nilai bidang tidak valid.
400	invalid_request_error	skills melebihi batas maksimum 20 entri.
401	authentication_error	PAT tidak valid atau telah kedaluwarsa.
403	permission_error	Pemanggil tidak memiliki izin untuk memperbarui agen ini.
404	not_found_error	Tidak ada agen dengan ID yang diberikan.
409	conflict_error	version tidak sesuai: modifikasi konkuren.

Contoh respons konflik versi (409):

{
  "type": "error",
  "error": {
    "type": "conflict_error",
    "message": "Version conflict. Expected version 99, got 1."
  }
}

Untuk struktur lengkap error, lihat Error.

Catatan

• version wajib disertakan; pengabaian nilai ini menyebabkan pembaruan gagal.

• version dinaikkan setiap kali pembaruan berhasil.

• Pembaruan menggunakan semantik partial-update (merge): bidang opsional yang tidak disertakan dalam badan permintaan mempertahankan nilai sebelumnya, sedangkan hanya bidang yang secara eksplisit diberikan yang diperbarui.

• Gunakan List Agent versions untuk melihat riwayat versi.