*全新* Anthropic Claude 3.7 Sonnet

Anthropic Claude 3.7 Sonnet 是第一个提供 step-by-step推理的克劳德模型，Anthropic 被称为 “延伸思维”。With Claude 3.7 Sonnet， step-by-step推理的使用是可选的。您可以在标准思维和扩展思维之间进行选择，以进行高级推理。除了延伸思维外，Claude 3.7 Sonnet 每个请求最多允许 12.8 万个输出令牌（通常认为最多 64K 输出令牌可用，但在 64K 到 128K 之间的输出处于测试阶段）。此外，Anthropic 已增强其计算机使用测试版，支持新操作。

With Claude 3.7 Sonnet，max_tokens（包括启用思维时的思维预算）作为严格限制强制执行。现在，如果提示标记 + max_tokens 超过上下文窗口大小，系统将返回验证错误。在启用思维的情况下计算上下文窗口使用情况时，需要注意一些注意事项：

推理（延伸思维）

延伸思考 Claude 3.7 Sonnet 使 chain-of-thought推理能力能够提高复杂任务的准确性，同时还能在给出最终答案之前为其 step-by-step思考过程提供透明度。当你启用扩展思维时，Claude 将通过响应中的thinking内容块展示其推理过程。这些thinking方块代表了 Claude 用于为响应提供信息的内部问题解决过程。Claude 3.7 Sonnet的推理（或思考）模式默认处于禁用状态。每当你启用 Claude 的thinking模式时，你都需要为克劳德在内部推理过程中可能使用的最大代币数量设置预算。您的thinkingbudget_tokens值必须始终小于max_tokens您在请求中指定的值。当推理输出不符合安全标准时，你可能会在输出中看到经过编辑的思维方块。这是预料之中的行为。该模型仍然可以使用这种经过编辑的思维来为其反应提供信息，同时保持安全护栏。在多回thinking合对话中将redacted_thinking方块传递给 API 时，您必须提供完整的、未修改的区块。

回复中的思考令牌计入上下文窗口，并作为输出令牌计费。由于思维令牌被视为普通输出令牌，因此它们也计入您的每分钟服务配额令牌 (TPM) 限制。在多回合对话中，与之前的助手消息相关的思维块不会作为输入令牌收费。

使用思维预算：

最低限度budget_tokens为 1,024 个代币。Anthropic 建议尝试至少 4,000 个代币来实现更全面、更细致入微的推理。

推理与其他参数的兼容性：

推理和提示缓存（有限预览）

思维方块包容性：

在以下情况下，缓存失效：

持久性限制：

带推理的工具使用

在多回合对话中将 thinking 和 redacted_thinking 方块传回 API 时，你必须提供完整的、未经修改的方块。这需要在工具使用过程中保留思维障碍，原因有两个：

在使用工具时使用思维时，请注意以下行为模式：

工具使用思维对话的正常顺序遵循以下步骤：

这种设计允许助手在提出工具请求之前展示其推理过程，但不会在收到工具结果后重复思考过程。

With Anthropic Claude 3.7 Sonnet 模型，你可以指定模型可以用来回复消息的工具。有关更多信息，请参阅中的工具使用（函数调用） Anthropic Claude 文档中）。

更新了《电脑使用》（测试版）

使用电脑时，Claude 可以帮助您通过基本的 GUI 操作自动执行任务。

计算机使用 API 提供了多种预定义的计算机使用工具供您使用。然后，您可以根据您的请求创建提示，例如“向 Ben 发送一封包含我上次会议笔记的电子邮件”和屏幕截图（如果需要）。响应包含 JSON 格式的 tool_use 操作列表（例如，scroll_down、left_button_press、screenshot）。您的代码运行计算机操作并提供 Claude 屏幕截图显示输出（如果需要）。

