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

Buat konfigurasi agen baru.

Header permintaan

Header	Wajib	Deskripsi
`Authorization`	Ya	`Bearer <PAT>`
`Content-Type`	Ya	`application/json`
`Idempotency-Key`	Tidak	Kunci idempotensi yang mencegah pembuatan duplikat.

Body permintaan

Field	Tipe	Wajib	Deskripsi
`name`	string	Ya	Nama agen, 1–256 karakter.
`model`	string\|object	Ya	Identifikasi model. Berupa string seperti `"ultimate"`, atau objek.
`instructions`	string	Tidak	Prompt sistem.
`description`	string	Tidak	Deskripsi agen.
`tools`	array	Tidak	Daftar konfigurasi tool. Lihat struktur elemen `tools` di bawah.
`mcp_servers`	array	Tidak	Daftar konfigurasi server MCP, dalam bentuk `[{"name":"[name]","type":"http","url":"[mcp_server_url]"}]`. Otentikasi dikonfigurasi melalui Vault.
`skills`	array	Tidak	Binding skill, dalam bentuk `[{"type":"custom","skill_id":"[skill_id]"}]`. Maksimal 20 entri.
`metadata`	object	Tidak	Pasangan kunci-nilai metadata kustom.

Struktur elemen `tools`

{
  "type": "agent_toolset_20260401",
  "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]
}

Field	Tipe	Wajib	Deskripsi
`type`	string	Ya	Identifikasi tipe toolset.
`enabled_tools`	array	Tidak	Daftar izin tool atomik yang diaktifkan. Menghilangkan field ini atau memberikan array kosong `[]` akan mengaktifkan semua tool bawaan. Array tidak kosong berfungsi sebagai daftar izin ketat; tool di luar daftar tersebut tidak terlihat oleh model.

Contoh permintaan

curl -X POST "https://api.qoder.com.cn/api/v1/cloud/agents" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "doc-test-agent",
    "model": "ultimate",
    "instructions": "You are a documentation test assistant.",
    "tools": [
      {
        "type": "agent_toolset_20260401",
        "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]
      }
    ],
    "mcp_servers": [
      {
        "type": "url",
        "name": "weather-service",
        "url": "https://mcp.example.com/sse"
      }
    ]
  }'

Contoh respons

HTTP 201 Created

{
  "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": [
    {
      "type": "agent_toolset_20260401",
      "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]
    }
  ],
  "mcp_servers": [
    {
      "type": "url",
      "name": "weather-service",
      "url": "https://mcp.example.com/sse"
    }
  ],
  "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"
}

Field respons

Field	Tipe	Deskripsi
`type`	string	Selalu `"agent"`.
`id`	string	Identifikasi agen unik, diawali dengan `"agent_"`.
`name`	string	Nama agen.
`description`	string	Deskripsi agen.
`model`	string	Identifikasi model.
`instructions`	string	Prompt sistem.
`system`	string	Alias dari `instructions` (tidak digunakan lagi; gunakan `instructions` sebagai gantinya).
`tools`	array	Daftar konfigurasi tool.
`mcp_servers`	array	Konfigurasi server MCP.
`default_environment`	string	Lingkungan runtime default.
`version`	integer	Nomor versi saat ini, dimulai dari 1.
`archived`	boolean	Menunjukkan 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
400	`invalid_request_error`	Field wajib `name` tidak ditemukan.
400	`invalid_request_error`	`name` melebihi 256 karakter.
400	`invalid_request_error`	Field wajib `model` tidak ditemukan.
400	`invalid_request_error`	Konfigurasi `mcp_servers` atau `skills` 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 operasi ini.

Contoh respons error:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "name must be between 1 and 256 characters"
  }
}

Untuk informasi lengkap mengenai struktur respons error, lihat Error.

Header permintaan

Body permintaan

Struktur elemen tools

Contoh permintaan

Contoh respons

Field respons

Kesalahan

Struktur elemen `tools`