ツールを呼び出す
関数を記述し、モデルが求める呼び出しを実行して、モデルが回答するまで結果を返します。
tools に関数を記述すると、モデルは推測する代わりに、データベースの検索などその関数の 1 つを呼び出す形で応答します。モデル自身は何も実行しません。アプリが関数を実行して結果を返し、それを受けてモデルが最終的な回答を書きます。
curl https://api.phaseo.app/v1/chat/completions \
-H "Authorization: Bearer $PHASEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-6-astra",
"messages": [
{ "role": "user", "content": "What is the weather in London?" }
],
"tools": [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather by city",
"parameters": {
"type": "object",
"properties": {
"city": { "type": "string" }
},
"required": ["city"]
}
}
}
]
}'
Chat Completions では、返答に finish_reason: "tool_calls" があり、アシスタントのメッセージに tool_calls のリストが入ります。それぞれに id、関数の name、JSON 文字列の arguments があります。各呼び出しを実行したら、会話、変更しないままのアシスタントのメッセージ、そして呼び出しごとに tool_call_id で対応付けた role: "tool" メッセージを 1 つずつ含めて、次のリクエストを送ります。tools ももう一度送ります。モデルは回答するか別のツールを呼び出すので、それを繰り返します。/v1/responses では、呼び出しは function_call アイテム、結果は同じ call_id を持つ function_call_output アイテムです。/v1/messages では tool_use ブロックと tool_result ブロックです。
tool_choice は、モデルがツールを呼び出せるかを制御します。テキストだけなら none、モデルに任せるなら auto(または省略)、呼び出しを強制するなら required、特定のツールを指定するならオブジェクトを使います。ツールを 1 つずつ実行する必要がある場合は、parallel_tool_calls を false にします。
すべての呼び出しを信頼できない入力として扱ってください。ツール名を許可リストと照合し、未知の名前は拒否し、何かを実行する前に解析した引数を検証します。検証に失敗したらツールは実行せず、短いエラーをツールの結果として返し、モデルに再試行させます。stream: true の場合は、解析する前にすべての引数のデルタを集めてください。phaseo:web_search や phaseo:datetime のように、type が phaseo: で始まるツールは Phaseo 側で実行されるので、実行処理を書かなくても最終的な回答が得られます。これらのサーバーツールは ベータ です。
理解度チェック
モデルが {"id": "42"} で delete_user の呼び出しを返しました。アプリで定義しているのは get_weather だけです。コードはどうすべきですか?
実践してみる
サポートボットは get_order を呼び出してから回答します。チームメイトのループは、次のリクエストで role: "tool" メッセージだけを送っており、プロバイダーに拒否されます。何が足りませんか?
答えを表示答えを隠す
次のリクエストでは、会話を繰り返し、続いて tool_calls を変更しないままのアシスタントのメッセージ、さらに呼び出しごとに対応する tool_call_id を持つ role: "tool" メッセージを 1 つずつ送る必要があります。tools ももう一度送ってください。前に呼び出しのないツールの結果には、対応付ける相手がありません。
ポイント
関連リンク
最終確認日:2026年11月17日