All Products
Search

This Product

    Alibaba Cloud Model Studio:DashScope SDK Expert

    Document Center

    Alibaba Cloud Model Studio:DashScope SDK Expert

    Last Updated:Sep 09, 2026

    Asisten cerdas SDK yang tertanam di DashScope Python SDK — jelaskan kebutuhan Anda untuk mendapatkan kode siap jalan yang versinya sudah diverifikasi, atau tempelkan error maupun path file untuk mendiagnosis, memperbaiki, dan memverifikasi secara otomatis.

    DashScope SDK Expert (selanjutnya disebut "SDK Expert") adalah CLI asisten cerdas SDK yang tertanam di dashscope Python SDK (>=1.27.3). Halaman ini adalah panduan penggunaan umum: cara memakai SDK Expert untuk pengembangan dan pemecahan masalah. Untuk parameter lengkap setiap antarmuka, lihat halaman referensi antarmuka terkait di bilah sisi; domain kemampuan tercantum di "Ikhtisar cakupan" di bawah.

    Mulai cepat

    1. Siapkan API key dan base_url: Buat key (berawalan sk-) di konsol Model Studio pada "API Key Management"; key bersifat spesifik per region. Konfigurasikan melalui variabel lingkungan atau /setup di dalam sesi:

      export DASHSCOPE_API_KEY=sk-xxxxxxxx
export DASHSCOPE_HTTP_BASE_URL=https://{workspace-id}.{region}.maas.aliyuncs.com/api/v1

      base_url berbeda untuk setiap region; untuk pemetaan domain, lihat Ikhtisar Base URL.

    2. Instal/upgrade SDK: SDK Expert diperkenalkan pada dashscope Python SDK 1.27.3.

      # jika gagal, ganti pip dengan pip3
pip install -U dashscope

    3. Jalankan CLI: Jalankan dashscope (tanpa subcommand) untuk masuk ke sesi interaktif SDK Expert; atau python -m dashscope.acli (acli adalah modul entri CLI SDK Expert). Pada peluncuran pertama, Anda akan diminta mengunduh paket pengetahuan SDK Expert (mencakup skill api-doc/diagnose dan lainnya); Anda juga dapat menginstalnya secara manual:

      dashscope
# atau instal paket pengetahuan SDK Expert secara manual
python -m dashscope.acli example download dashscope-sdk-expert

    4. Lihat bantuan: Masukkan /help untuk melihat semua command dan skill. Command adalah operasi sesi (misalnya /clear /help /exit); skill adalah sakelar kemampuan domain (/skill <nama>). Jika ragu, cukup bertanya dalam bahasa alami dan SDK Expert akan mencocokkan skill secara otomatis.

    5. Bertanya sesuai kebutuhan: Jelaskan kebutuhan Anda dalam bahasa alami, contohnya:

      • "Streaming output dengan qwen-plus dan hitung penggunaan token"
      • "Apa arti error Throttling.RateQuota ini dan bagaimana memperbaikinya?"
      • "Baca gen.py dan diagnosis akar masalah error InvalidParameter"

      Anda juga dapat menggunakan Ctrl+T untuk input suara, @path-file untuk melampirkan file agar dibaca SDK Expert, dan ↑ untuk riwayat perintah.

    PentingSDK Expert memeriksa versi dashscope lokal dan mengingatkan Anda untuk menjalankan pip install -U dashscope jika versinya terlalu lama.

    PentingUntuk model multimodal atau model di luar Tongyi: pip install -U 'dashscope[acli-all]'.

    Ikhtisar cakupan

    Setelah paket pengetahuan SDK Expert terpasang, skill berikut tersedia (gunakan /skill untuk melihat semuanya):

    skillKegunaanContoh
    api-docMenelusuri dokumen API SDK/skill api-doc Generation
    sdk-exampleMembuat contoh kode/skill sdk-example TextEmbedding
    error-codeArti kode error + cara perbaikan/skill error-code InvalidApiKey
    diagnoseMembaca file kode, menemukan akar masalah/skill diagnose ./my_code.py
    explain-codeMenjelaskan logika kode/skill explain-code <kode>
    translatePenerjemahan multibahasa/skill translate en hello world
    update-sdkMemperbarui indeks pengetahuan/skill update-sdk <path-sdk>

    SDK Expert mencakup seluruh domain kemampuan DashScope SDK — pembuatan teks, multimodal, suara, retrieval, fine-tuning & deployment, Agent, dan lainnya. Untuk menelusuri dokumen/contoh antarmuka tertentu, gunakan api-doc/sdk-example; untuk membuat kode atau memecahkan masalah, cukup bertanya dalam bahasa alami.

    CatatanSDK Expert adalah CLI agentic yang lengkap dan juga mendukung kolaborasi multi-agent, server MCP (Model Context Protocol, standar integrasi alat eksternal), tugas terjadwal (/cron), audit (/audit), kompresi dan riwayat sesi (/compress, /history), dan lainnya. Perintah / yang umum dipakai dalam sesi, menurut kategori:

    • Manajemen sesi: /help /clear /info /stats /setup /exit /feedback
    • Kemampuan & alat: /skill /mcp /voice /tts /copy
    • Riwayat & audit: /history /compress /cron /audit /dev /example

    Daftar lengkapnya mengacu pada output /help.

    Praktik terbaik 1: Cukup sebutkan kebutuhan — tanpa membaca dokumen, langsung dapat kode siap jalan

    Masalah: Antarmuka SDK sangat banyak dan versinya cepat berubah; pengembang sering harus membuka dokumen untuk memastikan nama parameter, format input, dan daftar model.

    Cara kerja: Jelaskan kebutuhan Anda ke SDK Expert, lalu SDK Expert otomatis melakukan:

    1. Mencocokkan basis pengetahuan SDK bawaan (daftar model/parameter/struktur input-output/kode error)
    2. Memeriksa versi SDK lokal (mengingatkan upgrade jika tidak cocok)
    3. Membuat kode siap jalan dan benar-benar menjalankannya, lalu menampilkan hasilnya

    Contoh dialog:

    > Streaming satu paragraf dengan qwen-plus dan hitung penggunaan token

