Qoder Cloud Agents CN adalah platform runtime AI agent yang sepenuhnya dikelola. Anda tidak perlu membangun loop agent sendiri, mengelola sandbox eksekusi tool, atau menangani koneksi berdurasi panjang. Cukup definisikan agent dan mulai sesi melalui API untuk menjalankan tugas kompleks serta menerima hasil secara real-time di cloud.
Konsep utama
|
Konsep |
Deskripsi |
Analogi |
|
agent |
Templat konfigurasi yang dapat digunakan ulang untuk mendefinisikan model, system prompt, dan toolset. |
Deskripsi pekerjaan seorang karyawan |
|
environment |
Lingkungan container tempat sesi dijalankan, termasuk konfigurasi jaringan dan dependensi. |
Meja kerja dan kotak peralatan |
|
session |
Instans spesifik dari percakapan atau eksekusi tugas. |
Sesi kerja tertentu |
|
event |
Aliran event real-time yang dihasilkan dalam suatu sesi. |
Siaran langsung progres pekerjaan |
Alur kerja
-
Definisikan agent — Tentukan model, system prompt, dan tool yang tersedia.
-
Konfigurasikan environment — Pilih tipe container, kebijakan jaringan, dan dependensi pra-instal. Akun baru harus terlebih dahulu menggunakan
POST /environmentsuntuk membuat environment karena tidak ada environment yang disediakan secara default. -
Mulai sesi — Ikat agent ke environment untuk membuat instans runtime.
-
Kirim pesan dan terima event — Kirim
user.messageke sesi, lalu terima aliran event real-time—seperti pemikiran agent, pesan, dan perubahan status—melalui Server-Sent Events (SSE) atau polling.
Verifikasi konektivitas
# Verifikasi PAT dan daftar agent
curl -s https://api.qoder.com.cn/api/v1/cloud/agents \
-H "Authorization: Bearer $QODER_PAT"
Tanggapan sukses akan tampak seperti ini:
{
"data": [ ],
"first_id": null,
"last_id": null,
"has_more": false
}
Kasus penggunaan
-
Tugas asinkron berdurasi panjang — Tinjauan kode, refaktoring skala besar, dan pembuatan tes otomatis.
-
Integrasi API — Sisipkan kemampuan agent ke layanan backend Anda tanpa perlu memelihara runtime.
-
Pemrosesan batch — Mulai beberapa sesi secara paralel untuk memproses permintaan batch.
-
Tugas terjadwal — Integrasikan dengan sistem penjadwalan untuk menjalankan agent secara berkala guna inspeksi atau pelaporan.
Autentikasi
Semua permintaan API harus menyertakan header berikut:
|
Header |
Nilai |
Deskripsi |
|
|
|
Personal access token |
Anda dapat membuat personal access token (PAT) di Konsol Qoder dengan membuka Settings > Personal Access Tokens. Simpan PAT Anda dengan aman dan jangan commit ke repositori kode.
Paginasi
API daftar menggunakan paginasi berbasis kursor. Struktur responsnya sebagai berikut:
{
"data": [...],
"first_id": "agent_019e451902fe7a2ca42c2dfc62d9320e",
"last_id": "agent_019e45369b3379e18bfaf59b3aad2fc9",
"has_more": true
}
Gunakan parameter kueri after_id dan before_id untuk melakukan paginasi.
FAQ
T: Dapatkah saya menggunakan Qoder Cloud Agents CN dan Qoder CLI secara bersamaan?
J: Ya. Qoder CLI ideal untuk pengembangan interaktif lokal, sedangkan Qoder Cloud Agents CN dirancang untuk otomatisasi dan integrasi. Keduanya saling melengkapi.
T: Berapa banyak sesi yang dapat dijalankan secara konkuren oleh satu agent?
J: Tidak ada batas ketat. Konfigurasi agent dapat dikaitkan dengan beberapa sesi aktif secara simultan.
T: Bagaimana keamanan data dijamin?
J: Setiap sesi dijalankan dalam sandbox container yang terisolasi, sehingga mencegah akses antar sesi. Semua data dihapus saat environment dihancurkan.
Langkah selanjutnya
-
Quickstart: Jalankan agent cloud pertama Anda dalam lima langkah.
-
Define an agent: Pelajari lebih lanjut tentang konfigurasi agent.
-
Cloud environments: Konfigurasikan lingkungan runtime.
-
Start a session: Kelola siklus hidup sesi.