Memulai Cepat - Seri Qoder CN - Alibaba Cloud Documentation Center

Jalankan Qoder Cloud Agent pertama Anda dalam lima langkah: dapatkan token, pilih lingkungan, buat agent, buat session, serta kirim dan terima pesan. Anda hanya memerlukan curl—tanpa perlu menginstal SDK.

Prasyarat

Akun Qoder
Lingkungan terminal (macOS, Linux, atau WSL)
curl dan jq (opsional, untuk memformat output JSON)

Untuk pengguna Windows: Perintah dalam dokumen ini menggunakan sintaksis bash. Kami menyarankan menggunakan Git Bash (termasuk dalam Git for Windows) atau WSL (instal dengan wsl --install). Jika Anda menggunakan PowerShell, sesuaikan perintahnya: atur variabel lingkungan dengan $env:QODER_PAT="your-token", gunakan curl.exe untuk melewati alias curl PowerShell, dan instal jq secara terpisah (misalnya, winget install jqlang.jq).

Langkah 1: Dapatkan PAT

Masuk ke Qoder Console.
Buka Settings > Personal Access Tokens.
Klik **Create Token**, lalu atur nama dan masa berlaku.
Salin token tersebut dan tetapkan sebagai variabel lingkungan:

export QODER_PAT="your-token-here"

Token Anda hanya ditampilkan sekali saat pembuatan. Segera simpan di tempat yang aman. Untuk kenyamanan, tambahkan perintah export ke file startup shell Anda, seperti ~/.bashrc atau ~/.zshrc.

Langkah 2: Pilih lingkungan

Daftar lingkungan yang tersedia untuk mendapatkan ID lingkungan:

curl -s https://api.qoder.com.cn/api/v1/cloud/environments \
  -H "Authorization: Bearer $QODER_PAT" | jq .

Jika respons mengembalikan "data": [] (array kosong), akun Anda belum memiliki lingkungan. Buat satu sebagai berikut:

curl -s -X POST https://api.qoder.com.cn/api/v1/cloud/environments \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{"name": "default", "config": {"type": "cloud", "networking": {"type": "unrestricted"}}}' | jq .

Langkah 3: Buat agent

Definisikan agent serbaguna dengan alat shell:

curl -s -X POST https://api.qoder.com.cn/api/v1/cloud/agents \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "quickstart-agent",
    "model": "ultimate",
    "instructions": "You are a helpful coding assistant.",
    "tools": [
      {
        "type": "agent_toolset_20260401",
        "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]
      }
    ]
  }' | jq .

Catat bidang id dalam respons (misalnya, agent_019e...). Anda akan membutuhkannya untuk membuat session pada langkah berikutnya.

Langkah 4: Buat session

Membuat session memerlukan dua parameter: agent (ID atau objek agent) dan environment_id (ID lingkungan).

Ikat agent ke lingkungan untuk membuat instans yang berjalan:

curl -s -X POST https://api.qoder.com.cn/api/v1/cloud/sessions \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "agent_YOUR_AGENT_ID",
    "environment_id": "env_YOUR_ENV_ID"
  }' | jq .

Setelah dibuat, session berada dalam status idle. Agent baru mulai mengeksekusi setelah Anda mengirim pesan padanya di langkah berikutnya.

Langkah 5: Kirim pesan dan terima event

Kirim pesan pengguna ke session, lalu terima respons agent secara real-time dari aliran SSE:

# Kirim pesan
curl -s -X POST "https://api.qoder.com.cn/api/v1/cloud/sessions/sess_YOUR_SESSION_ID/events" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "user.message",
    "content": [{"type": "text", "text": "Write a Python function that calculates fibonacci numbers"}]
  }'

# Terima aliran event SSE
curl -sN "https://api.qoder.com.cn/api/v1/cloud/sessions/sess_YOUR_SESSION_ID/events/stream" \
  -H "Authorization: Bearer $QODER_PAT"

API mengirim event heartbeat kira-kira setiap 15 detik untuk menjaga koneksi tetap aktif. Bidang content dari event agent.message menggunakan format array: [{"type":"text","text":"..."}].

FAQ

T: Apa yang harus saya lakukan jika menerima error 401 Unauthorized?

J: Periksa apakah variabel lingkungan $QODER_PAT telah diatur dengan benar dan token Anda belum kedaluwarsa. Jika perlu, buat token baru dan perbarui variabel lingkungan tersebut.

T: Mengapa saya mendapat error 400 Bad Request saat membuat agent?

J: Periksa apakah badan permintaan berupa JSON yang valid. Pastikan bidang model memiliki nilai yang valid (misalnya, "ultimate") dan bidang tools berupa array.

T: Mengapa sesi saya macet dalam status diam dan tidak menerima event?

J: Session secara default berada dalam status idle setelah dibuat. Anda harus mengirim event user.message untuk memicu agent. Pastikan Anda telah melakukan Langkah 5 dengan benar.

T: Apa yang harus saya lakukan jika koneksi aliran SSE terputus?

J: Kami menyarankan menyimpan id dari event terakhir yang diterima sebelum koneksi terputus (misalnya, evt_...). Saat menyambung ulang, sertakan parameter kueri ?after_id=<last_event_id>. Server kemudian akan melanjutkan pengiriman event dari titik terakhir Anda.

T: Mengapa GET /environments mengembalikan array kosong?

J: Akun baru mungkin belum memiliki lingkungan yang telah dikonfigurasi. Buat satu seperti yang dijelaskan di Langkah 2.