SDK Expert:
1. Mencocokkan skill api-doc/sdk-example, memeriksa versi dashscope lokal
2. Membuat skrip dan menjalankannya, menampilkan output streaming dan statistik token (lihat di bawah)

    import os, dashscope
dashscope.api_key = os.getenv("DASHSCOPE_API_KEY")
for chunk in dashscope.Generation.call(
    model="qwen-plus",
    messages=[{"role": "user", "content": "Tulis sebuah puisi tentang musim gugur"}],
    result_format="message", stream=True, incremental_output=True,
):
    if chunk.status_code == 200:
        print(chunk.output.choices[0].message.content, end="", flush=True)
# chunk terakhir memuat usage (input/output tokens)

    Dedaunan musim gugur berjatuhan... (streaming karakter per karakter)
usage: input=10 output=52

    Tips:

    • Tentukan bahasa/framework: misalnya "Bungkus sebagai endpoint FastAPI", "Panggil dengan async/await"
    • Tentukan versi: "Kami memakai dashscope 1.20.x — apakah parameter ini didukung?" — SDK Expert memeriksa versi terpasang sebelum menjawab
    • Tanyakan detail: "Berapa rentang nilai parameternya?" "Model apa lagi yang tersedia?"

    Praktik terbaik 2: Pemecahan masalah — biarkan SDK Expert menemukan dan memperbaiki bug

    Masalah: Saat pemanggilan gagal, arti kode error tidak jelas dan stack trace menunjuk ke internal SDK — sulit menentukan apakah masalahnya di kode atau parameter.

    Cara kerja (tiga jalur, pilih sesuai skenario):

    1. Tempelkan kode/pesan error → /skill error-code <kode> (misalnya /skill error-code Throttling.RateQuota) → SDK Expert menampilkan arti kode error + saran perbaikan yang dapat langsung dijalankan (menyesuaikan konkurensi/mengubah parameter/mengajukan kuota) + cuplikan kode opsional.
    2. Berikan path file kode yang bermasalah → /skill diagnose <path file> (misalnya /skill diagnose gen.py) → SDK Expert membaca kode sumber, membandingkannya dengan akar masalah yang umum (mencampur format prompt versi lama, struktur messages salah, api_key/workspace belum dikonfigurasi, tugas asinkron tidak di-polling dengan benar), lalu menampilkan dugaan akar masalah + titik perbaikan yang disarankan.
    3. Loop perbaikan otomatis → /skill diagnose menemukan akar masalah → membuat pratinjau diff untuk Anda konfirmasi → setelah dikonfirmasi, SDK Expert menerapkan perbaikan dan menjalankan ulang skrip untuk verifikasi → membentuk alur "baca → diagnosis → perbaiki → verifikasi". SDK Expert meminta konfirmasi sebelum mengubah file dan mendukung rollback.

    Contoh dialog:

    > Menjalankan gen.py memunculkan InvalidParameter: url error, tolong perbaiki

SDK Expert:
1. /skill diagnose gen.py → menemukan bahwa image_url diberi path lokal
2. Membuat diff untuk dikonfirmasi (lihat di bawah)
3. Menerapkannya setelah dikonfirmasi, menjalankan ulang skrip, mengembalikan 200

    - image_url="/tmp/photo.jpg"
+ image_url="https://example.com/photo.jpg"

    Tips:

    • Sertakan request_id bersama error untuk mengorelasikannya dengan log di sisi server (request_id ada di field response.request_id pada body respons atau pada atribut objek error)
    • Untuk masalah yang kompleks, mintalah SDK Expert lebih dulu untuk "jelaskan logika kode ini" (/skill explain-code) agar pemahaman sejalan sebelum diperbaiki
    • Jika SDK-nya sendiri bermasalah atau kebutuhan Anda belum terpenuhi, buat Issue di GitHub

    FAQ

    Apakah SDK Expert mengubah kode sumber saya tanpa bertanya? Tidak. Sebelum mengubah file, SDK Expert membuat pratinjau diff untuk Anda konfirmasi; perubahan hanya diterapkan setelah Anda mengonfirmasi, dan rollback didukung.

    Bisakah dipakai offline? Tidak. SDK Expert memanggil inferensi model (mengonsumsi token dan ditagih oleh Model Studio); dibutuhkan akses jaringan dan API key yang valid.

    Bisakah kode yang dihasilkan langsung dipakai di produksi? SDK Expert menghasilkan kode siap jalan yang versinya sudah diverifikasi, tetapi sebelum masuk produksi Anda perlu meninjau sendiri kuota, konkurensi, penanganan error, dan informasi sensitif.

    Bisakah menghasilkan kode selain Python? Bisa menghasilkan teks kode dalam bahasa lain, tetapi versi SDK non-Python tidak diverifikasi (skema versinya berbeda — tinjau sendiri).

    Apakah kode saya diunggah? Saat mendiagnosis (/skill diagnose) atau melampirkan kode, isi kode dikirim ke model untuk inferensi; perhatikan data sensitif.