DeepSeekガイド
DeepSeek APIのツール呼び出し:流れ・strictモード・思考モードの注意
ツール呼び出し(Function Calling)は、モデルが「この関数をこの引数で呼んでほしい」と返し、実際に関数を動かすのは自分のプログラムという仕組みです。公式ドキュメント(2026年11月11日確認)をもとに、基本の流れ、思考モードで400になる落とし穴、strictモード(Beta)の条件を整理します。
基本の流れ:モデルは関数を実行しない
公式は、サンプルの流れを4段階で説明しています。モデル自身は関数を実行しません。関数の中身は、使う側が用意します。
- ユーザーが質問する。例:「杭州の天気は?」
- モデルが関数の呼び出しを返す。get_weather({location: "杭州"}) のように、関数名と引数だけが返ります(message.tool_calls)。
- 自分のプログラムで関数を実行し、結果をroleがtoolのメッセージで返す。tool_call_idに、モデルが付けたidをそのまま入れます。
- モデルが結果を使って自然な文章で答える。「杭州の気温は24℃です」のように返ります。
ツールは、tools引数に「名前・説明・引数のJSON Schema」を並べて渡します。説明(description)は、モデルがどのツールを選ぶかの手がかりになるため、「何をする関数か・引数に何を入れるか」を具体的に書きます。
最小のコード(非思考モード)
from openai import OpenAI
client = OpenAI(api_key="<APIキー>", base_url="https://api.deepseek.com")
tools = [{
"type": "function",
"function": {
"name": "get_weather",
"description": "都市の天気を返す。都市名を先に確認すること。",
"parameters": {
"type": "object",
"properties": {"location": {"type": "string", "description": "都市名"}},
"required": ["location"],
},
},
}]
def send(messages):
res = client.chat.completions.create(
model="deepseek-flash", messages=messages, tools=tools,
extra_body={"thinking": {"type": "disabled"}},
)
return res.choices[0].message
messages = [{"role": "user", "content": "杭州の天気は?"}]
msg = send(messages)
call = msg.tool_calls[0]
messages.append(msg) # モデルの返答をそのまま履歴へ
messages.append({"role": "tool", "tool_call_id": call.id, "content": "24℃"})
print(send(messages).content)公式の例は思考モードを切って書かれています。思考モードの場合は、次の節の決まりが加わります。
思考モードでは、reasoning_contentを全部返す
2026年11月11日時点の公式の説明では、思考モードでもツール呼び出しが使えます(DeepSeek-V3.2から対応)。ただし条件があります。toolsを付けたリクエストでは、過去のすべてのターンのreasoning_contentをAPIに返し続ける必要があり、返さないと400エラーになります。ツールを呼ばなかったターンも同じです。
| リクエストにtools | 過去のreasoning_content | 結果 |
|---|---|---|
| あり | すべて返す | 文脈に連結され、思考を引き継ぐ |
| なし | 返さなくてよい | 渡しても無視され、文脈に入らない |
実装のコツは、response.choices[0].message をそのまま履歴に追加することです。content・reasoning_content・tool_calls がすべて入っているので、書き写し漏れが起きません。1つの質問の中でモデルが「考える→ツール→考える」を繰り返す場合も、同じ形でループさせます。会話履歴の全体像は会話履歴の渡し方で説明しています。
strictモード(Beta):引数を型どおりに出させる
strictモードは、モデルが出すツール呼び出しが、定義したJSON Schemaに厳密に従うようにする機能です。思考モード・非思考モードのどちらでも使えます。公式が示す条件は次のとおりです。
- base_urlを
https://api.deepseek.com/betaにする(Beta機能を有効にするため)。 - tools内のすべての関数に strict: true を付ける。
- 各objectで、すべてのプロパティをrequiredにし、additionalPropertiesをfalseにする。
サーバーはスキーマを検証し、仕様に合わない、または未対応の型を含むと、エラーを返します。
| 型 | 使える指定 | 使えない指定 |
|---|---|---|
| string | pattern(正規表現)、format(email・hostname・ipv4・ipv6・uuid) | minLength・maxLength |
| number・integer | const・default・minimum・maximum・exclusiveMinimum・exclusiveMaximum・multipleOf | (記載なし) |
| array | items | minItems・maxItems |
| object | properties・required・additionalProperties:false | (すべてrequiredが必須) |
| その他 | enum・anyOf・$ref/$def | — |
「文字数の上限」や「配列の個数の上限」はスキーマで縛れないため、受け取った側のコードで確認します。
知っておくと詰まらない3つの点
- 会話の途中にツール呼び出しを差し込む(モデルが作っていない呼び出しと結果を履歴に入れる)のは、Anthropic形式(/messages)とResponses APIで対応します。Chat Completion APIは非対応で、システムメッセージの差し込みだけ対応です。
- tool_choiceをnoneにすると、toolsを渡していてもツール呼び出しは無効になります。
- deepseek-v4-proの思考モードでは、top_pは指定しても無視され、ツール呼び出しを有効にしているときは0.95に固定されます(公式のThinking Modeの記載)。
エラーが出たときは、まずエラーコードの一覧で400(形式の誤り)か422(パラメータの誤り)かを確かめます。
確認した公式資料
上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。サンプルコードは公式の例をもとに、このサイトで読みやすく書き換えたものです。
あわせて読むページ
よくある質問
モデルが関数を実行してくれるのですか?
いいえ。モデルが返すのは、呼び出してほしい関数名と引数だけです。実行と、その結果をモデルに返す処理は、自分のプログラムで行います。
思考モードでツールを使うと400エラーになります。
toolsを付けたリクエストでは、過去のターンのreasoning_contentをすべて返す必要があります。response.choices[0].messageをそのまま履歴に追加すれば漏れません。
strictモードは本番で使えますか?
公式はBeta機能と位置づけています。仕様が変わる可能性があるため、使う前に公式のページで最新の条件を確かめてください。