DashScope SDK Expert

​

快速開始

1. 準備 API Key 與 base_url：在百鍊主控台的「API Key 管理」建立 Key（sk- 前置字元），各地區的 Key 相互獨立。透過環境變數或工作階段內的 /setup 進行設定：
   Copy

   export DASHSCOPE_API_KEY=sk-xxxxxxxx
   export DASHSCOPE_HTTP_BASE_URL=https://{workspace-id}.{region}.maas.aliyuncs.com/api/v1
   
   各地區的 base_url 不同，網域名稱對照請見 Base URL總覽。
2. 安裝／升級 SDK：SDK Expert 自 dashscope Python SDK 1.27.3 起引入。
   Copy

   # 如果執行失敗，可以將 pip 替換成 pip3
   pip install -U dashscope
   
3. 啟動 CLI：在終端機執行 dashscope（不帶子命令）即可進入 SDK Expert 互動式工作階段；也可以執行 python -m dashscope.acli（acli 即 SDK Expert 的 CLI 進入點模組）。首次啟動會提示下載 SDK Expert 知識包（含 api-doc/diagnose 等專項 skill）；也可以手動安裝：
   Copy

   dashscope
   # 或手動安裝 SDK Expert 知識包
   python -m dashscope.acli example download dashscope-sdk-expert
   
4. 檢視說明：在工作階段中輸入 /help 檢視全部 command 與 skill。command 是工作階段操作（如 /clear /help /exit）；skill 是領域能力開關（/skill <名稱>）。不確定時直接用自然語言提問，SDK Expert 會自動比對 skill。
5. 依需求提問：用自然語言描述需求即可，例如：
   • 「用 qwen-plus 串流輸出並統計 token 消耗」
   • 「這段錯誤 Throttling.RateQuota 是什麼意思，該怎麼修？」
   • 「讀 gen.py 診斷 InvalidParameter 錯誤的根本原因」
   也支援 Ctrl+T 語音輸入、@檔案路徑 附加檔案讓 SDK Expert 直接讀取、↑ 翻閱歷史命令。

​

涵蓋能力一覽

​

最佳實踐一：只提需求，不讀文件，直接產出可執行程式碼

1. 比對內建的 SDK 知識庫（模型清單／參數／輸入輸出結構／錯誤碼）
2. 校驗本機的 SDK 版本（不一致時會提醒升級）
3. 產生可執行程式碼並實際執行，展示輸出

> 用 qwen-plus 串流輸出一段話，並統計 token 消耗

SDK Expert：
1. 比對 api-doc/sdk-example skill，核對本機的 dashscope 版本
2. 產生腳本並執行，展示串流輸出與 token 統計（見下）

import os, dashscope
dashscope.api_key = os.getenv("DASHSCOPE_API_KEY")
for chunk in dashscope.Generation.call(
    model="qwen-plus",
    messages=[{"role": "user", "content": "寫一首關於秋天的詩"}],
    result_format="message", stream=True, incremental_output=True,
):
    if chunk.status_code == 200:
        print(chunk.output.choices[0].message.content, end="", flush=True)
# 最後一個 chunk 含 usage（input/output tokens）

秋風掃落葉...（串流逐字輸出）
usage: input=10 output=52

• 指定語言／框架：如「封裝成 FastAPI 介面」、「用 async/await 非同步呼叫」
• 指定版本：「我們用 dashscope 1.20.x，這個參數支援嗎？」——SDK Expert 會核對已安裝版本後回答
• 追問細節：「參數取值範圍？」「還有哪些可選模型？」

​

最佳實踐二：排查問題，讓它自動定位並修復 Bug

1. 貼上錯誤碼／錯誤訊息 → /skill error-code <錯誤碼>（如 /skill error-code Throttling.RateQuota）→ SDK Expert 輸出錯誤碼含義 + 可執行的修復建議（調整並行數／修改參數／申請配額）+ 可選的程式碼片段。
2. 提供問題程式碼的檔案路徑 → /skill diagnose <檔案路徑>（如 /skill diagnose gen.py）→ SDK Expert 讀取原始碼，對照常見根本原因（混用舊版 prompt 格式、messages 結構錯誤、api_key／workspace 未設定、非同步任務未正確輪詢）輸出疑似根本原因 + 建議修改點。
3. 自動修復閉環 → /skill diagnose 定位根本原因 → 產生 diff 預覽供你確認 → 確認後 SDK Expert 套用修改並重新執行腳本驗證 → 形成「讀取 → 診斷 → 修復 → 驗證」流程。SDK Expert 修改檔案前會徵求確認，並可回復。

> 執行 gen.py 報 InvalidParameter: url error，幫我修

SDK Expert：
1. /skill diagnose gen.py → 定位 image_url 傳入了本機路徑
2. 產生 diff 供確認（見下）
3. 確認後套用，重新執行腳本，回傳 200

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

• 報錯時附上 request_id 便於對應服務端日誌（request_id 位於回應內容的 response.request_id 欄位或錯誤物件的屬性中）
• 複雜問題可先讓 SDK Expert「解釋這段程式碼的邏輯」（/skill explain-code）確認理解一致後再修復
• SDK 本身有缺陷或未滿足需求時，可到 GitHub 提 Issue 回饋

​

常見疑問