ホーム › APIの始め方 › ツール呼び出し

DeepSeekガイド

DeepSeek APIのツール呼び出し:流れ・strictモード・思考モードの注意

ツール呼び出し(Function Calling)は、モデルが「この関数をこの引数で呼んでほしい」と返し、実際に関数を動かすのは自分のプログラムという仕組みです。公式ドキュメント(2026年11月11日確認)をもとに、基本の流れ、思考モードで400になる落とし穴、strictモード(Beta)の条件を整理します。

確認・更新 

基本の流れ:モデルは関数を実行しない

公式は、サンプルの流れを4段階で説明しています。モデル自身は関数を実行しません。関数の中身は、使う側が用意します。

  1. ユーザーが質問する。例:「杭州の天気は?」
  2. モデルが関数の呼び出しを返す。get_weather({location: "杭州"}) のように、関数名と引数だけが返ります(message.tool_calls)。
  3. 自分のプログラムで関数を実行し、結果をroleがtoolのメッセージで返す。tool_call_idに、モデルが付けたidをそのまま入れます。
  4. モデルが結果を使って自然な文章で答える。「杭州の気温は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エラーになります。ツールを呼ばなかったターンも同じです。

reasoning_contentの扱い(思考モード)
リクエストにtools過去のreasoning_content結果
ありすべて返す文脈に連結され、思考を引き継ぐ
なし返さなくてよい渡しても無視され、文脈に入らない

実装のコツは、response.choices[0].message をそのまま履歴に追加することです。content・reasoning_content・tool_calls がすべて入っているので、書き写し漏れが起きません。1つの質問の中でモデルが「考える→ツール→考える」を繰り返す場合も、同じ形でループさせます。会話履歴の全体像は会話履歴の渡し方で説明しています。

strictモード(Beta):引数を型どおりに出させる

strictモードは、モデルが出すツール呼び出しが、定義したJSON Schemaに厳密に従うようにする機能です。思考モード・非思考モードのどちらでも使えます。公式が示す条件は次のとおりです。

  1. base_urlを https://api.deepseek.com/beta にする(Beta機能を有効にするため)。
  2. tools内のすべての関数に strict: true を付ける。
  3. 各objectで、すべてのプロパティをrequiredにし、additionalPropertiesをfalseにする。

サーバーはスキーマを検証し、仕様に合わない、または未対応の型を含むと、エラーを返します。

strictモードで使えるJSON Schemaの型(公式の記載)
型使える指定使えない指定
stringpattern(正規表現)、format(email・hostname・ipv4・ipv6・uuid)minLength・maxLength
number・integerconst・default・minimum・maximum・exclusiveMinimum・exclusiveMaximum・multipleOf(記載なし)
arrayitemsminItems・maxItems
objectproperties・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機能と位置づけています。仕様が変わる可能性があるため、使う前に公式のページで最新の条件を確かめてください。