AI Coding Assistant Lingma:Daftar versi agen

Header permintaan

Header	Wajib	Deskripsi
Authorization	Ya	Bearer <PAT>

Parameter path

Parameter	Tipe	Wajib	Deskripsi
agent_id	string	Ya	Pengidentifikasi unik agen.

Parameter kueri

Parameter	Tipe	Wajib	Bawaan	Deskripsi
limit	integer	Tidak	20	Jumlah hasil per halaman.
order	string	Tidak	desc	Arah pengurutan. Bisa berupa "asc" atau "desc".
after_id	string	Tidak	-	Kursor. Kembalikan catatan setelah versi ini.
before_id	string	Tidak	-	Kursor. Kembalikan catatan sebelum versi ini.

Lihat Pagination untuk semantik kursor.

Contoh permintaan

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

Contoh respons

HTTP 200 OK

{
  "data": [
    {
      "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,
      "created_at": "2026-05-18T15:26:39.61669Z",
      "updated_at": "2026-05-18T15:27:07.967138Z"
    },
    {
      "type": "agent",
      "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "name": "doc-test-agent",
      "description": "",
      "model": "ultimate",
      "system": "You are a documentation test assistant.",
      "instructions": "You are a documentation test assistant.",
      "tools": [],
      "mcp_servers": [],
      "default_environment": "",
      "version": 1,
      "created_at": "2026-05-18T15:26:39.61669Z",
      "updated_at": "2026-05-18T15:26:39.61669Z"
    }
  ],
  "first_id": "2",
  "last_id": "1",
  "has_more": false
}

Bidang respons

Bidang	Tipe	Deskripsi
data	array	Array Snapshot versi agen. Setiap elemen merupakan objek agen lengkap pada saat versi tersebut dibuat.
first_id	string	Pengidentifikasi versi dari catatan pertama pada halaman saat ini.
last_id	string	Pengidentifikasi versi dari catatan terakhir pada halaman saat ini.
has_more	boolean	Menunjukkan apakah masih tersedia catatan versi tambahan.

Perilaku riwayat versi

• Setiap pembaruan PUT pada agen akan membuat versi baru.

• Penomoran versi dimulai dari 1 dan bertambah satu per satu.

• Setiap versi menyimpan Snapshot lengkap agen pada saat perubahan dilakukan.

• Gunakan Titik akhir ini untuk mengaudit riwayat perubahan atau sebagai Referensi untuk rollback.

Kesalahan

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

Lihat Errors untuk struktur lengkap respons error.

Catatan

• first_id dan last_id pada Titik akhir ini berupa string yang merepresentasikan nomor versi, misalnya "1" atau "2".

• Hasil diurutkan menurun berdasarkan nomor versi secara default (versi terbaru ditampilkan lebih dahulu).

• Gabungkan dengan pemeriksaan konkurensi optimistik (OCC) pada operasi PUT untuk melacak perubahan konfigurasi dari waktu ke waktu.