Pi Agent: DeepSeek 配置详解
最后更新：2026-08-31
DeepSeek 是 Pi Agent 最推荐的提供商——便宜、好用、中文能力强。这一课搞定 DeepSeek 的全部配置。
1. 为什么选 DeepSeek
| 优势 | 说明 |
|---|---|
| 性价比极高 | 输入 ¥1/百万 token，输出 ¥2/百万 token |
| 中文能力强 | 原生中文训练，理解和生成质量优秀 |
| 函数调用 | 支持工具调用（Function Calling） |
| 长上下文 | 支持 64K 上下文窗口 |
| 响应速度快 | 首个 token 延迟低 |
2. 获取 API 密钥
- 访问 https://platform.deepseek.com/
- 注册账号并登录
- 进入"API Keys"页面
- 点击"创建 API Key"
- 复制密钥（格式：
sk-xxxxxxxxxxxxxxxx）
⚠️ 注意：密钥只显示一次，务必妥善保存。如果泄露，立即在平台上删除并重新创建。
3. 基础配置
(1) 最小配置
YAML
providers:
deepseek:
api_key: "sk-xxxxxxxx"
(2) 完整配置
YAML
providers:
deepseek:
api_key: "sk-xxxxxxxx"
base_url: "https://api.deepseek.com"
model: "deepseek-chat"
temperature: 0.7
max_tokens: 4096
top_p: 0.95
timeout: 60
default_provider: deepseek
(3) 环境变量
BASH
export PI_DEEPSEEK_API_KEY="sk-xxxxxxxx"
export PI_DEEPSEEK_BASE_URL="https://api.deepseek.com"
4. 模型选择
| 模型 | 用途 | 上下文 | 价格（每百万 token） |
|---|---|---|---|
| deepseek-chat | 通用对话 | 64K | 输入 ¥1 / 输出 ¥2 |
| deepseek-reasoner | 复杂推理 | 64K | 输入 ¥4 / 输出 ¥16 |
▶ 示例 1：不同模型对比（难度⭐）
PYTHON
from pi_agent import Agent
chat_agent = Agent(
name="quick",
provider="deepseek",
model="deepseek-chat"
)
reasoner_agent = Agent(
name="thinker",
provider="deepseek",
model="deepseek-reasoner"
)
print(chat_agent.chat("1+1=?"))
print(reasoner_agent.chat("证明根号2是无理数"))
5. 参数调优
(1) temperature
控制输出的随机性，值越低越确定：
PYTHON
# 代码生成：低温度，追求精确
code_agent = Agent(model="deepseek-chat", temperature=0.1)
# 创意写作：高温度，追求多样性
creative_agent = Agent(model="deepseek-chat", temperature=1.0)
(2) max_tokens
控制单次回复的最大长度：
PYTHON
# 短回复场景
brief_agent = Agent(model="deepseek-chat", max_tokens=256)
# 长文生成场景
essay_agent = Agent(model="deepseek-chat", max_tokens=8192)
(3) 工具调用配置
PYTHON
agent = Agent(
provider="deepseek",
model="deepseek-chat",
tools=["search", "calculator"],
tool_choice="auto" # auto | required | none
)
| tool_choice 值 | 行为 |
|---|---|
| auto | Agent 自行决定是否调用工具 |
| required | 必须调用工具 |
| none | 禁止调用工具 |
6. 成本优化
Alice 的项目每天要处理上千条请求，她用以下策略控制成本：
PYTHON
agent = Agent(
provider="deepseek",
model="deepseek-chat",
max_tokens=2048, # 限制输出长度
temperature=0.3, # 低温度减少重复调用
context_window=4096 # 控制上下文窗口
)
Bob 建议："简单问题用 deepseek-chat，复杂推理才用 deepseek-reasoner。90% 的场景 chat 就够了。"
❓ 常见问题
Q DeepSeek API 调用报 401 错误？
A API 密钥无效或过期。到平台重新检查密钥，注意不要有多余的空格或换行。
Q 响应很慢怎么办？
A 检查网络连接，适当降低 max_tokens，减少上下文窗口大小。高峰期延迟可能增加。
Q DeepSeek 和 OpenAI API 兼容吗？
A DeepSeek 的 API 格式与 OpenAI 兼容，可以设置
base_url 指向 DeepSeek，然后用 OpenAI SDK 调用。Pi Agent 已内置此兼容。📖 小节
- DeepSeek 是 Pi Agent 推荐的 LLM 提供商，性价比极高
- 获取 API 密钥后通过配置文件或环境变量设置
- deepseek-chat 适合日常对话，deepseek-reasoner 适合复杂推理
- 通过 temperature、max_tokens、tool_choice 等参数优化效果和成本
📝 作业
- 基础题（难度⭐）：注册 DeepSeek 账号，获取 API 密钥，配置 Pi Agent 并发送一条消息。
- 进阶题（难度⭐⭐）：对比 deepseek-chat 和 deepseek-reasoner 在同一数学题上的表现差异。
- 挑战题（难度⭐⭐⭐）：编写一个成本监控工具，记录每次 API 调用的 token 消耗和费用。
