Skip to Content
ガイド機能ツール呼び出し

ツール呼び出し

ツール呼び出しを使うと、アプリケーションに用意した関数(ツール)を、モデルの判断で呼び出せます。 モデルは呼び出す関数と引数を返すだけで、関数を実行し、その結果をモデルに返すのはアプリケーションです。

手順

  1. tools に、呼び出せる関数の名前、説明、引数の形式を指定して、リクエストを送ります。
  2. モデルが呼び出しを決めると、レスポンスの tool_calls に関数の名前と引数が返ります。
  3. アプリケーションで関数を実行します。
  4. 実行した結果を、role が tool のメッセージとして追加して、もう一度リクエストを送ります。

ツールを指定してリクエストを送る

curl https://ai-gateway.lolipop.jp/v1/chat/completions \ -H "Authorization: Bearer $AI_GATEWAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-6", "messages": [ { "role": "user", "content": "福岡の天気を教えてください。" } ], "tools": [ { "type": "function", "function": { "name": "get_weather", "description": "指定した都市の現在の天気を取得する", "parameters": { "type": "object", "properties": { "city": { "type": "string" } }, "required": ["city"] } } } ] }'

モデルが呼び出しを決めた場合は、finish_reason が tool_calls になり、message.tool_calls に関数の名前と引数が入ります。

JSON
{ "role": "assistant", "content": "福岡の天気を取得します!", "tool_calls": [ { "id": "toolu_vrtx_01KoGNSudXLt4uqhGgfS2gbZ", "type": "function", "function": { "name": "get_weather", "arguments": "{\"city\": \"福岡\"}" } } ] }

ツールの実行結果を返す

モデルが返したメッセージと、関数を実行した結果を messages に追加して、もう一度リクエストを送ります。 実行結果のメッセージの tool_call_id には、対応する tool_calls の id を指定します。

以下にPythonコードでの記述例を示します。

Python
messages.append(completion.choices[0].message) messages.append( { "role": "tool", "tool_call_id": tool_call.id, "content": json.dumps({"city": "福岡", "weather": "晴れ", "temperature": 18}), } ) completion = client.chat.completions.create( model="claude-sonnet-4-6", messages=messages, tools=tools, ) print(completion.choices[0].message.content)

ツールを使うかどうかを指定する

tool_choice に次の値を指定します。

値動作
autoツールを使うかどうかを、モデルが判断します
requiredいずれかのツールを必ず使います
noneツールを使いません

対応しているAPI

APIパラメーター
Chat Completionstools、tool_choice、parallel_tool_calls
Responsestools、tool_choice、parallel_tool_calls
Messagestools、tool_choice

parallel_tool_calls では、複数のツールを同時に呼び出すかどうかを指定できます。 値は各APIのリファレンスを参照してください。

ツール呼び出しに対応していないモデルでは、指定が無視されるか、400 が返ります。