Files
Obsidian/CSDN等国内/思考模式 DeepSeek API Docs.md
T
coco 8b94d76799 a
2026-07-21 13:57:15 +08:00

241 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "思考模式 | DeepSeek API Docs"
source: "https://api-docs.deepseek.com/zh-cn/guides/thinking_mode"
author:
published:
created: 2026-03-18
description: "DeepSeek 模型支持思考模式:在输出最终回答之前,模型会先输出一段思维链内容,以提升最终答案的准确性。您可以通过以下任意一种方式,开启思考模式:"
tags:
- "clippings"
---
## 思考模式
DeepSeek 模型支持思考模式:在输出最终回答之前,模型会先输出一段思维链内容,以提升最终答案的准确性。您可以通过以下任意一种方式,开启思考模式:
1. 设置 `model` 参数: `"model": "deepseek-reasoner"`
2. 设置 `thinking` 参数: `"thinking": {"type": "enabled"}`
如果您使用的是 OpenAI SDK,在设置 `thinking` 参数时,需要将 `thinking` 参数传入 `extra_body` 中:
```python
response = client.chat.completions.create(
model="deepseek-chat",
# ...
extra_body={"thinking": {"type": "enabled"}}
)
```
## API 参数
- **输入参数** :
- `max_tokens` :模型单次回答的最大长度(含思维链输出),默认为 32K,最大为 64K。
- **输出字段** :
- `reasoning_content` :思维链内容,与 `content` 同级,访问方法见 [样例代码](https://api-docs.deepseek.com/zh-cn/guides/thinking_mode#%E6%A0%B7%E4%BE%8B%E4%BB%A3%E7%A0%81) 。
- `content` :最终回答内容。
- `tool_calls`: 模型工具调用。
- **支持的功能** : [Json Output](https://api-docs.deepseek.com/zh-cn/guides/json_mode) 、 [Tool Calls](https://api-docs.deepseek.com/zh-cn/guides/tool_calls) 、 [对话补全](https://api-docs.deepseek.com/zh-cn/api/create-chat-completion) , [对话前缀续写 (Beta)](https://api-docs.deepseek.com/zh-cn/guides/chat_prefix_completion)
- **不支持的功能** :FIM 补全 (Beta)
- **不支持的参数** : `temperature` 、 `top_p` 、 `presence_penalty` 、 `frequency_penalty` 、 `logprobs` 、 `top_logprobs` 。请注意,为了兼容已有软件,设置 `temperature` 、 `top_p` 、 `presence_penalty` 、 `frequency_penalty` 参数不会报错,但也不会生效。设置 `logprobs` 、 `top_logprobs` 会报错。
## 多轮对话拼接
在每一轮对话过程中,模型会输出思维链内容( `reasoning_content` )和最终回答( `content` )。在下一轮对话中,之前轮输出的思维链内容不会被拼接到上下文中,如下图所示:
![](https://api-docs.deepseek.com/zh-cn/img/deepseek_r1_multiround_example_cn.jpeg)
### 样例代码
下面的代码以 Python 语言为例,展示了如何访问思维链和最终回答,以及如何在多轮对话中进行上下文拼接。注意代码中在新一轮对话里,只传入了上一轮输出的 `content` ,而忽略了 `reasoning_content` 。
- 非流式
- 流式
```python
from openai import OpenAI
client = OpenAI(api_key="<DeepSeek API Key>", base_url="https://api.deepseek.com")
# Turn 1
messages = [{"role": "user", "content": "9.11 and 9.8, which is greater?"}]
response = client.chat.completions.create(
model="deepseek-reasoner",
messages=messages
)
reasoning_content = response.choices[0].message.reasoning_content
content = response.choices[0].message.content
# Turn 2
messages.append({'role': 'assistant', 'content': content})
messages.append({'role': 'user', 'content': "How many Rs are there in the word 'strawberry'?"})
response = client.chat.completions.create(
model="deepseek-reasoner",
messages=messages
)
# ...
```
## 工具调用
我们为 DeepSeek 模型的思考模式增加了工具调用功能。模型在输出最终答案之前,可以进行多轮的思考与工具调用,以提升答案的质量。其调用模式如下图所示:
![](https://api-docs.deepseek.com/zh-cn/img/v3.2_thinking_with_tools.jpeg)
- 在回答问题 1 过程中(请求 1.1 - 1.3),模型进行了多次思考 + 工具调用后给出答案。在这个过程中,用户需回传思维链内容(reasoning\_content)给 API,以让模型继续思考。
- 在下一个用户问题开始时(请求 2.1),需删除之前的 `reasoning_content` ,并保留其它内容发送给 API。如果保留了 `reasoning_content` 并发送给 API,API 将会忽略它们。
### 兼容性提示
因思考模式下的工具调用过程中要求用户回传 `reasoning_content` 给 API,若您的代码中未正确回传 `reasoning_content` ,API 会返回 400 报错。正确回传方法请您参考下面的样例代码。
### 样例代码
下面是一个简单的在思考模式下进行工具调用的样例代码:
```python
import os
import json
from openai import OpenAI
# The definition of the tools
tools = [
{
"type": "function",
"function": {
"name": "get_date",
"description": "Get the current date",
"parameters": { "type": "object", "properties": {} },
}
},
{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get weather of a location, the user should supply the location and date.",
"parameters": {
"type": "object",
"properties": {
"location": { "type": "string", "description": "The city name" },
"date": { "type": "string", "description": "The date in format YYYY-mm-dd" },
},
"required": ["location", "date"]
},
}
},
]
# The mocked version of the tool calls
def get_date_mock():
return "2025-12-01"
def get_weather_mock(location, date):
return "Cloudy 7~13°C"
TOOL_CALL_MAP = {
"get_date": get_date_mock,
"get_weather": get_weather_mock
}
def clear_reasoning_content(messages):
for message in messages:
if hasattr(message, 'reasoning_content'):
message.reasoning_content = None
def run_turn(turn, messages):
sub_turn = 1
while True:
response = client.chat.completions.create(
model='deepseek-chat',
messages=messages,
tools=tools,
extra_body={ "thinking": { "type": "enabled" } }
)
messages.append(response.choices[0].message)
reasoning_content = response.choices[0].message.reasoning_content
content = response.choices[0].message.content
tool_calls = response.choices[0].message.tool_calls
print(f"Turn {turn}.{sub_turn}\n{reasoning_content=}\n{content=}\n{tool_calls=}")
# If there is no tool calls, then the model should get a final answer and we need to stop the loop
if tool_calls is None:
break
for tool in tool_calls:
tool_function = TOOL_CALL_MAP[tool.function.name]
tool_result = tool_function(**json.loads(tool.function.arguments))
print(f"tool result for {tool.function.name}: {tool_result}\n")
messages.append({
"role": "tool",
"tool_call_id": tool.id,
"content": tool_result,
})
sub_turn += 1
client = OpenAI(
api_key=os.environ.get('DEEPSEEK_API_KEY'),
base_url=os.environ.get('DEEPSEEK_BASE_URL'),
)
# The user starts a question
turn = 1
messages = [{
"role": "user",
"content": "How's the weather in Hangzhou Tomorrow"
}]
run_turn(turn, messages)
# The user starts a new question
turn = 2
messages.append({
"role": "user",
"content": "How's the weather in Hangzhou Tomorrow"
})
# We recommended to clear the reasoning_content in history messages so as to save network bandwidth
clear_reasoning_content(messages)
run_turn(turn, messages)
```
在 Turn 1 的每个子请求中,都携带了该 Turn 下产生的 `reasoning_content` 给 API,从而让模型继续之前的思考。 `response.choices[0].message` 携带了 `assistant` 消息的所有必要字段,包括 `content` 、 `reasoning_content` 、 `tool_calls` 。简单起见,可以直接用如下代码将消息 append 到 messages 结尾:
```markdown
messages.append(response.choices[0].message)
```
这行代码等价于:
```markdown
messages.append({
'role': 'assistant',
'content': response.choices[0].message.content,
'reasoning_content': response.choices[0].message.reasoning_content,
'tool_calls': response.choices[0].message.tool_calls,
})
```
在 Turn 2 开始时,我们建议丢弃掉之前 Turn 中的 `reasoning_content` 来节省网络带宽:
```markdown
clear_reasoning_content(messages)
```
该代码的样例输出如下:
```bash
Turn 1.1
reasoning_content="The user is asking about the weather in Hangzhou tomorrow. I need to get the current date first, then calculate tomorrow's date, and then call the weather API. Let me start by getting the current date."
content=''
tool_calls=[ChatCompletionMessageToolCall(id='call_00_Tcek83ZQ4fFb1RfPQnsPEE5w', function=Function(arguments='{}', name='get_date'), type='function', index=0)]
tool_result(get_date): 2025-12-01
Turn 1.2
reasoning_content='Today is December 1, 2025. Tomorrow is December 2, 2025. I need to format the date as YYYY-mm-dd: "2025-12-02". Now I can call get_weather with location Hangzhou and date 2025-12-02.'
content=''
tool_calls=[ChatCompletionMessageToolCall(id='call_00_V0Uwt4i63m5QnWRS1q1AO1tP', function=Function(arguments='{"location": "Hangzhou", "date": "2025-12-02"}', name='get_weather'), type='function', index=0)]
tool_result(get_weather): Cloudy 7~13°C
Turn 1.3
reasoning_content="I have the weather information: Cloudy with temperatures between 7 and 13°C. I should respond in a friendly, helpful manner. I'll mention that it's for tomorrow (December 2, 2025) and give the details. I can also ask if they need any other information. Let's craft the response."
content="Tomorrow (Tuesday, December 2, 2025) in Hangzhou will be **cloudy** with temperatures ranging from **7°C to 13°C**. \n\nIt might be a good idea to bring a light jacket if you're heading out. Is there anything else you'd like to know about the weather?"
tool_calls=None
Turn 2.1
reasoning_content="The user wants clothing advice for tomorrow based on the weather in Hangzhou. I know tomorrow's weather: cloudy, 7-13°C. That's cool but not freezing. I should suggest layered clothing, maybe a jacket, long pants, etc. I can also mention that since it's cloudy, an umbrella might not be needed unless there's rain chance, but the forecast didn't mention rain. I should be helpful and give specific suggestions. I can also ask if they have any specific activities planned to tailor the advice. Let me respond."
content="Based on tomorrow's forecast of **cloudy weather with temperatures between 7°C and 13°C** in Hangzhou, here are some clothing suggestions:\n\n**Recommended outfit:**\n- **Upper body:** A long-sleeve shirt or sweater, plus a light to medium jacket (like a fleece, windbreaker, or light coat)\n- **Lower body:** Long pants or jeans\n- **Footwear:** Closed-toe shoes or sneakers\n- **Optional:** A scarf or light hat for extra warmth, especially in the morning and evening\n\n**Why this works:**\n- The temperature range is cool but not freezing, so layering is key\n- Since it's cloudy but no rain mentioned, you likely won't need an umbrella\n- The jacket will help with the morning chill (7°C) and can be removed if you warm up during the day\n\n**If you have specific plans:**\n- For outdoor activities: Consider adding an extra layer\n- For indoor/office settings: The layered approach allows you to adjust comfortably\n\nWould you like more specific advice based on your planned activities?"
tool_calls=None
```