ツール呼び出し
ツール呼び出しを使うと、アプリケーションに用意した関数(ツール)を、モデルの判断で呼び出せます。 モデルは呼び出す関数と引数を返すだけで、関数を実行し、その結果をモデルに返すのはアプリケーションです。
手順
toolsに、呼び出せる関数の名前、説明、引数の形式を指定して、リクエストを送ります。- モデルが呼び出しを決めると、レスポンスの
tool_callsに関数の名前と引数が返ります。 - アプリケーションで関数を実行します。
- 実行した結果を、
roleがtoolのメッセージとして追加して、もう一度リクエストを送ります。
ツールを指定してリクエストを送る
Shell
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 Completions | tools、tool_choice、parallel_tool_calls |
| Responses | tools、tool_choice、parallel_tool_calls |
| Messages | tools、tool_choice |
parallel_tool_calls では、複数のツールを同時に呼び出すかどうかを指定できます。
値は各APIのリファレンスを参照してください。
ツール呼び出しに対応していないモデルでは、指定が無視されるか、400 が返ります。