Claude 3.7 Sonnet 通过现有计算机使用测试版工具的新版本支持扩展计算机使用能力。要使用这些新工具，必须指定 anthropic-beta 推理参数 “anthropic_beta”：[“computer-use-2025-01-24"]。计算机使用时可能出现的一组返回操作包括：滚动、等待、鼠标左键向下、鼠标左键向上、按住键和三击。它将继续在输出中遵循相同的工具使用格式。

有关更多信息，请参阅《计算机使用（测试版）》中的 Anthropic 文档中）。

以下是一个示例响应，它假定请求包含带有 Firefox 图标的桌面屏幕截图。

{
    "id": "msg_123",
    "type": "message",
    "role": "assistant",
    "model": "anthropic.claude-3-7-sonnet-20250219-v1:0",
    "anthropic_beta": ["computer-use-2025-01-24"] ,
    "content": [
        {
            "type": "text",
            "text": "I see the Firefox icon. Let me click on it and then navigate to a weather website."
        },
        {
            "type": "tool_use",
            "id": "toolu_123",
            "name": "computer",
            "input": {
                "action": "mouse_move",
                "coordinate": [
                    708,
                    736
                ]
            }
        },
        {
            "type": "tool_use",
            "id": "toolu_234",
            "name": "computer",
            "input": {
                "action": "left_click"
            }
        }
    ],
    "stop_reason": "tool_use",
    "stop_sequence": null,
    "usage": {
        "input_tokens": 3391,
        "output_tokens": 132
    }
}

思维障碍

思维块代表 Claude 3.7 Sonnet的内部思考过程。

InvokeModel 请求

{
    "anthropic_version": "bedrock-2023-05-31",
    "max_tokens": 24000,
    "thinking": {
        "type": "enabled",
        "budget_tokens": 16000
    },
    "messages": [
        {
            "role": "user",
            "content": "Are there an infinite number of prime numbers such that n mod 4 == 3?"
        }
    ]
}

InvokeModel 响应

{
    "content": [
        {
            "type": "thinking",
            "thinking": "To approach this, let's think about what we know about prime numbers...",
            "signature": "eyJhbGciOiJFUzI1NiIsImtpZCI6ImtleS0xMjM0In0.eyJoYXNoIjoiYWJjMTIzIiwiaWF0IjoxNjE0NTM0NTY3fQ...."
        },
        {
            "type": "text",
            "text": "Yes, there are infinitely many prime numbers such that..."
        }
    ]
}

为了让 Claude 能够在保持安全标准的同时以最小的内部限制解决问题，Anthropic 定义了以下内容：

有时，Claude的内部推理会被自动安全系统标记。发生这种情况时，整个思维方块都会被加密并作为 redacted_thinking 方块返回给你。这些经过编辑的思维块在传递回模型时会被解密，这使克劳德能够在不丢失背景的情况下继续做出回应。

以下是一个 InvokeModel 响应示例，显示了普通思维块和经过编辑的思维方块：

{
  "content": [
    {
      "type": "thinking",
      "thinking": "Let me analyze this step by step...",
      "signature": "WaUjzkypQ2mUEVM36O2TxuC06KN8xyfbJwyem2dw3URve/op91XWHOEBLLqIOMfFG/UvLEczmEsUjavL...."
    },
    {
      "type": "redacted_thinking",
      "data": "EmwKAhgBEgy3va3pzix/LafPsn4aDFIT2Xlxh0L5L8rLVyIwxtE3rAFBa8cr3qpP..."
    },
    {
      "type": "text",
      "text": "Based on my analysis..."
    }
  ]
}

当推理输出不符合安全标准时，你可能会在输出中看到经过编辑的思维方块。这是预料之中的行为。该模型仍然可以使用这种经过编辑的思维来为其反应提供信息，同时保持安全护栏。在多回合对话中将 thinking 和 redacted_thinking 方块传回 API 时，你必须提供完整的、未经修改的方块。

InvokeModelWithResponseStream

启用直播后，您将收到来自 thinking_delta 事件的思考内容。以下是用思维处理直播的方法：

请求

{
    "anthropic_version": "bedrock-2023-05-31",
    "max_tokens": 24000,
    "thinking": {
        "type": "enabled",
        "budget_tokens": 16000
    },
    "messages": [
        {
            "role": "user",
            "content": "What is 27 * 453?"
        }
    ]
}

响应

event: message_start
data: {"type": "message_start", "message": {"id": "msg_01...", "type": "message", "role": "assistant", "content": [], "model": "claude-3-7-sonnet-20250219", "stop_reason": null, "stop_sequence": null}}

event: content_block_start
data: {"type": "content_block_start", "index": 0, "content_block": {"type": "thinking", "thinking": ""}}

event: content_block_delta
data: {"type": "content_block_delta", "index": 0, "delta": {"type": "thinking_delta", "thinking": "Let me solve this step by step:\n\n1. First break down 27 * 453"}}

event: content_block_delta
data: {"type": "content_block_delta", "index": 0, "delta": {"type": "thinking_delta", "thinking": "\n2. 453 = 400 + 50 + 3"}}

// Additional thinking deltas...

event: content_block_delta
data: {"type": "content_block_delta", "index": 0, "delta": {"type": "signature_delta", "signature": "EqQBCgIYAhIM1gbcDa9GJwZA2b3hGgxBdjrkzLoky3dl1pkiMOYds..."}}

event: content_block_stop
data: {"type": "content_block_stop", "index": 0}

event: content_block_start
data: {"type": "content_block_start", "index": 1, "content_block": {"type": "text", "text": ""}}

event: content_block_delta
data: {"type": "content_block_delta", "index": 1, "delta": {"type": "text_delta", "text": "27 * 453 = 12,231"}}

// Additional text deltas...

event: content_block_stop
data: {"type": "content_block_stop", "index": 1}

event: message_delta
data: {"type": "message_delta", "delta": {"stop_reason": "end_turn", "stop_sequence": null}}

event: message_stop
data: {"type": "message_stop"}

扩展输出长度（测试版）

Claude 3.7 Sonnet可以产生比以前的Claude模型长得多的响应，支持多达12.8万个输出代币（测试版）。这种扩展的输出长度可以与新的推理功能一起使用。可以通过传递anthropic-beta推理参数来启用此功能。output-128k-2025-02-19

更新了《电脑使用》（测试版）

Claude 3.7 Sonnet 通过现有计算机使用测试版工具的新版本支持扩展计算机使用能力。要使用这些新工具，必须指定anthropic-beta推理参数computer_20250212。计算机使用时可能出现的一组返回操作包括：滚动、等待、鼠标左键向下、鼠标左键向上、按住键和三击。它将继续在输出中遵循相同的工具使用格式。

全新 Anthropic 定义工具

文本编辑器和 bash 工具以前仅作为computer-use-20241022测试版的一部分提供。作为 Claude 3.7 Sonnet 的一部分，它们现在也将作为独立的 Anthropic 定义工具提供：

字符串替换和 bash 工具都不需要 anthropic-beta 推理参数。

请求和响应

请求正文在请求body字段中传递给InvokeModel或InvokeModelWithResponseStream。您可以在请求中发送的最大有效载荷大小为 20 MB。

有关更多信息，请参阅https://docs.anthropic.com/claude/参考文献/ 消息帖子。

{
    "anthropic_version": "bedrock-2023-05-31", 
    "anthropic_beta": ["computer-use-2025-01-24"] 
    "max_tokens": int,
    "system": string,    
    "messages": [
        {
            "role": string,
            "content": [
                { "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "content image bytes" } },
                { "type": "text", "text": "content text" }
      ]
        }
    ],
    "temperature": float,
    "top_p": float,
    "top_k": int,
    "tools": [
        {
                "type": "custom",
                "name": string,
                "description": string,
                "input_schema": json
            
        },
        { 
            "type": "computer_20250212",  
            "name": "computer", 
            "display_height_px": int,
            "display_width_px": int,
            "display_number": 0 int
        },
        { 
            "type": "bash_20250124", 
            "name": "bash"
        },
        { 
            "type": "text_editor_20250124",
            "name": "str_replace_editor"
        }
        
    ],
    "tool_choice": {
        "type" :  string,
        "name" : string,
    },
    

 
    "stop_sequences": [string]
}