Struktur Data Generik - AI Coding Assistant Lingma - Alibaba Cloud Documentation Center

Envelop umum dan objek yang dapat digunakan ulang di seluruh API Cloud Agents.

Halaman ini mendefinisikan struktur lintas-resource yang digunakan oleh beberapa kelompok API. Struktur khusus resource didokumentasikan pada halaman struktur data masing-masing direktori resource.

Objek metadata

metadata adalah objek flat berisi atribut string yang ditentukan oleh pemanggil.

Aturan	Deskripsi
Bentuk	Objek JSON yang nilainya berupa string
Jumlah kunci maksimum	16
Panjang kunci maksimum	64 karakter Unicode
Panjang nilai maksimum	512 karakter Unicode
Nilai default	`{}` jika dihilangkan

Contoh:

{
  "team": "docs",
  "project": "cloud-agents"
}

Daftar terpaginasi

Endpoint daftar mengembalikan envelop paginasi berbasis kursor.

Bidang	Tipe	Deskripsi
`data`	array	Objek resource pada halaman saat ini
`has_more`	boolean	Menunjukkan apakah masih ada catatan tambahan yang tersedia
`first_id`	string \| null	ID kursor dari item pertama yang dikembalikan, atau `null` ketika `data` kosong
`last_id`	string \| null	ID kursor dari item terakhir yang dikembalikan, atau `null` ketika `data` kosong

Selubung Error

Tanggapan error menggunakan envelop berikut:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Field 'name' is required."
  }
}

Bidang	Tipe	Deskripsi
`type`	string	Selalu `"error"`
`error.type`	string	Kategori error, seperti `invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, atau `api_error`
`error.message`	string	Pesan error yang dapat dibaca manusia

Timestamp

Timestamp berupa string ISO 8601 / RFC 3339 dalam UTC, contohnya "2026-05-18T15:26:39.61669Z". Beberapa bidang bersifat nullable; skema resource masing-masing secara eksplisit mencantumkan hal tersebut.

Awalan ID

Resource	Awalan
Agent	`agent_`
Environment	`env_`
Session	`sess_`
Session event	`evt_`
Session thread	`sthr_`
Turn	`turn_`
File	`file_`
Vault	`vault_`
Vault credential	`vcred_`
Skill	`skill_`
Memory store	`memstore_`
Memory entry	`mem_`
Memory version	`memver_`