AI Coding Assistant Lingma:Arsipkan agen

Header permintaan

Header	Wajib	Deskripsi
Authorization	Ya	Bearer <PAT>

Parameter path

Parameter	Tipe	Wajib	Deskripsi
agent_id	string	Ya	Identifier unik agen.

Badan permintaan

Tidak diperlukan badan permintaan.

Contoh permintaan

curl -X POST "https://api.qoder.com.cn/api/v1/cloud/agents/agent_019eXXXX.../archive" \
  -H "Authorization: Bearer $QODER_PAT"

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 testing assistant.",
  "instructions": "You are the updated documentation testing assistant.",
  "tools": [],
  "mcp_servers": [],
  "default_environment": "",
  "version": 2,
  "created_at": "2026-05-18T15:26:39.61669Z",
  "updated_at": "2026-05-18T15:27:22.698411Z"
}

Bidang respons

Mengembalikan objek agen lengkap setelah diarsipkan. Bidang updated_at diperbarui ke waktu operasi arsip.

Bidang	Tipe	Deskripsi
type	string	Selalu "agent".
id	string	Identifier unik agen.
name	string	Nama agen.
description	string	Deskripsi agen.
model	string	Identifier model.
instructions	string	Prompt sistem.
system	string	Alias dari instructions. Tidak digunakan lagi; gunakan instructions.
tools	array	Konfigurasi tool.
mcp_servers	array	Konfigurasi server MCP.
default_environment	string	Lingkungan runtime default.
version	integer	Nomor versi saat ini.
created_at	string	Waktu pembuatan dalam format ISO 8601.
updated_at	string	Waktu pembaruan terakhir dalam format ISO 8601. Diperbarui saat diarsipkan.

Kesalahan

HTTP	Tipe	Pemicu
401	authentication_error	PAT tidak valid atau telah kedaluwarsa.
403	permission_error	Pemanggil tidak memiliki izin untuk mengarsipkan agen ini.
404	not_found_error	Tidak ada agen dengan ID yang diberikan.

Lihat Kesalahan untuk struktur lengkap respons kesalahan.

Arsip vs. hapus

Tindakan	Efek	Dapat dipulihkan
Archive	Agen disembunyikan dari daftar default; data tetap disimpan.	Ya (dukungan unarchive tersedia).
Delete	Agen dihapus secara permanen.	Tidak.

Catatan

• Pengarsipan merupakan penghapusan lunak; data agen tetap berada dalam sistem.

• Agen yang diarsipkan tidak termasuk dalam respons default dari GET /v1/agents.

• Agen yang diarsipkan tetap dapat diambil melalui GET /v1/agents/{agent_id}.

• Operasi ini bersifat idempoten; mengarsipkan agen yang sudah diarsipkan tidak menimbulkan kesalahan.