Dapatkan agen - AI Coding Assistant Lingma - Alibaba Cloud Documentation Center

Mengambil konfigurasi lengkap dari agen tertentu.

Header permintaan

Header	Wajib	Deskripsi
`Authorization`	Ya	`Bearer <PAT>`

Parameter path

Parameter	Tipe	Wajib	Deskripsi
`agent_id`	string	Ya	Identifier unik agen, dalam bentuk `"agent_"` diikuti oleh UUID.

Contoh permintaan

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

Contoh respons

HTTP 200 OK

{
  "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,
  "archived": false,
  "archived_at": null,
  "created_at": "2026-05-18T15:26:39.61669Z",
  "updated_at": "2026-05-18T15:26:39.61669Z"
}

Bidang respons

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` melainkan).
`tools`	array	Daftar konfigurasi tool.
`mcp_servers`	array	Konfigurasi server MCP.
`default_environment`	string	Lingkungan runtime default.
`version`	integer	Nomor versi saat ini.
`archived`	boolean	Apakah agen telah diarsipkan.
`archived_at`	string \| null	Waktu pengarsipan (ISO 8601). `null` jika belum diarsipkan.
`created_at`	string	Waktu pembuatan (ISO 8601).
`updated_at`	string	Waktu pembaruan terakhir (ISO 8601).

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 yang sesuai dengan ID yang diberikan.

Contoh respons error:

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "Agent 'agent_nonexistent' was not found."
  }
}

Untuk struktur lengkap respons error, lihat Error.