ツール呼び出し

カタログのメタデータでツール対応が明示されたモデルにのみ関数定義を送ってください。

ツールを定義

チャットリクエスト

{
  "model": "YOUR_APPROVED_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "What is the weather in Paris?"
    }
  ],
  "max_tokens": 256,
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Look up weather for a city",
        "parameters": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string"
            }
          },
          "required": [
            "city"
          ]
        }
      }
    }
  ],
  "tool_choice": "auto"
}

ツールのループを実行

応答からアシスタントのtool_callsを読み取ります。
自身のアプリで要求された関数と引数を検証します。
必要な許可を取得してからツールを実行します。
対応するtool_call_idを付けてツール結果を返します。

ゲートウェイはツール定義と結果を中継し、実行はしません。モデル出力とツール引数は信頼できない入力として扱ってください。

機能に関するエラー

ツール対応未確認のモデルにツールやツールメッセージを送ると unsupported_capability エラーが返ります。クライアントのツールモードを有効にする前にカタログを確認してください。