レッスン 1/3 · 10 分

ツールを呼び出す

関数を記述し、モデルが求める呼び出しを実行して、モデルが回答するまで結果を返します。

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 ももう一度送ってください。前に呼び出しのないツールの結果には、対応付ける相手がありません。

ポイント

モデルが求め、アプリが呼び出しを検証して実行し、モデルが最終的な回答を出すまで、呼び出しの ID とともに結果を返します。

関連リンク

進捗はこのブラウザーに保存されます。

最終確認日:2026年11月17日