1?? 為何選擇 DeepSeek V3.1

?? 官方文檔：https://platform.deepseek.com/docs
?? 價格頁：https://platform.deepseek.com/pricing

2?? 環境準備（0.5 天）

2.1 領取 API Key

1. 注冊 DeepSeek Platform
2. 實名認證 → 免費贈送 30 ￥（≈ 250 萬 tokens）

2.2 本地一鍵腳本

curl -fsSL https://raw.githubusercontent.com/deepseek/examples/main/bootstrap.sh | bash

腳本會自動安裝：

• Python 3.11
• Poetry 依賴管理
• Docker & docker-compose（可選）

2.3 目錄結構速覽

?? deepseek-5day-bootcamp/
├ ?? agent.py 單 Agent 示例
├ ?? crew.py 多 Agent 編排
├ ?? memory.py 持久化
├ ?? tools.py 工具鏈
└ ?? deploy.yml K8s 部署

3?? Day 1 單 Agent 快速熱身

3.1 最小可運行代碼

from openai import OpenAI
client = OpenAI(
    api_key="sk-xxx",
    base_url="https://api.deepseek.com/v1"
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "用 Python 寫一個快速排序"}]
)
print(response.choices[0].message.content)

運行時間 ≈ 1.2 s，token 消耗 212。

3.2 流式輸出

stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[...],
    stream=True
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

4?? Day 2 多 Agent 編排

4.1 概念模型

4.2 核心 API：/v1/agent/crew

POST /v1/agent/crew
{
  "crew_id": "bootcamp_day2",
  "agents": [
    {"name":"router","role":"router","model":"deepseek-chat"},
    {"name":"dev","role":"dev","model":"deepseek-chat"},
    {"name":"review","role":"review","model":"deepseek-chat"}
  ],
  "task": "完成一個 Python CLI 工具"
}

返回字段：

• session_id：用于后續輪詢

• status：queued | running | done | failed

4.3 代碼片段

import requests, time
url = "https://api.deepseek.com/v1/agent/crew"
payload = {...}
r = requests.post(url, json=payload, headers={"Authorization":"Bearer sk-xxx"})
session_id = r.json()["session_id"]

while True:
    status = requests.get(f"{url}/{session_id}", headers={"Authorization":"Bearer sk-xxx"}).json()["status"]
    if status == "done": break
    time.sleep(2)

5?? Day 3 記憶與持久化

5.1 記憶類型

5.2 插入記憶示例

POST /v1/user/memory
{
  "user_id": "alice@corp.com",
  "key": "tech_stack",
  "value": "Python, FastAPI, PostgreSQL"
}

6?? Day 4 工具鏈 & 調試

6.1 官方工具列表

6.2 自建工具注冊

from deepseek.tools import register_tool

@register_tool(name="jira")
def jira_tool(ticket_id: str) -> str:
    return requests.get(f"https://jira.corp.com/rest/api/2/issue/{ticket_id}", auth=("user","pass")).json()["fields"]["summary"]

7?? Day 5 交付與灰度上線

7.1 一鍵打包鏡像

docker build -t deepseek-crew:v1 .
docker run -p 8000:8000 deepseek-crew:v1

7.2 K8s 部署清單

apiVersion: apps/v1
kind: Deployment
metadata:
  name: deepseek-crew
spec:
  replicas: 3
  selector:
    matchLabels: {app: deepseek-crew}
  template:
    metadata:
      labels: {app: deepseek-crew}
    spec:
      containers:
      - name: app
        image: deepseek-crew:v1
        env:
        - name: DEEPSEEK_API_KEY
          valueFrom:
            secretKeyRef: {name: ds-secret, key: api-key}

7.3 灰度策略

8?? 性能基準 & 成本對比

8.1 實驗設置

• 任務：自動生成 50 個 Python 函數
• 并發：10 threads
• 觀測：token 消耗、平均延遲、成功率

8.2 結果

9?? 常見坑 & FAQ

?? 總結與展望

5 天實踐驗證了 DeepSeek V3.1 多 Agent 協同 API 在「培訓場景」的完整閉環：從單 Agent 熱身到灰度上線，團隊 6 人、累計 40 工時，成功交付一套內部代碼問答機器人。
未來，DeepSeek 官方已預告 「Agent Marketplace」 與 「可視化編排器」，將進一步降低使用門檻。
如果你正在為團隊尋找 低成本、高效率、可落地 的 LLM 培訓方案，現在就是最佳上車時間。