{"id":3595,"date":"2026-10-27T10:59:25","date_gmt":"2026-10-27T01:59:25","guid":{"rendered":"https:\/\/qol-kk.com\/wp2\/?p=3595"},"modified":"2026-10-27T10:59:25","modified_gmt":"2026-10-27T01:59:25","slug":"20261025-plan091","status":"publish","type":"post","link":"https:\/\/qol-kk.com\/wp2\/blog\/2026\/10\/27\/20261025-plan091\/","title":{"rendered":"Claude API \u306e Tool Use \u3067\u5916\u90e8\u30c7\u30fc\u30bf\u3092\u53d6\u5f97\u3059\u308b"},"content":{"rendered":"<h2>\u6982\u8981<\/h2>\n<p>Claude API \u5358\u4f53\u3067\u306f\u3001\u30e2\u30c7\u30eb\u306f\u5b66\u7fd2\u6642\u70b9\u307e\u3067\u306e\u77e5\u8b58\u3057\u304b\u6301\u305f\u305a\u3001\u30ea\u30a2\u30eb\u30bf\u30a4\u30e0\u306e\u5929\u6c17\u30fb\u5728\u5eab\u30fb\u793e\u5185DB\u306e\u5024\u3068\u3044\u3063\u305f\u5916\u90e8\u30c7\u30fc\u30bf\u3092\u7b54\u3048\u3089\u308c\u307e\u305b\u3093\u3002\u3053\u306e\u58c1\u3092\u8d8a\u3048\u308b\u4ed5\u7d44\u307f\u304c <strong>Tool Use\uff08\u30c4\u30fc\u30eb\u4f7f\u7528\uff09<\/strong> \u3067\u3059\u3002<\/p>\n<p>\u3053\u306e\u8a18\u4e8b\u3067\u306f\u3001Python SDK \u3092\u4f7f\u3063\u3066\u300cClaude \u304c\u30c4\u30fc\u30eb\u3092\u547c\u3073\u51fa\u3059 \u2192 \u30a2\u30d7\u30ea\u5074\u3067\u5916\u90e8\u30c7\u30fc\u30bf\u3092\u53d6\u5f97 \u2192 \u7d50\u679c\u3092\u8fd4\u3059 \u2192 Claude \u304c\u6700\u7d42\u56de\u7b54\u3092\u4f5c\u308b\u300d\u3068\u3044\u3046\u5f80\u5fa9\u30eb\u30fc\u30d7\u3092\u30cf\u30f3\u30ba\u30aa\u30f3\u3067\u7d44\u307f\u7acb\u3066\u307e\u3059\u3002\u8907\u6570\u30c4\u30fc\u30eb\u30fb\u30a8\u30e9\u30fc\u51e6\u7406\u30fb\u30d7\u30ed\u30f3\u30d7\u30c8\u30ad\u30e3\u30c3\u30b7\u30e5\u307e\u3067\u6271\u3044\u307e\u3059\u3002\u5185\u5bb9\u306f\u516c\u958b\u60c5\u5831\u306b\u57fa\u3065\u304f\u4e00\u822c\u7684\u306a\u5b9f\u88c5\u30d1\u30bf\u30fc\u30f3\u306e\u307f\u3067\u3059\u3002<\/p>\n<h2>\u74b0\u5883<\/h2>\n<ul>\n<li>Python 3.10+<\/li>\n<li><code>anthropic<\/code> SDK\uff081.x \u7cfb\uff09\uff0f\u5916\u90e8 API \u7528\u306b <code>requests<\/code><\/li>\n<li>\u30e2\u30c7\u30eb: <code>claude-sonnet-4-6<\/code><\/li>\n<\/ul>\n<pre class=\"lang:default decode:true\">pip install anthropic requests\nexport ANTHROPIC_API_KEY=\"\uff08\u81ea\u5206\u306e\u30ad\u30fc\uff09\"<\/pre>\n<h2>Tool Use \u306e\u5168\u4f53\u50cf<\/h2>\n<p>Tool Use \u306f\u300cClaude \u304c\u95a2\u6570\u3092\u5b9f\u884c\u3057\u3066\u304f\u308c\u308b\u300d\u6a5f\u80fd\u3067\u306f\u3042\u308a\u307e\u305b\u3093\u3002<strong>\u5b9f\u969b\u306b\u30b3\u30fc\u30c9\u3092\u52d5\u304b\u3059\u306e\u306f\u30a2\u30d7\u30ea\u5074<\/strong>\u3067\u3001Claude \u306f\u300c\u3053\u306e\u30c4\u30fc\u30eb\u3092\u3001\u3053\u306e\u5f15\u6570\u3067\u547c\u3093\u3067\u307b\u3057\u3044\u300d\u3068\u3044\u3046\u8981\u6c42\u3092\u8fd4\u3059\u3060\u3051\u3067\u3059\u3002<\/p>\n<ol>\n<li>\u30a2\u30d7\u30ea\u304c\u30c4\u30fc\u30eb\u5b9a\u7fa9\u3092\u6dfb\u3048\u3066\u30e1\u30c3\u30bb\u30fc\u30b8\u3092\u9001\u308b<\/li>\n<li>Claude \u304c <code>stop_reason: \"tool_use\"<\/code> \u3068 <code>tool_use<\/code> \u30d6\u30ed\u30c3\u30af\u3092\u8fd4\u3059<\/li>\n<li>\u30a2\u30d7\u30ea\u304c\u30c4\u30fc\u30eb\u3092\u5b9f\u884c\u3057\u3001<code>tool_result<\/code> \u3092\u4f1a\u8a71\u5c65\u6b74\u306b\u8ffd\u52a0\u3057\u3066\u518d\u9001\u3059\u308b<\/li>\n<li>Claude \u304c\u7d50\u679c\u3092\u8e0f\u307e\u3048\u3066\u6700\u7d42\u56de\u7b54\u3092\u8fd4\u3059<\/li>\n<\/ol>\n<p>\u3053\u306e\u5f80\u5fa9\u3092<strong>\u30a2\u30d7\u30ea\u5074\u306e\u30eb\u30fc\u30d7\u3067\u56de\u3059<\/strong>\u306e\u304c\u809d\u3067\u3059\u30021\u56de\u306e <code>messages.create<\/code> \u3067\u306f\u5b8c\u7d50\u3057\u307e\u305b\u3093\u3002<\/p>\n<h2>\u307e\u305a\u6700\u5c0f\u69cb\u6210\uff1a\u30c4\u30fc\u30eb\u5b9a\u7fa9\u3068\u547c\u3073\u51fa\u3057\u8981\u6c42<\/h2>\n<pre class=\"lang:default decode:true\">import anthropic\n\nclient = anthropic.Anthropic()\n\ntools = [\n    {\n        \"name\": \"get_weather\",\n        \"description\": \"\u6307\u5b9a\u3057\u305f\u90fd\u5e02\u306e\u73fe\u5728\u306e\u5929\u6c17\u3092\u53d6\u5f97\u3059\u308b\u3002\u6c17\u6e29\u306f\u6442\u6c0f\u3067\u8fd4\u308b\u3002\",\n        \"input_schema\": {\n            \"type\": \"object\",\n            \"properties\": {\n                \"city\": {\n                    \"type\": \"string\",\n                    \"description\": \"\u90fd\u5e02\u540d\u3002\u82f1\u8a9e\u8868\u8a18\uff08\u4f8b: Tokyo, Osaka\uff09\",\n                }\n            },\n            \"required\": [\"city\"],\n        },\n    }\n]\n\nresponse = client.messages.create(\n    model=\"claude-sonnet-4-6\",\n    max_tokens=1024,\n    tools=tools,\n    messages=[{\"role\": \"user\", \"content\": \"\u6771\u4eac\u306e\u5929\u6c17\u3092\u6559\u3048\u3066\"}],\n)\n\nfor block in response.content:\n    if block.type == \"tool_use\":\n        print(block.name, block.input, block.id)\n        # get_weather {'city': 'Tokyo'} toolu_...<\/pre>\n<p><code>description<\/code> \u306f Claude \u304c\u30c4\u30fc\u30eb\u3092\u9078\u3076\u5224\u65ad\u6750\u6599\u305d\u306e\u3082\u306e\u3067\u3059\u3002<strong>\u4f55\u3092\u8fd4\u3059\u30c4\u30fc\u30eb\u304b\u30fb\u5358\u4f4d\u30fb\u524d\u63d0\u30fb\u4f7f\u3044\u3069\u3053\u308d<\/strong>\u307e\u3067\u5177\u4f53\u7684\u306b\u66f8\u304f\u3068\u7cbe\u5ea6\u304c\u5b89\u5b9a\u3057\u307e\u3059\u3002<\/p>\n<h2>\u5916\u90e8\u30c7\u30fc\u30bf\u53d6\u5f97\u3092\u5b9f\u88c5\u3059\u308b<\/h2>\n<pre class=\"lang:default decode:true\">import requests\n\ndef get_weather(city: str) -&gt; dict:\n    geo = requests.get(\n        \"https:\/\/geocoding-api.open-meteo.com\/v1\/search\",\n        params={\"name\": city, \"count\": 1}, timeout=10,\n    ).json()\n    if not geo.get(\"results\"):\n        return {\"error\": f\"\u90fd\u5e02\u304c\u898b\u3064\u304b\u308a\u307e\u305b\u3093: {city}\"}\n\n    loc = geo[\"results\"][0]\n    w = requests.get(\n        \"https:\/\/api.open-meteo.com\/v1\/forecast\",\n        params={\n            \"latitude\": loc[\"latitude\"],\n            \"longitude\": loc[\"longitude\"],\n            \"current\": \"temperature_2m,weather_code\",\n        }, timeout=10,\n    ).json()[\"current\"]\n\n    return {\n        \"city\": loc[\"name\"],\n        \"temperature_c\": w[\"temperature_2m\"],\n        \"weather_code\": w[\"weather_code\"],\n    }<\/pre>\n<p>\u793e\u5185 API \u3067\u3082 DB \u30af\u30a8\u30ea\u3067\u3082\u3001\u95a2\u6570\u306e\u4e2d\u8eab\u304c\u5909\u308f\u308b\u3060\u3051\u3067\u69cb\u9020\u306f\u540c\u3058\u3067\u3059\u3002<\/p>\n<h2>\u5f80\u5fa9\u30eb\u30fc\u30d7\u3092\u7d44\u3080<\/h2>\n<pre class=\"lang:default decode:true\">import json\n\ndef run_conversation(user_message: str, max_turns: int = 10) -&gt; str:\n    messages = [{\"role\": \"user\", \"content\": user_message}]\n\n    for _ in range(max_turns):\n        response = client.messages.create(\n            model=\"claude-sonnet-4-6\",\n            max_tokens=1024,\n            tools=tools,\n            messages=messages,\n        )\n        messages.append({\"role\": \"assistant\", \"content\": response.content})\n\n        if response.stop_reason != \"tool_use\":\n            return \"\".join(b.text for b in response.content if b.type == \"text\")\n\n        tool_results = []\n        for block in response.content:\n            if block.type != \"tool_use\":\n                continue\n            try:\n                if block.name == \"get_weather\":\n                    result = get_weather(**block.input)\n                else:\n                    result = {\"error\": f\"unknown tool: {block.name}\"}\n            except Exception as e:\n                result = {\"error\": f\"tool execution failed: {e}\"}\n\n            tool_results.append({\n                \"type\": \"tool_result\",\n                \"tool_use_id\": block.id,\n                \"content\": json.dumps(result, ensure_ascii=False),\n                \"is_error\": \"error\" in result,\n            })\n\n        messages.append({\"role\": \"user\", \"content\": tool_results})\n\n    return \"\uff08\u6700\u5927\u30bf\u30fc\u30f3\u6570\u306b\u5230\u9054\u3057\u307e\u3057\u305f\uff09\"\n\n\nprint(run_conversation(\"\u6771\u4eac\u3068\u30cb\u30e5\u30fc\u30e8\u30fc\u30af\u306e\u5929\u6c17\u3092\u6bd4\u3079\u3066\"))<\/pre>\n<p>\u5b9f\u88c5\u3067\u62bc\u3055\u3048\u308b\u3079\u304d3\u70b9\u3067\u3059\u3002<\/p>\n<ul>\n<li><strong>assistant \u306e <code>content<\/code> \u306f\u4e38\u3054\u3068\u5c65\u6b74\u306b\u623b\u3059<\/strong>\u3002\u5206\u89e3\u3057\u3066\u5165\u308c\u76f4\u3059\u3068 <code>tool_use_id<\/code> \u306e\u5bfe\u5fdc\u304c\u58ca\u308c\u307e\u3059\u3002<\/li>\n<li><strong><code>tool_result<\/code> \u306f <code>role: \"user\"<\/code> \u3067\u9001\u308b<\/strong>\u3002<code>assistant<\/code> \u306b\u3059\u308b\u3068 API \u30a8\u30e9\u30fc\u306b\u306a\u308a\u307e\u3059\u3002<\/li>\n<li><strong>1\u5fdc\u7b54\u306b\u8907\u6570\u306e <code>tool_use<\/code> \u304c\u5165\u308a\u3046\u308b<\/strong>\uff08\u300c\u6771\u4eac\u3068\u30cb\u30e5\u30fc\u30e8\u30fc\u30af\u300d\u3067\u5929\u6c17API\u30922\u56de\uff09\u3002\u5168\u90e8\u51e6\u7406\u3057\u3066\u5168\u90e8\u307e\u3068\u3081\u3066\u8fd4\u3057\u307e\u3059\u3002\u8fd4\u3057\u6f0f\u3089\u3059\u3068\u30a8\u30e9\u30fc\u306b\u306a\u308a\u307e\u3059\u3002<\/li>\n<\/ul>\n<h2>\u30a8\u30e9\u30fc\u306e\u6271\u3044\u3068 tool_choice<\/h2>\n<p>\u30c4\u30fc\u30eb\u5b9f\u884c\u306e\u5931\u6557\u306f\u4f8b\u5916\u3067\u843d\u3068\u3055\u305a\u3001<strong>\u30a8\u30e9\u30fc\u5185\u5bb9\u3092 <code>tool_result<\/code> \u3068\u3057\u3066\u8fd4\u3059<\/strong>\u306e\u304c\u5b9f\u52d9\u7684\u3067\u3059\u3002<code>is_error: true<\/code> \u3092\u4ed8\u3051\u308b\u3068\u3001Claude \u306f\u5225\u306e\u5f15\u6570\u3067\u518d\u8a66\u884c\u3057\u305f\u308a\u3001\u30e6\u30fc\u30b6\u30fc\u306b\u78ba\u8a8d\u3057\u305f\u308a\u3068\u81ea\u5df1\u4fee\u6b63\u3067\u304d\u307e\u3059\u3002<\/p>\n<p><code>tool_choice<\/code> \u306e\u65e2\u5b9a\u306f <code>auto<\/code>\uff08Claude \u304c\u5224\u65ad\uff09\u3002\u5fc5\u305a\u547c\u3070\u305b\u305f\u3044\u3068\u304d\u306f <code>{\"type\": \"any\"}<\/code>\u3001\u7279\u5b9a\u30c4\u30fc\u30eb\u56fa\u5b9a\u306f <code>{\"type\": \"tool\", \"name\": \"...\"}<\/code>\u3001\u7981\u6b62\u306f <code>{\"type\": \"none\"}<\/code> \u3067\u3059\u3002\u30a8\u30e9\u30fc\u304c\u7d9a\u304f\u3068\u5f80\u5fa9\u304c\u6b62\u307e\u3089\u306a\u3044\u305f\u3081\u3001<strong>\u6700\u5927\u53cd\u5fa9\u56de\u6570\u306e\u4e0a\u9650\u306f\u5fc5\u9808<\/strong>\u3067\u3059\u3002<\/p>\n<h2>\u30d7\u30ed\u30f3\u30d7\u30c8\u30ad\u30e3\u30c3\u30b7\u30e5\u3067\u30b3\u30b9\u30c8\u3092\u6291\u3048\u308b<\/h2>\n<p>\u30c4\u30fc\u30eb\u5b9a\u7fa9\u3084\u30b7\u30b9\u30c6\u30e0\u30d7\u30ed\u30f3\u30d7\u30c8\u304c\u5927\u304d\u3044\u5834\u5408\u3001<code>tools<\/code> \u306e\u672b\u5c3e\u8981\u7d20\u306b <code>cache_control<\/code> \u3092\u4ed8\u3051\u308b\u3068\u5b9a\u7fa9\u90e8\u304c\u30ad\u30e3\u30c3\u30b7\u30e5\u3055\u308c\u3001\u5f80\u5fa9\u306e\u305f\u3073\u306e\u30c8\u30fc\u30af\u30f3\u30b3\u30b9\u30c8\u3068\u9045\u5ef6\u3092\u6291\u3048\u3089\u308c\u307e\u3059\u3002<\/p>\n<pre class=\"lang:default decode:true\">tools = [\n    {\"name\": \"get_weather\", \"description\": \"...\",\n     \"input_schema\": {...},\n     \"cache_control\": {\"type\": \"ephemeral\"}}\n]<\/pre>\n<h2>\u78ba\u8a8d\u65b9\u6cd5<\/h2>\n<ul>\n<li>1\u5468\u76ee\u3067 <code>stop_reason == \"tool_use\"<\/code>\u3001<code>block.input<\/code> \u304c schema \u901a\u308a\u306e\u578b\u306b\u306a\u308b\u3053\u3068<\/li>\n<li>2\u5468\u76ee\u4ee5\u964d\u3067 <code>stop_reason == \"end_turn\"<\/code> \u306b\u5909\u308f\u308a\u6700\u7d42\u30c6\u30ad\u30b9\u30c8\u304c\u5f97\u3089\u308c\u308b\u3053\u3068<\/li>\n<li>\u5b58\u5728\u3057\u306a\u3044\u30c4\u30fc\u30eb\u540d\u3084\u5f15\u6570\u4e0d\u8db3\u306e\u3068\u304d\u3001<code>is_error<\/code> \u3092\u898b\u3066 Claude \u304c\u81ea\u5df1\u4fee\u6b63\u3059\u308b\u3053\u3068<\/li>\n<\/ul>\n<p>\u6bce\u5468\u306e <code>messages<\/code> \u3092\u51fa\u529b\u3059\u308b\u3068\u3001\u5c65\u6b74\u306e\u7a4d\u307f\u65b9\u306e\u8aa4\u308a\uff08<code>tool_result<\/code> \u4ed8\u3051\u5fd8\u308c\u30fb\u30ed\u30fc\u30eb\u9055\u3044\uff09\u304c\u3059\u3050\u898b\u3048\u307e\u3059\u3002<\/p>\n<h2>\u307e\u3068\u3081<\/h2>\n<ul>\n<li>Tool Use \u306f Claude \u304c\u8981\u6c42\u3057\u3001<strong>\u5b9f\u884c\u306f\u30a2\u30d7\u30ea\u304c\u62c5\u3046<\/strong>\u4ed5\u7d44\u307f<\/li>\n<li><code>tool_use \u2192 \u5b9f\u884c \u2192 tool_result \u518d\u9001<\/code> \u3092 <code>stop_reason<\/code> \u304c\u5909\u308f\u308b\u307e\u3067\u30eb\u30fc\u30d7\u3067\u56de\u3059<\/li>\n<li>assistant \u5fdc\u7b54\u306f\u4e38\u3054\u3068\u623b\u3059\uff0f<code>tool_result<\/code> \u306f user \u30ed\u30fc\u30eb\uff0f\u8907\u6570\u547c\u3073\u51fa\u3057\u306f\u5168\u90e8\u8fd4\u3059<\/li>\n<li>\u30a8\u30e9\u30fc\u306f <code>is_error<\/code> \u3067\u8fd4\u3059\u3068\u81ea\u5df1\u4fee\u6b63\u304c\u52b9\u304f\uff0f\u5927\u304d\u306a\u5b9a\u7fa9\u306f <code>cache_control<\/code> \u3067\u30ad\u30e3\u30c3\u30b7\u30e5<\/li>\n<\/ul>\n<p>\u307e\u305a1\u30c4\u30fc\u30eb1\u5f80\u5fa9\u3092\u52d5\u304b\u3057\u3001\u305d\u3053\u304b\u3089\u8907\u6570\u30c4\u30fc\u30eb\u3068\u30a8\u30e9\u30fc\u51e6\u7406\u3092\u8db3\u3057\u3066\u3044\u304f\u306e\u304c\u3001\u62e1\u5f35\u3057\u3084\u3059\u304f\u78ba\u5b9f\u3067\u3059\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Claude API \u5358\u4f53\u3067\u306f\u3001\u30e2\u30c7\u30eb\u306f\u5b66\u7fd2\u6642\u70b9\u307e\u3067\u306e\u77e5\u8b58\u3057\u304b\u6301\u305f\u305a\u3001\u30ea\u30a2\u30eb\u30bf\u30a4\u30e0\u306e\u5929\u6c17\u30fb\u5728\u5eab\u30fb\u793e\u5185DB\u306e\u5024\u3068\u3044\u3063\u305f\u5916\u90e8\u30c7\u30fc\u30bf\u3092\u7b54\u3048\u3089\u308c\u307e\u305b\u3093\u3002\u3053\u306e\u58c1\u3092\u8d8a\u3048\u308b\u4ed5\u7d44\u307f\u304c Tool Use\uff08\u30c4\u30fc\u30eb\u4f7f\u7528\uff09 \u3067\u3059\u3002<\/p>\n","protected":false},"author":1,"featured_media":3594,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"sns_share_botton_hide":"","vkExUnit_sns_title":"","_vk_print_noindex":"","sitemap_hide":"","_veu_custom_css":"","veu_display_promotion_alert":"","vkexunit_cta_each_option":"","_lightning_design_setting":[],"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"jetpack_post_was_ever_published":false},"categories":[38],"tags":[64,147],"class_list":["post-3595","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-python-memorandum","tag-api","tag-python"],"veu_head_title_object":{"title":"","add_site_title":""},"jetpack_publicize_connections":[],"jetpack-related-posts":[],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"https:\/\/qol-kk.com\/wp2\/wp-content\/uploads\/2026\/10\/20261025-plan091-thumbnail.jpg","_links":{"self":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts\/3595","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/comments?post=3595"}],"version-history":[{"count":1,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts\/3595\/revisions"}],"predecessor-version":[{"id":3615,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts\/3595\/revisions\/3615"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/media\/3594"}],"wp:attachment":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/media?parent=3595"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/categories?post=3595"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/tags?post=3595"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}